| Reference > Key Object > Key Object Properties > NextCtrl Property (Key) |
Sets/returns the shortcut key or keys for moving to the next control.
object.NextCtrl= string
Read/Write at run time and design time.
Zero-length string ("") is the default
A maximum of five keys can be set in the NextCtrl property. When setting multiple keys, use a comma (",") as a delimiter. There are keys that are used by Windows, such as [F10], and so on, which will not function as the user may expect if assigned to the control.
TDBDate.Key.NextCtrl = "{Enter}"
In this example, focus would be moved to the next control when [Enter] is pressed.
The NextCtrl and the NextField properties can be assigned with the same keys. In this case, the control determines whether moving to the next control or the next field, by referring to the current position of the caret. If the current position is placed within the last field, the focus will move to the next control. Otherwise, the caret moves to the next field.
By default, the TAB key also moves to the next control when the control's TabAction property is set to 0-Control Navigation.
When moving away from a field or selected fields that are half way entered by hitting the Tab/Shift+Tab or the keys assigned to the NextField / PrevField, NextCtrl / PrevCtrl properties, the incomplete values will be automatically rounded to the closes value. For example, with the cursor placed in the following position, "1998/1|_/31", by hitting the Tab/Shift+Tab key the month field will be rounded displaying "01". "1998/0|_/31" will also be rounded to "01". Note that when moving the focus away from the control will also cause the incomplete fields to be rounded accordingly.
Using the arrow combination keys and the mouse for navigation within the control will not cause automatic rounding. Also automatic rounding does not apply to fields that are empty.
When the user moves the cursor to the next/previous control by pressing the Tab / Shift + Tab keys or the keys assigned to the NextCtrl / PrevCtrl properties of the Key object, the KeyExit event is invoked. The KeyExit event is fired before the LostFocus event. This property was named KeyNext in the previous versions.