WM HELP

This message occurs when a control has a significant event to notify to its owner or when a key stroke has been translated by an accelerator table into a WM_HELP.

in Button Controls) - Syntax

Button control sets uscmd to the button identity.

in Menu Controls) - Syntax

The menu control window procedure sets uscmd to the menu-item identity.

Syntax

param1
     USHORT  uscmd       /*  Command value. */

param2
     USHORT  ussource    /*  Source type. */
     USHORT  uspointer   /*  Pointer-device indicator. */

Parameters

uscmd (USHORT)

Command value.

It is the responsibility of the application to be able to relate uscmd to an application function.

ussource (USHORT)

Source type.

Identifies the type of control:

CMDSRC_PUSHBUTTON

Posted by a push-button control. uscmd is the window identity of the push button.

CMDSRC_MENU

Posted by a menu control. uscmd is the identity of the menu item.

CMDSRC_ACCELERATOR

Posted as the result of an accelerator. uscmd is the accelerator command value.

CMDSRC_OTHER

Other source. uscmd gives further control-specific information defined for each control type.

uspointer (USHORT)

Pointer-device indicator.

TRUE

If the message is posted as a result of a pointer-device operation

FALSE

If the message is posted as a result of a keyboard operation.

Returns

ulReserved (ULONG)

Reserved value, should be 0.

Remarks

This message is identical to a WM_COMMAND message, but implies that the application should respond to this message by displaying help information.

This message is posted to the queue of the owner of the control.

In Buttons Controls

The button control generates this message and posts it to the queue of its owner, if it has the style of BS_HELP and a push button is pressed, or when it receives a BM_CLICK message.

in Menu Controls

The menu control window procedure generates this message and posts it to the queue of its owner when an item is selected that has the style of MIS_HELP, but only if WM_MENUSELECT (in Menu Controls) returns a rc of TRUE.

Default Processing

The default window procedure sends this message to the parent window, if it exists and is not the desktop. Otherwise, it sets ulReserved to 0.