Method XbpActiveXControl():mouseMove()

Default event handler for ActiveX control event "MouseMove" (DISPID_MOUSEMOVE).

:mouseMove( <nButton>, <nShift>, ;
            <nXPos>,   <nYPos> ) --> self

A numeric value indicating whether a mouse button was held at the time the mouse was moved. A value 1 denotes the left, 2 the right and 3 the middle mouse button.

A numeric value indicating the state of the SHIFT, ALT and CTRL keys at the time the mouse was moved. A value of 1 indicates the SHIFT key was down, a value of 2 the CTRL was pressed and a value of 4 indicates the ALT key was depressed. The value in parameter <nShift> can be any combination of these values. 0 indicates neither key was down when the mouse was moved.

<nXPos>

<nXPos> is a numeric value indicating the horizontal position of the mouse pointer when the mouse was moved.

<nYPos>

<nYPos> is a numeric value indicating the vertical position of the mouse pointer when the mouse was moved.

This method returns the object executing the method (self).

The method :mouseMove() is called automatically upon reception of a "MouseMove" (DISPID_MOUSMOVE) COM event. The :mouseMove() event handler generates an xbeM_Motion event. The event is posted to the current thread's message queue using the function PostAppEvent().

Applications can process mouse events via the standard event protocol defined for Xbase Parts. In order to react to mouse event generated by an ActiveX control, a code block can be assigned to the callback slot :motion, Alternatively, an overloaded method :motion()can be implemented in a derived class.

Not all ActiveX controls generate mouse events. If a control does not generate "MouseMove" (DISPID_MOUSEMOVE) events, the method :mouseMove() will not be called.

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.

Method XbpActiveXControl():mouseMove() Foundation