PROPSHEETHEADER

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure defines the frame and pages of a property sheet.

Syntax

typedef struct _PROPSHEETHEADER { 
  DWORD dwSize; 
  DWORD dwFlags; 
  HWND hwndParent; 
  HINSTANCE hInstance; 
  union {
    HICON hIcon; 
    LPCWSTR pszIcon; 
  };
  LPCWSTR pszCaption; 
  UINT nPages; 
  union {
    UINT nStartPage; 
    LPCWSTR pStartPage; 
  };
  union {
    LPCPROPSHEETPAGE ppsp; 
    HPROPSHEETPAGE FAR* phpage; 
  };
  PFNPROPSHEETCALLBACK pfnCallback;
} PROPSHEETHEADER, FAR* LPPROPSHEETHEADER;
typedef const PROPSHEETHEADER FAR* LPCPROPSHEETHEADER;

Members

• dwSize
  Specifies the size, in bytes, of this structure.

• dwFlags
  Specifies a bitmask of flags that indicate which options to use when creating the property sheet page. It can be a combination of the following values.

  Value	Description
  PSH_DEFAULT	Uses the default meaning for all structure members.
  PSH_HASHELP	Displays the property sheet Help button. The Help button is enabled only when the PSP_HASHELP flag is set in the PROPSHEETPAGE structure for the active page. If any of the initial property sheet pages set the PSP_HASHELP flag, the Help button is automatically displayed regardless of the PSH_HASHELP flag. However, PSH_HASHELP is useful when none of the initial pages set PSP_HASHELP, but pages added later might.
  PSH_HEADER	Indicates that a header bitmap will be used. If this value does not include PSH_USEHBMHEADER, the header bitmap is obtained from pszbmHeader. If this value includes PSH_USEHBMHEADER, the header bitmap is obtained from hbmHeader. This flag is ignored if PSH_WIZARD97 is not included.
  PSH_MAXIMIZE	Causes the dialog manager to make the property sheet a full-screen window. This style is not compatible with PSH_WIZARD.
  PSH_MODELESS	Causes the PropertySheet function to create the property sheet as a modeless dialog instead of as a modal dialog. When this flag is set, PropertySheet returns immediately after the dialog is created, and the return value from PropertySheet is the window handle to the property sheet dialog.
  PSH_NOAPPLYNOW	Removes the Apply Now button.
  PSH_PIVOT	Applies to Windows Mobile 6.5.3 Replaces dialog box tabs with a horizontal scroll.
  PSH_PROPSHEETPAGE	Uses ppsp and ignores phpage when creating the pages for the property sheet.
  PSH_PROPTITLE	Displays the string "Properties for", followed by the string specified by pszCaption, in the title bar of the property sheet.
  PSH_RTLREADING	Reverses the direction in which pszCaption is displayed. Normal windows display all text, including pszCaption, left-to-right (LTR). For languages such as Hebrew or Arabic that read right-to-left (RTL), a window can be mirrored and all text will be displayed RTL. If PSH_RTLREADING is set, pszCaption will instead read RTL in a normal parent window and LTR in a mirrored parent window.
  PSH_STRETCHWATERMARK	Stretches the bitmap to fit the background of the property sheet instead of tiling the watermark and/or header bitmap. This flag is ignored if PSH_WIZARD97 and PSH_WATERMARK or PSH_HEADER are not included.
  PSH_USECALLBACK	Calls the function specified by pfnCallback when initializing the property sheet defined by this structure.
  PSH_USEHBMHEADER	Obtains the header bitmap from hbmHeader instead of pszbmHeader. This flag is ignored if PSH_WIZARD97 and PSH_HEADER are not included.
  PSH_USEHBMWATERMARK	Obtains the watermark bitmap from hbmWatermark instead of pszbmWatermark. This flag is ignored if PSH_WIZARD97 and PSH_WATERMARK are not included.
  PSH_USEHICON	Not supported.
  PSH_USEHPLWATERMARK	Obtains the HPALETTE for drawing the watermark bitmap and/or header bitmap from hplWatermark instead of using the default palette. This flag is ignored if PSH_WIZARD97 and PSH_WATERMARK or PSH_HEADER are not included.
  PSH_USEICONID	Not supported.
  PSH_USEPAGELANG	The language for the property sheet will be taken from the first page's resource.
  PSH_USEPSTARTPAGE	Uses pStartPage and ignores nStartPage when displaying the initial page of the property sheet.
  PSH_WATERMARK	Specifies that a watermark bitmap will be used. If this value does not include PSH_USEHBMWATERMARK, the watermark bitmap is obtained from pszbmWatermark. If this value includes PSH_USEHBMWATERMARK, the header bitmap is obtained from hbmWatermark. This flag is ignored if PSH_WIZARD97 is not included.
  PSH_WIZARD	Creates a wizard property sheet.
  PSH_WIZARD97	Creates a wizard property sheet that allows a header and/or watermark bitmap to be displayed in the background. This and all Wizard 97-associated flags are not currently implemented.
  PSH_WIZARDCONTEXTHELP	Adds a system menu to the wizard property sheet. This flag is ignored if PSH_WIZARD or PSH_WIZARD97 is not included.
  PSH_WIZARDHASFINISH	Always displays the Finish button on the wizard. This flag is ignored if PSH_WIZARD or PSH_WIZARD97 is not included.

