UIComponent

包	mx.core
类	public class UIComponent
继承	UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
实现	IAutomationObject, IChildList, IConstraintClient, IDeferredInstantiationUIComponent, IFlexDisplayObject, IFlexModule, IInvalidating, ILayoutManagerClient, IPropertyChangeNotifier, IRepeaterClient, IStateClient, IAdvancedStyleClient, IToolTipManagerClient, IUIComponent, IValidatorListener, IVisualElement
子类	AdvancedDataGridDragProxy, AdvancedDataGridGroupItemRenderer, AdvancedDataGridHeaderRenderer, AdvancedDataGridSortItemRenderer, BoxDivider, BusyIndicator, Button, CalloutArrow, ChartBase, ChartItemDragProxy, ChartLabel, ComboBase, Container, DataGridDragProxy, DataGridHeaderBase, DataTip, DateChooser, DefaultItemRenderer, DefaultItemRenderer, DualStyleObject, FlexBundleLoaderBase, FormHeading, GroupBase, HighlightBitmapCaptureSkin, HRule, HSliderDataTip, Label, LabelItemRenderer, Legend, LegendItem, ListBaseContentHolder, ListItemDragProxy, ListItemRenderer, MenuBar, MenuBarItem, MenuItemRenderer, MobileSkin, NumericStepper, OLAPDataGridGroupRenderer, PopUpAnchor, PopUpButtonSkin, ProgressBar, RectangularDropShadow, Repeater, RichEditableText, ScrollBar, ScrollControlBase, SkinnableComponent, Slider, Spacer, StatusBar, StyleableStageText, SwatchSkin, SWFLoader, TextBase, TextInput, TileListItemRenderer, TitleBar, ToolTip, TreeItemRenderer, UIServiceBase, VideoDisplay, VideoDisplay, VRule, WindowCloseButtonSkin, WindowMaximizeButtonSkin, WindowMinimizeButtonSkin, WindowRestoreButtonSkin

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

UIComponent 类是所有可视组件（交互式和非交互式）的基类。

交互式组件可以参与 Tab 切换和其他几种键盘焦点处理，接受低级事件（如键盘和鼠标输入），还可以被禁用，以便该组件不能收到键盘和鼠标输入。这与非交互式组件（如 Label 和 ProgressBar）相反，非交互式组件只显示内容且不能由用户操作。

UIComponent 类不作为 MXML 标签使用，而作为其他类的基类使用。

MXML 语法

隐藏 MXML 语法

All user interface components in Flex extend the UIComponent class. Flex components inherit the following properties from the UIComponent class:

  <mx:tagname
   Properties 
    accessibilityDescription="null"
    accessibilityName="null"
    accessibilityShortcut="null"
    accessibilitySilent="true|false"
    automationName="null"
    cachePolicy="auto|on|off"
    currentState="null"
    doubleClickEnabled="false|true"
    enabled="true|false"
    explicitHeight="NaN"
    explicitMaxHeight="NaN"
    explicitMaxWidth="NaN"
    explicitMinHeight="NaN"
    explicitMinWidth="NaN"
    explicitWidth="NaN"
    focusEnabled="true|false"
    hasFocusableChildren="false|true"
    height="0"
    id=""
    includeInLayout="true|false"
    maxHeight="10000"
    maxWidth="10000"
    measuredHeight=
    measuredMinHeight=
    measuredMinWidth=
    measuredWidth=
    minHeight="0"
    minWidth="0"
    mouseFocusEnabled="true|false"
    percentHeight="NaN"
    percentWidth="NaN"
    scaleX="1.0"
    scaleY="1.0"
    states="null"
    styleName="undefined"
    toolTip="null"
    transitions=""
    validationSubField
    width="0"
    x="0"
    y="0"
 
  Styles
    bottom="undefined"
    errorColor="0xFF0000"
    focusBlendMode="normal"
    focusSkin="HaloFocusRect""
    focusThickness="2"
    horizontalCenter="undefined"
    layoutDirection="ltr"
    left="undefined"
    right="undefined"
    themeColor="haloGreen"
    top="undefined"
    verticalCenter="undefined"
 
  Effects
    addedEffect="No default"
    creationCompleteEffect="No default"
    focusInEffect="No default"
    focusOutEffect="No default"
    hideEffect="No default"
    mouseDownEffect="No default"
    mouseUpEffect="No default"
    moveEffect="No default"
    removedEffect="No default"
    resizeEffect="No default"
    rollOutEffect="No default"
    rollOverEffect="No default"
    showEffect="No default"
 
  Events
    add="No default"
    creationComplete="No default"
    currentStateChange="No default"
    currentStateChanging="No default"
    dragComplete="No default"
    dragDrop="No default"
    dragEnter="No default"
    dragExit="No default"
    dragOver="No default"
    effectEnd="No default"
    effectStart="No default"
    enterState="No default"
    exitState="No default"
    hide="No default"
    initialize="No default"
    invalid="No default"
    mouseDownOutside="No default"
    mouseWheelOutside="No default"
    move="No default"
    preinitialize="No default"
    remove="No default"
    resize="No default"
    show="No default"
    toolTipCreate="No default"
    toolTipEnd="No default"
    toolTipHide="No default"
    toolTipShow="No default"
    toolTipShown="No default"
    toolTipStart="No default"
    updateComplete="No default"
    valid="No default"
    valueCommit="No default"
  >

相关 API 元素

mx.core.UIComponent

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		accessibilityDescription : String 一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 description 属性。	UIComponent
		accessibilityEnabled : Boolean 一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 silent 属性。	UIComponent
		accessibilityImplementation : AccessibilityImplementation InteractiveObject 实例的当前辅助功能实现 (AccessibilityImplementation)。	InteractiveObject
		accessibilityName : String 一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 name 属性。	UIComponent
		accessibilityProperties : AccessibilityProperties 此显示对象的当前辅助功能选项。	DisplayObject
		accessibilityShortcut : String 一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 shortcut 属性。	UIComponent
		activeEffects : Array [只读] 组件上当前播放的效果列表，如 EffectInstance 实例的 Array。	UIComponent
		alpha : Number 表示指定对象的 Alpha 透明度值。	DisplayObject
		automationDelegate : Object 处理自动化相关功能的委托对象。	UIComponent
		automationEnabled : Boolean [只读] 如果此组件启用了自动化，则为 true；否则为 false。	UIComponent
		automationName : String 可用作此对象的标识符的名称。	UIComponent
		automationOwner : DisplayObjectContainer [只读] 用于自动化目的的此组件的所有者。	UIComponent
		automationParent : DisplayObjectContainer [只读] 用于自动化目的的此组件的父级。	UIComponent
		automationTabularData : Object [只读] IAutomationTabularData 接口的实现，可用于检索数据。	UIComponent
		automationValue : Array [只读] 此值通常对应于对象的经呈示的外观，当对象在应用中以可视方式显示时，此值使标识符与该对象相关联。	UIComponent
		automationVisible : Boolean [只读] 如果此组件对于自动化是可见的，则为 true；否则为 false。	UIComponent
		baseline : Object 对于组件，此布局约束属性是基于类似命名的样式的外观。	UIComponent
		baselinePosition : Number [只读] 组件第一行文本的基线的 y 坐标。	UIComponent
		blendMode : String BlendMode 类中的一个值，用于指定要使用的混合模式。	DisplayObject
		blendShader : Shader [只写] 设置用于混合前景和背景的着色器。	DisplayObject
		bottom : Object 对于组件，此布局约束属性是基于类似命名的样式的外观。	UIComponent
		buttonMode : Boolean 指定此 sprite 的按钮模式。	Sprite
		cacheAsBitmap : Boolean 如果设置为 true，则 Flash 运行时将缓存显示对象的内部位图表示形式。	DisplayObject
		cacheAsBitmapMatrix : Matrix 如果为非 null，则 Matrix 对象会定义显示对象在 cacheAsBitmap 设置为 true 时的呈现方式。	DisplayObject
		cacheHeuristic : Boolean [只写] 供 Flex 使用，表示建议为对象实施位图缓存。	UIComponent
		cachePolicy : String 指定此对象的位图缓存策略。	UIComponent
		className : String [只读] 此实例的类的名称，如“Button”。	UIComponent
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		contentMouseX : Number [只读] 返回鼠标在内容坐标系中的 x 位置。	UIComponent
		contentMouseY : Number [只读] 返回内容坐标系中鼠标的 y 位置。	UIComponent
		contextMenu : NativeMenu 指定与此对象相关联的上下文菜单。	InteractiveObject
		currentState : String 组件的当前视图状态。	UIComponent
		cursorManager : ICursorManager [只读] 获取控制此组件及其同级组件的光标的 CursorManager。	UIComponent
		depth : Number 确定容器内各项目的呈示顺序。	UIComponent
		descriptor : UIComponentDescriptor 引用 UIComponentDescriptor（如果有），过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。	UIComponent
		designLayer : DesignLayer 指定与该可视元素关联的可选 DesignLayer 实例。	UIComponent
		document : Object 引用与此 UIComponent 相关联的文档对象。	UIComponent
		doubleClickEnabled : Boolean [覆盖] 指定 UIComponent 对象是否接收 doubleClick 事件。	UIComponent
		dropTarget : DisplayObject [只读] 指定拖动 sprite 时经过的显示对象，或放置 sprite 的显示对象。	Sprite
		enabled : Boolean 组件是否可以接受用户交互。	UIComponent
		errorString : String 当验证程序监视组件并且验证失败时，组件的错误提示中将显示的文本。	UIComponent
		explicitHeight : Number 指定该组件在组件坐标中显式高度（以像素为单位）的数字。	UIComponent
		explicitMaxHeight : Number 布局过程中父级要考虑的组件最大建议高度。	UIComponent
		explicitMaxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。	UIComponent
		explicitMinHeight : Number 布局过程中父级要考虑的组件最小建议高度。	UIComponent
		explicitMinWidth : Number 布局过程中父级要考虑的组件最小建议宽度。	UIComponent
		explicitWidth : Number 指定该组件在组件坐标中显式宽度（以像素为单位）的数字。	UIComponent
		filters : Array 包含当前与显示对象关联的每个滤镜对象的索引数组。	DisplayObject
		flexContextMenu : IFlexContextMenu 此 UIComponent 的上下文菜单。	UIComponent
		focusEnabled : Boolean 指示切换到此组件时，是否可以获得焦点。	UIComponent
		focusManager : IFocusManager 获取控制此组件及其同级组件的焦点的 FocusManager。	UIComponent
		focusPane : Sprite 与此对象相关联的焦点窗格。	UIComponent
		focusRect : Object 指定此对象是否显示焦点矩形。	InteractiveObject
		graphics : Graphics [只读] 指定属于此 sprite 的 Graphics 对象，在此 sprite 中可执行矢量绘图命令。	Sprite
		hasFocusableChildren : Boolean 一个标志，指示子对象是否能够获得焦点。	UIComponent
		hasLayoutMatrix3D : Boolean [只读] 如果元素具有 3D 矩阵，则为 true。	UIComponent
		height : Number [覆盖] 指定组件在父坐标中的高度的数字（以像素为单位）。	UIComponent
		hitArea : Sprite 指定一个 sprite 用作另一个 sprite 的点击区域。	Sprite
		horizontalCenter : Object 对于组件，此布局约束属性是基于类似命名的样式的外观。	UIComponent
		id : String 组件 ID。	UIComponent
		includeInLayout : Boolean 指定此组件是否包含在父容器的布局中。	UIComponent
		inheritingStyles : Object 此组件的继承样式链的开头内容。	UIComponent
		initialized : Boolean 一个标志，用于确定某个对象是否已通过布局的所有三个阶段：提交、测量和布局（假设每个阶段都是必需的）。	UIComponent
		instanceIndex : int [只读] 重复组件的索引。	UIComponent
		instanceIndices : Array 一个 Array，包含从此 UIComponent 对象的父文档引用该对象所需的索引。	UIComponent
		is3D : Boolean [只读] 当元素为 3D 时，则为 true。	UIComponent
		isDocument : Boolean [只读] 如果此 UIComponent 实例为文档对象，则为 true。	UIComponent
		isPopUp : Boolean PopUpManager 将其设置为 true 以指示已弹出该组件。	UIComponent
		layoutMatrix3D : Matrix3D [只写] 用于相对于其同级组件计算组件的布局的转换矩阵。	UIComponent
		left : Object 对于组件，此布局约束属性是基于类似命名的样式的外观。	UIComponent
		loaderInfo : LoaderInfo [只读] 返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。	DisplayObject
		maintainProjectionCenter : Boolean 如果为 true，则该组件将使其投影矩阵在其边框的中央保持居中。	UIComponent
		mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。	DisplayObject
		maxHeight : Number 布局过程中父级要考虑的组件最大建议高度。	UIComponent
		maxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。	UIComponent
		measuredHeight : Number 组件的默认高度（以像素为单位）。	UIComponent
		measuredMinHeight : Number 组件的默认最小高度（以像素为单位）。	UIComponent
		measuredMinWidth : Number 组件的默认最小宽度（以像素为单位）。	UIComponent
		measuredWidth : Number 组件的默认宽度（以像素为单位）。	UIComponent
		metaData : Object 如果元数据是通过 PlaceObject4 标记与此 DisplayObject 的实例一起存储在 SWF 文件中的，则获取 DisplayObject 实例的元数据对象。	DisplayObject
		minHeight : Number 布局过程中父级要考虑的组件最小建议高度。	UIComponent
		minWidth : Number 布局过程中父级要考虑的组件最小建议宽度。	UIComponent
		moduleFactory : IFlexModuleFactory 模块工厂用作上下文，用于为此组件使用嵌入字体以及查找用于控制此组件样式的样式管理器。	UIComponent
		mouseChildren : Boolean 确定对象的子级是否支持鼠标或用户输入设备。	DisplayObjectContainer
		mouseEnabled : Boolean 指定此对象是否接收鼠标或其他用户输入、消息。	InteractiveObject
		mouseFocusEnabled : Boolean 单击时是否可获得焦点。	UIComponent
		mouseX : Number [只读] 表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。	DisplayObject
		mouseY : Number [只读] 表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。	DisplayObject
		name : String 表示 DisplayObject 的实例名称。	DisplayObject
		needsSoftKeyboard : Boolean 指定当该 InteractiveObject 实例获得焦点时，是否显示虚拟键盘（显示在屏幕上的软键盘）。	InteractiveObject
		nestLevel : int 此对象在所属关系层次结构中的深度。	UIComponent
		nonInheritingStyles : Object 此组件的非继承样式链的开头内容。	UIComponent
		numAutomationChildren : int [只读] 此容器包含的自动化子项数。	UIComponent
		numChildren : int [只读] 返回此对象的子项数目。	DisplayObjectContainer
		opaqueBackground : Object 指定显示对象是否由于具有某种背景颜色而不透明。	DisplayObject
		owner : DisplayObjectContainer 此 IVisualElement 对象的所有者。	UIComponent
		parent : DisplayObjectContainer [覆盖] [只读] 此组件的父容器或组件。	UIComponent
		parentApplication : Object [只读] 引用包含此 UIComponent 实例的 Application 对象。	UIComponent
		parentDocument : Object [只读] 引用此 UIComponent 的父文档对象。	UIComponent
		percentHeight : Number 以组件父代大小百分比的方式指定组件高度。	UIComponent
		percentWidth : Number 以组件父代大小百分比的方式指定组件宽度。	UIComponent
		postLayoutTransformOffsets : mx.geom:TransformOffsets 定义能够应用于对象转换且在一定程度上对其父布局不可视的一组调整。	UIComponent
		processedDescriptors : Boolean 临时或延迟子项创建操作后设置为 true，具体取决于发生对象。	UIComponent
		repeater : IRepeater [只读] 对生成此 UIComponent 的父文档中 Repeater 对象的引用。	UIComponent
		repeaterIndex : int [只读] 项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。	UIComponent
		repeaterIndices : Array 一个 Array，包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。	UIComponent
		repeaters : Array 一个 Array，包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。	UIComponent
		right : Object 对于组件，此布局约束属性是基于类似命名的样式的外观。	UIComponent
		root : DisplayObject [只读] 对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。	DisplayObject
		rotation : Number [覆盖] 表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。	UIComponent
		rotationX : Number [覆盖] 表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。	UIComponent
		rotationY : Number [覆盖] 表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。	UIComponent
		rotationZ : Number [覆盖] 表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。	UIComponent
		scale9Grid : Rectangle 当前有效的缩放网格。	DisplayObject
		scaleX : Number [覆盖] 用于指定水平缩放系数的数字。	UIComponent
		scaleY : Number [覆盖] 用于指定垂直缩放系数的数字。	UIComponent
		scaleZ : Number [覆盖] 指定沿着 z 轴的缩放因子的数值。	UIComponent
		screen : Rectangle [只读] 返回包含此对象的基本绘图表面大小和位置的对象。	UIComponent
		scrollRect : Rectangle 显示对象的滚动矩形范围。	DisplayObject
		showInAutomationHierarchy : Boolean 用于确定自动化对象是否显示在自动化层次中的标志。	UIComponent
		softKeyboard : String 控制软键盘的外观。	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle 定义当显示软键盘时应在屏幕上保留的区域（在 iOS 上不支持）。	InteractiveObject
		soundTransform : flash.media:SoundTransform 控制此 sprite 中的声音。	Sprite
		stage : Stage [只读] 显示对象的舞台。	DisplayObject
		states : Array 为此组件定义的视图状态。	UIComponent
		styleDeclaration : CSSStyleDeclaration 存储此对象的内嵌继承样式。	UIComponent
		styleManager : IStyleManager2 [只读] 返回此组件使用的 StyleManager 实例。	UIComponent
		styleName : Object 此组件使用的类样式。	UIComponent
		styleParent : IAdvancedStyleClient 组件的父项用于评估后代选择器。	UIComponent
		systemManager : ISystemManager 返回此组件使用的 SystemManager 对象。	UIComponent
		tabChildren : Boolean 确定对象的子项是否支持 Tab 键。	DisplayObjectContainer
		tabEnabled : Boolean 指定此对象是否遵循 Tab 键顺序。	InteractiveObject
		tabFocusEnabled : Boolean 一个标志，指示该对象是否能够通过 Tab 键获得焦点。这与 Flash Player 使用的 tabEnabled 属性类似。对于处理键盘输入的组件该标志通常为 true，但是控件栏中的一些组件将其设置为 false，因为它们不能像编辑器一样从另外的组件窃取焦点。	UIComponent
		tabIndex : int 指定 SWF 文件中的对象按 Tab 键顺序排列。	InteractiveObject
		textSnapshot : flash.text:TextSnapshot [只读] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。	DisplayObjectContainer
		toolTip : String 要在 ToolTip 中显示的文本。	UIComponent
		top : Object 对于组件，此布局约束属性是基于类似命名的样式的外观。	UIComponent
		transform : flash.geom:Transform [覆盖] 一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。	UIComponent
		transformX : Number 设置组件转换中心的 x 坐标。	UIComponent
		transformY : Number 设置组件转换中心的 y 坐标。	UIComponent
		transformZ : Number 设置组件转换中心的 z 坐标。	UIComponent
		transitions : Array 一个 Transition 对象 Array，其中的每个 Transition 对象都定义一组效果，用于在视图状态发生更改时播放。	UIComponent
		tweeningProperties : Array 当前在此对象上进行补间的属性数组。	UIComponent
		uid : String 对象的唯一标识符。	UIComponent
		updateCompletePendingFlag : Boolean 一个标志，确定某个对象是否已通过所有三个阶段的布局验证（假设需要通过所有验证）。	UIComponent
		useHandCursor : Boolean 布尔值，表示当指针滑过 buttonMode 属性设置为 true 的 sprite 时是否显示指针手形（手形光标）。	Sprite
		validationSubField : String 供验证程序用来将子字段与此组件相关联。	UIComponent
		verticalCenter : Object 对于组件，此布局约束属性是基于类似命名的样式的外观。	UIComponent
		visible : Boolean [覆盖] 显示对象是否可见。	UIComponent
		width : Number [覆盖] 指定组件在父坐标中的宽度的数字（以像素为单位）。	UIComponent
		x : Number [覆盖] 指定组件在其父容器中的水平位置（以像素为单位）的数字。	UIComponent
		y : Number [覆盖] 指定组件在其父容器中的垂直位置（以像素为单位）的数字。	UIComponent
		z : Number [覆盖] 表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。	UIComponent

