WM BUTTON1DOWN

This message occurs when the operator presses pointer button one.

Syntax

param1
    POINTS    ptspointerpos;  /* Pointer position. */

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

Parameters

ptspointerpos (POINTS) - Input

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

fsHitTestres (USHORT) - Input

Hit-test result. fsHitTestres provides the hit-test result. It contains the value returned from the hit test process, which determined 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 codes are 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 pointer-button information.

It is the responsibility of the application to ensure that the appropriate frame window is activated and that the focus is to the appropriate window, by using the WinSetFocus function. 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.

Mouse Event	Action
Click	Clicking in the text sets the cursor and anchor points to the nearest insertion point. If the MLE is in overtype mode, the anchor is extended one character further in the text, subject to the end-of-text and new-line boundary conditions, defined under WM_CHAR (in Multiline Entry Fields).
Shift-Click	Clicking while the shift key is held down sets the cursor point to the nearest insertion point, while leaving the anchor point alone.
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 activates the window using WinSetActiveWindow, and then sets 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 this is over a part of the window that does not have a frame control, it issues a WinSetActiveWindow function. If the click is over the size border, this window begins tracking by sending a WM_TRACKFRAME message to itself. If the click is not over the size border, this message is passed on.

in Multiline Entry Fields

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

Related Messages

WM_BUTTON1DOWN (in Frame Controls)
WM_BUTTON1DOWN (in Multiline Entry Fields)