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