Share via

DIALOG_HOOK_PROC (Windows Embedded CE 6.0)

  • Article

1/6/2010

This is the optional dialog hook callback function for the PhCommon Dialog control. This callback allows a caller to override the standard dialog behavior in a PhDialog screen. The caller of the dialog gets first look at every message going through the dialog procedure of the window. Returning TRUE means that the standard dialog procedure will not be called, and of course, implies that the callback has handled the message. For more information, please see PHDialogScreen.

Syntax

typedef BOOL (CALLBACK* DIALOG_HOOK_PROC)(
    HWND hDialogWnd,
    UINT Message,
    WPARAM wParam, 
    LPARAM lParam,
    void*  pUserData
);

Parameters

  • hDialogWnd
    [in] A handle to the dialog window.
  • Message
    [in] The message being passed.
  • wParam
    [in] The messages wParam information.
  • lParam
    [in] The messages lParam information.
  • pUserData
    [in] User data associated with the message.

Return Value

The following table shows possible return values.

Value Description

TRUE

Message was handled by the callback function.

FALSE

Message was not handled.

Remarks

Note

This documentation applies to functionality implemented in sample code for PhCommon. For more information, see PhCommon Reference.

This is an optional callback function that you implement in your code for the PhCommon Dialog control.

Requirements

Header controldefinitions.h
Library PhCommon.dll
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

PhCommon Controls APIs
PhCommon Reference
PH_DIALOG_SCREEN_PARAMETERS