Edit

InkPicture.MouseDown event

  • Article

Occurs when the mouse pointer is over the InkPicture control and a mouse button is pressed.

Syntax

void MouseDown(
  [in]      InkMouseButton           Button,
  [in]      InkShiftKeyModifierFlags Shift,
  [in]      long                     pX,
  [in]      long                     pY,
  [in, out] VARIANT_BOOL             *Cancel
);

Parameters

Button [in]

The button that was pressed.

Shift [in]

The state of the SHIFT key.

pX [in]

The x-coordinate, in pixels, of the IInkCursor object.

pY [in]

The y-coordinate, in pixels, of the IInkCursor object.

Cancel [in, out]

VARIANT_TRUE to cancel this event for the parent control; otherwise, VARIANT_FALSE.

Return value

This event does not return a value.

Remarks

Note

The parameters pX and pY are in pixels, and not the HIMETRIC units that are associated with the ink space coordinate system. This is because this event replaces the related mouse event of an application that is not pen-aware, and that type of application refers only to pixels.

Caution

Some controls rely on a specific relationship between MouseDown, MouseMove, and MouseUp events. Canceling some of these events may have unanticipated results.

This event method is defined in the _IInkPictureEvents interface. The _IInkPictureEvents interface implements the IDispatch interface with an identifier of DISPID_IPEMouseDown.

Requirements

Requirement Value
Minimum supported client
 Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server
 None supported
Header
Msinkaut.h (also requires Msinkaut_i.c)
Library
InkObj.dll

See also

InkPicture