| Applies To: | Grid |
Description
If enabled, this event is reported when the user releases a mouse button down whilst over a cell in a Grid. This event is a companion to the CellDown event and could be used to hide a pop-up which was displayed in response to the CellDown. The CellUp event performs no default action and may not be disabled.
The event message reported as the result of ⎕DQ, or supplied as the right argument to your callback function, is a 9 element vector as follows :
| [1] | Object | ref or character vector |
| [2] | Event | 'CellUp' or 162 |
| [3] | Y | y-position of mouse (number) |
| [4] | X | x-position of mouse (number) |
| [5] | Button | button released (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 clicks 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.
An application can position the user on a particular cell in a Grid by calling CellDown event as a method, but it is recommended that a CellMove event is used instead.