MouseMove

Description

Occurs when the user moves the mouse pointer in a DataWindow control.

PowerBuilder event information Event ID: pbm_dwnmousemove

MouseMove is not a standard PowerBuilder DataWindow event. To write a script for this event, you must first define a user event for the event ID pbm_dwnmousemove.

Argument

Description

xpos

Integer by value. The distance of the pointer from the left side of the DataWindow’s workspace. The distance is given in pixels.

ypos

Integer by value. The distance of the pointer from the top of the DataWindow’s workspace. The distance is given in pixels.

row

Long by value. The number of the row under the pointer.

If the pointer is not over a row, the value of the row argument is 0. For example, row is 0 when the user double-clicks outside the data area, in text or spaces between rows, or in the header, summary, or footer area.

dwo

DWObject by value. A reference to the control within the DataWindow that is under the pointer.

Web ActiveX event information Event name: MouseMove

Argument

Description

Button

Number. A value that is the sum of the values of the buttons the user is pressing. Values are:

  • 1 Left button

  • 2 Right button

  • 4 Middle button

Shift

Number. A value that is the sum of the values of the modifier keys the user is pressing. Values are:

  • 1 Shift key

  • 2 Control key

  • 4 Alt key

XPos

Number. The distance of the pointer from the left side of the DataWindow’s workspace. The distance is given in pixels.

YPos

Number. The distance of the pointer from the top of the DataWindow’s workspace. The distance is given in pixels.

Returns

There are no special outcomes for this event. The only code is:

Usage

The dwo, Name, or DWObject argument provides easy access to the control the user clicks. You do not need to know the coordinates of elements within the DataWindow to program control-specific responses to the user’s clicks. For example, you can prevent editing of a column and use the Clicked event to set data or properties for the column and row the user clicks.

PowerBuilder programming note The xpos and ypos arguments provide the same values the functions PointerX and PointerY return when you call them for the DataWindow control.

See also