DLGPAGE structure (compstui.h)

The DLGPAGE structure is used for specifying a property sheet page to CPSUI's ComPropSheet function. The structure's address is included in a COMPROPSHEETUI structure, and all member values are supplied by the ComPropSheet caller.

Syntax

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

Members

cbSize

Caller-supplied size, in bytes, of the DLGPAGE structure.

Flags

Caller-supplied bit flags, as described in the following table.

Flag Definition
DPF_ICONID_AS_HICON If set, IconID contains an icon handle. If not set, IconID contains an icon resource identifier.
DPF_USE_HDLGTEMPLATE If set, hDlgTemplate contains a template handle. If not set, DlgTemplateID contains a template resource identifier.

Optional, caller-supplied DLGPROC-typed pointer to a dialog box procedure, used to process messages sent by the system when user events occur. If NULL, CPSUI supplies a dialog box procedure. For more information, see the Remarks section below.

DlgProc

Defines the DLGPROC member DlgProc.

pTabName

Caller-supplied pointer to a NULL-terminated string to be displayed on the page tab.

IconID

Caller-supplied, can be one of the following:

  • An icon resource identifier. This can be application-defined, or it can be one of the CPSUI-supplied, IDI_CPSUI-prefixed icon resource identifiers.

  • An icon handle. If a handle is specified, DPF_ICONID_AS_HICON must be set in the Flags member.

The specified icon is displayed on the page tab. If this value is zero, an icon is not displayed.

DUMMYUNIONNAME

Defines the DUMMYUNIONNAME union.

DUMMYUNIONNAME.DlgTemplateID

Caller-supplied resource identifier for a dialog box template. This can refer to an application-supplied DIALOG resource, or it can be one of the following CPSUI-supplied identifiers (defined in compstui.h):

Identifier Type of page
DP_STD_DOCPROPPAGE1 Nontreeview page, used for a print document's Layout page.
DP_STD_DOCPROPPAGE2 Nontreeview page, used for a print document's Paper/Quality page.
DP_STD_TREEVIEWPAGE Generic treeview page.

The CPSUI-supplied identifiers refer to templates that can display CPSUI option types. The page size for those templates is 252 by 216 dialog box units. For more information, see CPSUI-Supplied Pages and Templates.

This member is not used if DPF_USE_HDLGTEMPLATE is set in Flags.

DUMMYUNIONNAME.hDlgTemplate

Caller-supplied handle to a DLGTEMPLATE structure.

Used only if DPF_USE_HDLGTEMPLATE is set in Flags.

Remarks

CPSUI creates a property sheet page by allocating a PROPSHEETPAGE structure and passing it to CreatePropertySheetPage. If the caller has specified a DLGPROC-typed pointer to a dialog box procedure in DlgProc, that procedure is used for handling the page's window messages. If DlgProc is NULL, CPSUI's own dialog box procedures are used.

When the dialog box procedure pointed to by DlgProc is called with a message value of WM_INITDIALOG, it receives the PROPSHEETPAGE structure as input, and it also receives a PSPINFO structure.

If a caller-supplied dialog box procedure handles a message, it should return a nonzero value. If the function does not handle the message it should return zero, which causes CPSUI to handle the message.

Requirements

Requirement Value
Header compstui.h (include Compstui.h)