Compartilhar via


PropSheetProc (Windows CE 5.0)

Send Feedback

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

intCALLBACKPropSheetProc(HWNDhwndDlg, UINTuMsg, LPARAMlParam );

Parameters

  • hwndDlg
    [in] Handle to the property sheet dialog box.
  • uMsg
    [in] Specifies the message being received. It is one of the following values.
    Value Description
    PSCB_GETTITLE Requests the title to be used by the property sheet. The lParam parameter is the address of the buffer that receives the title text. The maximum length of this message is 256 characters.

    The return value is zero if this message is specified.

    PSCB_GETVERSION Requests the property sheet version to be used. The hwndDlg parameter is NULL, and the lParam value is 0.

    The return value indicates the desired version for the control.

    PSCB_INITIALIZED Indicates that the property sheet is being initialized. The lParam parameter is the address of the PROPSHEETHEADER for the property sheet.

    The return value is zero if this message is specified.

    PSCB_PRECREATE Indicates that the property sheet is about to be created. The hwndDlg parameter is NULL, and the lParam parameter is the address of a dialog template in memory. This template is in the form of a DLGTEMPLATE structure followed by one or more DLGITEMTEMPLATE structures.

    The return value is zero if this message is specified.

  • lParam
    [in] Additional information about the message. The meaning of this value depends on the uMsg parameter.

Return Values

The return values are dependent on the message specified by uMsg. If uMsg is PSCB_GETVERSION, the return value indicates the desired version for the control. For all other values of uMsg, the return value is 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 an address of 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 the address of a PropSheetProc callback function.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Prsht.h.

See Also

PropertySheet | DLGITEMTEMPLATE | DLGTEMPLATE | PROPSHEETHEADER

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.