OnUnknownAreaClick - cCJGrid
Called when the user clicks in an unknown area of the grid
Type: Event
Parameters
| Parameter | Type | Description |
|---|---|---|
| iX | Integer | X coordinate of the mouse pointer. |
| iY | Integer | Y coordinate of the mouse pointer. |
Syntax
Procedure OnUnknownAreaClick Integer iX Integer iY
Description
OnUnknownAreaClick is called when the user (left) clicks on an unknown area of the grid. Most often, this will be the area below the last row. This is used to append an empty row to the end of the grid. This only occurs if you are allowed to append rows (pbAllowAppendRow is true) and auto-append is enabled (pbAutoAppend is true).
If row append is supported, most users will expect that clicking on a row below the last row will append a row and this event is designed to do this.
It is possible that this will result in false-alarm row appends, which might occur if you click in another empty area, such as the right area beyond the last column. There is no way for the control to distinguish between these two areas. If this behavior is not desired, you may cancel it by overriding this event as follows:
Procedure OnUnknownAreaClick
End_Procedure