| 包 | mx.managers |
| 接口 | public interface IFocusManager extends IEventDispatcher |
| 实现器 | FocusManager |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
相关 API 元素
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| defaultButton : IButton
对原始的默认 Button 控件的引用。 | IFocusManager | ||
| defaultButtonEnabled : Boolean
一个标志，指示 FocusManager 是否应检查为激活默认按钮而要按下的 Enter 键。 | IFocusManager | ||
| focusPane : Sprite
随着焦点在各容器之间移动的单个 Sprite。 | IFocusManager | ||
| nextTabIndex : int [只读]
此 Tab 键循环中要用到的下一个唯一的 tab 索引。 | IFocusManager | ||
| showFocusIndicator : Boolean
一个标志，指示是否显示用于指示组件具有焦点的指示符。 | IFocusManager | ||
隐藏继承的公共方法
显示继承的公共方法| 方法 | 由以下参数定义 | ||
|---|---|---|---|
如果同时有多个 IFocusManagerContainer 可见，则 SystemManager 将激活 FocusManager，然后取消激活。 | IFocusManager | ||
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | IEventDispatcher | |
如果同时有多个 IFocusManagerContainer 可见，则 SystemManager 将激活 FocusManager，然后取消激活。 | IFocusManager | ||
|
将事件调度到事件流中。 | IEventDispatcher | |
返回包含给定对象（如果有）的 IFocusManagerComponent。 | IFocusManager | ||
获取当前具有焦点的 IFocusManagerComponent 组件。 | IFocusManager | ||
返回 IFocusManagerComponent，当用户按下 Tab 键导航到下一个组件时，它可以获取焦点。 | IFocusManager | ||
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | IEventDispatcher | |
将 showFocusIndicator 设置为 false，并从具有焦点的对象（如果有）上删除可视的焦点指示符。 | IFocusManager | ||
|
从 EventDispatcher 对象中删除侦听器。 | IEventDispatcher | |
将焦点设置到 IFocusManagerComponent 组件。 | IFocusManager | ||
将 showFocusIndicator 设置为 true，并在具有焦点的对象（如果有）上绘制可视的焦点指示符。 | IFocusManager | ||
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | IEventDispatcher | |
defaultButton | 属性 |
defaultButton:IButton| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
对原始的默认 Button 控件的引用。当任何控件上有焦点时按 Enter 键可调度 Button 控件上的 click 事件，从而激活 Button 控件，效果与单击鼠标相同。如果将焦点授予了其他 Button 控件，却在当焦点不在按钮上时将焦点切换回原始控件，则默认 Button 控件实际上发生了更改。
此属性由 Flex 容器管理；请勿直接设置此属性来指定默认按钮。
defaultButton 必须属于 mx.controls.Button 类，即使此属性属于 IUIComponent 类型也不例外。
实现
public function get defaultButton():IButton public function set defaultButton(value:IButton):voiddefaultButtonEnabled | 属性 |
defaultButtonEnabled:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示 FocusManager 是否应检查为激活默认按钮而要按下的 Enter 键。TextArea 和希望识别 Enter 键的其他组件将此属性设置为 false，以禁止 Enter 键调度默认按钮上的 click 事件（如果存在）。
实现
public function get defaultButtonEnabled():Boolean public function set defaultButtonEnabled(value:Boolean):voidfocusPane | 属性 |
nextTabIndex | 属性 |
showFocusIndicator | 属性 |
showFocusIndicator:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
一个标志，指示是否显示用于指示组件具有焦点的指示符。如果为 true，则获得焦点的组件将绘制一个可视指示符，指示它具有焦点。
默认为 false，如果用户使用 Tab 键，则将其设为 true。
通常情况下，最好使用 showFocus() 和 hideFocus() 方法更改此属性，因为这些方法还会更新用于指示组件具有焦点的可视指示符。
实现
public function get showFocusIndicator():Boolean public function set showFocusIndicator(value:Boolean):voidactivate | () | 方法 |
public function activate():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
如果同时有多个 IFocusManagerContainer 可见，则 SystemManager 将激活 FocusManager，然后取消激活。如果在具有已取消激活 FocusManager 的 IFocusManagerContainer 中单击鼠标，则 SystemManager 将对该 FocusManager 调用 activate() 方法。已激活的 FocusManager 将首先调用自身的 deactivate() 方法，然后再激活另一个 FocusManager。
deactivate | () | 方法 |
public function deactivate():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
如果同时有多个 IFocusManagerContainer 可见，则 SystemManager 将激活 FocusManager，然后取消激活。如果在具有已取消激活 FocusManager 的 IFocusManagerContainer 中单击鼠标，则 SystemManager 将对该 FocusManager 调用 activate() 方法。已激活的 FocusManager 将首先调用自身的 deactivate() 方法，然后再激活另一个 FocusManager。
findFocusManagerComponent | () | 方法 |
public function findFocusManagerComponent(o:InteractiveObject):IFocusManagerComponent| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回包含给定对象（如果有）的 IFocusManagerComponent。因为播放器可以为 Flex 组件的子组件设置焦点，所以此方法可以从组件角度确定具有焦点的 IFocusManagerComponent。
参数
o:InteractiveObject — 具有 Flash Player 级别的焦点的对象。
|
IFocusManagerComponent — 包含 o 或 null 的 IFOcusManagerComponent
|
getFocus | () | 方法 |
public function getFocus():IFocusManagerComponent| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
获取当前具有焦点的 IFocusManagerComponent 组件。建议调用此方法而不要使用 Stage 对象，因为此方法可以指示哪个组件具有焦点。Stage 可能会返回该组件中的子组件。
返回IFocusManagerComponent — 具有焦点的 IFocusManagerComponent 对象。
|
getNextFocusManagerComponent | () | 方法 |
public function getNextFocusManagerComponent(backward:Boolean = false):IFocusManagerComponent| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回 IFocusManagerComponent，当用户按下 Tab 键导航到下一个组件时，它可以获取焦点。如果应用程序中不存在其他的有效组件，则会返回与当前具有焦点的组件相同的组件。
参数
backward:Boolean (default = false)true，则返回该对象，就像按下了 Shift-Tab 一样。
|
IFocusManagerComponent — 要获得焦点的组件。
|
hideFocus | () | 方法 |
public function hideFocus():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
将 showFocusIndicator 设置为 false，并从具有焦点的对象（如果有）上删除可视的焦点指示符。
setFocus | () | 方法 |
public function setFocus(o:IFocusManagerComponent):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
将焦点设置到 IFocusManagerComponent 组件。此方法不检查组件的可见性、启用状态或任何其他条件。
参数
o:IFocusManagerComponent — 一个可以获得焦点的组件。
|
showFocus | () | 方法 |
public function showFocus():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
将 showFocusIndicator 设置为 true，并在具有焦点的对象（如果有）上绘制可视的焦点指示符。
Tue Jun 12 2018, 11:04 AM Z