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

定義 DUMMCOUNTIONNAME 等位。

DUMMYUNIONNAME.DlgTemplateID

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

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

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

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

DUMMYUNIONNAME.hDlgTemplate

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

只有在 旗標中設定DPF_USE_HDLGTEMPLATE時才使用。

備註

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

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

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

規格需求

需求	值
標頭	compstui.h (包括 Compstui.h)