ComponentOne True DBInput Pro 8.0
NextField Property (Key)

Syntax

object.NextField= string

Read/Write at run time and design time.

Values

Zero-length string ("") is the default

Remarks

Sets/returns the shortcut key or keys for moving to the next field. A maximum of five keys can be set in the NextField 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.NextField = "{Enter}"

In this example, focus would be moved to the next field when [Enter] is pressed.

The NextField and the NextCtrl properties can be assigned with the same keys. In this case, the control determines whether to move to the next field or the next control, 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 field when the control's TabAction property is set to 1-Field Navigation.

When set the control for free format entry, all text will be treated as one field. Therefore, the key assigned to this property will not take any effect.

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.

 

 


Copyright (c) GrapeCity, inc. All rights reserved.

Product Support Forum  |  Documentation Feedback