InkPicture.MouseDown event

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


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


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.


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.


Minimum supported client

Windows XP Tablet PC Edition [desktop apps only]

Minimum supported server

None supported


Msinkaut.h (also requires Msinkaut_i.c)



See also