TabStop

TabStop

Specifies the tab stop positions for the control

KString property

Applies to: Grid , GridCell , KCMLEdit

TabStop

Include in the forms tab sequence

This is a style property that is only available in the forms designer. It is possible to modify this programmatically through the Style property in the Create event.

Applies to: Generic

TabStop

Specifies the tab stop positions for the control

String property

Applies to: List Box

TabStop

This property is used three ways:

• As a generic boolean property applicable to all controls setting the tab order of controls on the form
• Setting the position of the descriptive text associated with a value in a KCML edit dropdown list
• As an array of comma separated tab positions in a string setting the tab expansion column values for columns in a multicolumn listbox.

Boolean tab stop setting

This generic boolean property is used to include or exclude the control in the tabbing order of the form. This order is established at design time using the tab order feature of the forms designer. When the user presses the TAB key at runtime the focus will shift to the next control in the tab order. By setting this property to FALSE either at design time or at run time a control can be skipped in this sequence. However it is not possible to reorder the sequence at runtime in a program.

Note that a picture button that has the .TabStop property set FALSE will not take focus, even when clicked on, although the event will still be generated

Setting tab positions in a KCML edit dropdown

A KCML edit control with a drop down list has the ability of displaying some secondary descriptive text, called a tag, to the right of the entry text. This text is taken from list box which must have been populated with the .Add(desc$, key$) method associating a desc$ tag with each entry key$. If the entry is changed, either by keying in a new value of picking from the list, the descriptive text is updated.

By default columns are set in the two controls at 32 Dialog Box Unit intervals. This string property can is used to set the tab expansion positions in both the edit box and any accompanying drop down listbox to a different value. The column values are expressed in Dialog Box Units as a comma separated string though only the first value is used e.g.

 .editControl1.TabStop$ = "50"

Setting tab positions in a list box

This array property is used to set the tab expansion positions in a listbox. Provided the UseTabs property is TRUE any HEX(09) characters in the listbox text will be expanded to position the following text at that point. The column values are expressed in Dialog Box Units as a comma separated string e.g.

.listControl1.TabStop$ = "50, 100, 150, 200"

By default, if not changed at design time in the forms designer, the columns are set at 32 DBU intervals.

See also

Generic methods, properties and events. Grid methods, properties and events. GridCell methods, properties and events. KCMLEdit methods, properties and events. List Box methods, properties and events.