typedef struct _EXTPUSH {
WORD cbSize;
WORD Flags;
LPTSTR pTitle;
union {
DLGPROC DlgProc;
FARPROC pfnCallBack;
}
DWORD IconID;
union {
WORD DlgTemplateID;
HANDLE hDlgTemplate;
}
DWORD dwReserved[3];
} EXTPUSH, *PEXTPUSH;
The EXTPUSH structure describes the extended push button available on an OPTITEM. Each option item can optionally have one extended push button callback or one extended check box callback.
Members
cbSize
Size of this structure in bytes.
Flags
Bitmask that describes the extended push button. This field can be a bitwise OR of the following values.
Flag | Description |
EPF_PUSH_TYPE_DLGPROC | The extended push button has a DLGPROC function associated with it. The CPSUI uses the DlgProc and DlgTemplateID fields. |
EPF_INCLUDE_SETUP_TITLE | The CPSUI appends "Setup" to the string to which pTitle points. |
EPF_NO_DOT_DOT_DOT | The CPSUI does not append "…" to the string to which pTitle points. |
EPF_ICONID_AS_HICON | The CPSUI interprets IconID as a handle to an icon rather than as a resource ID. |
EPF_OVERLAY_WARNING_ICON | The CPSUI overlays its IDI_CPSUI_WARNING icon on the icon associated with this push button. |
EPF_OVERLAY_STOP_ICON | The CPSUI overlays its IDI_CPSUI_STOP icon on the icon associated with this push button. |
EPF_OVERLAY_NO_ICON | The CPSUI overlays its IDI_CPSUI_NO icon on the icon associated with this push button. |
EPF_USE_HDLGTEMPLATE | The CPSUI uses the hDlgTemplate field to obtain the dialog box template. |
pTitle
Pointer to a null-terminated string to be used as the extended push button title, or a resource ID.
DlgProc
Pointer to a caller-supplied DLGPROC function. The CPSUI calls the Win32 DialogBoxParam function with this function pointer, and passes a pointer to the CPSUICBPARAM structure — with the Reason field set to CPSUICB_REASON_EXTPUSH — to the WM_INITDIALOG message. If DlgProc is null, the CPSUI assumes that the extended push button is disabled. If DlgProc is not null, the CPSUI calls it only when the EPF_PUSH_TYPE_DLGPROC flag is set.
pfnCallBack
Pointer to a _CPSUICALLBACK callback. The CPSUI calls the function to which pfnCallBack points only when the EPF_PUSH_TYPE_DLGPROC flag is not set. The CPSUI passes a pointer to the CPSUICBPARAM structure as the parameter to this callback.
IconID
Identifies the icon to be associated with this push button. This field can be a standard IDI_CPSUI_Xxx icon ID, a caller's icon resource ID, or, if the EPF_ICONID_AS_HICON bit is set in Flags, a handle to a caller-defined icon. If IconID is zero, the selectable entry does not have an icon associated with it.
DlgTemplateID
Specifies the resource ID for the dialog box.
hDlgTemplate
Handle to the DLGTEMPLATE that the CPSUI uses to display the dialog box.
dwReserved[3]
Reserved; these fields must be set to zero.
Comments
The EXTPUSH structure describes the extended push button available on an OPTITEM.
The pTitle parameter is either a pointer to a null-terminated string or an integer value that specifies a resource identifier. If pTitle specifies a resource identifier, its high-order word must be zero and its low-order word must contain the identifier.
See Also