DLGPAGE 구조체(compstui.h)

  • 아티클

DLGPAGE 구조체는 CPSUI의 ComPropSheet 함수에 속성 시트 페이지를 지정하는 데 사용됩니다. 구조체의 주소는 COMPROPSHEETUI 구조체에 포함되며 모든 멤버 값은 ComPropSheet 호출자가 제공합니다.

구문

typedef struct _DLGPAGE {
  WORD      cbSize;
  WORD      Flags;
  DLGPROC   DlgProc;
  LPTSTR    pTabName;
  ULONG_PTR IconID;
  union {
    WORD   DlgTemplateID;
    HANDLE hDlgTemplate;
  } DUMMYUNIONNAME;
} DLGPAGE, *PDLGPAGE;

멤버

cbSize

호출자가 제공한 DLGPAGE 구조체의 크기(바이트)입니다.

Flags

다음 표에 설명된 대로 호출자가 제공한 비트 플래그입니다.

플래그 정의
DPF_ICONID_AS_HICON 설정되면 IconID에 아이콘 핸들이 포함됩니다. 설정하지 않으면 IconID에 아이콘 리소스 식별자가 포함됩니다.
DPF_USE_HDLGTEMPLATE 설정된 경우 hDlgTemplate 에는 템플릿 핸들이 포함됩니다. 설정하지 않으면 DlgTemplateID 에는 템플릿 리소스 식별자가 포함됩니다.

사용자 이벤트가 발생할 때 시스템에서 보낸 메시지를 처리하는 데 사용되는 대화 상자 프로시저에 대한 호출자 제공 DLGPROC 형식 포인터(선택 사항)입니다. NULL인 경우 CPSUI는 대화 상자 프로시저를 제공합니다. 자세한 내용은 아래 설명 섹션을 참조하세요.

DlgProc

DLGPROC 멤버 DlgProc을 정의합니다.

pTabName

페이지 탭에 표시할 NULL로 끝나는 문자열에 대한 호출자 제공 포인터입니다.

IconID

호출자가 제공하는 는 다음 중 하나일 수 있습니다.

  • 아이콘 리소스 식별자입니다. 애플리케이션에서 정의하거나 CPSUI에서 제공하는 IDI_CPSUI 접두사 아이콘 리소스 식별자 중 하나일 수 있습니다.

  • 아이콘 핸들입니다. 핸들이 지정된 경우 flags 멤버에서 DPF_ICONID_AS_HICON 설정해야 합니다.

지정한 아이콘이 페이지 탭에 표시됩니다. 이 값이 0이면 아이콘이 표시되지 않습니다.

DUMMYUNIONNAME

DUMMYUNIONNAME 공용 구조체를 정의합니다.

DUMMYUNIONNAME.DlgTemplateID

대화 상자 템플릿에 대한 호출자 제공 리소스 식별자입니다. 애플리케이션에서 제공하는 DIALOG 리소스를 참조하거나 다음 CPSUI 제공 식별자 중 하나일 수 있습니다(compstui.h에 정의됨).

ID 페이지 유형
DP_STD_DOCPROPPAGE1 인쇄 문서의 레이아웃 페이지에 사용되는 비트리뷰 페이지입니다.
DP_STD_DOCPROPPAGE2 인쇄 문서의 용지/품질 페이지에 사용되는 비트리뷰 페이지입니다.
DP_STD_TREEVIEWPAGE 일반 트리 뷰 페이지입니다.

CPSUI 제공 식별자는 CPSUI 옵션 형식을 표시할 수 있는 템플릿을 참조합니다. 해당 템플릿의 페이지 크기는 252 by 216 대화 상자 단위입니다. 자세한 내용은 CPSUI 제공 페이지 및 템플릿을 참조하세요.

DPF_USE_HDLGTEMPLATE 플래그에 설정된 경우 이 멤버는 사용되지 않습니다.

DUMMYUNIONNAME.hDlgTemplate

DLGTEMPLATE 구조체에 대한 호출자 제공 핸들입니다.

DPF_USE_HDLGTEMPLATE 플래그에 설정된 경우에만 사용됩니다.

설명

CPSUI는 PROPSHEETPAGE 구조를 할당하고 CreatePropertySheetPage에 전달하여 속성 시트 페이지를 만듭니다. 호출자가 DlgProc의 대화 상자 프로시저에 대한 DLGPROC 형식 포인터를 지정한 경우 해당 프로시저는 페이지의 창 메시지를 처리하는 데 사용됩니다. DlgProc이 NULL인 경우 CPSUI의 자체 대화 상자 프로시저가 사용됩니다.

DlgProc에서 가리키는 대화 상자 프로시저가 WM_INITDIALOG 메시지 값으로 호출되면 PROPSHEETPAGE 구조를 입력으로 수신하고 PSPINFO 구조도 수신합니다.

호출자가 제공한 대화 상자 프로시저가 메시지를 처리하는 경우 0이 아닌 값을 반환해야 합니다. 함수가 메시지를 처리하지 않으면 0을 반환해야 하므로 CPSUI에서 메시지를 처리합니다.

요구 사항

요구 사항 값
헤더 compstui.h(Compstui.h 포함)