IContainer  - AS3 Flex

指定此 sprite 的按钮模式。如果为 true，此 sprite 的行为方式就像按钮，这表示它可在指针经过 sprite 时触发显示手形光标，并可在 sprite 具有焦点时按下 Enter 键或空格键来接收 click 事件。通过将 useHandCursor 属性设置为 false 可以禁止显示手形光标，在此情况下将显示指针。

虽然使用 SimpleButton 类创建按钮是一种比较好的方法，但是可以使用 buttonMode 属性为 Sprite 提供某种类似按钮的功能。要在 Tab 键顺序中包括 Sprite，请将 tabEnabled 属性（继承自 InteractiveObject 类，默认情况下为 false）设置为 true。此外，考虑是否希望 sprite 的子级支持用户输入。大多数按钮不启用其子对象的用户输入交互性，因为这样会混淆事件流。要对所有子对象禁用用户输入交互性，则必须将 mouseChildren 属性（继承自 DisplayObjectContainer 类）设置为 false。

如果将 buttonMode 属性与 MovieClip 类（该类是 Sprite 类的子类）一起使用，则按钮可能会具有一些增加的功能。如果包括具有 _up、_over 和 _down 标签的帧，则 Flash Player 将提供自动状态更改功能（类似于 ActionScript 的以前版本中为用作按钮的影片剪辑提供的功能）。没有时间轴的 Sprite 不可以使用这些自动状态更改，因此没有要加标签的帧。

容器使用内部内容窗格控制滚动。容器创建内容窗格时，creatingContentPane 为 true，以便忽略或阻止某些事件。

指定为容器的默认按钮的 Button 控件。当容器中的控件具有焦点时，按 Enter 键与单击此 Button 控件的效果相同。

指定此对象是否接收 doubleClick 事件。默认值为 false，这意味着在默认情况下，InteractiveObject 实例不接收 doubleClick 事件。如果将 doubleClickEnabled 属性设置为 true，实例在其范围内接收 doubleClick 事件。InteractiveObject 实例的 mouseEnabled 属性也必须设置为 true，以便对象能够接收 doubleClick 事件。

设置此属性不会调度任何事件。必须使用 addEventListener() 方法为 doubleClick 事件添加事件侦听器。

指定拖动 sprite 时经过的显示对象，或放置 sprite 的显示对象。

获取控制此组件及其同级组件的焦点的 FocusManager。每个弹出框都有自己的焦点循环，因此也有自己的 FocusManager 实例。为确保使用的实例正确，请使用此方法。

指定此对象是否显示焦点矩形。它可以采用三个值中的一个：true、false 或 null。true 和 false 值按预期工作，指定是否显示焦点矩形。null 值表示此对象遵循舞台的 stageFocusRect 属性。

指定属于此 sprite 的 Graphics 对象，在此 sprite 中可执行矢量绘图命令。

指定一个 sprite 用作另一个 sprite 的点击区域。如果 hitArea 属性不存在或者其值为 null 或 undefined，则 Sprite 本身将用作点击区域。hitArea 属性的值可以是对 Sprite 对象的引用。

可以随时更改 hitArea 属性；修改后的 Sprite 会立即使用新的点击区域行为。指定为点击区域的 Sprite 不必是可见的；虽然不可见，但其图形形状仍会作为点击区域被检测。

注意：必须将指定为点击区域的 Sprite 的 mouseEnabled 属性设置为 false。否则，sprite 按钮可能会不起作用，因为被指定为点击区域的 sprite 会接收用户输入事件而不是您的 sprite 按钮。

水平滚动条的当前位置。此值等于可滚动表面的左边缘和当前可见表面最左侧的片段之间的距离（以像素为单位）。

确定对象的子级是否支持鼠标或用户输入设备。如果对象支持鼠标或用户输入设备，用户可以通过使用鼠标或用户输入设备与之交互。默认值为 true。

当您使用 Sprite 类的实例（而不是使用 SimpleButton 类）来创建按钮时，此属性很有用。当您使用 Sprite 实例来创建按钮时，可以选择使用 addChild() 方法添加其他 Sprite 实例来修饰该按钮。此过程可能导致鼠标事件出现意外行为，因为当您期望父实例成为鼠标事件的目标对象时，作为子项添加的 Sprite 实例却可能成为目标对象。要确保父实例用作鼠标事件的目标对象，您可以将父实例的 mouseChildren 属性设置为 false。

设置此属性不会调度任何事件。您必须使用 addEventListener() 方法才能创建交互式功能。

