Applies To: | Grid |
Description
If enabled, this event is reported when the user moves the mouse pointer whilst over a cell in a Grid.
There is no default action for this event.
The event message reported as the result of ⎕DQ, or supplied as the right argument to your callback function, is an 9 element vector as follows :
[1] | Object | ref or character vector |
[2] | Event | 'CellOver' or 160 |
[3] | Y | y-position of mouse (number) |
[4] | X | x-position of mouse (number) |
[5] | Button | button pressed (number) 1 = left button 2 = right button 4 = middle button |
[6] | Shift State | sum of shift key codes (number) 1 = Shift key is down 2 = Ctrl key is down 4 = Alt key is down |
[7] | Cell row | integer |
[8] | Cell column | integer |
[9] | Title index | integer |
The y and x position of the mouse are reported relative to the top-left corner of the Grid.
The cell row and column are ⎕IO dependent
If the user moves the mouse pointer over a row title, the value reported for the column is ¯1, and the value reported for Title index is the index of that row title in RowTitles, or, if RowTitles is not defined, the row number. Column titles are handled in a similar fashion.