IDLitWindow::OnMouseMotion

IDL Reference Guide: iTools Object Classes

IDLitWindow::OnMouseMotion

The IDLitWindow::OnMouseMotion procedure method handles notification (from the native window device) that a mouse motion event has occurred, and passes along that notification to all observers in the list of window event observers (as specified by calls to the IDLitWindow::AddWindowEventObserver method). You can also simulate a mouse motion event by calling this method directly.

Note
Window event observers that handle mouse motion events must implement the OnMouseMotion method, as described in Implementing the OnMouseMotion Interface. In addition, window event observers must implement the OnKeyboard, OnMouseDown, and OnMouseUp methods. See IDLitWindow::AddWindowEventObserver for details.

Syntax

Obj->[IDLitWindow::]OnMouseMotion, X, Y, Modifiers

Arguments

X

A long integer representing the x-location (in device coordinates) of the mouse event.

Y

A long integer representing the y-location (in device coordinates) of the mouse event.

Modifiers

A long integer containing a bitwise mask indicating which modifier keys are active at the time the mouse button is pressed. If a bit is zero, the key is up; if the bit is set, the key is pressed. The following table describes the bits in this bitmask:

Table 7-18: Bits of the Modifier Key Mask

Table 7-18: Bits of the Modifier Key Mask
Bit	Value	Modifier Key
0	1	Shift
1	2	Control
2	4	Caps Lock
3	8	Alt

Keywords

None

Implementing the OnMouseMotion Interface

When defining a window event observer that handles mouse motion events, you must implement an OnMouseMotion procedure method with the following signature:

PRO OnMouseMotion, Window, X, Y, Modifiers

where the Window argument is an object reference to the IDLitWindow object in which the event was generated, and all of the other arguments are described above.

In addition, you must implement OnKeyboard, OnMouseDown, and OnMouseUp procedure methods, as discussed in IDLitWindow::AddWindowEventObserver.

Version History


6.0	Introduced