PropSheetProc

A PropSheetProc function is an application-defined callback function that the system calls when the property sheet is being created and initialized.

int CALLBACK PropSheetProc(

HWND hwndDlg, // handle to the property sheet dialog box
UINT uMsg, // message identifier
LPARAM lParam // message parameter
);  

Parameters

hwndDlg

Handle to the property sheet dialog box.

uMsg

Identifies the message being received. This parameter is one of the following values:

Value Meaning
PSCB_INITIALIZED Indicates that the property sheet is being initialized. The lParam value is zero for this message.
PSCB_PRECREATE Indicates that the property sheet is about to be created. The hwndDlg parameter is NULL and the lParam parameter is a pointer to a dialog template in memory. This template is in the form of a DLGTEMPLATE structure followed by one or more DLGITEMTEMPLATE structures.

lParam

Specifies additional information about the message. The meaning of this value depends on the uMsg parameter.

Return Values

The function returns zero.

Remarks

To enable a PropSheetProc callback function, use the PROPSHEETHEADER structure when you call the PropertySheet function to create the property sheet. Use the pfnCallback member to specify a pointer to the callback function, and set the PSP_USECALLBACK flag in the dwFlags member.

PropSheetProc is a placeholder for the application-defined function name. The PFNPROPSHEETCALLBACK type is a pointer to a PropSheetProc callback function.

See Also

DLGTEMPLATE, DLGITEMTEMPLATE, PropertySheet, PROPSHEETHEADER