指定此对象是否接收鼠标或其他用户输入、消息。默认值为 true，这表示默认情况下，显示列表上的任何 InteractiveObject 实例都会接收鼠标事件或其他用户输入事件。如果将 mouseEnabled 设置为 false，则实例将不接收任何鼠标事件（或其他用户输入事件，例如键盘事件）。显示列表上的该实例的任何子级都不会受到影响。要更改显示列表上对象的所有子级的 mouseEnabled 行为，请使用 flash.display.DisplayObjectContainer.mouseChildren。

设置此属性不会调度任何事件。您必须使用 addEventListener() 方法才能创建交互式功能。

返回此对象的子项数目。

控制此 sprite 中的声音。

注意：此属性不影响 HTMLControl 对象（位于 Adobe AIR 中）中的 HTML 内容。

确定对象的子项是否支持 Tab 键。

注意：不要将此属性用于 Flex，而是使用 UIComponent.hasFocusableChildren 属性。

相关 API 元素

指定此对象是否遵循 Tab 键顺序。如果该对象遵循 Tab 键顺序，值为 true；否则值为 false。默认情况下，值为 false，但以下情况除外：

• 对于 SimpleButton 对象，值为 true。
• 对于具有 type = "input" 的 TextField 对象，值为 true。
• 对于具有 buttonMode = true 的 Sprite 对象或 MovieClip 对象，值为 true。

指定 SWF 文件中的对象按 Tab 键顺序排列。默认情况下，tabIndex 属性为 -1，这意味着没有为该对象设置任何 Tab 索引。

如果 SWF 文件中当前显示的任何对象包含 tabIndex 属性，则禁用 Tab 键自动排序，而使用该 SWF 文件中对象的 tabIndex 属性来计算 Tab 键顺序。这个自定义的 Tab 键排序仅包括指定了 tabIndex 属性的对象。

tabIndex 属性可以是非负整数。这些对象按照其 tabIndex 属性按升序进行排序。tabIndex 值为 1 的对象在 tabIndex 值为 2 的对象的前面。不要对多个对象使用相同的 tabIndex 值。

由 tabIndex 属性定义的自定义 Tab 键顺序为平构。这意味着不考虑 SWF 文件中对象的层次结构关系。SWF 文件中具有 tabIndex 属性的所有对象都排入 Tab 键顺序中，而 Tab 键顺序由 tabIndex 值的顺序确定。

注意：要设置 TLFTextField 实例的 Tab 键顺序，请将 TLFTextField 的显示子对象转换为 InteractiveObject，然后设置 tabIndex 属性。例如：

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。

布尔值，表示当指针滑过 buttonMode 属性设置为 true 的 sprite 时是否显示指针手形（手形光标）。useHandCursor 属性的默认值是 true。如果 useHandCursor 设置为 true，则当指针滑过按钮 sprite 时将显示用于按钮的指针手形。如果 useHandCursor 为 false，则将改用箭头指针。

可以随时更改 useHandCursor 属性；修改后的 Sprite 会立即具有新的光标外观。

注意：在 Flex 或 Flash Builder 中，如果您的 Sprite 拥有子 Sprite，您可能要将 mouseChildren 属性设置为 false。例如，如果您希望在 Flex <mx:Label> 控件上出现手形光标，请将 useHandCursor 和 buttonMode 属性设置为 true，并将 mouseChildren 属性设置为 false。

垂直滚动条的当前位置。此值等于可滚动表面的顶部边缘与当前可见表面的最顶部片段之间的距离（以像素为单位）。

返回一个对象，该对象具有四个属性：left、top、right 和 bottom。每个属性的值分别等于容器边缘四周镶边（可视元素）的粗细。

镶边包括边框粗细。如果 horizontalScrollPolicy 或 verticalScrollPolicy 属性值为 ScrollPolicy.ON，则镶边还包括相应滚动条的粗细。如果滚动策略为 ScrollPolicy.AUTO，则即使显示滚动条，镶边度量也不包括滚动条粗细。

Container 的子类应覆盖此方法，以便在定位 Container 的子项时考虑其他镶边。例如，Panel 类的 viewMetrics 属性应返回一个对象，该对象的 top 属性包括 Panel 容器的标题栏的粗细。

将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。子项将被添加到该 DisplayObjectContainer 实例中其他所有子项的前（上）面。（要将某子项添加到特定索引位置，请使用 addChildAt() 方法。）

如果添加一个已将其它显示对象容器作为父项的子对象，则会从其它显示对象容器的子列表中删除该对象。

注意：stage.addChild() 命令可导致与发布的 SWF 文件有关的问题，包括安全性问题和与其他加载的 SWF 文件的冲突。无论将多少 SWF 文件加载到运行时中，Flash 运行时实例中都只有一个 Stage。因此，通常无论如何也不应将对象直接添加到 Stage。Stage 应该包含的唯一对象是根对象。创建 DisplayObjectContainer 以包含显示列表上的所有项目。如果需要，随后将 DisplayObjectContainer 实例添加到 Stage。

