Occurs when the user clicks anywhere in a DataWindow control.
Event ID
Event ID Objects
pbm_dwnlbuttonclk DataWindow
Arguments
Argument Description
xpos Integer by value (the distance of the pointer from the left side of the DataWindow's workspace)
ypos Integer by value (the distance of the pointer from the top of the DataWindow's workspace)
row Long by value (the number of the row the user clicked) If the user doesn't click on a row, the value of the row argument is 0. For example, row is 0 when the user 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 object within the DataWindow under the pointer when the user clicked)
Return value
Long. Return code choices (specify in a RETURN statement):
0 Continue processing
1 Prevent the focus from changing
Usage
The DataWindow Clicked event occurs when the mouse button is pressed down.
The xpos and ypos arguments provide the same values the functions PointerX and PointerY return when you call them for the DataWindow control.
The dwo argument provides easy access to the object the user clicks. You don't need to know the coordinates of elements within the DataWindow to program object-specific responses to the user's clicks.
For example, you can prevent editing of a column and use the Clicked script to set data or properties for the column and row the user clicks.
For graphs, the ObjectAtPointer function provides similar information about objects within the graph object.
A click can also trigger RowFocusChanged and ItemFocusChanged events.
A double-click triggers a Clicked event, then a DoubleClicked event.