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。

指定的圖示會顯示在頁面索引標籤上。如果此值為零，則不會顯示圖示。

DUMMYUNIONNAME

定義 DUMMYUNIONNAME 等位。

DUMMYUNIONNAME.DlgTemplateID

對話框範本的呼叫端提供的資源標識碼。 這可以參考應用程式提供的 DIALOG 資源，或者它可以是下列其中一個 CPSUI 提供的識別碼（定義於 compstui.h）：

標識碼	頁面類型
DP_STD_DOCPROPPAGE1	非樹檢視頁面，用於列印檔的 版面配置 頁面。
DP_STD_DOCPROPPAGE2	非樹檢視頁面，用於列印檔的 紙張/品質 頁面。
DP_STD_TREEVIEWPAGE	一般樹視圖頁面。

CPSUI 提供的識別碼是指可以在 顯示CPSUI 選項類型的範本。 這些範本的頁面大小為252到216個對話框單位。 如需詳細資訊，請參閱 CPSUI-Supplied Pages 和 Templates。

如果在 Flags中設定DPF_USE_HDLGTEMPLATE，則不會使用此成員。

DUMMYUNIONNAME.hDlgTemplate

呼叫端提供給 DLGTEMPLATE 結構的句柄。

只有在 Flags中設定DPF_USE_HDLGTEMPLATE時，才會使用 。

言論

CPSUI 會藉由配置 PROPSHEETPAGE 結構，並將其傳遞至 createPropertySheetPage ，以建立屬性表頁面。 如果呼叫端在 DlgProc中指定了對話框程式的 DLGPROC 型別指標，則會使用該程式來處理頁面的視窗訊息。 如果 DlgProc NULL，則會使用 CPSUI 自己的對話框程式。

當 DlgProc 所指向的對話框程式以 WM_INITDIALOG訊息值呼叫時，它會接收 PROPSHEETPAGE 結構做為輸入，而且也會接收 PSPINFO 結構。

如果呼叫端提供的對話框程式會處理訊息，它應該會傳回非零值。 如果函式未處理訊息，它應該傳回零，這會導致 CPSUI 處理訊息。

要求

要求	價值
標頭	compstui.h （包括 Compstui.h）