受保护的属性

	属性		由以下参数定义
		currentCSSState : String [只读] 匹配 CSS 伪选择器时要使用的状态。	UIComponent
		hasComplexLayoutMatrix : Boolean [只读] 如果 UIComponent 具有任何非平移 (x,y) 转换属性，则返回 true。	UIComponent
		resourceManager : IResourceManager [只读] 对管理所有应用程序本地化资源的对象的引用。	UIComponent
		unscaledHeight : Number [只读] 用于确定组件的未缩放高度的简便方法。	UIComponent
		unscaledWidth : Number [只读] 用于确定组件的未缩放宽度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成，还应将此宽度作为参数传递到 updateDisplayList() 中。	UIComponent

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		UIComponent() 构造函数。	UIComponent
		addChild(child:DisplayObject):DisplayObject 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		addStyleClient(styleClient:IAdvancedStyleClient):void 将非可视样式客户端添加到该组件实例。	UIComponent
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 表示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。	DisplayObjectContainer
		callLater(method:Function, args:Array = null):void 排队稍后调用的函数。	UIComponent
		clearStyle(styleProp:String):void 删除此组件实例的样式属性。	UIComponent
		contains(child:DisplayObject):Boolean 确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。	DisplayObjectContainer
		contentToGlobal(point:Point):Point 将 Point 对象由内容坐标转换为全局坐标。	UIComponent
		contentToLocal(point:Point):Point 将 Point 对象由内容坐标转换为本地坐标。	UIComponent
		createAutomationIDPart(child:IAutomationObject):Object 返回标识此容器中的子项的一组属性。	UIComponent
		createAutomationIDPartWithRequiredProperties(child:IAutomationObject, properties:Array):Object 返回标识此容器中的子项的一组属性。	UIComponent
		createReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void 在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。	UIComponent
		deleteReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void 在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。	UIComponent
		determineTextFormatFromStyles():mx.core:UITextFormat 返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。	UIComponent
		dispatchEvent(event:Event):Boolean [覆盖] 将事件调度到事件流中。	UIComponent
		drawFocus(isFocused:Boolean):void 在此组件周围显示或隐藏焦点指示符。	UIComponent
		drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void 通过编程方式在此外观的 Graphics 对象中绘制一个矩形。	UIComponent
		effectFinished(effectInst:IEffectInstance):void 停止在组件上播放效果实例时，由效果实例调用。	UIComponent
		effectStarted(effectInst:IEffectInstance):void 开始在组件上播放效果实例时，由效果实例调用。	UIComponent
		endEffectsStarted():void 结束组件上当前播放的所有效果。	UIComponent
		executeBindings(recurse:Boolean = false):void 执行 UIComponent 对象是目标的所有绑定。	UIComponent
		finishPrint(obj:Object, target:IFlexDisplayObject):void 打印完成后调用。	UIComponent
		getAutomationChildAt(index:int):IAutomationObject 在指定的索引位置提供自动化对象。	UIComponent
		getAutomationChildren():Array 提供自动化对象列表。	UIComponent
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。	DisplayObject
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 按指定的元素大小，返回元素边界的 x 坐标。	UIComponent
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 按指定的元素大小，返回元素边界的 y 坐标。	UIComponent
		getChildAt(index:int):DisplayObject 返回位于指定索引处的子显示对象实例。	DisplayObjectContainer
		getChildByName(name:String):DisplayObject 返回具有指定名称的子显示对象。	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int 返回 DisplayObject 的 child 实例的索引位置。	DisplayObjectContainer
		getClassStyleDeclarations():Array 查找此 UIComponent 实例的类型选择器。	UIComponent
		getConstraintValue(constraintName:String):* 返回一个约束布局值，这与获取此组件的约束样式的方式类似。	UIComponent
		getExplicitOrMeasuredHeight():Number 确定是使用显式高度还是测量高度的一种简便方法	UIComponent
		getExplicitOrMeasuredWidth():Number 确定是使用显式宽度还是测量宽度的一种简便方法	UIComponent
		getFocus():InteractiveObject 获取当前具有焦点的对象。	UIComponent
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的布局高度。	UIComponent
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的布局宽度。	UIComponent
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number 返回元素在屏幕上进行绘制时所用的 x 坐标。	UIComponent
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number 返回元素在屏幕上进行绘制时所用的 y 坐标。	UIComponent
		getLayoutMatrix():Matrix 返回用于相对于其同级组件计算组件的布局的转换矩阵。	UIComponent
		getLayoutMatrix3D():Matrix3D 返回此元素的布局转换 Matrix3D。	UIComponent
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的最大高度。	UIComponent
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的最大宽度。	UIComponent
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的最小高度。	UIComponent
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的最小宽度。	UIComponent
		getObjectsUnderPoint(point:Point):Array 返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。	DisplayObjectContainer
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的首选高度。	UIComponent
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的首选宽度。	UIComponent
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。	DisplayObject
		getRepeaterItem(whichRepeater:int = -1):Object 返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目；如果此 Repeater 未重复，则返回 null。	UIComponent
		getStyle(styleProp:String):* 获取已在此组件的样式查找链中的某个位置设置过的样式属性。	UIComponent
		globalToContent(point:Point):Point 将 Point 对象由全局坐标转换为内容坐标。	UIComponent
		globalToLocal(point:Point):Point 将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。	DisplayObject
		globalToLocal3D(point:Point):Vector3D 将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。	DisplayObject
		hasCSSState():Boolean 如果 currentCSSState 不为 null，则返回 true。	UIComponent
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		hasState(stateName:String):Boolean 确定是否已在此 UIComponent 上定义指定的状态。	UIComponent
		hitTestObject(obj:DisplayObject):Boolean 计算显示对象的边框，以确定它是否与 obj 显示对象的边框重叠或相交。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。	DisplayObject
		horizontalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix 返回一个框 Matrix，在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。	UIComponent
		initialize():void 初始化此组件的内部结构。	UIComponent
		initializeRepeaterArrays(parent:IRepeaterClient):void 初始化用于跟踪此组件的重复实例的各个属性。	UIComponent
		invalidateDisplayList():void 标记组件，以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。	UIComponent
		invalidateLayering():void 由某个组件的项目进行调用，以指示其 depth 属性已更改。	UIComponent
		invalidateLayoutDirection():void 当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时，该元素必须调用该方法。	UIComponent
		invalidateProperties():void 标记组件，以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。	UIComponent
		invalidateSize():void 标记组件，以便在稍后屏幕更新期间调用该组件的 measure() 方法。	UIComponent
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		local3DToGlobal(point3d:Vector3D):Point 将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。	DisplayObject
		localToContent(point:Point):Point 将 Point 对象由本地坐标转换为内容坐标。	UIComponent
		localToGlobal(point:Point):Point 将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。	DisplayObject
		matchesCSSState(cssState:String):Boolean 如果 cssState 与 currentCSSState 匹配，则返回 true。	UIComponent
		matchesCSSType(cssType:String):Boolean 确定此实例与给定类型相同，还是属于给定类型的子类。	UIComponent
		measureHTMLText(htmlText:String):flash.text:TextLineMetrics 测量指定的 HTML 文本（该文本中可能包含 <font> 和 <b> 等 HTML 标签），假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。	UIComponent
		measureText(text:String):flash.text:TextLineMetrics 测量指定的文本，假定该文本使用由此 UIComponent 的样式确定的 UITextFormat 显示在单行 UITextField（或 UIFTETextField）中。	UIComponent
		move(x:Number, y:Number):void 将组件移动到其父项内的指定位置。	UIComponent
		notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void 将样式更改传播到子项。	UIComponent
		owns(child:DisplayObject):Boolean 如果 owner 属性链从 child 指向此 UIComponent，则返回 true。	UIComponent
		parentChanged(p:DisplayObjectContainer):void 当在父项中添加或删除 UIComponent 对象时由 Flex 调用。	UIComponent
		prepareToPrint(target:IFlexDisplayObject):Object 准备 IFlexDisplayObject 用于打印。	UIComponent
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		regenerateStyleCache(recursive:Boolean):void 为此组件及其所有后代生成或重新生成 CSS 样式缓存，前提条件是递归参数为 true。	UIComponent
		registerEffects(effects:Array):void 针对每个效果事件，将 EffectManager 注册为一个事件侦听器。	UIComponent
		removeChild(child:DisplayObject):DisplayObject 从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject 从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void 从 DisplayObjectContainer 实例的子级列表中删除所有子 DisplayObject 实例。	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		removeStyleClient(styleClient:IAdvancedStyleClient):void 从该组件实例删除非可视样式客户端。	UIComponent
		replayAutomatableEvent(event:Event):Boolean 重放指定的事件。	UIComponent
		requestSoftKeyboard():Boolean 显示虚拟键盘。	InteractiveObject
		resolveAutomationIDPart(criteria:Object):Array 使用提供的 ID 解析子项。	UIComponent
		resumeBackgroundProcessing():void [静态] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。	UIComponent
		setActualSize(w:Number, h:Number):void 调整对象大小。	UIComponent
		setChildIndex(child:DisplayObject, index:int):void 更改现有子项在显示对象容器中的位置。	DisplayObjectContainer
		setConstraintValue(constraintName:String, value:*):void 设置一个布局约束值的方式，与设置此组件的约束样式的方式相同。	UIComponent
		setCurrentState(stateName:String, playTransition:Boolean = true):void 设置当前状态。	UIComponent
		setFocus():void 设置此组件的焦点。	UIComponent
		setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void 设置元素在屏幕上进行绘制时所用的坐标。	UIComponent
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void 设置元素的布局大小。	UIComponent
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void 设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。	UIComponent
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void 设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。	UIComponent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setStyle(styleProp:String, newValue:*):void 对此组件实例设置样式属性。	UIComponent
		setVisible(value:Boolean, noEvent:Boolean = false):void 当 visible 属性发生更改时调用。	UIComponent
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void 允许用户拖动指定的 Sprite。	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void 使用户可以在启用触摸的设备上拖动指定的 Sprite。	Sprite
		stopAllMovieClips():void 对源起于此对象的所有 MovieClip 递归停止时间轴执行。	DisplayObjectContainer
		stopDrag():void 结束 startDrag() 方法。	Sprite
		stopTouchDrag(touchPointID:int):void 结束 startTouchDrag() 方法，用于启用触摸的设备。	Sprite
		styleChanged(styleProp:String):void 检测对样式属性的更改。	UIComponent
		stylesInitialized():void 首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。	UIComponent
		suspendBackgroundProcessing():void [静态] 阻止对使用 callLater() 排队的方法进行背景处理，直到调用 resumeBackgroundProcessing() 为止。	UIComponent
		swapChildren(child1:DisplayObject, child2:DisplayObject):void 交换两个指定子对象的 Z 轴顺序（从前到后顺序）。	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void 在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。	DisplayObjectContainer
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String [覆盖] 返回一个字符串，用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。	FlexSprite
		transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void 用于更新转换的旋转、缩放和平移的一种实用程序方法，同时保留某个特定点，该点是在组件自己的坐标空间中指定的，且在父项的坐标空间中是固定的。	UIComponent
		transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void 一种实用程序方法，用于将以该对象的本地坐标指定的点转换为在该对象父坐标中的相应位置。	UIComponent
		validateDisplayList():void 验证子项的位置和大小，并绘制其他可视内容。	UIComponent
		validateNow():void 验证并更新此对象的属性和布局，如果需要的话重绘对象。	UIComponent
		validateProperties():void 由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。	UIComponent
		validateSize(recursive:Boolean = false):void 如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法，随后在测量时调用了 validateSize() 方法，则验证组件的度量大小。	UIComponent
		validationResultHandler(event:ValidationResultEvent):void 处理分配给此组件的验证程序调度的 valid 和 invalid 事件。	UIComponent
		valueOf():Object 返回指定对象的原始值。	Object
		verticalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix 返回一个框 Matrix，在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。	UIComponent
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

	方法		由以下参数定义
		adjustFocusRect(obj:DisplayObject = null):void 调整焦点矩形。	UIComponent
		applyComputedMatrix():void 提交计算的矩阵，该矩阵是基于布局矩阵以及 flash displayObject 的转换的转换偏移量而构建的。	UIComponent
		attachOverlay():void 这是一个内部方法，供 Flex 框架用于支持 Dissolve 效果。	UIComponent
		canSkipMeasurement():Boolean 确定是否可以跳过对 measure() 方法的调用。	UIComponent
		childrenCreated():void 创建子对象后执行任何最终处理。	UIComponent
		commitProperties():void 处理对组件设置的属性。	UIComponent
		createChildren():void ‏‏创建组件的子对象。	UIComponent
		createInFontContext(classObj:Class):Object 根据所用的嵌入字体使用上下文创建新对象。	UIComponent
		createInModuleContext(moduleFactory:IFlexModuleFactory, className:String):Object 使用给定的 moduleFactory 创建对象。	UIComponent
		dispatchPropertyChangeEvent(prop:String, oldValue:, value:):void 更新属性时调度 PropertyChangeEvent 的 Helper 方法。	UIComponent
		focusInHandler(event:FocusEvent):void 当 UIComponent 对象获得焦点时调用的事件处理函数。	UIComponent
		focusOutHandler(event:FocusEvent):void 当 UIComponent 对象失去焦点时调用的事件处理函数。	UIComponent
		initAdvancedLayoutFeatures():void 对于组件的某些不常使用的高级布局功能，初始化其实现和存储。	UIComponent
		initializationComplete():void 完成对此组件的初始化。	UIComponent
		initializeAccessibility():void 初始化此组件的辅助功能代码。	UIComponent
		invalidateParentSizeAndDisplayList():void 此对象影响其布局时（includeInLayout 为 true），使父代大小和显示列表失效的 Helper 方法。	UIComponent
		isOurFocus(target:DisplayObject):Boolean 通常由包含 UITextField 对象的组件覆盖，其中 UITextField 对象获取焦点。	UIComponent
		keyDownHandler(event:KeyboardEvent):void 为 keyDown 事件调用的事件处理函数。	UIComponent
		keyUpHandler(event:KeyboardEvent):void 为 keyUp 事件调用的事件处理函数。	UIComponent
		measure():void 计算组件的默认大小和（可选）默认最小大小。	UIComponent
		resourcesChanged():void 构建 UIComponent 时将调用此方法，并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时，都会再次调用此方法。	UIComponent
		setStretchXY(stretchX:Number, stretchY:Number):void 在水平方向和垂直方向上，指定转换拉伸因子。	UIComponent
		stateChanged(oldState:String, newState:String, recursive:Boolean):void 当状态改变以检查状态特定的样式是否应用到此组件时，会调用此方法。	UIComponent
		updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void 绘制对象和/或设置其子项的大小和位置。	UIComponent

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
add	当组件通过使用 addChild()、addChildAt()、addElement() 或 addElementAt() 方法作为内容子项添加到容器后调度。	UIComponent
added	将显示对象添加到显示列表中时调度。	DisplayObject
addedToStage	在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。	DisplayObject
clear	当用户从文本上下文菜单中选择“清除”（或“删除”）时调度。	InteractiveObject
click	用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。	InteractiveObject
contextMenu	当用户手势触发 AIR 应用程序中与此交互式对象相关联的上下文菜单时调度。	InteractiveObject
copy	在用户为复制操作激活特定于平台的加速键组合或从文本上下文菜单中选择“复制”时调度。	InteractiveObject
creationComplete	当组件完成其构建、属性处理、测量、布置和绘制时调度。	UIComponent
currentStateChange	视图状态更改后调度。	UIComponent
currentStateChanging	在 currentState 属性更改后但视图状态更改前调度。	UIComponent
cut	在用户为剪切操作激活特定于平台的加速键组合或从文本上下文菜单中选择“剪切”时调度。	InteractiveObject
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
doubleClick	如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true，当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。	InteractiveObject
dragComplete	在拖动操作完成时（将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时）由拖动启动器（作为要拖动的数据源的组件）调度。	UIComponent
dragDrop	用户在放置目标上释放鼠标时由放置目标调度。	UIComponent
dragEnter	当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时，由该组件调度。	UIComponent
dragExit	用户在组件外拖动但没有将数据放置到目标时，由组件调度。	UIComponent
dragOver	在拖动操作期间，当用户在鼠标位于组件上方的情况下移动鼠标时，由组件调度。	UIComponent
dragStart	启动拖动操作时，由拖动启动器调度。	UIComponent
effectEnd	在一个效果结束后调度。	UIComponent
effectStart	在即将开始播放效果前调度。	UIComponent
effectStop	在停止某个效果（仅当对该效果调用 stop() 时发生）之后调度。	UIComponent
enterFrame	[播放事件] 播放头进入新帧时调度。	DisplayObject
enterState	在组件已进入视图状态之后调度。	UIComponent
exitFrame	[广播事件] 播放头退出当前帧时调度。	DisplayObject
exitState	在组件即将退出视图状态之前调度。	UIComponent
focusIn	显示对象获得焦点后调度。	InteractiveObject
focusOut	显示对象失去焦点后调度。	InteractiveObject
frameConstructed	[广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。	DisplayObject
gestureDirectionalTap	当用户使用 InteractiveObject 实例沿触摸面边缘创建接触点时调度（如在 Siri Remote for Apple TV 上沿触摸面边缘轻击）。有些设备也可能将这种接触解释为多个触摸事件的组合。	InteractiveObject
gestureLongPress	当用户在启用触摸设备上的同一 InteractiveObject 实例上按下两个接触点时（例如，在配有触摸屏的移动电话或平板电脑上的显示对象上按下和释放两个手指）调度。	InteractiveObject
gesturePan	当用户在启用触摸的设备上的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上的显示对象上从左向右移动手指）调度。	InteractiveObject
gestureRotate	当用户在接触点处使用 InteractiveObject 实例执行旋转手势时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或平板电脑上的显示对象上旋转这两个手指）调度。	InteractiveObject
gestureSwipe	当用户在接触点处使用 InteractiveObject 实例执行滑动手势（例如，在配有触摸屏的移动电话或平板电脑上用三根手指触摸屏幕，然后在一个显示对象上平行移动这三根手指）时调度。	InteractiveObject
gestureTap	当用户使用 InteractiveObject 实例创建接触点，然后点击启用触屏的设备时（例如，将几个手指放在显示对象上以打开菜单，然后点击一个手指在配有触摸屏的移动电话或平板电脑上选择一个菜单项）调度。	InteractiveObject
gestureZoom	当用户在接触点处使用 InteractiveObject 实例执行缩放手势操作时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或平板电脑上的显示对象上快速分开手指）调度。	InteractiveObject
hide	当对象的状态从可见变为不可见时调度。	UIComponent
imeStartComposition	此事件被调度到任何支持使用 IME 进行内联输入的客户端应用程序	InteractiveObject
initialize	当组件完成构建并设置了所有初始化属性后调度。	UIComponent
invalid	当组件由 Validator 监控且未通过验证时调度。	UIComponent
keyDown	用户按下某个键时调度。	InteractiveObject
keyFocusChange	用户尝试使用键盘导航更改焦点时调度。	InteractiveObject
keyUp	用户释放某个键时调度。	InteractiveObject
middleClick	当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。	InteractiveObject
middleMouseDown	当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。	InteractiveObject
middleMouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
mouseDown	当用户在 InteractiveObject 实例上按下指针设备按钮时调度。	InteractiveObject
mouseDownOutside	当用户在使用 PopUpManager 打开的某个组件外部单击时，从该组件调度。	UIComponent
mouseFocusChange	用户尝试使用指针设备更改焦点时调度。	InteractiveObject
mouseMove	用户移动 InteractiveObject 上的指针设备时调度。	InteractiveObject
mouseOut	用户将指针设备从 InteractiveObject 实例上移开时调度。	InteractiveObject
mouseOver	用户将指针设备移动到 InteractiveObject 实例上时调度。	InteractiveObject
mouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
mouseWheel	当鼠标滚轮滚动到 InteractiveObject 实例上时调度。	InteractiveObject
mouseWheelOutside	当用户使用鼠标滚轮滚动到使用 PopUpManager 打开的某个组件外部时，从该组件调度。	UIComponent
move	移动对象后调度。	UIComponent
nativeDragComplete	当用户释放拖动手势时由拖动启动器 InteractiveObject 调度。	InteractiveObject
nativeDragDrop	在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时，由目标 InteractiveObject 调度。	InteractiveObject
nativeDragEnter	当拖动手势进入其边界时由 InteractiveObject 调度。	InteractiveObject
nativeDragExit	当拖动手势离开其边界时由 InteractiveObject 调度。	InteractiveObject
nativeDragOver	当拖动手势保持在其边界内时，由 InteractiveObject 持续调度。	InteractiveObject
nativeDragStart	在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。	InteractiveObject
nativeDragUpdate	在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。	InteractiveObject
paste	在用户为粘贴操作激活特定于平台的加速键组合或从文本上下文菜单中选择“粘贴”时调度。	InteractiveObject
preinitialize	在组件初始化序列开始时调度。	UIComponent
proximityBegin	当用户将活动笔针放低经过屏幕的邻近检测阈值上时调度。	InteractiveObject
proximityEnd	当用户将活动笔针抬高放在屏幕的邻近检测阈值上时调度。	InteractiveObject
proximityMove	当用户将活动笔针移动到屏幕上但仍保留在邻近检测阈值中时调度。	InteractiveObject
proximityOut	当用户直接将活动笔针从此 InteractiveObject 上移开但仍保留在屏幕的邻近检测阈值中时调度。	InteractiveObject
proximityOver	当用户直接将活动笔针移动到此 InteractiveObject 上但仍保留在屏幕的邻近检测阈值中时调度。	InteractiveObject
proximityRollOut	当用户从此 InteractiveObject 及其任一子项中移开而仍保留在屏幕的邻近检测阈值中时调度。	InteractiveObject
proximityRollOver	当用户将活动笔针从显示列表中子项的对象树中滑过此 InteractiveObject 时（而仍保留在屏幕的邻近检测阈值中）时调度。	InteractiveObject
releaseOutside	在用户首先在 InteractiveObject 实例上按下按钮，然后将指针设备移离 InteractiveObject 实例，释放指针设备上的按钮时调度。	InteractiveObject
remove	当组件通过使用 removeChild()、removeChildAt()、removeElement() 或 removeElementAt() 方法作为内容子项从容器中删除后调度。	UIComponent
removed	将要从显示列表中删除显示对象时调度。	DisplayObject
removedFromStage	在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。	DisplayObject
render	[广播事件] 将要更新和呈现显示列表时调度。	DisplayObject
resize	在调整组件大小时调度。	UIComponent
rightClick	当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。	InteractiveObject
rightMouseDown	当用户在 InteractiveObject 实例上按下指针设备按钮时调度。	InteractiveObject
rightMouseUp	当用户在 InteractiveObject 实例上释放指针设备按钮时调度。	InteractiveObject
rollOut	用户将指针设备从 InteractiveObject 实例上移开时调度。	InteractiveObject
rollOver	用户将指针设备移动到 InteractiveObject 实例上时调度。	InteractiveObject
selectAll	在用户为全选操作激活特定于平台的加速键组合或从文本上下文菜单中选择“全选”时调度。	InteractiveObject
show	当对象的状态从不可见变为可见时调度。	UIComponent
softKeyboardActivate	在放开软键盘之后立即调度。	InteractiveObject
softKeyboardActivating	在放开软键盘之前立即调度。	InteractiveObject
softKeyboardDeactivate	在隐藏软键盘之后立即调度。	InteractiveObject
stateChangeComplete	在组件进入新状态且切换到该状态的状态转换动画已经播放完时调度。	UIComponent
stateChangeInterrupted	在组件中断转换到当前状态从而切换到新状态时调度。	UIComponent
tabChildrenChange	对象的 tabChildren 标志值发生更改时调度。	InteractiveObject
tabEnabledChange	对象的 tabEnabled 标志发生更改时调度。	InteractiveObject
tabIndexChange	对象的 tabIndex 属性值发生更改时调度。	InteractiveObject
textInput	当用户输入一个或多个文本字符时调度。	InteractiveObject
toolTipCreate	要创建 ToolTip 时由组件调度。	UIComponent
toolTipEnd	已隐藏组件的 ToolTip 并要将其放弃时由组件调度。	UIComponent
toolTipHide	要隐藏组件的 ToolTip 时由组件调度。	UIComponent
toolTipShow	要显示组件的 ToolTip 时由组件调度。	UIComponent
toolTipShown	显示组件的 ToolTip 时由组件调度。	UIComponent
toolTipStart	用户将鼠标移动到设置了 toolTip 属性的组件上方后，由该组件调度。	UIComponent
touchBegin	当用户第一次触摸启用触摸的设备时（例如，用手指触摸配有触摸屏的移动电话或平板）调度。	InteractiveObject
touchEnd	当用户移除与启用触摸的设备的接触时（例如，将手指从配有触摸屏的移动电话或平板电脑上抬起）调度。	InteractiveObject
touchInteractionEnd	不可撤消事件，在组件结束响应 touch 交互用户操作时由组件调度。	UIComponent
touchInteractionStart	不可撤消事件，在组件开始响应 touch 交互用户操作时由组件调度。	UIComponent
touchInteractionStarting	可撤消事件，在组件试图响应 touch 交互用户操作时由组件调度。	UIComponent
touchMove	当用户触碰设备时进行调度，而且会连续调度，直到接触点被删除。	InteractiveObject
touchOut	当用户将接触点从启用触摸的设备上的 InteractiveObject 实例移开时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从一个显示对象拖到另一个显示对象）调度。	InteractiveObject
touchOver	当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。	InteractiveObject
touchRollOut	当用户移动接触点，使其远离启用触摸的设备上的 InteractiveObject 实例时（例如，在配有触摸屏的移动电话或平板电脑上将一个手指从显示对象上的一点移动到显示对象外的一点）调度。	InteractiveObject
touchRollOver	当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。	InteractiveObject
touchTap	当用户在启用触摸设备上的已启动接触的同一 InteractiveObject 实例上抬起接触点时（例如，在配有触摸屏的移动电话或平板的显示对象上的某一点处按下并释放手指）调度。	InteractiveObject
updateComplete	当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度（如果需要）。	UIComponent
valid	当组件由 Validator 监控并且成功通过验证时调度。	UIComponent
valueCommit	当以编程方式或通过用户交互更改值时调度。	UIComponent

样式

样式为常见样式，或与特定主题关联。如果为常见样式，则可以用于任何主题。如果样式与特定主题关联，则只有应用程序使用该主题时才能使用该样式。

常见样式

单击此处了解有关样式的更多信息

	说明	由以下参数定义
baseline	类型: String CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从内容区域的上边缘到控件的基线位置的垂直距离（以像素为单位）。如果设置此样式，则组件的基线锚定在其内容区域的上边缘；调整组件容器大小后，这两个边缘将保持它们的间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。	UIComponent
bottom	类型: String CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件底边到其父容器的内容区域底边之间的垂直距离（以像素为单位）。如果设置此样式，则组件的下边缘锚定在其内容区域的下边缘；调整组件容器大小后，这两个边缘将保持它们的间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。	UIComponent
errorColor	类型: uint 格式: Color CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 验证失败时，组件加亮部分的颜色。验证失败时，Flex 还会将组件的 `borderColor` 样式设置为 `errorColor`。Halo 主题的默认值为 `0xFF0000`。Spark 主题的默认值为 `0xFE0000`。	UIComponent
focusBlendMode	类型: String CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 焦点矩形使用的混合模式。有关详细信息，请参阅 flash.display.DisplayObject 类的 `blendMode` 属性。默认值为 `"normal"`。	UIComponent
focusSkin	类型: Class CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用于绘制焦点矩形的外观。Halo 组件的默认值为 mx.skins.halo.HaloFocusRect。Spark 组件的默认值为 spark.skins.spark.FocusSkin。	UIComponent
focusThickness	类型: Number 格式: Length CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 焦点矩形轮廓的粗细（以像素为单位）。默认值为 `2`。	UIComponent
horizontalCenter	类型: String CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的水平距离（以像素为单位）。如果设置此样式，则组件的中心锚定在其内容区域的中心；调整其容器大小后，这两个中心将保持其水平间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。	UIComponent
interactionMode	类型: String CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 2.5 该组件的主要交互模式。可接受值为 `mouse` 和 `touch`。Halo 主题的默认值为 `mouse`。Spark 主题的默认值为 `mouse`。Mobile 主题的默认值为 `touch`。相关 API 元素 mx.core.InteractionMode.MOUSE mx.core.InteractionMode.TOUCH	UIComponent
layoutDirection	类型: String CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 4.1 运行时版本: Flash10, AIR 1.5 指定组件的所需布局方向。允许的值为`“ltr”`（表示从左到右的布局，用于使用拉丁样式脚本的组件）和`“rtl”`（表示从右到左的布局，用于使用阿拉伯语和希伯来语等脚本的组件）。在 ActionScript 中，可以使用 `mx.core.LayoutDirection.LTR`、`mx.core.LayoutDirection.RTL` 或 `undefined` 值设置 layoutDirection 以从父代继承 layoutDirection。 layoutDirection 通常应在 `Application` 上进行设置，而不是在单独的组件上进行设置。如果 layoutDirection 为`“rtl”`，将会镜像大多数可视元素（文本和图像除外）。文本的方向由 `direction` 样式确定。 layoutDirection 为`“rtl”`时，处理 Keyboard.LEFT 和 Keyboard.RIGHT 事件的组件通常交换键的含义。换句话说，左始终表示向左移动，右始终表示向右移动，而不考虑 `layoutDirection` 注意：该样式适用于将 UIFTETextField 指定为 textFieldClass 的所有 Spark 组件和 MX 组件。默认值为 `"ltr"`。相关 API 元素 MXFTEText.css mx.core.ILayoutDirectionElement mx.core.LayoutDirection	UIComponent
left	类型: String CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件左边到其父容器的内容区域左边之间的水平距离（以像素为单位）。如果设置此样式，则组件的左边缘锚定在其内容区域的左边缘；调整组件容器大小后，这两个边缘将保持它们的间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。	UIComponent
right	类型: String CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件右边到其父容器的内容区域右边之间的水平距离（以像素为单位）。如果设置此样式，则组件的右边缘锚定在其内容区域的右边缘；调整组件容器大小后，这两个边缘将保持它们的间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。	UIComponent
showErrorSkin	类型: Boolean CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 1.5 当此组件无效时，显示错误边框或外观默认值为 `true`。	UIComponent
showErrorTip	类型: Boolean CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 1.5 如果此组件无效，当用户将鼠标移到它上方时，将显示错误提示默认值为 `true`。	UIComponent
top	类型: String CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件顶边到其父容器的内容区域顶边之间的垂直距离（以像素为单位）。如果设置此样式，则组件的上边缘锚定在其内容区域的上边缘；调整其容器大小后，这两个边缘将保持其间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。	UIComponent
verticalCenter	类型: String CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的垂直距离（以像素为单位）。如果设置此样式，则组件的中心锚定在其内容区域的中心；调整其容器大小后，这两个中心将保持其垂直间距。此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（`layout` 属性设置为 `absolute`）中的组件上使用时才发挥作用。默认值为 `undefined`，即不进行设置。	UIComponent

Spark 主题样式

单击此处了解有关样式的更多信息

	样式		说明	由以下参数定义
		chromeColor	类型: uint 格式: Color CSS 继承: 是主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 组件的主要颜色。	UIComponent

Halo 主题样式

单击此处了解有关样式的更多信息

	样式		说明	由以下参数定义
		themeColor	类型: uint 格式: Color CSS 继承: 是主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件的主题颜色。此属性控制加亮内容的外观、选中组件时的外观和其他相似的形象化提示，但是它对此组件的常规边框和背景颜色不起作用。虽然可以使用任意有效的颜色值，但首选值为 `haloGreen`、`haloBlue`、`haloOrange` 和 `haloSilver`。 `rollOverColor` 和 `selectionColor` 样式的默认值基于 `themeColor` 值。默认值为 `"haloBlue"`。	UIComponent

效果

单击此处了解有关效果的更多信息

	说明	由以下参数定义
addedEffect	触发事件: added 将组件作为子项添加到 Container 时播放。	UIComponent
creationCompleteEffect	触发事件: creationComplete 创建组件时播放。	UIComponent
focusInEffect	触发事件: focusIn 组件获得键盘焦点时播放。	UIComponent
focusOutEffect	触发事件: focusOut 组件失去键盘焦点时播放。	UIComponent
hideEffect	触发事件: hide 组件变为不可见时播放。	UIComponent
mouseDownEffect	触发事件: mouseDown 用户在组件上方按下鼠标按键时播放。	UIComponent
mouseUpEffect	触发事件: mouseUp 用户在组件上方释放鼠标按键时播放。	UIComponent
moveEffect	触发事件: move 移动组件时播放。	UIComponent
removedEffect	触发事件: removed 从 Container 中删除组件时播放。	UIComponent
resizeEffect	触发事件: resize 调整组件大小时播放。	UIComponent
rollOutEffect	触发事件: rollOut 用户将鼠标指针滚离组件上方时播放。	UIComponent
rollOverEffect	触发事件: rollOver 用户将鼠标指针滚动到组件上方时播放。	UIComponent
showEffect	触发事件: show 组件变为可见时播放。	UIComponent

公共常量

	常量		由以下参数定义
		DEFAULT_MAX_HEIGHT : Number = 10000 [静态] maxHeight 属性的默认值。	UIComponent
		DEFAULT_MAX_WIDTH : Number = 10000 [静态] maxWidth 属性的默认值。	UIComponent
		DEFAULT_MEASURED_HEIGHT : Number = 22 [静态] measuredHeight 属性的默认值。	UIComponent
		DEFAULT_MEASURED_MIN_HEIGHT : Number = 22 [静态] measuredMinHeight 属性的默认值。	UIComponent
		DEFAULT_MEASURED_MIN_WIDTH : Number = 40 [静态] measuredMinWidth 属性的默认值。	UIComponent
		DEFAULT_MEASURED_WIDTH : Number = 160 [静态] measuredWidth 属性的默认值。	UIComponent

属性详细信息

accessibilityDescription

属性

accessibilityDescription:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 description 属性。

getter 仅返回 accessibilityProperties.description。如果 accessibilityProperties 为 null，则返回“”。setter 先检查 accessibilityProperties 是否为 null，如果是，则将其设置为新的 AccessibilityProperties 实例。随后会设置 accessibilityProperties.description。

实现
public function get accessibilityDescription():String
public function set accessibilityDescription(value:String):void

accessibilityEnabled

属性

accessibilityEnabled:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 silent 属性。

请注意，accessibilityEnabled 与 silent 相反；silent 为 false 时，accessibilityEnabled 为 true。

getter 仅返回 accessibilityProperties.silent。如果 accessibilityProperties 为 null，则返回 true。setter 先检查 accessibilityProperties 是否为 null，如果是，则将其设置为新的 AccessibilityProperties 实例。随后会设置 accessibilityProperties.silent。

实现
public function get accessibilityEnabled():Boolean
public function set accessibilityEnabled(value:Boolean):void

accessibilityName

属性

accessibilityName:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 name 属性。

getter 仅返回 accessibilityProperties.name。如果 accessibilityProperties 为 null，则返回“”。setter 先检查 accessibilityProperties 是否为 null，如果是，则将其设置为新的 AccessibilityProperties 实例。随后会设置 accessibilityProperties.name。

实现
public function get accessibilityName():String
public function set accessibilityName(value:String):void

accessibilityShortcut

属性

accessibilityShortcut:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 shortcut 属性。

getter 仅返回 accessibilityProperties.shortcut。如果 accessibilityProperties 为 null，则返回“”。setter 先检查 accessibilityProperties 是否为 null，如果是，则将其设置为新的 AccessibilityProperties 实例。随后会设置 accessibilityProperties.shortcut。

实现
public function get accessibilityShortcut():String
public function set accessibilityShortcut(value:String):void

activeEffects

属性

activeEffects:Array [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

组件上当前播放的效果列表，如 EffectInstance 实例的 Array。

实现
public function get activeEffects():Array

automationDelegate

属性

automationDelegate:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

处理自动化相关功能的委托对象。

实现
public function get automationDelegate():Object
public function set automationDelegate(value:Object):void

automationEnabled

属性

automationEnabled:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

如果此组件启用了自动化，则为 true；否则为 false。

实现
public function get automationEnabled():Boolean

automationName

属性

automationName:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

可用作此对象的标识符的名称。

实现
public function get automationName():String
public function set automationName(value:String):void

automationOwner

属性

automationOwner:DisplayObjectContainer [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

用于自动化目的的此组件的所有者。

实现
public function get automationOwner():DisplayObjectContainer

automationParent

属性

automationParent:DisplayObjectContainer [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

用于自动化目的的此组件的父级。

实现
public function get automationParent():DisplayObjectContainer

automationTabularData

属性

automationTabularData:Object [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

IAutomationTabularData 接口的实现，可用于检索数据。

实现
public function get automationTabularData():Object

automationValue

属性

automationValue:Array [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此值通常对应于对象的经呈示的外观，当对象在应用中以可视方式显示时，此值使标识符与该对象相关联。

实现
public function get automationValue():Array

automationVisible

属性

automationVisible:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

如果此组件对于自动化是可见的，则为 true；否则为 false。

实现
public function get automationVisible():Boolean

baseline

属性

baseline:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对于组件，此布局约束属性是基于类似命名的样式的外观。要将属性设置为其默认值 undefined，请使用 MXML 中的 @Clear () 指令或 ActionScript 代码中的 undefined 值。例如，在 MXML 代码中，baseline.s2="@Clear()" 将取消对状态 s2 中 baseline 约束的设置。或者在 ActionScript 代码中，button.baseline = undefined 将取消对 button 中 baseline 约束的设置。

从锚点目标到控件的基线位置的垂直距离（以像素为单位）。

默认情况下，锚点目标是容器的内容区域的上边缘。在具有高级约束的布局中，目标可以是一个约束行。

将属性设置为数字或数字字符串（如“10”）会指定使用默认锚点目标。

要指定锚点目标，请使用格式“anchorTargetName:value”将属性值设置为一个字符串，如“row1:10”。

实现
public function get baseline():Object
public function set baseline(value:Object):void

baselinePosition

属性

baselinePosition:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

组件第一行文本的基线的 y 坐标。

此属性用于实现 baseline 约束样式，还可用于将 FormItem 的标签与 FormItem 中的控件对齐。

实现
public function get baselinePosition():Number

bottom

属性

bottom:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对于组件，此布局约束属性是基于类似命名的样式的外观。要将属性设置为其默认值 undefined，请使用 MXML 中的 @Clear () 指令或 ActionScript 代码中的 undefined 值。例如，在 MXML 代码中，bottom.s2="@Clear()" 将取消对状态 s2 中 botton 约束的设置。或者在 ActionScript 代码中，button.bottom = undefined 将取消对 button 中 bottom 约束的设置。

从组件的下边缘到锚点目标的下边缘的垂直距离（以像素为单位）。

默认情况下，锚点目标是容器的内容区域。在具有高级约束的布局中，目标可以是一个约束行。

将属性设置为数字或数字字符串（如“10”）会指定使用默认锚点目标。

要指定锚点目标，请使用格式“anchorTargetName:value”将属性值设置为一个字符串，如“row1:10”。

实现
public function get bottom():Object
public function set bottom(value:Object):void

cacheHeuristic

属性

cacheHeuristic:Boolean [只写]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

供 Flex 使用，表示建议为对象实施位图缓存。如果 cachePolicy 为 UIComponentCachePolicy.AUTO，则 cacheHeuristic 用于控制对象的 cacheAsBitmap 属性。

实现
public function set cacheHeuristic(value:Boolean):void

cachePolicy

属性

cachePolicy:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定此对象的位图缓存策略。在 MXML 中，可能值为 "on"、"off" 和 "auto"（默认值）。

在 ActionScript 中，可能值为 UIComponentCachePolicy.ON、UIComponentCachePolicy.OFF 和 UIComponentCachePolicy.AUTO（默认值）。

如果值为 UIComponentCachePolicy.ON，则表示对象始终作为位图缓存。
如果值为 UIComponentCachePolicy.OFF，则表示对象从不作为位图缓存。
如果值为 UIComponentCachePolicy.AUTO，则表示框架将使用试探法确定此对象是否应作为位图缓存。

默认值为 UIComponentCachePolicy.AUTO。

实现
public function get cachePolicy():String
public function set cachePolicy(value:String):void

className

属性

className:String [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此实例的类的名称，如 "Button"。

此字符串不包括包名称。如果您还需要包名称，请调用 flash.utils 包中的 getQualifiedClassName() 方法。此方法将返回一个字符串，如 "mx.controls::Button"。

实现
public function get className():String

contentMouseX

属性

contentMouseX:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回鼠标在内容坐标系中的 x 位置。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。

实现
public function get contentMouseX():Number

contentMouseY

属性

contentMouseY:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回内容坐标系中鼠标的 y 位置。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。

实现
public function get contentMouseY():Number

currentCSSState

属性

currentCSSState:String [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.5

匹配 CSS 伪选择器时要使用的状态。默认情况下，此状态为 currentState。

实现
protected function get currentCSSState():String

currentState

属性

currentState:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

组件的当前视图状态。将其设置为 "" 或 null 可将组件重置回其基本状态。

当您使用此属性设置组件的状态时，Flex 将应用您定义的转移。您还可以使用 setCurrentState() 方法设置当前状态，此方法可以有选择性地更改状态，而无需应用转移。

此属性可用作数据绑定的源。修改此属性后，将调度 currentStateChange 事件。

实现
public function get currentState():String
public function set currentState(value:String):void

相关 API 元素

setCurrentState()

cursorManager

属性

cursorManager:ICursorManager [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

获取控制此组件及其同级组件的光标的 CursorManager。每个顶级窗口都包含自己的 CursorManager 实例；为确保使用的实例正确，请使用此方法。

实现
public function get cursorManager():ICursorManager

depth

属性

depth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

确定容器内各项目的呈示顺序。Spark 容器根据项目的 depth 属性确定这些项目的顺序，具有最低深度的项目在后面，具有较高深度的项目在前面。具有相同深度值的项目按照添加到容器中的顺序显示。

实现
public function get depth():Number
public function set depth(value:Number):void

descriptor

属性

descriptor:UIComponentDescriptor

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

引用 UIComponentDescriptor（如果有），过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。如果此 UIComponent 实例并非基于描述符创建，则此属性为 null。

实现
public function get descriptor():UIComponentDescriptor
public function set descriptor(value:UIComponentDescriptor):void

相关 API 元素

mx.core.UIComponentDescriptor

designLayer

属性

designLayer:DesignLayer

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

指定与该可视元素关联的可选 DesignLayer 实例。

当分配一个 DesignLayer 时，可视元素在最终将自身的有效可视性或透明度提交给它的支持 DisplayObject（如果适用）时，必须考虑其父层的可视性和透明度。

可视元素必须侦听来自关联层的父项发出的 layerPropertyChange 通知。当层的 effectiveAlpha 或 effectiveVisibility 发生改变时，元素必须计算其有效可视性（或透明度）且相应地应用。

该属性不应在 MXML 内直接设置。

designLayer 属性不用于 z 轴顺序控件，请参见 depth。

实现
public function get designLayer():DesignLayer
public function set designLayer(value:DesignLayer):void

document

属性

document:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

引用与此 UIComponent 相关联的文档对象。文档对象是位于 Flex 应用程序、MXML 组件或 AS 组件层次结构顶层的 Object。

实现
public function get document():Object
public function set document(value:Object):void

doubleClickEnabled

属性

doubleClickEnabled:Boolean[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定 UIComponent 对象是否接收 doubleClick 事件。默认值为 false，即 UIComponent 对象不接收 doubleClick 事件。

还必须将 mouseEnabled 属性设置为 true（默认值），这样对象才能接收 doubleClick 事件。

默认值为 false。

实现
override public function get doubleClickEnabled():Boolean
override public function set doubleClickEnabled(value:Boolean):void

enabled

属性

enabled:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

组件是否可以接受用户交互。将 enabled 属性设置为 false 后，某些组件仍会响应鼠标交互，如 mouseOver。因此，要完全禁用 UIComponent，您应该将 mouseEnabled 属性的值也设置为 false。如果将容器的 enabled 属性设置为 false，则 Flex 会使该容器及其所有子项的颜色变暗，并阻止用户向容器及其所有子项输入内容。

此属性可用作数据绑定的源。修改此属性后，将调度 enabledChanged 事件。

实现
public function get enabled():Boolean
public function set enabled(value:Boolean):void

errorString

属性

errorString:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当验证程序监视组件并且验证失败时，组件的错误提示中将显示的文本。

您可以使用 errorString 属性显示组件的验证错误，而无需实际使用 validator 类。当您将 String 值写入 errorString 属性时，Flex 将在组件周围绘制红色边框以指示验证错误，并且当您将鼠标指针移至组件上方时，该 String 将作为验证错误消息显示在工具提示中，就像验证程序检测到验证错误一样。

若要清除验证错误，请为 errorString 属性写入一个空 String ""。

请注意，为 errorString 属性写入值不会触发 valid 或 invalid 事件，只会更改边框颜色和显示验证错误消息。

此属性可用作数据绑定的源。修改此属性后，将调度 errorStringChanged 事件。

实现
public function get errorString():String
public function set errorString(value:String):void

explicitHeight

属性

explicitHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定该组件在组件坐标中显式高度（以像素为单位）的数字。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此，如果父项为 Container，则此属性可能不会产生任何效果，要么就是容器在此属性中不起作用。由于该值是组件坐标值，因此针对其父项的真正 explicitHeight 受 scaleY 属性影响。

设置 height 属性，同时也会将此属性设置为指定的高度值。

此属性可用作数据绑定的源。修改此属性后，将调度 explicitHeightChanged 事件。

实现
public function get explicitHeight():Number
public function set explicitHeight(value:Number):void

explicitMaxHeight

属性

explicitMaxHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最大建议高度。此值采用组件坐标（以像素为单位）。

应用程序开发人员一般不设置 explicitMaxHeight 属性。而是设置 maxHeight 属性的值，该值设置 explicitMaxHeight 属性。不会更改 maxHeight 的值。

在布局过程中，如果应用程序开发人员明确设置了 maxHeight，则使用 explicitMaxHeight 的值。否则，使用 maxHeight 的默认值。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此，如果父项为 Container，则此属性可能不会产生任何效果，要么就是容器在此属性中不起作用。由于此值位于组件坐标中，因此与其父项相关的真正 maxHeight 受 scaleY 属性影响。有些组件从理论上没有高度限制。在这些情况下，可将其 maxHeight 设置为 UIComponent.DEFAULT_MAX_HEIGHT。

默认值为 NaN。

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMaxHeightChanged 事件。

实现
public function get explicitMaxHeight():Number
public function set explicitMaxHeight(value:Number):void

explicitMaxWidth

属性

explicitMaxWidth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最大建议宽度。此值采用组件坐标（以像素为单位）。

应用程序开发人员一般不设置 explicitMaxWidth 属性。而是设置 maxWidth 属性的值，该值设置 explicitMaxWidth 属性。不会更改 maxWidth 的值。

在布局过程中，如果应用程序开发人员明确设置了 maxWidth，则使用 explicitMaxWidth 的值。否则，使用 maxWidth 的默认值。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此，如果父项为 Container，则此属性可能不会产生任何效果，要么就是容器在此属性中不起作用。由于此值位于组件坐标中，因此与其父项相关的真正 maxWidth 受 scaleX 属性影响。有些组件从理论上没有宽度限制。在这些情况下，可将其 maxWidth 设置为 UIComponent.DEFAULT_MAX_WIDTH。

默认值为 NaN。

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMaxWidthChanged 事件。

实现
public function get explicitMaxWidth():Number
public function set explicitMaxWidth(value:Number):void

explicitMinHeight

属性

explicitMinHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最小建议高度。此值采用组件坐标（以像素为单位）。

应用程序开发人员一般不设置 explicitMinHeight 属性。而是设置 minHeight 属性的值，该值设置 explicitMinHeight 属性。不会更改 minHeight 的值。

在布局过程中，如果应用程序开发人员明确设置了 minHeight，则使用 explicitMinHeight 的值。否则，使用 measuredMinHeight 的值。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此，如果父项为 Container，则此属性可能不会产生任何效果，要么就是容器在此属性中不起作用。由于此值位于组件坐标中，因此与其父项相关的真正 minHeight 受 scaleY 属性影响。

默认值为 NaN。

此属性可用作数据绑定的源。修改此属性后，将调度 explictMinHeightChanged 事件。

实现
public function get explicitMinHeight():Number
public function set explicitMinHeight(value:Number):void

explicitMinWidth

属性

explicitMinWidth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最小建议宽度。此值采用组件坐标（以像素为单位）。

应用程序开发人员一般不设置 explicitMinWidth 属性。而是设置 minWidth 属性的值，该值设置 explicitMinWidth 属性。不会更改 minWidth 的值。

在布局过程中，如果应用程序开发人员明确设置了 minWidth，则使用 explicitMinWidth 的值。否则，使用 measuredMinWidth 的值。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此，如果父项为 Container，则此属性可能不会产生任何效果，要么就是容器在此属性中不起作用。由于此值位于组件坐标中，因此与其父项相关的真正 minWidth 受 scaleX 属性影响。

默认值为 NaN。

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMinWidthChanged 事件。

实现
public function get explicitMinWidth():Number
public function set explicitMinWidth(value:Number):void

explicitWidth

属性

explicitWidth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定该组件在组件坐标中显式宽度（以像素为单位）的数字。

容器使用此值计算组件的大小和位置。组件本身确定其默认大小时不会使用此值。因此，如果父项为 Container，则此属性可能不会产生任何效果，要么就是容器在此属性中不起作用。由于该值是组件坐标值，因此针对其父项的真正 explicitWidth 受 scaleX 属性影响。

设置 width 属性，同时也会将此属性设置为指定的宽度值。

此属性可用作数据绑定的源。修改此属性后，将调度 explicitWidthChanged 事件。

实现
public function get explicitWidth():Number
public function set explicitWidth(value:Number):void

flexContextMenu

属性

flexContextMenu:IFlexContextMenu

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此 UIComponent 的上下文菜单。

默认值为 null。

实现
public function get flexContextMenu():IFlexContextMenu
public function set flexContextMenu(value:IFlexContextMenu):void

focusEnabled

属性

focusEnabled:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指示切换到此组件时，是否可以获得焦点。当 UIComponent 用作另一组件的子组件时，可以将 focusEnabled 设置为 false，以便外部组件成为可获得焦点的实体。如果此属性是 false，则焦点将转换到已将 focusEnable 设置为 true 的第一个父项。

默认值为 true，spark.components.Scroller 组件除外。对于该组件，默认值为 false。

实现
public function get focusEnabled():Boolean
public function set focusEnabled(value:Boolean):void

相关 API 元素

spark.components.Scroller

focusManager

属性

focusManager:IFocusManager

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get focusManager():IFocusManager
public function set focusManager(value:IFocusManager):void

focusPane

属性

focusPane:Sprite

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

与此对象相关联的焦点窗格。如果对象的任一子项包含焦点，该对象将具有焦点窗格。

实现
public function get focusPane():Sprite
public function set focusPane(value:Sprite):void

hasComplexLayoutMatrix

属性

hasComplexLayoutMatrix:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

如果 UIComponent 具有任何非平移 (x,y) 转换属性，则返回 true。

实现
protected function get hasComplexLayoutMatrix():Boolean

hasFocusableChildren

属性

hasFocusableChildren:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

一个标志，指示子对象是否能够获得焦点。

注意：此属性与 Flash Player 使用的 tabChildren 属性类似。应该将 hasFocusableChildren 属性用于 Flex 应用程序。请勿使用 tabChildren 属性。

此属性通常为 false，因为大多数组件既可以自己获得焦点，也可以委托单个内部子组件获得焦点（但显示为该组件获得了焦点）。例如，TextInput 控件包含一个可成为焦点的 RichEditableText 子控件，但实际上当 RichEditableText 子组件获得焦点时，却显示为 TextInput 获得了焦点。TextInput 将 hasFocusableChildren 设置为 false，因为获得焦点的组件为 TextInput。其内部结构是一个抽象概念。

通常只有像 TabNavigator 和 Accordion 这样的导航器组件将此标志设置为 true，因为它们在按 Tab 键时获得了焦点，但焦点会在进一步按 Tab 键时转移到子容器的组件中。

默认值为 false，spark.components.Scroller 组件除外。对于该组件，默认值为 true。

此属性可用作数据绑定的源。修改此属性后，将调度 hasFocusableChildrenChange 事件。

实现
public function get hasFocusableChildren():Boolean
public function set hasFocusableChildren(value:Boolean):void

相关 API 元素

spark.components.Scroller

hasLayoutMatrix3D

属性

hasLayoutMatrix3D:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

如果元素具有 3D 矩阵，则为 true。

使用 hasLayoutMatrix3D，而不是调用和检查 getLayoutMatrix3D() 的返回值，因为该方法会返回一个有效的矩阵，即使元素是 2D 的也是如此。

实现
public function get hasLayoutMatrix3D():Boolean

height

属性

height:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定组件在父坐标中的高度的数字（以像素为单位）。默认值为 0，但当 Flex 在应用程序中设置完组件的大小后，此属性将包含实际的组件高度。

请注意：您可以在 MXMLheight 属性中指定一个百分比值（如 height="100%"），但无法在 ActionScript 的 height 属性中使用百分比值；可改用 percentHeight 属性。

设置此属性将导致 resize 事件被调度。有关何时调度此事件的详细信息，请参阅 resize 事件。

此属性可用作数据绑定的源。修改此属性后，将调度 heightChanged 事件。

实现
override public function get height():Number
override public function set height(value:Number):void

相关 API 元素

percentHeight

horizontalCenter

属性

horizontalCenter:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对于组件，此布局约束属性是基于类似命名的样式的外观。要将属性设置为其默认值 undefined，请使用 MXML 中的 @Clear () 指令或 ActionScript 代码中的 undefined 值。例如，在 MXML 代码中，horizontalCenter.s2="@Clear()" 将取消对状态 s2 中 horizontalCenter 约束的设置。或者在 ActionScript 代码中，button.horizontalCenter = undefined 将取消对 button 中 horizontalCenter 约束的设置。

从组件中心到锚点目标的内容区域中心的水平距离（以像素为单位）。

默认锚点目标是容器本身。

在具有高级约束的布局中，锚点目标可以是一个约束列。那么，内容区域就是前一列（或容器侧）与目标列之间的空间。

将属性设置为数字或数字字符串（如“10”）会指定使用默认锚点目标。

要指定锚点目标，请使用格式“constraintColumnId:value”将属性值设置为一个字符串，如“col1:10”。

实现
public function get horizontalCenter():Object
public function set horizontalCenter(value:Object):void

id

属性

id:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

组件 ID。此值将作为对象的实例名称，因此不应包含任何空格或特殊字符。应用程序中的每个组件都应具有唯一的 ID。

如果将使用第三方工具对您的应用程序进行测试，请为每个组件赋予一个有意义的 ID。测试工具使用 ID 代表其脚本中的控件，因此使用有意义的名称可使脚本更具可读性。例如，将某个按钮的值设置为 submit_button 而不是 b1 或 button1。

实现
public function get id():String
public function set id(value:String):void

includeInLayout

属性

includeInLayout:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定此组件是否包含在父容器的布局中。如果为 true，则该对象将包含在其父容器的布局中，并由其父容器根据其布局规则调整其大小并确定其位置。如果为 false，则对象的父容器的布局不影响该对象的大小和位置。

默认值为 true。

此属性可用作数据绑定的源。修改此属性后，将调度 includeInLayoutChanged 事件。

实现
public function get includeInLayout():Boolean
public function set includeInLayout(value:Boolean):void

inheritingStyles

属性

inheritingStyles:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此组件的继承样式链的开头内容。getStyle() 方法只需访问 inheritingStyles[styleName]，即可搜索整个与原型链接的链。此对象由 initProtoChain() 设置。开发人员通常不需要直接访问此属性。

实现
public function get inheritingStyles():Object
public function set inheritingStyles(value:Object):void

initialized

属性

initialized:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个标志，用于确定某个对象是否已通过布局的所有三个阶段：提交、测量和布局（假设每个阶段都是必需的）。

实现
public function get initialized():Boolean
public function set initialized(value:Boolean):void

instanceIndex

属性

instanceIndex:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

重复组件的索引。如果组件不在 Repeater 中，则值为 -1。

实现
public function get instanceIndex():int

instanceIndices

属性

instanceIndices:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个 Array，包含从此 UIComponent 对象的父文档引用该对象所需的索引。除非 UIComponent 对象位于一个或多个 Repeater 中，否则该 Array 为空。第一个元素与最外面的 Repeater 对应。例如，如果 id 为“b”并且 instanceIndices 为 [2,4]，则在父文档中将以 b[2][4] 的形式对其引用。

实现
public function get instanceIndices():Array
public function set instanceIndices(value:Array):void

is3D

属性

is3D:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

当元素为 3D 时，则为 true。元素也可以是 3D 的，因为它具有 3D 转换属性或 3D 布局后转换偏移，或二者都有。

实现
public function get is3D():Boolean

isDocument

属性

isDocument:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果此 UIComponent 实例为文档对象，则为 true。这意味着该对象位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构的顶层。

实现
public function get isDocument():Boolean

isPopUp

属性

isPopUp:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

PopUpManager 将其设置为 true 以指示已弹出该组件。

实现
public function get isPopUp():Boolean
public function set isPopUp(value:Boolean):void

layoutMatrix3D

属性

layoutMatrix3D:Matrix3D [只写]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

用于相对于其同级组件计算组件的布局的转换矩阵。此矩阵由组件的 3D 属性（包括诸如 x、y、rotation、scaleX、scaleY、transformX 和 transformY 以及 rotationX、rotationY、scaleZ、z 和 transformZ 等 2D 属性）定义。

大多数组件上并未设置任何 3D 转换属性。

该布局矩阵与 postLayoutTransformOffsets 属性的值相结合用于确定组件的最终计算矩阵。

实现
public function set layoutMatrix3D(value:Matrix3D):void

相关 API 元素

postLayoutTransformOffsets

left

属性

left:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对于组件，此布局约束属性是基于类似命名的样式的外观。要将 MXML 中属性的状态特定的值设置为其默认值 undefined，请使用 @Clear() 指令。例如，在 MXML 代码中，left.s2="@Clear()" 将取消对状态 s2 中 left 约束的设置。或者在 ActionScript 代码中，button.left = undefined 将取消对 button 中 left 约束的设置。

从组件的左边缘到锚点目标的左边缘的水平距离（以像素为单位）。

默认情况下，锚点目标是容器的内容区域。在具有高级约束的布局中，目标可以是一个约束列。

将属性设置为数字或数字字符串（如“10”）会指定使用默认锚点目标。

要指定锚点目标，请使用格式“anchorTargetName:value”将属性值设置为一个字符串，如“col1:10”。

实现
public function get left():Object
public function set left(value:Object):void

maintainProjectionCenter

属性

maintainProjectionCenter:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

如果为 true，则该组件将使其投影矩阵在其边框的中央保持居中。如果未在组件上定义投影矩阵，则会自动添加一个。

实现
public function get maintainProjectionCenter():Boolean
public function set maintainProjectionCenter(value:Boolean):void

maxHeight

属性

maxHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最大建议高度。此值采用组件坐标（以像素为单位）。此属性的默认值由组件开发人员设置。

组件开发人员使用此属性设置组件高度的上限。

如果应用程序开发人员覆盖 maxHeight 的默认值，则将在 explicitMaxHeight 中存储新值。不会更改 maxHeight 的默认值。因此，在布局过程中，如果应用程序开发人员明确设置了 maxHeight，则对组件最大建议高度使用 explicitMaxHeight 的值。如果用户未明确设置 maxHeight，则使用默认值。

默认值为 10000。

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMaxHeightChanged 事件。

实现
public function get maxHeight():Number
public function set maxHeight(value:Number):void

maxWidth

属性

maxWidth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

布局过程中父级要考虑的组件最大建议宽度。此值采用组件坐标（以像素为单位）。此属性的默认值由组件开发人员设置。

组件开发人员使用此属性设置组件宽度的上限。

如果应用程序开发人员覆盖 maxWidth 的默认值，则将在 explicitMaxWidth 中存储新值。不会更改 maxWidth 的默认值。因此，在布局过程中，如果应用程序开发人员明确设置了 maxWidth，则对组件最大建议宽度使用 explicitMaxWidth 的值。如果用户未明确设置 maxWidth，则使用默认值。

默认值为 10000。

此属性可用作数据绑定的源。修改此属性后，将调度 explicitMaxWidthChanged 事件。

实现
public function get maxWidth():Number
public function set maxWidth(value:Number):void

measuredHeight

属性

measuredHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

组件的默认高度（以像素为单位）。此值由 measure() 方法设置。

实现
public function get measuredHeight():Number
public function set measuredHeight(value:Number):void

measuredMinHeight

属性

measuredMinHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

组件的默认最小高度（以像素为单位）。此值由 measure() 方法设置。

实现
public function get measuredMinHeight():Number
public function set measuredMinHeight(value:Number):void

measuredMinWidth

属性

measuredMinWidth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

组件的默认最小宽度（以像素为单位）。此值由 measure() 方法设置。

属性

moduleFactory:IFlexModuleFactory

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

模块工厂用作上下文，用于为此组件使用嵌入字体以及查找用于控制此组件样式的样式管理器。

实现
public function get moduleFactory():IFlexModuleFactory
public function set moduleFactory(value:IFlexModuleFactory):void

mouseFocusEnabled

属性

mouseFocusEnabled:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

单击时是否可获得焦点。如果值为 false，则焦点将转换到已将 mouseFocusEnable 设置为 true 的第一个父项。例如，您可以将某个 Button 控件的此属性设置为 false，这样可使用 Tab 键将焦点移动到该控件，但在单击该控件时不会使其获得焦点。

对于大多数子类（除了 Spark TabBar），默认值为 true。对于 Spark TabBar，默认值为 false。

默认值为 true。

实现
public function get mouseFocusEnabled():Boolean
public function set mouseFocusEnabled(value:Boolean):void

nestLevel

属性

nestLevel:int

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此对象在所属关系层次结构中的深度。测量和布局代码都使用此编号。如果 DisplayList 中没有此组件，则值为 0。

实现
public function get nestLevel():int
public function set nestLevel(value:int):void

nonInheritingStyles

属性

nonInheritingStyles:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此组件的非继承样式链的开头内容。getStyle() 方法只需访问 nonInheritingStyles[styleName]，即可搜索整个与原型链接的链。此对象由 initProtoChain() 设置。开发人员通常不需要直接访问此属性。

实现
public function get nonInheritingStyles():Object
public function set nonInheritingStyles(value:Object):void

numAutomationChildren

属性

numAutomationChildren:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此容器包含的自动化子项数。此和不应包含任何复合子项，尽管它在自动化层次中确实包含这些不重要的子项。

实现
public function get numAutomationChildren():int

owner

属性

owner:DisplayObjectContainer

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此 IVisualElement 对象的所有者。默认情况下，它是此 IVisualElement 对象的父代。不过，如果此 IVisualElement 对象是由其父代弹出的一个子组件（如 ComboBox 控件的下拉列表），则所有者是弹出此 IVisualElement 对象的组件。

此属性并非由 Flex 管理，而由各个组件管理。因此，如果使用 PopUpManger.createPopUp() 或 PopUpManger.addPopUp() 方法弹出一个子组件，则应该将该子组件的 owner 属性设置为弹出它的组件。

属性

percentHeight:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

以组件父代大小百分比的方式指定组件高度。允许的值为 0-100。默认值为 NaN。设置 height 或 explicitHeight 属性会将此属性重置为 NaN。

仅当先前已设置此属性时，此属性才会返回数值；它不会以百分比形式反映组件的确切大小。

对于 UITextField 控件，此属性始终设置为 NaN。

在 Spark 布局中使用时，该属性用于计算组件在缩放和旋转之后的边界高度。例如，如果组件旋转 90 度，则指定 percentHeight 将影响组件宽度。

此属性可用作数据绑定的源。修改此属性后，将调度 resize 事件。

实现
public function get percentHeight():Number
public function set percentHeight(value:Number):void

percentWidth

属性

percentWidth:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

以组件父代大小百分比的方式指定组件宽度。允许的值为 0-100。默认值为 NaN。设置 width 或 explicitWidth 属性会将此属性重置为 NaN。

仅当先前已设置此属性时，此属性才会返回数值；它不会以百分比形式反映组件的确切大小。

对于 UITextField 控件，此属性始终设置为 NaN。

在 Spark 布局中使用时，该属性用于计算组件在缩放和旋转之后的边界宽度。例如，如果组件旋转 90 度，则指定 percentWidth 将影响组件高度。

此属性可用作数据绑定的源。修改此属性后，将调度 resize 事件。

实现
public function get percentWidth():Number
public function set percentWidth(value:Number):void

postLayoutTransformOffsets

属性

postLayoutTransformOffsets:mx.geom:TransformOffsets

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

定义能够应用于对象转换且在一定程度上对其父布局不可视的一组调整。

例如，如果希望某个布局为将旋转 90 度的某个对象进行调整，请设置该对象的 rotation 属性。如果不希望布局为要旋转的对象进行调整，请设置其 postLayoutTransformOffsets.rotationZ 属性。

实现
public function get postLayoutTransformOffsets():mx.geom:TransformOffsets
public function set postLayoutTransformOffsets(value:mx.geom:TransformOffsets):void

processedDescriptors

属性

processedDescriptors:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

临时或延迟子项创建操作后设置为 true，具体取决于发生对象。对于 Container 对象，在 createComponentsFromDescriptors() 方法结束（即 Container 对象使用其子项描述符创建子项）后，该属性设置为 true。

例如，如果 Accordion 容器使用延迟的实例化，则在用户导航到 Accordion 容器的第二个窗格并且该窗格创建其子项后，此窗格的 processedDescriptors 属性才变为 true。但是，如果 Accordion 已将 creationPolicy 属性设置为 "all"，则在应用程序启动期间此容器第二个窗格的 processedDescriptors 属性设置为 true。

非容器类都没有描述符，所以对于这些类，createChildren() 方法创建任何内部组件子项后，该属性设置为 true。

实现
public function get processedDescriptors():Boolean
public function set processedDescriptors(value:Boolean):void

repeater

属性

repeater:IRepeater [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对生成此 UIComponent 的父文档中 Repeater 对象的引用。如果 UIComponent 是由单个 Repeater 对象创建的，请使用此属性，而不要使用 repeaters 属性。如果此 UIComponent 是由嵌套 Repeater 对象创建的，请使用 repeaters 属性。

如果此 UIComponent 并非由 Repeater 创建，则该属性设置为 null。

实现
public function get repeater():IRepeater

repeaterIndex

属性

repeaterIndex:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。如果 UIComponent 是由单个 Repeater 对象创建的，请使用此属性，而不要使用 repeaterIndices 属性。如果此 UIComponent 是由嵌套 Repeater 对象创建的，请使用 repeaterIndices 属性。

如果此 UIComponent 并非由 Repeater 创建，则该属性设置为 -1。

实现
public function get repeaterIndex():int

repeaterIndices

属性

repeaterIndices:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个 Array，包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。除非此 UIComponent 位于一个或多个 Repeater 中，否则该 Array 为空。

Array 中的第一个元素与最外面的 Repeater 对应。例如，如果 repeaterIndices 为 [2,4]，则表示使用项目 dataProvider[2] 的外部 Repeater 和使用项目 dataProvider[4] 的内部 Repeater。

请注意，如果任一 Repeater 的 startingIndex 属性并非 0，则此属性将与 instanceIndices 属性不同。例如，即使 Repeater 从 dataProvider[4] 开始，第一个重复对象的文档引用也是 b[0]，而不是 b[4]。

实现
public function get repeaterIndices():Array
public function set repeaterIndices(value:Array):void

repeaters

属性

repeaters:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个 Array，包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。除非此 UIComponent 位于一个或多个 Repeater 中，否则该 Array 为空。第一个元素与最外面的 Repeater 对象对应。

实现
public function get repeaters():Array
public function set repeaters(value:Array):void

resourceManager

属性

resourceManager:IResourceManager [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对管理所有应用程序本地化资源的对象的引用。此项是 singleton 实例，实现 IResourceManager 接口。

此属性可用作数据绑定的源。修改此属性后，将调度 unused 事件。

实现
protected function get resourceManager():IResourceManager

right

属性

right:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对于组件，此布局约束属性是基于类似命名的样式的外观。要将属性设置为其默认值 undefined，请使用 MXML 中的 @Clear () 指令或 ActionScript 代码中的 undefined 值。例如，在 MXML 代码中，right.s2="@Clear()" 将取消对状态 s2 中 right 约束的设置。或者在 ActionScript 代码中，button.right = undefined 将取消对 button 中 right 约束的设置。

从组件的右边缘到锚点目标的右边缘的水平距离（以像素为单位）。

默认情况下，锚点目标是容器的内容区域。在具有高级约束的布局中，目标可以是一个约束列。

将属性设置为数字或数字字符串（如“10”）会指定使用默认锚点目标。

要指定锚点目标，请使用格式“anchorTargetName:value”将属性值设置为一个字符串，如“col1:10”。

实现
public function get right():Object
public function set right(value:Object):void

rotation

属性

rotation:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。例如，my_video.rotation = 450语句与 my_video.rotation = 90 是相同的。

实现
override public function get rotation():Number
override public function set rotation(value:Number):void

rotationX

属性

rotationX:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 10, AIR 1.5

表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。在计算过程中，Flex 的任一 2D 布局都会忽略此属性。

实现
override public function get rotationX():Number
override public function set rotationX(value:Number):void

rotationY

属性

rotationY:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。在计算过程中，Flex 的任一 2D 布局都会忽略此属性。

实现
override public function get rotationY():Number
override public function set rotationY(value:Number):void

rotationZ

属性

rotationZ:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。

实现
override public function get rotationZ():Number
override public function set rotationZ(value:Number):void

scaleX

属性

scaleX:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用于指定水平缩放系数的数字。

默认值为 1.0，即不缩放对象。将 scaleX 值设为 2.0 表示对象将放大 2 倍，将 scaleX 值设为 0.5 表示对象将缩小 2 倍。

值 0.0 是无效值。不要将它设置为 0.0，但可以设置为一个很小的值，或者将 visible 属性设置为 false 来隐藏此组件。

默认值为 1.0。

此属性可用作数据绑定的源。修改此属性后，将调度 scaleXChanged 事件。

实现
override public function get scaleX():Number
override public function set scaleX(value:Number):void

scaleY

属性

scaleY:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用于指定垂直缩放系数的数字。

默认值为 1.0，即不缩放对象。将 scaleY 值设为 2.0 表示对象将放大 2 倍，将 scaleY 值设为 0.5 表示对象将缩小 2 倍。

值 0.0 是无效值。不要将它设置为 0.0，但可以设置为一个很小的值，或者将 visible 属性设置为 false 来隐藏此组件。

默认值为 1.0。

此属性可用作数据绑定的源。修改此属性后，将调度 scaleYChanged 事件。

实现
override public function get scaleY():Number
override public function set scaleY(value:Number):void

scaleZ

属性

scaleZ:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定沿着 z 轴的缩放因子的数值。

沿着 z 轴缩放不会影响在 z=0 平面中保持平放的典型组件。对于具有已应用 3D 转换的子项的组件，或具有非零 transformZ 的组件，将受到影响。

默认值为 1.0，即不缩放对象。

在计算过程中，Flex 的任一 2D 布局都会忽略此属性。

默认值为 1.0。

此属性可用作数据绑定的源。修改此属性后，将调度 scaleZChanged 事件。

实现
override public function get scaleZ():Number
override public function set scaleZ(value:Number):void

screen

属性

screen:Rectangle [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回包含此对象的基本绘图表面大小和位置的对象。

实现
public function get screen():Rectangle

showInAutomationHierarchy

属性

showInAutomationHierarchy:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用于确定自动化对象是否显示在自动化层次中的标志。层次中不可见的容器的子项显示为下一个最高可见父项的子项。通常，用于布局的容器（如框和画布）不显示在层次中。

如果合适，某些控件强制其子项在层次中显示。例如，List 控件将始终强制项呈示器（包括框）显示在层次中。实现程序必须支持将此属性设置为 true。

实现
public function get showInAutomationHierarchy():Boolean
public function set showInAutomationHierarchy(value:Boolean):void

states

属性

states:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

为此组件定义的视图状态。您只能对应用程序的根或 MXML 组件的根标签指定 states 属性。如果对其他控件指定此属性，则编译器将生成错误。

实现
public function get states():Array
public function set states(value:Array):void

styleDeclaration

属性

styleDeclaration:CSSStyleDeclaration

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

存储此对象的内嵌继承样式。第一次调用该组件的 setStyle() 方法来设置继承样式时，将创建此 CSSStyleDeclaration。开发人员通常不需要直接访问此属性。

实现
public function get styleDeclaration():CSSStyleDeclaration
public function set styleDeclaration(value:CSSStyleDeclaration):void

styleManager

属性

styleManager:IStyleManager2 [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

返回此组件使用的 StyleManager 实例。

实现
public function get styleManager():IStyleManager2

styleName

属性

styleName:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此组件使用的类样式。它可以是 String、CSSStyleDeclaration 或 IStyleClient。

如果是 String，则它是 <fx:Style> 标签或 CSS 文件中一个或多个空格分隔类声明的名称。您不能在 styleName 中使用句号。例如，如果您使用名为 ".bigText" 的类样式，请将 styleName 属性设置为 "bigText"（无句号）。

如果是 IStyleClient（通常是 UIComponent），则此组件将使用 styleName 对象中的所有样式。

默认值为 null。

实现
public function get styleName():Object
public function set styleName(value:Object):void

styleParent

属性

styleParent:IAdvancedStyleClient

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

组件的父项用于评估后代选择器。父项也必须是要参加高级样式声明的 IAdvancedStyleClient。

实现
public function get styleParent():IAdvancedStyleClient
public function set styleParent(value:IAdvancedStyleClient):void

systemManager

属性

systemManager:ISystemManager

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回此组件使用的 SystemManager 对象。

实现
public function get systemManager():ISystemManager
public function set systemManager(value:ISystemManager):void

tabFocusEnabled

属性

tabFocusEnabled:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

一个标志，指示该对象是否能够通过 Tab 键获得焦点。

这与 Flash Player 使用的 tabEnabled 属性类似。

对于处理键盘输入的组件该标志通常为 true，但是控件栏中的一些组件将其设置为 false，因为它们不能像编辑器一样从另外的组件窃取焦点。

默认值为 true。

此属性可用作数据绑定的源。修改此属性后，将调度 tabFocusEnabledChange 事件。

实现
public function get tabFocusEnabled():Boolean
public function set tabFocusEnabled(value:Boolean):void

toolTip

属性

toolTip:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

要在 ToolTip 中显示的文本。

默认值为 null。

此属性可用作数据绑定的源。修改此属性后，将调度 toolTipChanged 事件。

实现
public function get toolTip():String
public function set toolTip(value:String):void

top

属性

top:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对于组件，此布局约束属性是基于类似命名的样式的外观。要将属性设置为其默认值 undefined，请使用 MXML 中的 @Clear () 指令或 ActionScript 代码中的 undefined 值。例如，在 MXML 代码中，top.s2="@Clear()" 将取消对状态 s2 中 top 约束的设置。或者在 ActionScript 代码中，button.top = undefined 将取消对 button 中 top 约束的设置。

从组件的上边缘到锚点目标的上边缘的垂直距离（以像素为单位）。

默认情况下，锚点目标是容器的内容区域。在具有高级约束的布局中，目标可以是一个约束行。

将属性设置为数字或数字字符串（如“10”）会指定使用默认锚点目标。

要指定锚点目标，请使用格式“anchorTargetName:value”将属性值设置为一个字符串，如“row1:10”。

实现
public function get top():Object
public function set top(value:Object):void

transform

属性

transform:flash.geom:Transform[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。在 Transform 类的条目中对特定属性 matrix、colorTransform 和三个只读属性（concatenatedMatrix、concatenatedColorTransform 和 pixelBounds）进行了说明。

transform 对象的每个属性本身都是一个对象。此概念很重要，因为设置 matrix 或 colorTransform 对象的新值的唯一方法是，创建新对象并将该对象复制到 transform.matrix 或 transform.colorTransform 属性。

例如，要增加显示对象矩阵的 tx 值，您必须创建整个矩阵对象的副本，然后将新对象复制到 transform 对象的 matrix 属性中：

      var myMatrix:Matrix = myUIComponentObject.transform.matrix;  
      myMatrix.tx += 10; 
      myUIComponent.transform.matrix = myMatrix;

不能直接设置 tx 属性。下面的代码对 myUIComponent 不起作用：

      myUIComponent.transform.matrix.tx += 10;

请注意，对于 UIComponent，与 DisplayObject 不同，transform 保持 matrix 和 matrix3D 值同步，因此即使在组件自身没有设置 3D 属性时 matrix3D 也不为 null。开发人员应使用 is3D 属性检查组件是否设置了 3D 属性。如果组件具有 3D 属性，则应使用 transform 的 matrix3D 而不使用 transform 的 matrix。

实现
override public function get transform():flash.geom:Transform
override public function set transform(value:flash.geom:Transform):void

transformX

属性

transformX:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

设置组件转换中心的 x 坐标。

当该组件为 Spark 转换效果的目标时，可以通过设置 AnimateTransform.autoCenterTransform 属性来覆盖该属性。如果 autoCenterTransform 为 false，则转换中心由效果目标的 transformX、transformY 和 transformZ 属性决定。如果 autoCenterTransform 为 true，则效果出现在目标中心 (width/2, height/2) 附近。

在 Spark 效果类上设置该属性会覆盖目标组件上的设置。

实现
public function get transformX():Number
public function set transformX(value:Number):void

transformY

属性

transformY:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

设置组件转换中心的 y 坐标。

在 Spark 效果类上设置该属性会覆盖目标组件上的设置。

实现
public function get transformY():Number
public function set transformY(value:Number):void

transformZ

属性

transformZ:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

设置组件转换中心的 z 坐标。

在 Spark 效果类上设置该属性会覆盖目标组件上的设置。

实现
public function get transformZ():Number
public function set transformZ(value:Number):void

transitions

属性

transitions:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个 Transition 对象 Array，其中的每个 Transition 对象都定义一组效果，用于在视图状态发生更改时播放。

实现
public function get transitions():Array
public function set transitions(value:Array):void

相关 API 元素

mx.states.Transition

tweeningProperties

属性

tweeningProperties:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当前在此对象上进行补间的属性数组。

用于警告 EffectManager 此对象的某些属性正在进行补间，因此 EffectManger 不能尝试对相同属性设置动画效果。

实现
public function get tweeningProperties():Array
public function set tweeningProperties(value:Array):void

uid

属性

uid:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对象的唯一标识符。Flex 数据驱动的控件（包括作为 List 类的子类的所有控件）使用 UID 跟踪数据提供程序项目。

Flex 可自动创建和管理 UID。但是，有时您必须通过实现 IUID 接口来提供自己的 uid 属性，或通过提供自己的 uid 属性来提高处理效率。对于 Flex 中的大多数用途，UID 不必是全局唯一标识符，通过数据服务发送消息除外。

实现
public function get uid():String
public function set uid(value:String):void

相关 API 元素

IUID
mx.utils.UIDUtil

unscaledHeight

属性

unscaledHeight:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用于确定组件的未缩放高度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成，还应将此高度作为参数传递到 updateDisplayList() 中。

实现
protected function get unscaledHeight():Number

unscaledWidth

属性

unscaledWidth:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用于确定组件的未缩放宽度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成，还应将此宽度作为参数传递到 updateDisplayList() 中。

实现
protected function get unscaledWidth():Number

updateCompletePendingFlag

属性

updateCompletePendingFlag:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个标志，确定某个对象是否已通过所有三个阶段的布局验证（假设需要通过所有验证）。

实现
public function get updateCompletePendingFlag():Boolean
public function set updateCompletePendingFlag(value:Boolean):void

validationSubField

属性

validationSubField:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

供验证程序用来将子字段与此组件相关联。

实现
public function get validationSubField():String
public function set validationSubField(value:String):void

verticalCenter

属性

verticalCenter:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对于组件，此布局约束属性是基于类似命名的样式的外观。要将属性设置为其默认值 undefined，请使用 MXML 中的 @Clear () 指令或 ActionScript 代码中的 undefined 值。例如，在 MXML 代码中，verticalCenter.s2="@Clear()" 将取消对状态 s2 中 verticalCenter 约束的设置。或者在 ActionScript 代码中，button.verticalCenter = undefined 将取消对 button 中 verticalCenter 约束的设置。

从组件中心到锚点目标的内容区域中心的垂直距离（以像素为单位）。

默认锚点目标是容器本身。

在具有高级约束的布局中，锚点目标可以是一个约束行。那么，内容区域就是前一行（或容器侧）与目标行之间的空间。

将属性设置为数字或数字字符串（如“10”）会指定使用默认锚点目标。

要指定锚点目标，请使用格式“constraintColumnId:value”将属性值设置为一个字符串，如“row1:10”。

实现
public function get verticalCenter():Object
public function set verticalCenter(value:Object):void

visible

属性

visible:Boolean[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

显示对象是否可见。不可见的显示对象已被禁用。例如，如果 InteractiveObject 实例的 visible=false，则无法单击该对象。

当设置为 true 时，此对象将调度 show 事件。当设置为 false 时，此对象将调度 hide 事件。无论在哪种情况下，对象的子项都不会生成 show 或 hide 事件，除非明确地针对该对象编写一个实现来执行此操作。

此属性可用作数据绑定的源。修改此属性后，将调度 show 事件。

实现
override public function get visible():Boolean
override public function set visible(value:Boolean):void

width

属性

width:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定组件在父坐标中的宽度的数字（以像素为单位）。默认值为 0，但当 Flex 在应用程序中设置完组件的大小后，此属性将包含实际的组件宽度。

请注意：您可以在 MXMLwidth 属性中指定一个百分比值（如 width="100%"），但无法在 ActionScript 的 width 属性中使用百分比值。可改用 percentWidth 属性。

设置此属性将导致 resize 事件被调度。有关何时调度此事件的详细信息，请参阅 resize 事件。

此属性可用作数据绑定的源。修改此属性后，将调度 widthChanged 事件。

实现
override public function get width():Number
override public function set width(value:Number):void

相关 API 元素

percentWidth

x

属性

x:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定组件在其父容器中的水平位置（以像素为单位）的数字。

如果组件的父级是布局容器（如 HBox、Grid 或 Form），则直接设置此属性或调用 move() 都不会有任何效果，或只有暂时的效果，因为这些容器的布局计算会将 x 位置设置为此计算结果。但当父级是 Canvas 或其他绝对定位容器时，则必须几乎始终设置 x 属性，因为这些容器的默认值为 0。

默认值为 0。

此属性可用作数据绑定的源。修改此属性后，将调度 xChanged 事件。

实现
override public function get x():Number
override public function set x(value:Number):void

y

属性

y:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定组件在其父容器中的垂直位置（以像素为单位）的数字。

默认值为 0。

此属性可用作数据绑定的源。修改此属性后，将调度 yChanged 事件。

实现
override public function get y():Number
override public function set y(value:Number):void

z

属性

z:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 10, AIR 1.5

表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。z 属性用于 3D 坐标，而不是屏幕坐标或像素坐标。

当您将显示对象的 z 属性设置为默认值 0 之外的其他值时，将自动创建一个相对应的 Matrix3D 对象，以便调整显示对象在三维中的位置和方向。在使用 z 轴时，x 和 y 属性的现有行为将从屏幕坐标或像素坐标更改为相对于 3D 父容器的位置。

例如，位于 x = 100、y = 100、z = 200 位置的 _root 的子级不在像素位置 (100,100) 处进行绘制。将在 3D 投影计算将其所置之处绘制该子级。计算方法为：

(x*cameraFocalLength/cameraRelativeZPosition, y*cameraFocalLength/cameraRelativeZPosition)

此属性可用作数据绑定的源。修改此属性后，将调度 zChanged 事件。

实现
override public function get z():Number
override public function set z(value:Number):void

构造函数详细信息

()

构造函数

public function UIComponent()

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

方法详细信息

addStyleClient

()

方法

public function addStyleClient(styleClient:IAdvancedStyleClient):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 9, AIR 1.1

将非可视样式客户端添加到该组件实例。调用此方法后，样式客户端将继承该组件实例的样式更改。为 DisplayObject 的样式客户端必须使用 addChild 或 addChildAt 方法，才能添加到 UIComponent 中。作为副作用，该方法会设置 styleClient 参数的 styleParent 属性引用 UIComponent 的该实例。如果 styleClient 参数已具有 styleParent，该方法会调用上一个 styleParent 中的 removeStyleClient。

参数

styleClient:IAdvancedStyleClient — 将添加到该组件的非可视样式客户端列表的 IAdvancedStyleClient。

引发

ArgumentError — 如果 styleClient 参数为 DisplayObject。

相关 API 元素

removeStyleClient
mx.styles.IAdvancedStyleClient

adjustFocusRect

()

方法

protected function adjustFocusRect(obj:DisplayObject = null):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

调整焦点矩形。

参数

obj:DisplayObject (default = null) — 要修改其焦点矩形的组件。如果省略，则默认值为此 UIComponent 对象。

applyComputedMatrix

()

方法

protected function applyComputedMatrix():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

提交计算的矩阵，该矩阵是基于布局矩阵以及 flash displayObject 的转换的转换偏移量而构建的。

attachOverlay

()

方法

protected function attachOverlay():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

这是一个内部方法，供 Flex 框架用于支持 Dissolve 效果。您不必调用或覆盖它。

callLater

()

方法

public function callLater(method:Function, args:Array = null):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

排队稍后调用的函数。

在每次更新屏幕之前，Flash Player 或 AIR 都会调用为更新预定的函数集。有时，应在下次更新时调用函数，以执行为当前更新预定的其余代码。部分功能（如效果）可能会延迟排队的函数，直到功能完成为止。

参数

	`method:Function` — 对稍后执行的方法的引用。

	`args:Array` (default = `null`) — 对象 Array，给出要传递给此方法的参数。

canSkipMeasurement

()

方法

protected function canSkipMeasurement():Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

确定是否可以跳过对 measure() 方法的调用。

Boolean — 当 measureSizes() 方法可以跳过对 measure() 方法的调用时，返回 true。例如，同时设置 explicitWidth 和 explicitHeight 时，它通常为 true。对于路径，当路径的界限未改变时，此为 true。

childrenCreated

()

方法

protected function childrenCreated():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

创建子对象后执行任何最终处理。此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。

clearStyle

()

方法

public function clearStyle(styleProp:String):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

删除此组件实例的样式属性。

此操作不一定会使 getStyle() 方法返回 undefined。

参数

styleProp:String — 样式属性的名称。

commitProperties

()

方法

protected function commitProperties():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

处理对组件设置的属性。此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。

您无需直接调用此方法。当您使用 addChild() 方法向容器中添加组件时，或调用组件的 invalidateProperties() 方法时，Flex 都会调用 commitProperties() 方法。应在调用 measure() 方法之前调用 commitProperties() 方法。这允许您设置 measure() 方法可能会用到的属性值。

一些组件的属性可能会影响需要创建的子对象的数目或种类，也有些组件的属性彼此之间会相互影响（例如 horizontalScrollPolicy 和 horizontalScrollPosition 属性）。通常，最好在启动时一次性处理所有这些属性以避免重复工作。

contentToGlobal

()

方法

public function contentToGlobal(point:Point):Point

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将 Point 对象从内容坐标转换为全局坐标。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。全局坐标指定的像素位置随舞台的左上角，即应用窗口的最外侧边缘而变化。

参数

point:Point — 一个 Point 对象，用于指定内容坐标系中的 x 和 y 坐标作为属性。

Point — 具有相对于舞台的坐标的 Point 对象。

相关 API 元素

globalToContent()

contentToLocal

()

方法

public function contentToLocal(point:Point):Point

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将 Point 对象由内容坐标转换为本地坐标。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。本地坐标指定的像素位置随组件的左上角而变化。

参数

point:Point — 一个 Point 对象，用于指定内容坐标系中的 x 和 y 坐标作为属性。

Point — Point，具有随本地坐标系而变化的坐标的 Point 对象。

相关 API 元素

contentToGlobal()

createAutomationIDPart

()

方法

public function createAutomationIDPart(child:IAutomationObject):Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回标识此容器中的子项的一组属性。在应用程序的生命期内，不应更改这些值。

参数

child:IAutomationObject — 为其提供 ID 的子项。

Object — 描述稍后可用于解析组件的子项的几组属性。

createAutomationIDPartWithRequiredProperties

()

方法

public function createAutomationIDPartWithRequiredProperties(child:IAutomationObject, properties:Array):Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

返回标识此容器中的子项的一组属性。在应用程序的生命期内，不应更改这些值。

参数

	`child:IAutomationObject` — 为其提供 ID 的子项。

	`properties:Array`

Object — 描述稍后可用于解析组件的子项的几组属性。

createChildren

()

方法

protected function createChildren():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

‏‏创建组件的子对象。此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。

可在自身内部创建其他组件或对象的组件称为组合组件。例如，Flex ComboBox 控件实际上包含一个 TextInput 控件（用于定义 ComboBox 的文本区域）和一个 Button 控件（用于定义 ComboBox 箭头）。组件实现 createChildren() 方法以在其内部创建子对象（如其他组件）。

在 createChildren() 方法的覆盖内部，您可以调用 addChild() 方法来添加各个子对象。

您无需直接调用此方法。Flex 会调用 createChildren() 方法来响应对 addChild() 方法的调用，用以将组件添加到其父项。

createInFontContext

()

方法

protected function createInFontContext(classObj:Class):Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

根据所用的嵌入字体使用上下文创建新对象。

此方法用于解决在将框架加载为 RSL（RSL 具有自己的 SWF 上下文）情况下，访问应用程序 SWF 中嵌入的字体问题。嵌入字体只能从创建它们的 SWF 文件上下文中访问。通过使用应用程序 SWF 上下文，RSL 可以在能够访问应用程序的嵌入字体的应用程序 SWF 上下文中创建对象。

仅当设置此对象的字体样式后才调用此方法。

参数

classObj:Class — 要创建的类。

Object — 在拥有嵌入字体的 SWF 上下文中创建的类实例。如果此对象不使用嵌入字体，则在此对象的上下文中创建类。

createInModuleContext

()

方法

protected function createInModuleContext(moduleFactory:IFlexModuleFactory, className:String):Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

使用给定的 moduleFactory 创建对象。如果 moduleFactory 为 null，或者无法使用模块工厂创建对象，则重用 systemManager 创建对象。

参数

	`moduleFactory:IFlexModuleFactory` — 在其中创建类的 moduleFactory；可以为 null。

	`className:String` — 要创建的类的名称。

Object — 在 moduleFactory 上下文中创建的对象。

createReferenceOnParentDocument

()

方法

public function createReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。此函数可以对一个或多个 repeater 中的象创建多维引用，如 b[2][4]。如果索引为 null，它将创建一个简单的非 Array 引用。

参数

parentDocument:IFlexDisplayObject — 此 IUIComponent 对象的父项。

deleteReferenceOnParentDocument

()

方法

public function deleteReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。此函数可以对一个或多个 Repeater 中的对象删除多维引用，如 b[2][4]。如果索引为 null，它将删除简单的非 Array 引用。

参数

parentDocument:IFlexDisplayObject — 此 IUIComponent 对象的父项。

determineTextFormatFromStyles

()

方法

public function determineTextFormatFromStyles():mx.core:UITextFormat

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。

mx.core:UITextFormat — 与此 UIComponent 的文本样式对应的 UITextFormat 对象。

dispatchEvent

()

方法

override public function dispatchEvent(event:Event):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将事件调度到事件流中。事件目标是对其调用 dispatchEvent() 方法的 EventDispatcher 对象。

参数

event:Event — 调度到事件流中的 Event 对象。如果正在重新调度事件，则会自动创建此事件的一个克隆。在调度了事件后，其 target 属性将无法更改，因此您必须创建此事件的一个新副本以能够重新调度。

Boolean — 如果成功调度了事件，则值为 true。值 false 表示失败或对事件调用了 preventDefault() 方法。

dispatchPropertyChangeEvent

()

方法

protected function dispatchPropertyChangeEvent(prop:String, oldValue:*, value:*):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

更新属性时调度 PropertyChangeEvent 的 Helper 方法。

参数

	`prop:String` — 已更改的属性的名称。

	`oldValue:*` — 属性的旧值。

	`value:*` — 属性的新值。

drawFocus

()

方法

public function drawFocus(isFocused:Boolean):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在此组件周围显示或隐藏焦点指示符。

UIComponent 通过创建由 focusSkin 样式指定的类实例并将其适当定位来实现此控制。

参数

isFocused:Boolean — 确定是否应显示焦点指示符。设置为 true 可以显示焦点指示符。设置为 false 可以隐藏焦点指示符。

drawRoundRect

()

方法

 public function drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

通过编程方式在此外观的 Graphics 对象中绘制一个矩形。

矩形可以有圆角。其边缘使用 Graphics 对象的当前线条样式。可以使用纯色填充、渐变填充或无填充。纯色填充可以使用 Alpha 透明度。渐变填充可以为线性渐变或放射状渐变。可在沿着渐变的指定点上至多指定 15 个颜色和 Alpha 值，可为渐变指定旋转角度和转换矩阵。最后，该矩形可具有从其上切去的圆角矩形洞。

该通用矩形绘制例程被很多外观所使用。该例程调用 drawRect() 或 drawRoundRect() 方法（在 flash.display.Graphics 类中）在此外观的 Graphics 对象中进行绘制。

参数

	`x:Number` — 此外观中矩形左上角的水平位置。

	`y:Number` — 此外观中矩形左上角的垂直位置。

	`w:Number` — 矩形的宽度（以像素为单位）。

	`h:Number` — 矩形的高度（以像素为单位）。

	`r:Object` (default = `null`) — 矩形的角半径。可以是 `null`、Number 或 Object。如果为 `null`，则表示该角应为方形而不是弧形。如果为 Number，则为所有四个角指定相同半径（以像素为单位）。如果为 Object，则应具有 `tl`、`tr`、`bl` 和 `br` 属性，这些属性值是用于指定左上角、右上角、左下角、右下角的半径的 Number（以像素为单位）。例如，您可以传递简单 Object，如 `{ tl: 5, tr: 5, bl: 0, br: 0 }`。默认值为 null（方形角）。

	`c:Object` (default = `null`) — 填充的 RGB 颜色。可以是 `null`、uint 或 Array。如果为 `null`，则不为矩形填充颜色。如果为 uint，则会指定一个 RGB 填充色。例如，传递 `0xFF0000` 可填充红色。如果为 Array，则应包含用于指定渐变颜色的 uint。例如，传递 `[ 0xFF0000, 0xFFFF00, 0x0000FF ]` 可填充红-黄-蓝渐变。在渐变中最多可以指定 15 种颜色。默认值为 null（无填充颜色）。

	`alpha:Object` (default = `null`) — 用于填充的 Alpha 值。可以是 null、Number 或 Array。如果 `color` 为空，则忽略此参数。如果 `color` 是用于指定 RGB 填充颜色的 uint，则 `alpha` 应该是用于指定填充透明度的 Number，其中 0.0 表示完全透明，1.0 表示完全不透明。在本例中，您还可以通过传递空值而不是 1.0 来指定完全不透明。如果 `color` 是用于指定渐变颜色的 Array，则 `alpha` 应该是长度相同的数字 Array，用于为渐变指定相应的 alpha 值。在本例中，默认值为 `null`（完全不透明）。

	`rot:Object` (default = `null`) — 用于渐变填充的 Matrix 对象。可使用实用程序方法 `horizontalGradientMatrix()`、`verticalGradientMatrix()` 和 `rotatedGradientMatrix()` 来创建此参数的值。

	`gradient:String` (default = `null`) — 渐变填充的类型。可能的值为 `GradientType.LINEAR` 或 `GradientType.RADIAL`。（GradientType 类位于 flash.display 包中。）

	`ratios:Array` (default = `null`) — 指定颜色的分布。条目数必须与在 `color` 参数中定义的颜色数匹配。各值均定义 100% 采样的颜色所在位置的宽度百分比。值 0 表示渐变框中的左侧位置，255 表示渐变框中的右侧位置。

	`hole:Object` (default = `null`) — 应从另一个实心填充的圆角矩形 { x: #, y: #, w: #, h: #, r: # 或 { br: #, bl: #, tl: #, tr: # } } 中央切去的圆角矩形洞

effectFinished

()

方法

public function effectFinished(effectInst:IEffectInstance):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

停止在组件上播放效果实例时，由效果实例调用。您可以使用此方法还原 effectStarted() 方法在开始播放效果时对组件所做的修改，或在效果结束时，执行一些其他操作。

参数

effectInst:IEffectInstance — 组件上正在播放的效果实例对象。

effectStarted

()

方法

public function effectStarted(effectInst:IEffectInstance):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

开始在组件上播放效果实例时，由效果实例调用。作为效果的一部分，您可以使用此方法来修改组件。在效果结束时，您可以使用 effectFinished() 方法还原修改。

参数

effectInst:IEffectInstance — 组件上正在播放的效果实例对象。

endEffectsStarted

()

方法

public function endEffectsStarted():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

结束组件上当前播放的所有效果。

executeBindings

()

方法

public function executeBindings(recurse:Boolean = false):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

执行 UIComponent 对象是目标的所有绑定。

参数

recurse:Boolean (default = false) — 以递归方式为此组件的子项执行绑定。

finishPrint

()

方法

public function finishPrint(obj:Object, target:IFlexDisplayObject):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

打印完成后调用。对于 UIComponent 类，此方法不执行任何操作。Flex 容器将覆盖此方法以在打印后还原容器。

此方法通常不适用于应用程序开发人员。

参数

	`obj:Object` — 包含组件的一些属性，用于将其还原到打印前的状态。

	`target:IFlexDisplayObject` — 刚刚完成打印的组件。该组件可能是当前组件，也可能是其中的一个子项。

相关 API 元素

mx.printing.FlexPrintJob

focusInHandler

()

方法

protected function focusInHandler(event:FocusEvent):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当 UIComponent 对象获得焦点时调用的事件处理函数。如果覆盖此方法，请确保调用基类版本。

参数

event:FocusEvent — 事件对象。

focusOutHandler

()

方法

protected function focusOutHandler(event:FocusEvent):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当 UIComponent 对象失去焦点时调用的事件处理函数。如果覆盖此方法，请确保调用基类版本。

参数

event:FocusEvent — 事件对象。

getAutomationChildAt

()

方法

public function getAutomationChildAt(index:int):IAutomationObject

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在指定的索引位置提供自动化对象。该列表不应包含任何复合子项。

参数

index:int — 要返回的子项的索引

IAutomationObject — 位于指定索引位置处的子项。

getAutomationChildren

()

方法

public function getAutomationChildren():Array

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

提供自动化对象列表。该列表不应包含任何复合子项。

Array — 子代。

getBoundsXAtSize

()

方法

public function getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

按指定的元素大小，返回元素边界的 x 坐标。

如果将元素大小调整为特定尺寸，则此方法通常在调用 measure() 方法期间由布局使用，以预测该元素将来的位置。

参数

	`width:Number` — 元素的界限宽度，或要使用首选宽度的 NaN。

	`height:Number` — 元素的界限高度，或要使用首选高度的 NaN。

	`postLayoutTransform:Boolean` (default = `true`) — 当 `postLayoutTransform` 为 true 时，该方法会返回元素边框左上角的 x 坐标。边框位于元素的父坐标空间中，并基于指定的边界大小、布局位置和布局转换矩阵进行计算。

Number — 按指定的元素大小，元素边界的 x 坐标。

getBoundsYAtSize

()

方法

public function getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

按指定的元素大小，返回元素边界的 y 坐标。如果将元素大小调整为特定尺寸，则此方法通常在调用 measure() 期间由布局使用，以预测该元素将来的位置。

参数

	`width:Number` — 元素的界限宽度，或要使用首选宽度的 NaN。

	`height:Number` — 元素的界限高度，或要使用首选高度的 NaN。

	`postLayoutTransform:Boolean` (default = `true`) — 当 `postLayoutTransform` 为 true 时，该方法会返回元素边框左上角的 y 坐标。边框位于元素的父坐标空间中，并基于指定的边界大小、布局位置和布局转换矩阵进行计算。

Number — 按指定的元素大小，元素边界的 y 坐标。

getClassStyleDeclarations

()

方法

public function getClassStyleDeclarations():Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

查找此 UIComponent 实例的类型选择器。算法沿 superclass 链进行。例如，假设 MyButton 类扩展了 Button。MyButton 实例将先查找 MyButton 类型选择器，然后查找 Button 类型选择器，接着查找 UIComponent 类型选择器。（我们认为 superclass 链截止到 UIComponent，而不是 Object。）

Array — 此 UIComponent 实例的类型选择器 Array。

getConstraintValue

()

方法

public function getConstraintValue(constraintName:String):*

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回一个约束布局值，这与获取此组件的约束样式的方式类似。

参数

constraintName:String — 约束样式的名称，可以是以下任意一个：left、right、top、bottom、verticalCenter、horizontalCenter、baseline

* — 返回布局约束值，可以用两种形式中的任意一种指定该值。可以将其指定为数值字符串，如 "10"，还可以将其指定为 "标识符:数值" 形式的字符串。对于 "标识符:数值" 字符串，标识符为 ConstraintRow 或 ConstraintColumn 的 id。例如，"cc1:10" 的值指定具有 id "cc1" 的 ConstraintColumn 的值为 10。

getExplicitOrMeasuredHeight

()

方法

public function getExplicitOrMeasuredHeight():Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

确定是使用显式高度还是测量高度的一种简便方法

Number — 一个 Number，在已定义的情况下是 explicitHeight，在未定义的情况下是 measuredHeight。

getExplicitOrMeasuredWidth

()

方法

public function getExplicitOrMeasuredWidth():Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

确定是使用显式宽度还是测量宽度的一种简便方法

Number — 一个 Number，在已定义的情况下是 explicitWidth，在未定义的情况下是 measuredWidth。

getFocus

()

方法

public function getFocus():InteractiveObject

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

获取当前具有焦点的对象。它可能并非此对象。请注意，此方法不一定返回具有焦点的组件。该实例可能返回组件中具有焦点的内部子组件。若要获取具有焦点的组件，请使用 focusManager.focus 属性。

InteractiveObject — 具有焦点的对象。

getLayoutBoundsHeight

()

方法

public function getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

返回元素的布局高度。这是元素在屏幕上进行绘制时所用的大小。

参数

postLayoutTransform:Boolean (default = true) — 当 postLayoutTransform 为 true 时，该方法会返回元素的边框宽度。边框位于元素的父坐标空间中，并基于元素的布局大小和布局转换矩阵进行计算。

Number — 元素的布局高度。

()

方法

public function getLayoutMatrix():Matrix

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

返回用于相对于其同级组件计算组件的布局的转换矩阵。

此矩阵通常由组件的 2D 属性（如 x、y、rotation、scaleX、scaleY、transformX 和 transformY）定义。某些组件可以具有其他转换属性，这些属性在布局矩阵的顶层上应用，以确定最终计算的矩阵。例如，UIComponent 可定义 offsets 属性。

Matrix — 此元素的布局转换 Matrix。不要直接修改返回值；请调用 setLayoutMatrix() 方法。

()

方法

public function getStyle(styleProp:String):*

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

获取已在此组件的样式查找链中的某个位置设置过的样式属性。

因为此方法同样可用于获取任何类型的样式属性，所以返回值可能是 Boolean、String、Number、int、uint（用于 RGB 颜色）、Class（用于外观）或任何类型的对象。因此，只需将返回类型指定为 *。

如果要获取特定的样式属性，您需要了解其类型，而且通常希望将结果存储在该类型的某个变量中。无需将 * 转换为该类型。

var backgroundColor:uint = getStyle("backgroundColor");

如果在样式查找链中的任何位置都未设置样式属性，则 getStyle() 的返回值为 undefined。请注意，undefined 是一个特殊值，它与 false、""、NaN、0 或 null 均不同。如果没有有效的样式值，则总是 undefined。可以使用方法 IStyleManager2.isValidStyleValue() 来测试是否设置了值。

参数

styleProp:String — 样式属性的名称。

* — 样式值。

globalToContent

()

方法

public function globalToContent(point:Point):Point

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将 Point 对象由全局坐标转换为内容坐标。全局坐标指定的像素位置随舞台的左上角，即应用窗口的最外侧边缘而变化。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。

参数

point:Point — 一个 Point 对象，用于指定全局 (Stage) 坐标系中的 x 和 y 坐标作为属性。

Point — Point，具有随组件而变化的坐标的 Point 对象。

相关 API 元素

contentToGlobal()

hasCSSState

()

方法

public function hasCSSState():Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4.6

运行时版本:

Flash Player 10, AIR 2.5

如果 currentCSSState 不为 null，则返回 true。通常，您无需直接调用此方法。而是由 mx.styles.CSSCondition.matchesStyleClient() 方法进行调用。

请注意，Spark 组件将其外观状态用作伪状态。Halo 组件使用 currentState 属性。

Boolean — 如果 currentCSSState 不为 null，则返回 true。默认情况下，currentCSSState 与 currentState 相同。如果状态不存在，则返回 false。

hasState

()

方法

public function hasState(stateName:String):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

确定是否已在此 UIComponent 上定义指定的状态。

参数

stateName:String — 正在检查的状态的名称。

Boolean — 是否已定义指定的状态

horizontalGradientMatrix

()

方法

public function horizontalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回一个框 Matrix，在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。

由于性能原因，该 Matrix 存储在一个静态变量中，通过调用 horizontalGradientMatrix() 和 verticalGradientMatrix() 可以重复使用此变量。因此，您应该在再次调用 horizontalGradientMatrix() 或 verticalGradientMatrix() 之前将生成的 Matrix 传递给 drawRoundRect()。

参数

	`x:Number` — 渐变的左坐标（以像素为单位）。

	`y:Number` — 渐变的顶坐标（以像素为单位）。

	`width:Number` — 渐变的宽度（以像素为单位）。

	`height:Number` — 渐变的高度（以像素为单位）。

Matrix — 水平渐变的 Matrix。

initAdvancedLayoutFeatures

()

方法

protected function initAdvancedLayoutFeatures():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

对于组件的某些不常使用的高级布局功能，初始化其实现和存储。在尝试使用 AdvancedLayoutFeatures 对象实现的任何功能之前调用此函数。

initializationComplete

()

方法

protected function initializationComplete():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

完成对此组件的初始化。

此方法是您首次使用 addChild() 或 addChildAt() 向父项添加组件时所需执行的最后一段代码。它可处理一些与调度 initialize 事件相关的辅助工作。如果您正在编写组件，则无需覆盖此方法。

initialize

()

方法

public function initialize():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

初始化此组件的内部结构。

初始化 UIComponent 是创建可视组件实例这一过程中的第四个步骤，首次将实例添加到父项时会自动执行此步骤。因此，您一般无需调用 initialize()；Flex 框架会从 UIComponent 的 addChild() 和 addChildAt() 方法的覆盖中为您调用它。

创建可视化组件实例过程中的第一个步骤是使用 new 运算符进行构建：

      var okButton:Button = new Button();

构建完成后，新的 Button 实例是一个孤立 DisplayObject；该实例尚不包含用于显示其标签的作为子项的 UITextField，也没有父项。

第二个步骤是为新构建的实例配置适当的属性、样式和事件处理程序：

      okButton.label = "OK";
      okButton.setStyle("cornerRadius", 0);
      okButton.addEventListener(MouseEvent.CLICK, clickHandler);

第三个步骤是将该实例添加到父项：

      someContainer.addChild(okButton);

首次将组件添加到父项时，调用 addChild() 或 addChildAt() 会导致自动调用 initialize。

此方法首先调度 preinitialize 事件，这使利用此组件的开发人员可在创建该组件的内部结构之前改造它。接着，它会调用 createChildren() 方法来创建组件的内部结构；对于 Button，此方法将为标签创建并添加 UITextField。然后，它会调度 initialize 事件，这使开发人员可在创建组件的内部结构之后改造它。

请注意，是首次向父项附加组件的操作触发了对组件内部结构的创建。如果组件的内部结构中包含其他 UIComponent，这就是一个递归过程。在此过程中，DisplayObjects 树以每次一个叶节点的速度增长。

如果您正在编写组件，则无需覆盖此方法。

initializeAccessibility

()

方法

protected function initializeAccessibility():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

初始化此组件的辅助功能代码。

此方法由 initialize() 方法调用，用于与组件的辅助功能代码挂钩，这些代码位于 mx.accessibility 包中的单独类中。因为挂钩过程在每个子类中使用不同的静态变量，所以支持辅助功能的每个子类都必须覆盖此方法。

initializeRepeaterArrays

()

方法

public function initializeRepeaterArrays(parent:IRepeaterClient):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

初始化用于跟踪此组件的重复实例的各个属性。

MXML<mx:Repeater/> 标记可能会导致创建组件的重复实例（Repeater 数据提供程序中的每个项目一个实例）。UIComponent 的 instanceIndices、repeaters 和 repeaterIndices 属性跟踪各实例来自哪个数据项目和哪个 Repeater。

此方法是内部方法，由 Flex 框架自动调用。您不必调用或覆盖它。

参数

parent:IRepeaterClient — 包含用于创建此组件的 Repeater 的父对象。

invalidateDisplayList

()

方法

public function invalidateDisplayList():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

标记组件，以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。

Invalidation 是一个很有用的机制，可将组件更改延迟到稍后屏幕更新时进行处理，从而消除了重复的工作。例如，要更改宽度和高度，如果在更改宽度后立即更新组件，然后在设置新高度后再次更新组件，就有些浪费。更改两个属性后再使用新的大小一次性呈示组件，效率会更高。

很少调用 Invalidation 方法。通常，在组件上设置属性会自动调用合适的 invalidation 方法。

invalidateLayering

()

方法

public function invalidateLayering():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.4

由某个组件的项目进行调用，以指示其 depth 属性已更改。请注意，在 UIComponent 上定义此函数时，实现对复杂分层的支持取决于子类。默认情况下，只有 Group 和 DataGroup 支持其子项的任意分层。

相关 API 元素

深度

invalidateLayoutDirection

()

方法

public function invalidateLayoutDirection():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

()

方法

protected function isOurFocus(target:DisplayObject):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

通常由包含 UITextField 对象的组件覆盖，其中 UITextField 对象获取焦点。

参数

target:DisplayObject — 包含可以获得焦点的 UITextField 对象的 UIComponent 对象。

Boolean — 如果 UITextField 对象具有焦点，则返回 true。

keyDownHandler

()

方法

protected function keyDownHandler(event:KeyboardEvent):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

为 keyDown 事件调用的事件处理函数。如果覆盖此方法，请确保调用基类版本。

参数

event:KeyboardEvent — 事件对象。

keyUpHandler

()

方法

protected function keyUpHandler(event:KeyboardEvent):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

为 keyUp 事件调用的事件处理函数。如果覆盖此方法，请确保调用基类版本。

参数

event:KeyboardEvent — 事件对象。

localToContent

()

方法

public function localToContent(point:Point):Point

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将 Point 对象由本地坐标转换为内容坐标。本地坐标指定的像素位置随组件的左上角而变化。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。

参数

point:Point — 一个 Point 对象，用于指定本地坐标系中的 x 和 y 坐标作为属性。

Point — Point，具有随内容坐标系而变化的坐标的 Point 对象。

相关 API 元素

contentToLocal()

matchesCSSState

()

方法

public function matchesCSSState(cssState:String):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果 cssState 与 currentCSSState 匹配，则返回 true。通常，您无需直接调用此方法。而是由 mx.styles.CSSCondition.matchesStyleClient() 方法进行调用。

请注意，Spark 组件将其外观状态用作伪状态。Halo 组件使用 currentState 属性。

参数

cssState:String — CSSCondition.value 的可能值。该值表示此组件用于与 CSS 伪选择器匹配的当前状态。

Boolean — 如果 cssState 与 currentCSSState 匹配，则返回 true。默认情况下，currentCSSState 与 currentState 相同。如果不存在任何状态，则返回 null。

matchesCSSType

()

方法

public function matchesCSSType(cssType:String):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

确定此实例与给定类型相同，还是属于给定类型的子类。通常，您无需直接调用此方法。而是由 mx.styles.CSSCondition.matchesStyleClient() 方法进行调用。

参数

cssType:String — 一个 CSSSelector 对象。

Boolean — 如果 cssType 位于限定的类型选择器的层次结构中，则为 true。

measure

()

方法

protected function measure():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

计算组件的默认大小和（可选）默认最小大小。此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。

您无需直接调用此方法。使用 addChild() 方法将组件添加到某个容器时，以及调用组件的 invalidateSize() 方法时，Flex 将调用 measure() 方法。

当设置组件的特定高度和宽度时，Flex 不会调用 measure() 方法，即使您显式调用 invalidateSize() 方法也不例外。也就是说，仅当组件的 explicitWidth 属性或 explicitHeight 属性设置为 NaN 时，Flex 才调用 measure() 方法。

覆盖此方法时，必须设置 measuredWidth 和 measuredHeight 属性以定义默认大小。您可以选择设置 measuredMinWidth 和 measuredMinHeight 属性来定义默认的最小大小。

大多数组件都会根据其显示内容以及影响内容显示的属性来计算这些值。一少部分组件只有硬编码的默认值。

measure() 的概念点供组件提供其原始或固有大小作为默认值。因此，measuredWidth 和 measuredHeight 属性应由以下几个因素确定：

组件需要显示的文本量。
文本的样式，如 fontSize。
组件所显示的 JPEG 图像的大小。
组件子项的测量大小或显式大小。
任何边框、边距和间隙。

某些情况下，确定默认值的方式并不固定。例如，对于一个简单的 GreenCircle 组件，可能只需在其 measure() 方法中设置 measuredWidth = 100 和 measuredHeight = 100 便可提供合理的默认大小。而在其他情况下（例如 TextArea），相应计算（例如查找合适的宽度和高度，使其刚好适合显示所有文本并拥有黄金矩形的高宽比）所耗费的时间可能会过长。

measure() 的默认实现将 measuredWidth、measuredHeight、measuredMinWidth 和 measuredMinHeight 设置为 0。

measureHTMLText

()

方法

public function measureHTMLText(htmlText:String):flash.text:TextLineMetrics

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

测量指定的 HTML 文本（该文本中可能包含 <font> 和 <b> 等 HTML 标记），假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。

参数

htmlText:String — 指定要测量的 HTML 文本的 String。

flash.text:TextLineMetrics — 包含文本度量值的 TextLineMetrics 对象。

measureText

()

方法

public function measureText(text:String):flash.text:TextLineMetrics

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

测量指定的文本，假定该文本使用由此 UIComponent 的样式确定的 UITextFormat 显示在单行 UITextField（或 UIFTETextField）中。该方法对于 Spark 组件无效，因为这些组件不使用 UITextField（或 UIFTETextField）。要测量 Spark 组件中的文本，请获取 spark.components.Label 或 spark.components.RichText 的度量。

参数

text:String — 指定要测量的文本的 String。

flash.text:TextLineMetrics — 包含文本度量值的 TextLineMetrics 对象。

move

()

方法

public function move(x:Number, y:Number):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将组件移动到其父项内的指定位置。调用此方法的效果与设置组件的 x 和 y 属性完全相同。

如果您正在覆盖自定义组件中的 updateDisplayList() 方法，则应调用 move() 方法，而不是设置 x 和 y 属性。二者的区别在于：调用 move() 方法可更改组件的位置，并在调用此方法时调度 move 事件；而设置 x 和 y 属性也会更改组件的位置，但要在下次刷新屏幕时才调度此事件。

参数

	`x:Number` — 组件在其父项内的左侧位置。

	`y:Number` — 组件在其父项内的顶部位置。

notifyStyleChangeInChildren

()

方法

public function notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将样式更改传播到子项。您通常无需调用此方法。

参数

	`styleProp:String` — String，指定样式属性的名称。

	`recursive:Boolean` — 递归通知该组件的所有子项。

owns

()

方法

public function owns(child:DisplayObject):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果 owner 属性链从 child 指向此 UIComponent，则返回 true。

参数

child:DisplayObject — 一个 UIComponent。

Boolean — 如果子项以此 UIComponent 为父项或归其所有，则为 true。

parentChanged

()

方法

public function parentChanged(p:DisplayObjectContainer):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当在父项中添加或删除 UIComponent 对象时由 Flex 调用。开发人员通常无需调用此方法。

参数

p:DisplayObjectContainer — 此 UIComponent 对象的父项。

prepareToPrint

()

方法

public function prepareToPrint(target:IFlexDisplayObject):Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

准备 IFlexDisplayObject 用于打印。对于 UIComponent 类，此方法不执行任何操作。Flex 容器将覆盖此方法，为打印做准备；例如，从打印的输出内容中删除滚动条。

此方法通常不适用于应用程序开发人员。

参数

target:IFlexDisplayObject — 要打印的组件。该组件可能是当前组件，也可能是其中的一个子项。

Object — 包含当前组件的属性的对象，finishPrint() 方法需要使用这些属性将此组件还原为其先前的状态。

相关 API 元素

mx.printing.FlexPrintJob

regenerateStyleCache

()

方法

public function regenerateStyleCache(recursive:Boolean):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

为此组件构建或重新构建 CSS 样式缓存；如果 recursive 参数为 true，还会为此组件的所有后代执行同样的操作。

在下列情形中，Flex 框架将调用此方法：

使用 addChild() 或 addChildAt() 方法将 UIComponent 添加到父项时。
更改 UIComponent 的 styleName 属性时。
使用 CSSStyleDeclaration 的 setStyle() 方法设置 CSS 选择器中的样式时。

由于构建样式缓存涉及到复杂的计算，因此除非必要，应避免更改 styleName 或设置选择器样式。

通过调用 UIComponent 的 setStyle() 方法来设置实例样式时，不会调用此方法。与设置选择器样式相比，设置实例样式的速度较快。

您无需调用或覆盖此方法。

参数

recursive:Boolean — 以递归方式为此组件的所有子组件重新生成样式缓存。

registerEffects

()

方法

public function registerEffects(effects:Array):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

针对每个效果事件，将 EffectManager 注册为一个事件侦听器。您通常无需调用此方法。

参数

effects:Array — 效果事件的名称。

removeStyleClient

()

方法

public function removeStyleClient(styleClient:IAdvancedStyleClient):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 9, AIR 1.1

从该组件实例删除非可视样式客户端。调用此方法后，非可视样式客户端将不再继承该组件实例的样式更改。作为副作用，该方法将 styleClient 参数的 styleParent 属性设置为 null。如果 styleClient 未添加到该组件实例，将不会执行操作。

参数

styleClient:IAdvancedStyleClient — 将从该组件的非可视样式客户端列表删除的 IAdvancedStyleClient。

相关 API 元素

addStyleClient
mx.styles.IAdvancedStyleClient

replayAutomatableEvent

()

方法

public function replayAutomatableEvent(event:Event):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

重放指定的事件。如果已在 superclass 中定义默认重放行为，组件作者可能应调用 super.replayAutomatableEvent。

参数

event:Event — 要重放的事件。

Boolean — 如果重放成功，则为 true。

resolveAutomationIDPart

()

方法

public function resolveAutomationIDPart(criteria:Object):Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

使用提供的 ID 解析子项。ID 是 createAutomationIDPart() 方法提供的一组属性。

参数

criteria:Object — 描述子项的几组属性。条件可以包含能导致多个子项匹配的常规表达式值。

Array — 符合条件的子项的数组；如果可以解析所有子项，则为 null。

resourcesChanged

()

方法

protected function resourcesChanged():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构建 UIComponent 时将调用此方法，并且每当 ResourceManager 调度 "change" 事件用于指示本地化资源已经过某种更改时，都会再次调用此方法。

在下列情形中调度此事件：设置 ResourceManager 的 localeChain 属性时，资源模块完成加载时，以及调用 ResourceManager 的 update() 方法时。

子类应覆盖此方法，并在调用 super.resourcesChanged() 后，执行任何适当的操作以响应新资源值。

resumeBackgroundProcessing

()

方法

public static function resumeBackgroundProcessing():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。

有关详细信息，请参阅对 suspendBackgroundProcessing() 的描述。

setActualSize

()

方法

public function setActualSize(w:Number, h:Number):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

调整对象大小。调用 setActualSize() 方法并不设置 explictWidth 和 explicitHeight 属性，因此，将来进行布局计算时可能会导致对象还原为先前的大小。这一点与直接设置 width 和 height 属性不同。此方法主要适用于实现 updateDisplayList() 方法的组件开发人员、Effects 以及 LayoutManager。

参数

	`w:Number` — 对象的宽度。

	`h:Number` — 对象的高度。

setConstraintValue

()

方法

public function setConstraintValue(constraintName:String, value:*):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

设置一个布局约束值的方式，与设置此组件的约束样式的方式相同。

参数

	`constraintName:String` — 约束样式的名称，可以是以下任意一个：left、right、top、bottom、verticalCenter、horizontalCenter、baseline

	`value:*` — 可以使用以下两种格式之一指定约束值。可以将其指定为数值字符串，如 "10"，还可以将其指定为 "标识符:数值" 形式的字符串。对于 "标识符:数值" 字符串，标识符为 ConstraintRow 或 ConstraintColumn 的 `id`。例如，"cc1:10" 的值指定具有 `id` "cc1" 的 ConstraintColumn 的值为 10。

setCurrentState

()

方法

public function setCurrentState(stateName:String, playTransition:Boolean = true):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

设置当前状态。

参数

	`stateName:String` — 新视图状态的名称。

	`playTransition:Boolean` (default = `true`) — 如果为 `true`，则在视图状态更改时播放相应的转换。

相关 API 元素

currentState

setFocus

()

方法

public function setFocus():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

设置此组件的焦点。组件可能依次将焦点传递给子组件。

注意：使用此方法设置焦点时，只有 TextInput 和 TextArea 控件加亮显示。当用户按 Tab 键切换控件时，所有控件都加亮显示。

setLayoutBoundsPosition

()

方法

public function setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

设置元素在屏幕上进行绘制时所用的坐标。

请注意，调用 setLayoutBoundSize() 方法会影响布局位置，因此请在调用 setLayoutBoundSize() 之后再调用 setLayoutBoundPosition()。

参数

	`x:Number` — 边框左上角的 X 坐标。

	`y:Number` — 边框左上角的 Y 坐标。

	`postLayoutTransform:Boolean` (default = `true`) — 当 `postLayoutTransform` 为 `true` 时，元素的定位方式为：其边框的左上角为 (x, y)。边框位于元素的父坐标空间中，并基于元素的布局大小、布局位置和布局转换矩阵进行计算。

setLayoutBoundsSize

()

方法

public function setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

设置元素的布局大小。这是元素在屏幕上进行绘制时所用的大小。

如果 width 和/或 height 参数尚未指定 (NaN)，则 Flex 会将该元素的布局大小设置为首选宽度和/或首选高度。

请注意，调用 setLayoutBoundSize() 方法会影响布局位置，因此请在调用 setLayoutBoundSize() 之后再调用 setLayoutBoundPosition()。

参数

	`width:Number` — 元素的布局宽度。

	`height:Number` — 元素的布局高度。

	`postLayoutTransform:Boolean` (default = `true`) — 如果 `postLayoutTransform` 为 true，则指定的大小就是元素的边框的大小。边框位于元素的父坐标空间中，并基于元素的布局大小、布局位置和布局转换矩阵进行计算。

setLayoutMatrix

()

方法

public function setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。

请注意，在父坐标中计算时，布局 Matrix 是在 getPreferredSize()、getMinSize()、getMaxSize()、getLayoutSize() 方法中进行分解的；在父坐标和子坐标中计算时，布局 Matrix 是在 getLayoutPosition() 中进行分解的。计算转换矩阵的布局通常会显式调用此方法，并使用子坐标中的大小。调用此方法的布局会将 false 传递给 invalidateLayout() 方法，这样不会触发后续的布局传递。

参数

	`value:Matrix` — 矩阵。

	`invalidateLayout:Boolean` — 设置为 `true`，将使父容器重新布局其子代。通常情况下，会将 `true` 传递给 `invalidateLayout()` 方法。

setLayoutMatrix3D

()

方法

public function setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。

请注意，在父坐标中计算时，布局 Matrix3D 是在 getPreferredSize()、getMinSize()、getMaxSize()、getLayoutSize() 中进行分解的；在父坐标和子坐标中计算时，布局 Matrix3D 是在 getLayoutPosition() 中进行分解的。计算转换矩阵的布局通常会显式调用此方法，并使用子坐标中的大小。调用此方法的布局会将 false 传递给 invalidateLayout() 方法，这样不会触发后续的布局传递。

参数

	`value:Matrix3D` — 矩阵。

	`invalidateLayout:Boolean` — 设置为 `true`，将使父容器重新布局其子代。通常情况下，会将 `true` 传递给 `invalidateLayout()` 方法。

setStretchXY

()

方法

protected function setStretchXY(stretchX:Number, stretchY:Number):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

在水平方向和垂直方向上，指定转换拉伸因子。在进行任何其他转换之前，将拉伸因子应用到计算的矩阵。

参数

	`stretchX:Number` — 拉伸因子的水平组件。

	`stretchY:Number` — 拉伸因子的垂直组件。

setStyle

()

方法

public function setStyle(styleProp:String, newValue:*):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对此组件实例设置样式属性。

此方法可能会覆盖以全局方式设置的样式。

调用 setStyle() 方法会降低性能。仅在必要时才使用它。

参数

	`styleProp:String` — 样式属性的名称。

	`newValue:*` — 样式的新值。

setVisible

()

方法

public function setVisible(value:Boolean, noEvent:Boolean = false):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当 visible 属性发生更改时调用。请设置 visible 属性来显示或隐藏组件，而不是直接调用此方法。

参数

	`value:Boolean` — `visible` 属性的新值。指定 `true` 可显示组件，指定 `false` 可隐藏组件。

	`noEvent:Boolean` (default = `false`) — 如果为 `true`，则不调度事件。如果为 `false`，则当组件变为可见时调度 `show` 事件，当组件变为不可见时调度 `hide` 事件。

stateChanged

()

方法

protected function stateChanged(oldState:String, newState:String, recursive:Boolean):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

当状态改变以检查状态特定的样式是否应用到此组件时，会调用此方法。如果有机会为当前状态匹配 CSS 伪选择器，则需要为此实例重新生成样式缓存，并且，如果将 recursive 参数设置为 true，则可能需要为所有子项重新生成样式缓存。

参数

	`oldState:String` — 旧状态的名称。

	`newState:String` — 新状态的名称。

	`recursive:Boolean` — 设置为 `true`，以执行递归检查。

styleChanged

()

方法

public function styleChanged(styleProp:String):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

检测对样式属性的更改。设置任何样式属性后，Flex 将调用 styleChanged() 方法，向其传递所设置样式的名称。

此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。创建自定义组件时，可以覆盖 styleChanged() 方法，以检查传递给它的样式名称，并对更改进行相应处理。这允许您覆盖现有样式的默认行为或添加自己的自定义样式属性。

如果您处理样式属性，覆盖 styleChanged() 方法时应调用 invalidateDisplayList() 方法，以使 Flex 在下次更新屏幕时执行组件的 updateDisplayList() 方法。

参数

styleProp:String — 样式属性的名称；如果此组件的所有样式均已更改，则为 null。

stylesInitialized

()

方法

public function stylesInitialized():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。

此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。Flex 可以保证在首次调用组件的 measure 和 updateDisplayList 方法之前充分初始化组件的样式。对于大多数组件而言，这就足够了。但是，如果您需要早些访问样式值，则可以覆盖 stylesInitialized() 函数，以在首次初始化样式属性后立即访问这些属性。

suspendBackgroundProcessing

()

方法

public static function suspendBackgroundProcessing():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

阻止对使用 callLater() 排队的方法进行背景处理，直到调用 resumeBackgroundProcessing() 为止。

如果您使用需要无中断地执行的严格时间要求代码，这些方法可能非常有用。例如，如果将 Effect 的 suspendBackgroundProcessing 属性设置为 true，则会在开始播放效果时自动调用 suspendBackgroundProcessing()，并在停止播放时调用 resumeBackgroundProcessing 以确保动画流畅。

LayoutManager 使用 callLater()，这意味着在调用 suspendBackgroundProcessing() 和 resumeBackgroundProcessing() 期间不会调用 commitProperties()、measure() 和 updateDisplayList()。

无论对外部方法还是内部方法（即外部方法调用的方法）而言，调用 suspendBackgroundProcessing() 和 resumeBackgroundProcessing() 都很安全，因为这些方法实际上会增加或减少用于确定是否处理背景的计数。

transformAround

()

方法

 public function transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

用于更新转换的旋转、缩放和平移的一种实用程序方法，同时保留某个特定点，该点是在组件自己的坐标空间中指定的，且在父项的坐标空间中是固定的。此函数将指定提供的旋转值、缩放值和平移值，然后根据需要更新 x/y/z 属性以保持转换中心固定。

参数

	`transformCenter:Vector3D` — 在组件自己的坐标中用于相对于其父项保持固定的点。

	`scale:Vector3D` (default = `null`) — 转换的缩放的新值。

	`rotation:Vector3D` (default = `null`) — 转换的旋转的新值

	`translation:Vector3D` (default = `null`) — 转换的平移的新值。

	`postLayoutScale:Vector3D` (default = `null`) — 转换的布局后缩放的新值。

	`postLayoutRotation:Vector3D` (default = `null`) — 转换的布局后旋转的新值。

	`postLayoutTranslation:Vector3D` (default = `null`) — 转换的布局后平移的新值。

	`invalidateLayout:Boolean` (default = `true`) — 如果为 `true`，则父容器的大小和显示将无效。调用此方法的布局会传递 `false`，这样不会触发后续的布局传递。

transformPointToParent

()

方法

public function transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

一种实用程序方法，用于将以该对象的本地坐标指定的点转换为在该对象父坐标中的相应位置。如果 position 和 postLayoutPosition 参数为非 null，将对这两个参数设置布局前和布局后结果。

参数

	`localPosition:Vector3D` — 将要转换的点，指定为对象的本地坐标。

	`position:Vector3D` — 保存布局前结果的 Vector3D 点。如果为 null，则忽略该参数。

	`postLayoutPosition:Vector3D` — 保存布局后结果的 Vector3D 点。如果为 null，则忽略该参数。

updateDisplayList

()

方法

protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

绘制对象和/或设置其子项的大小和位置。此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。

您无需直接调用此方法。使用 addChild() 方法将组件添加到容器时，以及调用组件的 invalidateDisplayList() 方法时，Flex 将调用 updateDisplayList() 方法。

如果组件没有子项，您就可以借助此方法使用针对组件的 Graphics 对象（如 graphics.drawRect()）上的一些方法以编程方式进行绘制。

如果组件有子项，您就可以借助此方法调用其子项上的 move() 和 setActualSize() 方法。

组件可以通过编程方式进行绘制，即使组件有子项时也不例外。在上述任一操作中，您都应使用组件的 unscaledWidth 和 unscaledHeight 作为其边界。

请注意，您应使用 unscaledWidth 和 unscaledHeight 属性而不是 width 和 height 属性，这很重要。

参数

	`unscaledWidth:Number` — 指定组件在组件坐标中的宽度（以像素为单位），而不考虑该组件的 `scaleX` 属性值。

	`unscaledHeight:Number` — 指定组件在组件坐标中的高度（以像素为单位），而不考虑该组件的 `scaleY` 属性值。

validateDisplayList

()

方法

public function validateDisplayList():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

验证子项的位置和大小，并绘制其他可视内容。如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateDisplayList() 方法，则当更新显示列表时会调用 validateDisplayList() 方法。

validateNow

()

方法

public function validateNow():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

验证并更新此对象的属性和布局，如果需要的话重绘对象。通常只有当脚本执行完毕后，才会处理要求进行大量计算的处理属性。例如，对 width 属性的设置可能会延迟，因为此设置需要重新计算这些对象的子项或父项的宽度。如果脚本多次设置了 width 属性，则延迟处理可防止进行多次处理。此方法允许您手动覆盖此行为。

validateProperties

()

方法

public function validateProperties():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。通常，子类化程序应覆盖 commitProperties() 方法，而不是覆盖此方法。

validateSize

()

方法

public function validateSize(recursive:Boolean = false):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法，随后在测量时调用了 validateSize() 方法，则验证组件的度量大小。

参数

recursive:Boolean (default = false) — 如果为 true，则调用对象子项的此方法。

validationResultHandler

()

方法

public function validationResultHandler(event:ValidationResultEvent):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

处理分配给此组件的验证程序调度的 valid 和 invalid 事件。

您通常通过向验证程序分配事件侦听器来处理由验证程序调度的 valid 和 invalid 事件。如果您希望直接在正在验证的组件中处理验证事件，则可以覆盖此方法以处理 valid 和 invalid 事件。通常，您会在覆盖过程中调用 super.validationResultHandler(event)。

参数

event:ValidationResultEvent — 用于验证的事件对象。

相关 API 元素

mx.events.ValidationResultEvent

verticalGradientMatrix

()

方法

public function verticalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回一个框 Matrix，在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。

参数

	`x:Number` — 渐变的左坐标（以像素为单位）。

	`y:Number` — 渐变的顶坐标（以像素为单位）。

	`width:Number` — 渐变的宽度（以像素为单位）。

	`height:Number` — 渐变的高度（以像素为单位）。

Matrix — 垂直渐变的 Matrix。

事件详细信息

add

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当组件通过使用 addChild()、addChildAt()、addElement() 或 addElementAt() 方法作为内容子项添加到容器后调度。如果已使用 rawChildren.addChild() 或 rawChildren.addChildAt() 方法将该组件作为非内容子项添加到容器，则不会调度此事件。

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

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

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

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

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

creationComplete

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当组件完成其构建、属性处理、测量、布置和绘制时调度。

此时，根据组件的 visible 属性，即使绘制完组件后，该组件仍然不可见。

FlexEvent.CREATION_COMPLETE 常数可为 creationComplete 事件定义事件对象的 type 属性值。

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

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

currentStateChange

事件

事件对象类型: mx.events.StateChangeEvent
属性 StateChangeEvent.type = mx.events.StateChangeEvent.CURRENT_STATE_CHANGE

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

视图状态更改后调度。

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

StateChangeEvent.CURRENT_STATE_CHANGE 常量定义当视图状态发生变化时调度的事件的 type 属性的值。该常量的值是“currentStateChange”。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`newState`	已进入的视图状态的名称。
`oldState`	已退出的视图状态的名称。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`type`	StateChangeEvent.CURRENT_STATE_CHANGE

currentStateChanging

事件

事件对象类型: mx.events.StateChangeEvent
属性 StateChangeEvent.type = mx.events.StateChangeEvent.CURRENT_STATE_CHANGING

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在 currentState 属性更改后但视图状态更改前调度。

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

StateChangeEvent.CURRENT_STATE_CHANGING 常量定义当视图状态将要更改时调度的事件的 type 属性的值。该常量的值是“currentStateChanging”。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`newState`	正在进入的视图状态的名称。
`oldState`	正在退出的视图状态的名称。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`type`	StateChangeEvent.CURRENT_STATE_CHANGING

dragComplete

事件

事件对象类型: mx.events.DragEvent
属性 DragEvent.type = mx.events.DragEvent.DRAG_COMPLETE

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在拖动操作完成时（将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时）由拖动启动器（作为要拖动的数据源的组件）调度。

您可以使用此事件执行拖放操作的任意最终清理。例如，将 List 控件项目从一个列表拖动到另一个列表时，如果不再需要此 List 控件项目，则可以将其从源列表中删除。

将数据从一个 Tree 控件拖动到另一个控件时，如果在 Tree 控件 dragComplete 事件的事件处理函数调用 Event.preventDefault()，它将阻止该放置操作。

DragEvent.DRAG_COMPLETE 常量可为 dragComplete 事件定义事件对象的 type 属性的值。

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

属性	值
`action`	引发该事件的操作：`DragManager.COPY`、`DragManager.LINK`、`DragManager.MOVE` 或 `DragManager.NONE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

dragDrop

事件

事件对象类型: mx.events.DragEvent
属性 DragEvent.type = mx.events.DragEvent.DRAG_DROP

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用户在放置目标上释放鼠标时由放置目标调度。

可以使用此事件处理函数将拖动数据添加到放置目标。

将数据从一个 Tree 控件拖动到另一个控件时，如果在 Tree 控件 dragDrop 事件的事件处理函数调用 Event.preventDefault()，它将阻止该放置操作。

DragEvent.DRAG_DROP 常量可为 dragDrop 事件定义事件对象的 type 属性的值。

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

属性	值
`action`	引发该事件的操作：`DragManager.COPY`、`DragManager.LINK`、`DragManager.MOVE` 或 `DragManager.NONE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

dragEnter

事件

事件对象类型: mx.events.DragEvent
属性 DragEvent.type = mx.events.DragEvent.DRAG_ENTER

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时，由该组件调度。如果应用程序在 Flash Player 中运行，则当用户将鼠标移至任何组件所处的位置时，将多次调度此事件。如果应用程序在 AIR 中运行，则只调度此事件一次。

为使放置目标有效，您必须为此事件定义处理函数。在处理函数中，您可以通过更改放置目标的外观向用户提供可视反馈，即组件可以接受此拖动。例如，您可以围绕放置目标绘制一个边框，或者为放置目标提供焦点。

如果希望接受拖动，您必须调用 DragManager.acceptDragDrop() 方法。如果不调用 acceptDragDrop()，您将无法获得其他任何拖动事件。

在 Flash Player 中，action 属性的值始终为 DragManager.MOVE，即使是执行复制操作也不例外。这是因为在控件识别出已按下 Ctrl 键来指示复制之前，即已发生 dragEnter 事件。dragOver 事件的事件对象的 action 属性确实包含指示拖动操作类型的值。您可以通过调用 DragManager.showFeedback() 方法来更改拖动操作的类型。

在 AIR 中，action 属性的默认值为 DragManager.COPY。

由于 Tree 控件中数据的构建方式与其他基于列表的控件不同，所以 Tree 控件处理拖放的方式也与这些控件不同。对于 Tree 控件，仅当您在同一 Tree 控件中移动或复制数据时，或者将数据复制到其他 Tree 控件时，dragDrop 事件的事件处理函数才执行操作。如果您是通过将一个 Tree 控件中的数据拖放到另一个 Tree 控件来移动数据，则实际上是由 dragComplete 事件的事件处理函数（而非 dragDrop 事件的事件处理函数）执行将该数据添加到目标 Tree 控件的操作，并从源 Tree 控件中删除该数据。这非常有用，因为要重设将要删除的数据的父级，Flex 必须先将该数据从源 Tree 控件中删除。

DragEvent.DRAG_ENTER 常量可为 dragEnter 事件定义事件对象的 type 属性的值。

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

属性	值
`action`	导致此事件的操作，始终是 `DragManager.MOVE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

相关 API 元素

mx.managers.DragManager

dragExit

事件

事件对象类型: mx.events.DragEvent
属性 DragEvent.type = mx.events.DragEvent.DRAG_EXIT

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用户在组件外拖动但没有将数据放置到目标时，由组件调度。

如果在处理 dragEnter 或 dragOver 事件时修改了放置目标的外观，则可以使用此事件将放置目标还原为正常外观。

DragEvent.DRAG_EXIT 常量可为 dragExit 事件定义事件对象的 type 属性的值。

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

属性	值
`action`	引发该事件的操作：`DragManager.COPY`、`DragManager.LINK`、`DragManager.MOVE` 或 `DragManager.NONE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

dragOver

事件

事件对象类型: mx.events.DragEvent
属性 DragEvent.type = mx.events.DragEvent.DRAG_OVER

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在拖动操作期间，当用户在鼠标位于组件上方的情况下移动鼠标时，由组件调度。在 Flash Player 中，将项目拖动到有效放置目标上时，调度此事件。在 AIR 中，将项目拖动到任一组件上方（即使该组件不是有效的放置目标）时，调度此事件。

在处理函数中，您可以通过更改放置目标的外观向用户提供可视反馈，即组件可以接受此拖动。例如，您可以围绕放置目标绘制一个边框，或者为放置目标提供焦点。

您应该对此事件进行处理，从而在允许放置之前执行其他逻辑，例如，将数据放置在放置目标中的各不同位置，读取键盘输入以确定拖放操作是拖动还是复制拖放数据，或者根据拖放操作类型提供不同类型的可视反馈。

您还可以通过更改 DragManager.showFeedback() 方法来更改拖动操作的类型。action 属性的默认值为 DragManager.MOVE。

DragEvent.DRAG_OVER 常量可为 dragOver 事件定义事件对象的 type 属性的值。

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

属性	值
`action`	引发该事件的操作：`DragManager.COPY`、`DragManager.LINK`、`DragManager.MOVE` 或 `DragManager.NONE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

相关 API 元素

mx.managers.DragManager

dragStart

事件

事件对象类型: mx.events.DragEvent
属性 DragEvent.type = mx.events.DragEvent.DRAG_START

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

启动拖动操作时，由拖动启动器调度。基于列表的控件在内部使用此事件；实现拖放操作时不会处理此事件。如果您希望控制拖放操作的开始，请使用 mouseDown 或 mouseMove 事件。

DragEvent.DRAG_START 常量可为 dragStart 事件定义事件对象的 type 属性的值。

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

属性	值
`action`	引发该事件的操作：`DragManager.COPY`、`DragManager.LINK`、`DragManager.MOVE` 或 `DragManager.NONE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

effectEnd

事件

事件对象类型: mx.events.EffectEvent
属性 EffectEvent.type = mx.events.EffectEvent.EFFECT_END

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在一个效果结束后调度。

在触发此事件之前，效果将进行最后一组可视更改，但是这些更改将不会呈示在屏幕上。因此，您可能需要使用 callLater() 方法延迟任何其他更改，您希望在屏幕上呈示更改之后再进行这些更改。

EffectEvent.EFFECT_END 常量可为 effectEnd 事件定义事件对象的 type 属性值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`effectInstance`	事件的效果实例对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

effectStart

事件

事件对象类型: mx.events.EffectEvent
属性 EffectEvent.type = mx.events.EffectEvent.EFFECT_START

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在即将开始播放效果前调度。

在触发此事件后，效果才会开始更改可视效果。

EffectEvent.EFFECT_START 常量可为 effectStart 事件定义事件对象的 type 属性值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`effectInstance`	事件的效果实例对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

effectStop

事件

事件对象类型: mx.events.EffectEvent
属性 EffectEvent.type = mx.events.EffectEvent.EFFECT_STOP

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在停止某个效果（仅当对该效果调用 stop() 时发生）之后调度。

该效果接着将在完成时调度 EFFECT_END 事件。EFFECT_STOP 事件的目的是让侦听器知道该效果过早结束，而不是自然结束或对 end() 调用后而结束。

EffectEvent.EFFECT_STOP 常量可为 effectStop 事件定义事件对象的 type 属性值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`effectInstance`	事件的效果实例对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

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 属性值。

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

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

属性	值
`bubbles`	false
`cancelable`	false
`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 属性值。

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

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

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

hide

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当对象的状态从可见变为不可见时调度。

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

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

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

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

initialize

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当组件完成构建并设置了所有初始化属性后调度。

初始化阶段结束后，就处理了属性，并测量、布置和绘制了组件，然后将调度 creationComplete 事件。

FlexEvent.INITIALIZE 常数可为 initialize 事件定义事件对象的 type 属性值。

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

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

invalid

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当组件由 Validator 监控且未通过验证时调度。

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

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

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

mouseDownOutside

事件

事件对象类型: mx.events.FlexMouseEvent
属性 FlexMouseEvent.type = mx.events.FlexMouseEvent.MOUSE_DOWN_OUTSIDE

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当用户在使用 PopUpManager 打开的某个组件外部单击时，从该组件调度。

FlexMouseEvent.MOUSE_DOWN_OUTSIDE 常量可为 mouseDownOutside 事件定义事件对象的 type 属性的值。

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

属性	值
`altKey`	指示是 (`true`) 否 (`false`) 按下 Alt 键。
`bubbles`	false
`buttonDown`	指示是 (`true`) 否 (`false`) 按下主鼠标按键。
`cancelable`	false
`ctrlKey`	指示是 (`true`) 否 (`false`) 按下 Control 键。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。对于 PopUpManager 事件，对象为弹出窗口。
`delta`	指示用户每滚动鼠标滚轮上的一个刻度时，相应应该滚动的行数。对于 PopUpManager 事件，此值为 0。
`localX`	事件发生时所处的水平位置。对于 PopUpManager 事件，此值取决于弹出式控件。
`localY`	事件发生时所处的垂直位置。对于 PopUpManager 事件，此值取决于弹出式控件。
`relatedObject`	对与事件相关的显示列表对象的引用。对于 PopUpManager 事件，此对象是在其上放置鼠标指针的容器。
`shiftKey`	指示是 (`true`) 否 (`false`) 按下 Shift 键。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。对于 PopUpManager 事件，对象为弹出窗口。

mouseWheelOutside

事件

事件对象类型: mx.events.FlexMouseEvent
属性 FlexMouseEvent.type = mx.events.FlexMouseEvent.MOUSE_WHEEL_OUTSIDE

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当用户使用鼠标滚轮滚动到使用 PopUpManager 打开的某个组件外部时，从该组件调度。

FlexMouseEvent.MOUSE_WHEEL_OUTSIDE 常量可为 mouseWheelOutside 事件定义事件对象的 type 属性的值。

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

属性	值
`altKey`	指示是 (`true`) 否 (`false`) 按下 Alt 键。
`bubbles`	false
`buttonDown`	指示是 (`true`) 否 (`false`) 按下主鼠标按键。
`cancelable`	false
`ctrlKey`	指示是 (`true`) 否 (`false`) 按下 Control 键。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。对于 PopUpManager 事件，对象为弹出窗口。
`delta`	指示用户每滚动鼠标滚轮上的一个刻度时，相应应该滚动的行数。对于 PopUpManager 事件，此值为 0。
`localX`	事件发生时所处的水平位置。对于 PopUpManager 事件，此值取决于弹出式控件。
`localY`	事件发生时所处的垂直位置。对于 PopUpManager 事件，此值取决于弹出式控件。
`relatedObject`	对与事件相关的显示列表对象的引用。对于 PopUpManager 事件，此对象是在其上放置鼠标指针的容器。
`shiftKey`	指示是 (`true`) 否 (`false`) 按下 Shift 键。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。对于 PopUpManager 事件，对象为弹出窗口。

move

事件

事件对象类型: mx.events.MoveEvent
属性 MoveEvent.type = mx.events.MoveEvent.MOVE

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

移动对象后调度。

您可以通过以下方法移动组件：设置 x 或 y 属性、调用 move() 方法，在该组件上或其他组件上设置下列属性以使 LayoutManager 更改该组件的 x 或 y 属性：

minWidth
minHeight
maxWidth
maxHeight
explicitWidth
explicitHeight

调用 move() 方法时，将在此方法返回之前调度 move 事件。在其他所有情形下，在该属性更改之前都不会调度 move 事件。

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

MoveEvent.MOVE 常量可为 move 事件定义事件对象的 type 属性的值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`oldX`	对象先前的 x 坐标（以像素为单位）。
`oldY`	对象先前的 y 坐标（以像素为单位）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

preinitialize

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在组件初始化序列开始时调度。调度此事件时，组件恰处于原始状态。许多组件（如 Button 控件）可创建内部子组件来实现功能；例如，Button 控件可创建内部 UITextField 组件来呈示其标签文本。当 Flex 调度 preinitialize 事件时，尚未创建组件的子项（包括内部子项）。

FlexEvent.PREINITIALIZE 常数可为 preinitialize 事件定义事件对象的 type 属性值。

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

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

remove

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当组件通过使用 removeChild()、removeChildAt()、removeElement() 或 removeElementAt() 方法作为内容子项从容器中删除后调度。如果已使用 rawChildren.removeChild() 或 rawChildren.removeChildAt() 方法将组件作为非内容子项从容器中删除，则不会调度此事件。

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

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

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

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

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

resize

事件

事件对象类型: mx.events.ResizeEvent
属性 ResizeEvent.type = mx.events.ResizeEvent.RESIZE

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在调整组件大小时调度。

您可以通过以下方法调整组件大小：设置 width 或 height 属性、调用 setActualSize() 方法、在该组件上或其他组件上设置下列属性之一以使 LayoutManager 需要更改该组件的 width 或 height 属性：

minWidth
minHeight
maxWidth
maxHeight
explicitWidth
explicitHeight

在更改该属性之前，不会调度 resize 事件。

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

ResizeEvent.RESIZE 常量可为 resize 事件定义事件对象的 type 属性值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`oldHeight`	对象先前的高度（以像素为单位）。
`oldWidth`	对象先前的宽度（以像素为单位）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

show

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当对象的状态从不可见变为可见时调度。

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

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

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

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

stateChangeComplete

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.5

在组件进入新状态且切换到该状态的状态转换动画已经播放完时调度。如果不播放状态转换，会立即调度此事件。如果组件切换到其它状态，而转换仍正在进行时，该组件转换到新状态后就会调度此事件。

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

FlexEvent.STATE_CHANGE_COMPLETE 常量为 stateChangeComplete 事件定义事件对象的 type 属性的值。

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

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

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

stateChangeInterrupted

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.5

在组件中断转换到当前状态从而切换到新状态时调度。

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

FlexEvent.STATE_CHANGE_INTERRUPTED 常量为 stateChangeInterrupted 事件定义事件对象的 type 属性的值。

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

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

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

toolTipCreate

事件

事件对象类型: mx.events.ToolTipEvent
属性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_CREATE

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

要创建 ToolTip 时由组件调度。

如果创建了自己的 IToolTip 对象，并在传递到 toolTipCreate 处理函数的事件对象的 toolTip 属性中置入了对该对象的引用，则 ToolTipManager 将显示您的自定义 ToolTip。否则，ToolTipManager 将创建 ToolTipManager.toolTipClass 的实例以用于显示。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

ToolTipEvent.TOOL_TIP_CREATE 常量可为 toolTipCreate 事件定义事件对象的 type 属性值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`工具提示 (tooltip)`	应用此事件的 ToolTip 对象。

toolTipEnd

事件

事件对象类型: mx.events.ToolTipEvent
属性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_END

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

已隐藏组件的 ToolTip 并要将其放弃时由组件调度。

如果使用 ToolTipManager.hideEffect 属性指定了效果，则在停止播放该效果后调度此事件。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

ToolTipEvent.TOOL_TIP_END 常量可为 toolTipEnd 事件定义事件对象的 type 属性值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`工具提示 (tooltip)`	应用此事件的 ToolTip 对象。

toolTipHide

事件

事件对象类型: mx.events.ToolTipEvent
属性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_HIDE

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

要隐藏组件的 ToolTip 时由组件调度。

如果使用 ToolTipManager.hideEffect 属性指定了效果，则在开始播放该效果之前调度此事件。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

ToolTipEvent.TOOL_TIP_HIDE 常量可为 toolTipHide 事件定义事件对象的 type 属性值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`工具提示 (tooltip)`	应用此事件的 ToolTip 对象。

toolTipShow

事件

事件对象类型: mx.events.ToolTipEvent
属性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_SHOW

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

要显示组件的 ToolTip 时由组件调度。

如果使用 ToolTipManager.showEffect 属性指定了效果，则在开始播放该效果之前调度此事件。您可以使用此事件在 ToolTip 出现前对其进行修改。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

ToolTipEvent.TOOL_TIP_SHOW 常量可为 toolTipShow 事件定义事件对象的 type 属性值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`工具提示 (tooltip)`	应用此事件的 ToolTip 对象。

toolTipShown

事件

事件对象类型: mx.events.ToolTipEvent
属性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_SHOWN

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

显示组件的 ToolTip 时由组件调度。

如果使用 ToolTipManager.showEffect 属性指定了效果，则在停止播放该效果之后调度此事件。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

ToolTipEvent.TOOL_TIP_SHOWN 常量可为 toolTipShown 事件定义事件对象的 type 属性值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`工具提示 (tooltip)`	应用此事件的 ToolTip 对象。

toolTipStart

事件

事件对象类型: mx.events.ToolTipEvent
属性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_START

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用户将鼠标移动到设置了 toolTip 属性的组件上方后，由该组件调度。

ToolTip 事件的顺序为 toolTipStart、toolTipCreate、toolTipShow、toolTipShown、toolTipHide 和 toolTipEnd。

ToolTipEvent.TOOL_TIP_START 常量可为 toolTipStart 事件定义事件对象的 type 属性值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`工具提示 (tooltip)`	应用此事件的 ToolTip 对象。

touchInteractionEnd

事件

事件对象类型: mx.events.TouchInteractionEvent
属性 TouchInteractionEvent.type = mx.events.TouchInteractionEvent.TOUCH_INTERACTION_END

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.5

不可撤消事件，在组件结束响应 touch 交互用户操作时由组件调度。

该事件是冒泡事件，针对开始了 touch 交互（即发生了 mouseDown/touchBegin）的 DisplayObject 进行调度。

响应 touch 交互的组件应侦听 touch 交互事件，从而与其它组件协调用户计划进行哪种类型的 touch 交互以及哪个组件响应此 touch 交互。

Scroller 组件结束响应用户的 touch 交互后，Scroller 组件将调度 touchInteractionEnd 事件以通知其它组件。

TouchInteractionEvent.TOUCH_INTERACTION_END 常量为 touchInteractionEnd 事件定义事件对象的 type 属性的值。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`reason`	touch 交互事件的原因。请参阅 `mx.events.TouchInteractionReason`。
`relatedObject`	与此 touch 交互事件相关联的对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

touchInteractionStart

事件

事件对象类型: mx.events.TouchInteractionEvent
属性 TouchInteractionEvent.type = mx.events.TouchInteractionEvent.TOUCH_INTERACTION_START

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.5

不可撤消事件，在组件开始响应 touch 交互用户操作时由组件调度。

该事件是冒泡事件，针对开始了 touch 交互（即发生了 mouseDown/touchBegin）的 DisplayObject 进行调度。

响应 touch 交互的组件应侦听 touch 交互事件，从而与其它组件协调用户计划进行哪种类型的 touch 交互以及哪个组件响应此 touch 交互。

正在控制 touch 交互的 Scroller 组件将调度 touchInteractionStart 事件以通知可能响应相同用户的 touch 交互的其它组件。其它组件看到此事件后，应该停止响应 touch 交互，删除指明该组件正在响应 touch 交互的视觉指示，并执行其它清理操作。

TouchInteractionEvent.TOUCH_INTERACTION_START 常量为 touchInteractionStart 事件定义事件对象的 type 属性的值。

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

属性	值
`bubbles`	true
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`reason`	touch 交互事件的原因。请参阅 `mx.events.TouchInteractionReason`。
`relatedObject`	与此 touch 交互事件相关联的对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

touchInteractionStarting

事件

事件对象类型: mx.events.TouchInteractionEvent
属性 TouchInteractionEvent.type = mx.events.TouchInteractionEvent.TOUCH_INTERACTION_STARTING

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.5

可撤消事件，在组件试图响应 touch 交互用户操作时由组件调度。

该事件是冒泡事件，针对开始了 touch 交互（即发生了 mouseDown/touchBegin）的 DisplayObject 进行调度。

响应 touch 交互的组件应侦听 touch 交互事件，从而与其它组件协调用户计划进行哪种类型的 touch 交互以及哪个组件响应此 touch 交互。

要控制 touch 交互的 Scroller 组件将调度 touchInteractionStarting 事件以通知可能响应相同用户的 touch 交互的其它组件。其它组件可以利用此机会取消 Scroller 的操作，从而保持对该 touch 交互的控制。

TouchInteractionEvent.TOUCH_INTERACTION_STARTING 常量为 touchInteractionStarting 事件定义事件对象的 type 属性的值。

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

属性	值
`bubbles`	true
`cancelable`	true
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`reason`	touch 交互事件的原因。请参阅 `mx.events.TouchInteractionReason`。
`relatedObject`	与此 touch 交互事件相关联的对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

updateComplete

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度（如果需要）。

这是在显示组件前最后一次修改组件的机会。已提交所有属性，并已测量和布置了组件。

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

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

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

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

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

valid

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当组件由 Validator 监控并且成功通过验证时调度。

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

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

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

valueCommit

事件

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当以编程方式或通过用户交互更改值时调度。

由于以编程方式进行更改会触发此事件，所以请确保任何 valueCommit 事件处理函数都不会更改可引发另一 valueCommit 事件的值。例如，不要在 valueCommit 事件处理函数中更改控件的 dataProvider 属性。

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

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

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

常量详细信息

DEFAULT_MAX_HEIGHT

常量

public static const DEFAULT_MAX_HEIGHT:Number = 10000

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

maxHeight 属性的默认值。

默认值为 10000。

DEFAULT_MAX_WIDTH

常量

public static const DEFAULT_MAX_WIDTH:Number = 10000

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

maxWidth 属性的默认值。

默认值为 10000。

DEFAULT_MEASURED_HEIGHT

常量

public static const DEFAULT_MEASURED_HEIGHT:Number = 22

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

measuredHeight 属性的默认值。大多数组件都计算 measuredHeight，但有些组件是基于流的，所以必须选择看似合理的数字。

默认值为 22。

DEFAULT_MEASURED_MIN_HEIGHT

常量

public static const DEFAULT_MEASURED_MIN_HEIGHT:Number = 22

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

measuredMinHeight 属性的默认值。大多数组件都计算 measuredMinHeight，但有些组件是基于流的，所以必须选择看似合理的数字。

默认值为 22。

DEFAULT_MEASURED_MIN_WIDTH

常量

public static const DEFAULT_MEASURED_MIN_WIDTH:Number = 40

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

measuredMinWidth 属性的默认值。大多数组件都计算 measuredMinWidth，但有些组件是基于流的，所以必须选择看似合理的数字。

默认值为 40。

DEFAULT_MEASURED_WIDTH

常量

public static const DEFAULT_MEASURED_WIDTH:Number = 160

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

measuredWidth 属性的默认值。大多数组件都计算 measuredWidth，但有些组件是基于流的，所以必须选择看似合理的数字。

默认值为 160。

法律声明 | 在线隐私策略

UIComponent - AS3 Flex

包x

语言元素

附录

包 mx.core

accessibilityDescription

accessibilityEnabled

accessibilityName

accessibilityShortcut

activeEffects

automationDelegate

automationEnabled

automationName

automationOwner

automationParent

automationTabularData

automationValue

automationVisible

baseline

baselinePosition

bottom

cacheHeuristic

cachePolicy

className

contentMouseX

contentMouseY

currentCSSState

currentState

cursorManager

depth

descriptor

designLayer

document

doubleClickEnabled

enabled

errorString

explicitHeight

explicitMaxHeight

explicitMaxWidth

explicitMinHeight

explicitMinWidth

explicitWidth

flexContextMenu

focusEnabled

focusManager

focusPane

hasComplexLayoutMatrix

hasFocusableChildren

hasLayoutMatrix3D

height

horizontalCenter

id

includeInLayout

inheritingStyles

initialized

instanceIndex

instanceIndices

is3D

isDocument

isPopUp

layoutMatrix3D

left

maintainProjectionCenter

maxHeight

maxWidth

measuredHeight

measuredMinHeight

measuredMinWidth

measuredWidth

minHeight

minWidth

moduleFactory

mouseFocusEnabled

nestLevel

nonInheritingStyles

numAutomationChildren

owner

parent

parentApplication

parentDocument