Fired when the user releases a navigation key after holding it down long enough to repeat the keystroke.
Version Introduced: 3.0.3
Parameters
Parameter | Description |
---|---|
RepeatCount | The number of times the key stroke repeated |
Remarks
The OnKeyNavigationDone event fires when the user holds down a navigation key (up, down, page-up, etc.) long enough to cause the key stroke to repeat and then releases it. This event is especially useful if you typically do a lot of processing during the OnPosChanged event but don't want that logic to execute while the key is being held down. Note that this event will _not_ fire if the key stroke did not repeat, i.e., the key was pressed and immediately released. Thus, to best utilize this feature, your logic should check the RepeatCount parameter during the OnPosChanged event and only execute it's logic if RepeatCount = 1. Then, capture this event and execute that same logic. It should look something like this:
OLE_EDITTABLE.OnPosChanged: CurrentCell = Param1 PreviousCell = Param2 Cause = Param3 RepeatCount = Param4 // check the repeat count, and only execute the logic if we are not repeating If RepeatCount EQ 1 then GoSub Do_Logic end return OLE_EDITTABLE.OnKeyNavigationDone: GoSub Do_Logic return
The RepeatCount parameter is provided for convienience, but note that it will never be less than two, since this event _only_ fires when the navigation key stroke has repeated.