用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
mx.states 

State  - AS3 Flex

mx.states
public class State
继承State Inheritance EventDispatcher Inheritance Object

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

State 类定义视图状态,即组件的特定视图。例如,产品缩略图可以有两个视图状态,包含最少信息的基本视图状态和包含附加信息的丰富视图状态。overrides 属性指定一组要添加到基本视图状态或从基本视图状态中删除的子类,以及当视图状态有效时要设置的属性、样式和事件处理函数。

可以在 Flex 组件的 states 属性中使用 State 类。只能在应用程序或自定义控件的根中指定 states 属性,而不能在子控件中指定。

可通过设置组件的 currentState 属性来启用视图状态。

MXML 语法expanded隐藏 MXML 语法

The <mx:State> tag has the following attributes:

  <mx:State
  Properties
  basedOn="null"
  name="null"
  overrides="null"
  />
  

默认 MXML 属性overrides

相关 API 元素



公共属性
 属性由以下参数定义
  basedOn : String
该视图状态所基于的视图状态的名称;如果该视图状态不是基于已命名的视图状态,则为 null。
State
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  name : String
视图状态的名称。
State
  overrides : Array
该视图状态的覆盖,表现为实现 IOverride 接口的对象的数组。
State
  stateGroups : Array
此视图状态作为 String 数组所属的状态组。
State
公共方法
 方法由以下参数定义
  
State(properties:Object = null)
构造函数。
State
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 由以下参数定义
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
  在进入视图状态后调度。State
  在即将退出视图状态之前调度。State
属性详细信息

basedOn

属性
public var basedOn:String

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

该视图状态所基于的视图状态的名称;如果该视图状态不是基于已命名的视图状态,则为 null。如果该值为 null,则该视图状态基于根状态(包括不是使用 State 类为组件定义的属性、样式、事件处理函数和子项)。

默认值为 null。

name

属性 
public var name:String

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

视图状态的名称。给定组件的状态名称必须唯一。必须设置此属性。

overrides

属性 
public var overrides:Array

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

该视图状态的覆盖,表现为实现 IOverride 接口的对象的数组。这些覆盖在进入状态时按顺序应用,在退出状态时按相反的顺序删除。

以下 Flex 类实现 IOverride 接口,并可用来定义视图状态特性:

  • AddChild
  • RemoveChild
  • SetEventHandler
  • SetProperty
  • SetStyle

overrides 属性是 State 类的默认属性。如果使用 MXML 标签语法来定义覆盖,则可以省略 <mx:overrides> 标签及其子 <mx:Array> 标签。

stateGroups

属性 
public var stateGroups:Array

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

此视图状态作为 String 数组所属的状态组。

构造函数详细信息

State

()构造函数
public function State(properties:Object = null)

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

构造函数。

参数
properties:Object (default = null) — 一个对象,其中包含此 State 的属性设置。
事件详细信息

enterState

事件
事件对象类型: mx.events.FlexEvent
属性 FlexEvent.type = mx.events.FlexEvent.ENTER_STATE

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

在进入视图状态后调度。

FlexEvent.ENTER_STATE 常量可为 enterState 事件定义事件对象的 type 属性值。

仅当一个或多个相关侦听器附加到调度对象时,才会调度此事件。

事件对象的属性有下列值:

属性
bubblesfalse
cancelablefalse
currentTarget用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。

exitState

事件  
事件对象类型: mx.events.FlexEvent
属性 FlexEvent.type = mx.events.FlexEvent.EXIT_STATE

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

在即将退出视图状态之前调度。在删除默认视图状态的更改之前调度此事件。

FlexEvent.EXIT_STATE 常量可为 exitState 事件定义事件对象的 type 属性值。

仅当一个或多个相关侦听器附加到调度对象时,才会调度此事件。

事件对象的属性有下列值:

属性
bubblesfalse
cancelablefalse
currentTarget用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。




[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。