WM BUTTON1UP

This message occurs when the operator releases button 1 of the pointing device.

Syntax

param1
    POINTS ptspointerpos; /* Pointer position. */

param2
    USHORT fsHitTestres; /* Hit-test result. */
    USHORT fsflags;       /* Keyboard control codes. */

Parameters

ptspointerpos (POINTS) - input

Pointer position in window coordinates relative to the bottom-left corner of the window.

fsHitTestres (USHORT) - input

Hit-test result. Provides the hit-test result, which determines the window to be associated with this message. For details of the possible values, see WM_HITTEST.

fsflags (USHORT) - input

Keyboard control codes. In addition to the control codes described with the WM_CHAR message, the following keyboard control code is valid:

KC_NONE: Indicates that no key is pressed.

Returns

rc (BOOL) - returns

Processed indicator.

TRUE: Message processed

FALSE: Message ignored

Remarks

This message is posted to the application queue associated with the window that is to receive the pointing device button information. The keyboard control codes specified by flags reflects the keyboard state at the time the mouse message was initiated. This may or may not reflect the current keyboard state.

in Frame Controls

This message is posted to the application queue associated with the window that is to receive the pointer button information.

in Multiline Entry Fields

This message delimits mouse button click events. Between a button-down and a button-up event the mouse is considered to be dragging. A mouse click is considered to happen on button-down, and dragging is terminated by a button-up.

Margin Mouse Event

All mouse events in a margin cause the MLE to send a MLN_MARGIN notification to the owner window of the MLE. This message has, as its parameters, the original mouse message. The owner can process the notification or not. If the owner does not process the message, the event is treated as if it occurred on the closest point in the text.

Default Processing

The default window procedure sends the message to the owner window if it exists, otherwise it takes no action on this message other than to set rc to FALSE.

in Frame Controls

The frame control window procedure responds to this message by issuing the WinSetActiveWindow function and sets rc to TRUE. If the window is not minimized, this message is not processed. If the frame is minimized, this message causes the system menu to pop up.

in Multiline Entry Fields

The default window procedure takes no action on this message, other than to set rc to FALSE.

Related Messages

• WM_BUTTON1UP (in Frame Controls)
• WM_BUTTON1UP (in Multiline Entry Fields)