EXTPUSH 結構 (compstui.h)

CPSUI 應用程式會使用 EXTPUSH 結構， (包括印表機介面 DLL) 來指定擴充的按鈕，這可以新增至屬性表頁面選項。 按下按鈕時，即可顯示新的對話方塊。

語法

typedef struct _EXTPUSH {
  WORD      cbSize;
  WORD      Flags;
  LPTSTR    pTitle;
  union {
    DLGPROC DlgProc;
    FARPROC pfnCallBack;
  } DUMMYUNIONNAME;
  ULONG_PTR IconID;
  union {
    WORD   DlgTemplateID;
    HANDLE hDlgTemplate;
  } DUMMYUNIONNAME2;
  ULONG_PTR dwReserved[3];
} EXTPUSH, *PEXTPUSH;

成員

cbSize

EXTPUSH 結構的大小，以位元組為單位。

Flags

位旗標，可以是下列其中一項：

旗標	描述
EPF_ICONID_AS_HICON	如果設定， IconID 成員會包含圖示句柄。 如果未設定， IconID 成員會包含圖示資源標識符。
EPF_INCLUDE_SETUP_TITLE	如果設定，CPSUI 會將 「Setup」 附加至 pTitle 指向的字串。
EPF_NO_DOT_DOT_DOT	如果設定，CPSUI 不會附加 “...”表示 pTitle 所指向的字串。
EPF_OVERLAY_NO_ICON	如果設定，CPSUI 會將其IDI_CPSUI_NO圖示重疊到 IconID 成員所識別的圖示上。
EPF_OVERLAY_STOP_ICON	如果設定，CPSUI 會將IDI_CPSUI_STOP圖示重疊到 IconID 成員所識別的圖示上。
EPF_OVERLAY_WARNING_ICON	如果設定，CPSUI 會將其IDI_CPSUI_WARNING圖示重疊到 IconID 成員所識別的圖示上。
EPF_PUSH_TYPE_DLGPROC	如果設定， DlgProc 和 DlgTemplateID/hDlgTemplate 成員都是有效的。 如果未設定， pfnCallBack 成員是有效的。
EPF_USE_HDLGTEMPLATE	如果設定， hDlgTemplate 會包含範本句柄。 如果未設定， DlgTemplateID 會包含範本資源標識碼。

pTitle

字串標識碼，表示按鈕標題。 這可以是 NULL 終止字串的 32 位指標，也可以是 16 位字串資源識別符，且 HIWORD 設定為零。

DUMMYUNIONNAME

定義 DUMMCOUNTIONNAME 等位。

DUMMYUNIONNAME.DlgProc

DLGPROC 類型的對話框指標，用來處理按鈕對話框的訊息。 For more information on using DialogProc, see the Remarks section below.

如果提供此指標，則必須在 Flags 中設定EPF_PUSH_TYPE_DLGPROC。

DUMMYUNIONNAME.pfnCallBack

_CPSUICALLBACK型別回呼函式的指標，以處理CPSUICB_REASON_PUSHBUTTON原因。 如需詳細資訊，請參閱接下來的＜備註＞一節。

如果提供此指標，則必須在 Flags 中清除EPF_PUSH_TYPE_DLGPROC。

IconID

下列其中一個圖示識別碼：

• 圖示資源標識碼。 這可以是應用程式定義的，也可以是其中一個 CPSUI 提供的IDI_CPSUI前置圖示資源識別碼。

• 圖示句柄。 如果指定句柄，則必須在 Flags 成員中設定EPF_ICONID_AS_HICON。

• CPSUI 會顯示按鈕旁的圖示。 如果此值為零，則不會顯示圖示。

DUMMYUNIONNAME2

定義 DUMMYUNIONNAME2 聯集。

DUMMYUNIONNAME2.DlgTemplateID

指定對話框的資源識別碼。

如果 DlgTemplateID = 0，則常見的 UI 會使用下列參數呼叫 DlgProc ：

DlgProc(hDlg, WM_USER, NULL, (LPARAM)pCPSUICBParam);

DUMMYUNIONNAME2.hDlgTemplate

DLGTEMPLATE 的句柄，將用於快顯對話方塊。

dwReserved[3]

保留，必須初始化為零。

備註

延伸的按鈕是一種 CPSUI 定義的按鈕類型，可以與 OPTITEM 結構相關聯。 OPTITEM 結構可以有一個與它相關聯的延伸按鈕或一個延伸複選框。

當您使用 EXTPUSH 結構來建立按鈕時，您可以選擇性地建立當使用者按鍵時開啟的其他對話方塊。 若要建立此對話框，您應該在 DlgProc 成員中指定對話框程式的指標，並在 DlgTemplateID 或 hDlgTemplate 成員中包含對話框範本規格。

如果在 Flags 中設定EPF_USE_HDLGTEMPLATE，CPSUI 會呼叫 DialogBoxIndirectParam 來建立對話框，並傳遞 DlgProc 和 hDlgTemplate 成員的內容。

如果未在 Flags 中設定EPF_USE_HDLGTEMPLATE，CPSUI 會呼叫 DialogBoxParam 來建立對話方塊，並傳遞 DlgProc 和 DlgTemplateID 成員的內容。

使用 uMsg 值為 WM_INITDIALOG 呼叫對話框程式時， lParam 值是 CPSUICBPARAM 結構的位址， 而 Reason 成員設定為 CPSUICB_REASON_EXTPUSH。 如需 uMsg 和 lParam 參數的詳細資訊，請參閱 DialogProc。

如果使用者按鍵時不需要 CPSUI 顯示對話框，您可以在 pfnCallBack 成員中指定_CPSUICALLBACK型別回呼函式的位址。 當使用者按鍵時，CPSUI 會呼叫回調函式。 隨附的 CPSUICBPARAM 結構 Reason 成員將會設定為CPSUICB_REASON_EXTPUSH。

規格需求

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

另請參閱

EXTCHKBOX