• hwndParent
  Handle to the property sheet's owner window.

• hInstance
  Handle to the instance from which to load the icon or title string resource. If pszIcon or pszCaption identifies a resource to load, this member must be specified.

• hIcon
  Ignored. Must be NULL.

• pszIcon
  Ignored. Must be NULL.

• pszCaption
  Pointer to the null-terminated string that contains the title of the property sheet dialog box. This member can specify either the identifier of a string resource or the address of a string that specifies the title. If dwFlags includes PSH_PROPTITLE, the string "Properties for" is inserted at the beginning of the title.

• nPages
  Number of elements in the phpage array.

• nStartPage
  Zero-based index of the initial page that appears when the property sheet dialog box is created.

• pStartPage
  Pointer to the name of the initial page that appears when the property sheet dialog box is created. This member can specify either the identifier of a string resource or the address of a string that specifies the name.

• ppsp
  Pointer to an array of PROPSHEETPAGE structures that define the pages in the property sheet. If dwFlags does not include PSH_PROPSHEETPAGE, this member is ignored.

• phpage
  Pointer to an array of handles to the property sheet pages. Each handle must have been created by a previous call to the CreatePropertySheetPage function. If dwFlags includes PSH_PROPSHEETPAGE, this member is ignored.

• pfnCallback
  Pointer to an application-defined callback function that is called when the property sheet is initialized. For more information about the callback function, see the description of the PropSheetProc function. If dwFlags does not include PSH_USECALLBACK, this member is ignored.

• hbmWatermark
  Handle to the watermark bitmap. If dwFlags does not include PSH_USEHBMWATERMARK, this member is ignored.

• pszbmWatermark
  Pointer to a bitmap resource to use as the watermark. This member can specify either the identifier of the bitmap resource or the address of the string that specifies the name of the bitmap resource. If dwFlags includes PSH_USEHBMWATERMARK, this member is ignored.

• hplWatermark
  HPALETTE used for drawing the watermark bitmap and/or header bitmap. If dwFlags does not include PSH_USEHPLWATERMARK, this member is ignored.

• hbmHeader
  Handle to the header bitmap. If dwFlags does not include PSH_USEHBMHEADER, this member is ignored.

• pszbmHeader
  Pointer to a bitmap resource to use as the header. This member can specify either the identifier of the bitmap resource or the address of the string that specifies the name of the bitmap resource. If dwFlags includes PSH_USEHBMHEADER, this member is ignored.

Requirements

Header	prsht.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CreatePropertySheetPage
PropertySheet
PropSheetProc
PROPSHEETPAGE