DIGCPAGEINFO structure

The DIGCPAGEINFO structure defines a page in a property sheet.

Syntax

typedef struct {
  DWORD     dwSize;
  LPWSTR    lpwszPageTitle;
  DLGPROC   fpPageProc;
  BOOL      fProcFlag;
  DLGPROC   fpPrePostProc;
  BOOL      fIconFlag;
  LPWSTR    lpwszPageIcon;
  LPWSTR    lpwszTemplate;
  LPARAM    lParam;
  HINSTANCE hInstance;
} DIGCPAGEINFO, *LPDIGCPAGEINFO;

Members

  • dwSize
    Specifies the size of the structure in bytes. This member must be initialized before the structure is used.

  • lpwszPageTitle
    Points to the title of the property sheet dialog box. This title overrides the title specified in the dialog box template. This member can specify either the identifier of a string resource or the address of a string that specifies the title.

  • fpPageProc
    Points to the dialog box procedure for the page. The dialog box procedure must not call the EndDialog function.

  • fProcFlag
    If this member is TRUE, the fpPrePostProc member is called when it is created and when it is about to be destroyed. If this flag is FALSE, the fpPrePostProc member is ignored.

  • fpPrePostProc
    Points to an application-defined callback function that is called when the page is created and when it is about to be destroyed. For more information about the callback function, see the description of the PropSheetPageProc function as defined in the DirectInput portion of the DirectX SDK.

  • fIconFlag
    Specifies a Boolean value that indicates the name of the icon resource to load. If this value is TRUE, lpwszPageIcon is used as the name of the icon resource to load and use as the small icon on the tab of the page.

  • lpwszPageIcon
    Points to the icon resource to use as the small icon in the tab for the page. If fIconFlag is FALSE, this parameter is ignored. This member is ignored for Windows CE.

  • lpwszTemplate
    Points to the dialog box template used to create the page. This member can specify either the resource identifier of the template or the address of a string that specifies the name of the template.

  • lParam
    Application-defined data.

  • hInstance
    Handle to the instance from which to load the dialog box template, icon, or title string resource.

Requirements

Header

Dicpl.h (include Dicpl.h)

 

 

Send comments about this topic to Microsoft