User Guide

516 ActionScript classes

tabChildren (MovieClip.tabChildren property)

public tabChildren : Boolean

Determines whether the children of a movie clip are included in the automatic tab ordering. If

the

tabChildren property is undefined or true, the children of a movie clip are included in

automatic tab ordering. If the value of

tabChildren is false, the children of a movie clip are

not included in automatic tab ordering. The default value is

undefined.

Availability: ActionScript 1.0; Flash Lite 2.0

Example

A list box UI widget built as a movie clip contains several items. The user can click each item

to select it, so each item is a button. However, only the list box itself should be a tab stop. The

items inside the list box should be excluded from tab ordering. To do this, the

tabChildren

property of the list box should be set to

false.

The

tabChildren property has no effect if the tabIndex property is used; the tabChildren

property affects only automatic tab ordering.

The following example disables tabbing for all children movie clips inside a parent movie clip

called

menu_mc:

menu_mc.onRelease = function(){};

menu_mc.menu1_mc.onRelease = function(){};

menu_mc.menu2_mc.onRelease = function(){};

menu_mc.menu3_mc.onRelease = function(){};

menu_mc.menu4_mc.onRelease = function(){};

menu_mc.tabChildren = false;

Change the last line of code to the following to include the children movie clip instances of

menu_mc in the automatic tab ordering:

menu_mc.tabChildren = true;