参数

将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。该子项将被添加到指定的索引位置。索引为 0 表示该 DisplayObjectContainer 对象的显示列表的后（底）部。

例如，下例在索引位置 0、2、1 处分别显示 a、b、c 三个显示对象：

如果添加一个已将其它显示对象容器作为父项的子对象，则会从其它显示对象容器的子列表中删除该对象。

参数

表示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。默认情况下，一个域中的内容无法访问另一个域中的对象，除非通过调用 Security.allowDomain() 方法来允许它们这样做。有关安全性的详细信息，请参阅 Flash Player 开发人员中心主题：安全性。

point 参数位于舞台的坐标空间中，此坐标空间可能与显示对象容器的坐标空间不同（除非显示对象容器是舞台）。您可以使用 globalToLocal() 和 localToGlobal() 方法在这些坐标空间之间转换点。

参数

确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。搜索包括整个显示列表（其中包括此 DisplayObjectContainer 实例）。孙项、曾孙项等，每项都返回 true。

参数

返回位于指定索引处的子显示对象实例。

参数

返回具有指定名称的子显示对象。如果多个子显示对象具有指定名称，则该方法会返回子级列表中的第一个对象。

getChildAt() 方法比 getChildByName() 方法快。getChildAt() 方法从缓存数组中访问子项，而 getChildByName() 方法则必须遍历链接的列表来访问子项。

参数

返回 DisplayObject 的 child 实例的索引位置。

参数

返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。返回的数组中将省略出于安全原因而无法访问的任何子对象。要确定此安全限制是否影响返回的数组，请调用 areInaccessibleObjectsUnderPoint() 方法。

point 参数位于舞台的坐标空间中，此坐标空间可能与显示对象容器的坐标空间不同（除非显示对象容器是舞台）。您可以使用 globalToLocal() 和 localToGlobal() 方法在这些坐标空间之间转换点。

参数

从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。将已删除子项的 parent 属性设置为 null；如果不存在对该子项的任何其它引用，则将该对象作为垃圾回收。DisplayObjectContainer 中该子项之上的任何显示对象的索引位置都减去 1。

垃圾回收器重新分配未使用的内存空间。当在某处变量或对象不再被主动地引用或存储时，如果不存在对该变量或对象的任何其它引用，则垃圾回收器将清理并擦除其过去占用的内存空间。

参数

从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。将已删除子项的 parent 属性设置为 null；如果没有对该子项的任何其他引用，则将该对象作为垃圾回收。DisplayObjectContainer 中该子项之上的任何显示对象的索引位置都减去 1。

垃圾回收器重新分配未使用的内存空间。当在某处变量或对象不再被主动地引用或存储时，如果不存在对该变量或对象的任何其它引用，则垃圾回收器将清理并擦除其过去占用的内存空间。

参数

更改现有子项在显示对象容器中的位置。这会影响子对象的分层。例如，下例在索引位置 0、1、2 处分别显示 a、b、c 三个显示对象：

在使用 setChildIndex() 方法并指定一个已经占用的索引位置时，唯一发生更改的位置是显示对象先前的位置和新位置之间的位置。所有其他位置将保持不变。如果将一个子项移动到比它当前的索引更低的索引处，则这两个索引之间的所有子项的索引引用都将增加 1。如果将一个子项移动到比它当前的索引更高的索引处，则这两个索引之间的所有子项的索引引用都将减小 1。例如，如果上例中的显示对象容器名为 container，则可以通过调用以下代码来交换带有 a 和 b 标记的显示对象的位置：

container.setChildIndex(container.getChildAt(1), 0);

该代码产生以下对象排列：

参数

允许用户拖动指定的 Sprite。Sprite 将一直保持可拖动，直到通过调用 Sprite.stopDrag() 方法来明确停止，或直到将另一个 Sprite 变为可拖动为止。在同一时间只有一个 Sprite 是可拖动的。

三维显示对象跟随指针，Sprite.startDrag() 将在由显示对象定义的三维平面中移动对象。或者，如果显示对象为二维对象和三维对象的子对象，则二维对象将在由三维父对象定义的三维平面中移动。

参数

结束 startDrag() 方法。通过 startDrag() 方法变为可拖动的 Sprite 将一直保持可拖动状态，直到添加 stopDrag() 方法或另一个 Sprite 变为可拖动状态为止。在同一时间只有一个 Sprite 是可拖动的。

交换两个指定子对象的 Z 轴顺序（从前到后顺序）。显示对象容器中所有其他子对象的索引位置保持不变。

参数

在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。显示对象容器中所有其他子对象的索引位置保持不变。

参数