User Guide

TextField.tabIndex 923
TextField.tabIndex
Availability
Flash Player 6.
Usage
my_txt.tabIndex:Number
Parameters
None.
Returns
Nothing.
Description
Property; lets you customize the tab ordering of objects in a SWF file. You can set the tabIndex
property on a button, movie clip, or text field instance; it is
undefined by default.
If any currently displayed object in the SWF file contains a
tabIndex property, automatic tab
ordering is disabled, and the tab ordering is calculated from the
tabIndex properties of objects in
the SWF file. The custom tab ordering only includes objects that have
tabIndex properties.
The
tabIndex property must be a positive integer. The objects are ordered according to their
tabIndex properties, in ascending order. An object with a tabIndex value of 1 precedes an object
with a
tabIndex value of 2. If two objects have the same tabIndex value, the one that precedes
the other in the tab ordering is
undefined.
The custom tab ordering defined by the
tabIndex property is flat. This means that no attention
is paid to the hierarchical relationships of objects in the SWF file. All objects in the SWF file with
tabIndex properties are placed in the tab order, and the tab order is determined by the order of
the
tabIndex values. If two objects have the same tabIndex value, the one that goes first is
undefined. You shouldn’t use the same tabIndex value for multiple objects.
Example
The following ActionScript dynamically creates four text fields and assigns them to a custom tab
order. Add the following ActionScript to your FLA or AS file:
this.createTextField("one_txt", this.getNextHighestDepth(), 10, 10, 100, 22);
one_txt.border = true;
one_txt.type = "input";
this.createTextField("two_txt", this.getNextHighestDepth(), 10, 40, 100, 22);
two_txt.border = true;
two_txt.type = "input";
this.createTextField("three_txt", this.getNextHighestDepth(), 10, 70, 100,
22);
three_txt.border = true;
three_txt.type = "input";
this.createTextField("four_txt", this.getNextHighestDepth(), 10, 100, 100,
22);
four_txt.border = true;
four_txt.type = "input";