Fired when the user releases a navigation key after holding it down long enough to repeat the keystroke.

Version Introduced: 3.0.3

Parameters

ParameterDescription
RepeatCountThe 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.

See Also

PosChangingPosChanged

  • No labels