包 | mx.controls |
类 | public class MenuBar |
继承 | MenuBar UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
实现 | IFocusManagerComponent |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
通常,MenuBar 控件的顶级菜单栏始终可见。此控件不适合用作弹出菜单。当用户使用鼠标或键盘进行选择时,将弹出相应的子菜单。如果选择了某个菜单项,或者用户通过在菜单外单击取消了该菜单,打开的子菜单将会消失。
有关可以在 MenuBar 控件的数据提供程序中使用的属性的信息和示例,请参阅 Menu 控件。
MenuBar 控件具有下列大小特征:
特征 | 说明 |
---|---|
默认大小 | 宽度基于菜单文本确定,最小值为 27 个像素。高度的默认值为 22 个像素。 |
The <mx:MenuBar>
tag inherits all of the tag attributes of its superclass, and
adds the following tag attributes:
<mx:MenuBar Properties dataDescriptor="mx.controls.treeClasses.DefaultDataDescriptor" dataProvider="undefined" iconField="icon" labelField="label" labelFunction="undefined" menuBarItemRenderer="mx.controls.menuClasses.MenuBarItem" menuBarItems="[]" menus="[]" selectedIndex="-1" showRoot="true" Styles backgroundSkin="mx.skins.halo.MenuBarBackgroundSkin" borderColor="0xAAB3B3" color="0x0B333C" cornerRadius="0" disabledColor="0xAAB3B3" fillAlphas="[0.6,0.4]" fillColors="[0xFFFFFF, 0xCCCCCC]" focusAlpha="0.5" focusRoundedCorners="tl tr bl br" fontAntiAliasType="advanced|normal" fontFamily="Verdana" fontGridFitType="pixel|none|subpixel" fontSharpness="0" fontSize="10" fontStyle="normal|italic" fontThickness="0" fontWeight="normal|bold" highlightAlphas="[0.3,0.0]" itemDownSkin="mx.skins.halo.ActivatorSkin" itemOverSkin="mx.skins.halo.ActivatorSkin" itemUpSkin="mx.skins.halo.ActivatorSkin" leading="2" menuStyleName="No default" rollOverColor="0xB2E1FF" selectionColor="0x7FCEFF" textAlign="left" textDecoration="none" textIndent="0" Events itemClick="No default" itemRollOut="No default" itemRollOver="No default" menuHide="No default" menuShow="No default" />
默认 MXML 属性dataProvider
相关 API 元素
mx.controls.PopUpMenuButton
mx.controls.menuClasses.IMenuBarItemRenderer
mx.controls.menuClasses.MenuBarItem
mx.controls.menuClasses.IMenuDataDescriptor
mx.controls.treeClasses.DefaultDataDescriptor
属性 | 由以下参数定义 | ||
---|---|---|---|
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 | ||
dataDescriptor : IMenuDataDescriptor
访问并处理数据提供程序中数据的对象。 | MenuBar | ||
dataProvider : Object
对象的层次结构,显示为 MenuBar 项目和菜单。 | MenuBar | ||
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 | ||
hasRoot : Boolean [只读]
一个标志,用于指明当前数据提供程序具有根节点;例如,层次结构中的单个顶级节点。 | MenuBar | ||
height : Number [覆盖]
指定组件在父坐标中的高度的数字(以像素为单位)。 | UIComponent | ||
hitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。 | Sprite | ||
horizontalCenter : Object
对于组件,此布局约束属性是基于类似命名的样式的外观。 | UIComponent | ||
iconField : String
数据提供程序中字段的名称,该字段用于确定要为每个菜单项显示的图标。 | MenuBar | ||
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 | ||
labelField : String
数据提供程序中的字段名称,用以确定每个菜单项的显示文本。 | MenuBar | ||
labelFunction : Function
用于确定每个菜单项的显示文本的函数。 | MenuBar | ||
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 | ||
menuBarItemRenderer : IFactory
由 MenuBar 控件应用于 MenuBar 控件顶级菜单栏的项呈示器。 | MenuBar | ||
menuBarItems : Array
包含 MenuBarItem 对象的 Array,这些对象用于呈示 MenuBar 控件顶级菜单栏中的所有项目。 | MenuBar | ||
menus : Array
包含 Menu 对象的 Array,这些对象与 MenuBar 控件的弹出子菜单对应。 | MenuBar | ||
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 | ||
selectedIndex : int
MenuBar 控件中当前打开的菜单或上一次打开的菜单(如果当前没有打开菜单)的索引。 | MenuBar | ||
showInAutomationHierarchy : Boolean
用于确定自动化对象是否显示在自动化层次中的标志。 | UIComponent | ||
showRoot : Boolean
指定是否显示数据提供程序的根节点的布尔值标志。 | MenuBar | ||
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 | ||
menuBarItemStyleFilters : Object [只读]
从 MenuBar 项目传递给 menuBar 项目的一组样式。 | MenuBar | ||
resourceManager : IResourceManager [只读]
对管理所有应用程序本地化资源的对象的引用。 | UIComponent | ||
unscaledHeight : Number [只读]
用于确定组件的未缩放高度的简便方法。 | UIComponent | ||
unscaledWidth : Number [只读]
用于确定组件的未缩放宽度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成,还应将此宽度作为参数传递到 updateDisplayList() 中。 | UIComponent |
方法 | 由以下参数定义 | ||
---|---|---|---|
MenuBar()
构造函数。 | MenuBar | ||
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | ||
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | ||
将非可视样式客户端添加到该组件实例。 | UIComponent | ||
表示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | ||
排队稍后调用的函数。 | UIComponent | ||
删除此组件实例的样式属性。 | UIComponent | ||
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | ||
将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | ||
将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | ||
在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | ||
返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | ||
[覆盖]
将事件调度到事件流中。 | UIComponent | ||
在此组件周围显示或隐藏焦点指示符。 | 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 | ||
停止在组件上播放效果实例时,由效果实例调用。 | UIComponent | ||
开始在组件上播放效果实例时,由效果实例调用。 | UIComponent | ||
结束组件上当前播放的所有效果。 | UIComponent | ||
执行 UIComponent 对象是目标的所有绑定。 | UIComponent | ||
打印完成后调用。 | UIComponent | ||
在指定的索引位置提供自动化对象。 | UIComponent | ||
提供自动化对象列表。 | UIComponent | ||
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | ||
按指定的元素大小,返回元素边界的 x 坐标。 | UIComponent | ||
按指定的元素大小,返回元素边界的 y 坐标。 | UIComponent | ||
返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | ||
返回具有指定名称的子显示对象。 | DisplayObjectContainer | ||
返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | ||
查找此 UIComponent 实例的类型选择器。 | UIComponent | ||
返回一个约束布局值,这与获取此组件的约束样式的方式类似。 | UIComponent | ||
确定是使用显式高度还是测量高度的一种简便方法
| UIComponent | ||
确定是使用显式宽度还是测量宽度的一种简便方法
| UIComponent | ||
获取当前具有焦点的对象。 | UIComponent | ||
返回元素的布局高度。 | UIComponent | ||
返回元素的布局宽度。 | UIComponent | ||
返回元素在屏幕上进行绘制时所用的 x 坐标。 | UIComponent | ||
返回元素在屏幕上进行绘制时所用的 y 坐标。 | UIComponent | ||
返回用于相对于其同级组件计算组件的布局的转换矩阵。 | UIComponent | ||
返回此元素的布局转换 Matrix3D。 | UIComponent | ||
返回元素的最大高度。 | UIComponent | ||
返回元素的最大宽度。 | UIComponent | ||
返回对指定 MenuBar 项目索引处的 Menu 对象的引用,其中 0 是最左侧 MenuBar 项目索引处包含的 Menu 对象。 | MenuBar | ||
返回元素的最小高度。 | UIComponent | ||
返回元素的最小宽度。 | UIComponent | ||
返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。 | DisplayObjectContainer | ||
返回元素的首选高度。 | UIComponent | ||
返回元素的首选宽度。 | UIComponent | ||
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。 | DisplayObject | ||
返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。 | UIComponent | ||
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | ||
将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | ||
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。 | DisplayObject | ||
将二维点从舞台(全局)坐标转换为三维显示对象的(本地)坐标。 | DisplayObject | ||
如果 currentCSSState 不为 null,则返回 true。 | UIComponent | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | ||
表示对象是否已经定义了指定的属性。 | Object | ||
确定是否已在此 UIComponent 上定义指定的状态。 | UIComponent | ||
计算显示对象的边框,以确定它是否与 obj 显示对象的边框重叠或相交。 | DisplayObject | ||
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | ||
返回一个框 Matrix,在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | ||
初始化此组件的内部结构。 | UIComponent | ||
初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | ||
由某个组件的项目进行调用,以指示其 depth 属性已更改。 | UIComponent | ||
当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时,该元素必须调用该方法。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
根据 iconField 属性返回代表图标和数据项目(如果有)的类。 | MenuBar | ||
返回呈示器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。 | MenuBar | ||
将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。 | DisplayObject | ||
将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | ||
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。 | DisplayObject | ||
如果 cssState 与 currentCSSState 匹配,则返回 true。 | UIComponent | ||
确定此实例与给定类型相同,还是属于给定类型的子类。 | UIComponent | ||
测量指定的 HTML 文本(该文本中可能包含 <font> 和 <b> 等 HTML 标签),假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | ||
测量指定的文本,假定该文本使用由此 UIComponent 的样式确定的 UITextFormat 显示在单行 UITextField(或 UIFTETextField)中。 | UIComponent | ||
将组件移动到其父项内的指定位置。 | UIComponent | ||
将样式更改传播到子项。 | UIComponent | ||
如果 owner 属性链从 child 指向此 UIComponent,则返回 true。 | UIComponent | ||
当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | ||
准备 IFlexDisplayObject 用于打印。 | UIComponent | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
为此组件及其所有后代生成或重新生成 CSS 样式缓存,前提条件是递归参数为 true。 | UIComponent | ||
针对每个效果事件,将 EffectManager 注册为一个事件侦听器。 | UIComponent | ||
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | ||
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | ||
从 DisplayObjectContainer 实例的子级列表中删除所有子 DisplayObject 实例。 | DisplayObjectContainer | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
从该组件实例删除非可视样式客户端。 | UIComponent | ||
重放指定的事件。 | UIComponent | ||
显示虚拟键盘。 | InteractiveObject | ||
使用提供的 ID 解析子项。 | UIComponent | ||
[静态]
在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | ||
调整对象大小。 | UIComponent | ||
更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | ||
设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | ||
设置当前状态。 | UIComponent | ||
设置此组件的焦点。 | UIComponent | ||
设置元素在屏幕上进行绘制时所用的坐标。 | UIComponent | ||
设置元素的布局大小。 | UIComponent | ||
设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。 | UIComponent | ||
设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。 | UIComponent | ||
设置循环操作动态属性的可用性。 | Object | ||
对此组件实例设置样式属性。 | UIComponent | ||
当 visible 属性发生更改时调用。 | UIComponent | ||
允许用户拖动指定的 Sprite。 | Sprite | ||
使用户可以在启用触摸的设备上拖动指定的 Sprite。 | Sprite | ||
对源起于此对象的所有 MovieClip 递归停止时间轴执行。 | DisplayObjectContainer | ||
结束 startDrag() 方法。 | Sprite | ||
结束 startTouchDrag() 方法,用于启用触摸的设备。 | Sprite | ||
检测对样式属性的更改。 | UIComponent | ||
首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。 | UIComponent | ||
[静态]
阻止对使用 callLater() 排队的方法进行背景处理,直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | ||
交换两个指定子对象的 Z 轴顺序(从前到后顺序)。 | DisplayObjectContainer | ||
在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。 | DisplayObjectContainer | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
[覆盖]
返回一个字符串,用于指示此对象在应用程序的 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 | ||
一种实用程序方法,用于将以该对象的本地坐标指定的点转换为在该对象父坐标中的相应位置。 | UIComponent | ||
验证子项的位置和大小,并绘制其他可视内容。 | UIComponent | ||
验证并更新此对象的属性和布局,如果需要的话重绘对象。 | UIComponent | ||
由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | ||
如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法,随后在测量时调用了 validateSize() 方法,则验证组件的度量大小。 | UIComponent | ||
处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | ||
返回指定对象的原始值。 | Object | ||
返回一个框 Matrix,在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | ||
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher |
方法 | 由以下参数定义 | ||
---|---|---|---|
调整焦点矩形。 | UIComponent | ||
提交计算的矩阵,该矩阵是基于布局矩阵以及 flash displayObject 的转换的转换偏移量而构建的。 | UIComponent | ||
这是一个内部方法,供 Flex 框架用于支持 Dissolve 效果。 | UIComponent | ||
确定是否可以跳过对 measure() 方法的调用。 | UIComponent | ||
创建子对象后执行任何最终处理。 | UIComponent | ||
处理对组件设置的属性。 | UIComponent | ||
创建组件的子对象。 | UIComponent | ||
根据所用的嵌入字体使用上下文创建新对象。 | UIComponent | ||
使用给定的 moduleFactory 创建对象。 | UIComponent | ||
更新属性时调度 PropertyChangeEvent 的 Helper 方法。 | UIComponent | ||
当 UIComponent 对象获得焦点时调用的事件处理函数。 | UIComponent | ||
当 UIComponent 对象失去焦点时调用的事件处理函数。 | UIComponent | ||
对于组件的某些不常使用的高级布局功能,初始化其实现和存储。 | UIComponent | ||
完成对此组件的初始化。 | UIComponent | ||
初始化此组件的辅助功能代码。 | UIComponent | ||
此对象影响其布局时(includeInLayout 为 true),使父代大小和显示列表失效的 Helper 方法。 | UIComponent | ||
通常由包含 UITextField 对象的组件覆盖,其中 UITextField 对象获取焦点。 | UIComponent | ||
为 keyDown 事件调用的事件处理函数。 | UIComponent | ||
为 keyUp 事件调用的事件处理函数。 | UIComponent | ||
[覆盖]
根据 MenuBar 项目的默认宽度计算 MenuBar 的首选宽度和高度。 | MenuBar | ||
构建 UIComponent 时将调用此方法,并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时,都会再次调用此方法。 | UIComponent | ||
在水平方向和垂直方向上,指定转换拉伸因子。 | UIComponent | ||
当状态改变以检查状态特定的样式是否应用到此组件时,会调用此方法。 | UIComponent | ||
更新 MenuBar 控件的背景外观。 | MenuBar | ||
绘制对象和/或设置其子项的大小和位置。 | UIComponent |
事件 | 摘要 | 由以下参数定义 | ||
---|---|---|---|---|
[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | |||
当组件通过使用 addChild()、addChildAt()、addElement() 或 addElementAt() 方法作为内容子项添加到容器后调度。 | UIComponent | |||
将显示对象添加到显示列表中时调度。 | DisplayObject | |||
在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 | DisplayObject | |||
当选项由于用户交互操作而发生更改时调度。 | MenuBar | |||
当用户从文本上下文菜单中选择“清除”(或“删除”)时调度。 | InteractiveObject | |||
用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。 | InteractiveObject | |||
当用户手势触发 AIR 应用程序中与此交互式对象相关联的上下文菜单时调度。 | InteractiveObject | |||
在用户为复制操作激活特定于平台的加速键组合或从文本上下文菜单中选择“复制”时调度。 | InteractiveObject | |||
当组件完成其构建、属性处理、测量、布置和绘制时调度。 | UIComponent | |||
视图状态更改后调度。 | UIComponent | |||
在 currentState 属性更改后但视图状态更改前调度。 | UIComponent | |||
在用户为剪切操作激活特定于平台的加速键组合或从文本上下文菜单中选择“剪切”时调度。 | InteractiveObject | |||
[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | |||
如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。 | InteractiveObject | |||
在拖动操作完成时(将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时)由拖动启动器(作为要拖动的数据源的组件)调度。 | UIComponent | |||
用户在放置目标上释放鼠标时由放置目标调度。 | UIComponent | |||
当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时,由该组件调度。 | UIComponent | |||
用户在组件外拖动但没有将数据放置到目标时,由组件调度。 | UIComponent | |||
在拖动操作期间,当用户在鼠标位于组件上方的情况下移动鼠标时,由组件调度。 | UIComponent | |||
启动拖动操作时,由拖动启动器调度。 | UIComponent | |||
在一个效果结束后调度。 | UIComponent | |||
在即将开始播放效果前调度。 | UIComponent | |||
在停止某个效果(仅当对该效果调用 stop() 时发生)之后调度。 | UIComponent | |||
[播放事件] 播放头进入新帧时调度。 | DisplayObject | |||
在组件已进入视图状态之后调度。 | UIComponent | |||
[广播事件] 播放头退出当前帧时调度。 | DisplayObject | |||
在组件即将退出视图状态之前调度。 | UIComponent | |||
显示对象获得焦点后调度。 | InteractiveObject | |||
显示对象失去焦点后调度。 | InteractiveObject | |||
[广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。 | DisplayObject | |||
当用户使用 InteractiveObject 实例沿触摸面边缘创建接触点时调度(如在 Siri Remote for Apple TV 上沿触摸面边缘轻击)。有些设备也可能将这种接触解释为多个触摸事件的组合。 | InteractiveObject | |||
当用户在启用触摸设备上的同一 InteractiveObject 实例上按下两个接触点时(例如,在配有触摸屏的移动电话或平板电脑上的显示对象上按下和释放两个手指)调度。 | InteractiveObject | |||
当用户在启用触摸的设备上的 InteractiveObject 实例上移动接触点时(例如,在配有触摸屏的移动电话或平板电脑上的显示对象上从左向右移动手指)调度。 | InteractiveObject | |||
当用户在接触点处使用 InteractiveObject 实例执行旋转手势时(例如,将两个手指放在屏幕上,然后在配有触摸屏的移动电话或平板电脑上的显示对象上旋转这两个手指)调度。 | InteractiveObject | |||
当用户在接触点处使用 InteractiveObject 实例执行滑动手势(例如,在配有触摸屏的移动电话或平板电脑上用三根手指触摸屏幕,然后在一个显示对象上平行移动这三根手指)时调度。 | InteractiveObject | |||
当用户使用 InteractiveObject 实例创建接触点,然后点击启用触屏的设备时(例如,将几个手指放在显示对象上以打开菜单,然后点击一个手指在配有触摸屏的移动电话或平板电脑上选择一个菜单项)调度。 | InteractiveObject | |||
当用户在接触点处使用 InteractiveObject 实例执行缩放手势操作时(例如,将两个手指放在屏幕上,然后在配有触摸屏的移动电话或平板电脑上的显示对象上快速分开手指)调度。 | InteractiveObject | |||
当对象的状态从可见变为不可见时调度。 | UIComponent | |||
此事件被调度到任何支持使用 IME 进行内联输入的客户端应用程序 | InteractiveObject | |||
当组件完成构建并设置了所有初始化属性后调度。 | UIComponent | |||
当组件由 Validator 监控且未通过验证时调度。 | UIComponent | |||
当用户选择弹出子菜单中的项目时调度。 | MenuBar | |||
当鼠标指针滑离菜单项时调度。 | MenuBar | |||
当鼠标指针滑过菜单项时调度。 | MenuBar | |||
用户按下某个键时调度。 | InteractiveObject | |||
用户尝试使用键盘导航更改焦点时调度。 | InteractiveObject | |||
用户释放某个键时调度。 | InteractiveObject | |||
当弹出子菜单关闭时调度。 | MenuBar | |||
当弹出子菜单打开或用户选择的菜单栏项目没有下拉菜单时调度。 | MenuBar | |||
当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | |||
当用户在使用 PopUpManager 打开的某个组件外部单击时,从该组件调度。 | UIComponent | |||
用户尝试使用指针设备更改焦点时调度。 | InteractiveObject | |||
用户移动 InteractiveObject 上的指针设备时调度。 | InteractiveObject | |||
用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | |||
用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | |||
当鼠标滚轮滚动到 InteractiveObject 实例上时调度。 | InteractiveObject | |||
当用户使用鼠标滚轮滚动到使用 PopUpManager 打开的某个组件外部时,从该组件调度。 | UIComponent | |||
移动对象后调度。 | UIComponent | |||
当用户释放拖动手势时由拖动启动器 InteractiveObject 调度。 | InteractiveObject | |||
在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时,由目标 InteractiveObject 调度。 | InteractiveObject | |||
当拖动手势进入其边界时由 InteractiveObject 调度。 | InteractiveObject | |||
当拖动手势离开其边界时由 InteractiveObject 调度。 | InteractiveObject | |||
当拖动手势保持在其边界内时,由 InteractiveObject 持续调度。 | InteractiveObject | |||
在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | |||
在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | |||
在用户为粘贴操作激活特定于平台的加速键组合或从文本上下文菜单中选择“粘贴”时调度。 | InteractiveObject | |||
在组件初始化序列开始时调度。 | UIComponent | |||
当用户将活动笔针放低经过屏幕的邻近检测阈值上时调度。 | InteractiveObject | |||
当用户将活动笔针抬高放在屏幕的邻近检测阈值上时调度。 | InteractiveObject | |||
当用户将活动笔针移动到屏幕上但仍保留在邻近检测阈值中时调度。 | InteractiveObject | |||
当用户直接将活动笔针从此 InteractiveObject 上移开但仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | |||
当用户直接将活动笔针移动到此 InteractiveObject 上但仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | |||
当用户从此 InteractiveObject 及其任一子项中移开而仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | |||
当用户将活动笔针从显示列表中子项的对象树中滑过此 InteractiveObject 时(而仍保留在屏幕的邻近检测阈值中)时调度。 | InteractiveObject | |||
在用户首先在 InteractiveObject 实例上按下按钮,然后将指针设备移离 InteractiveObject 实例,释放指针设备上的按钮时调度。 | InteractiveObject | |||
当组件通过使用 removeChild()、removeChildAt()、removeElement() 或 removeElementAt() 方法作为内容子项从容器中删除后调度。 | UIComponent | |||
将要从显示列表中删除显示对象时调度。 | DisplayObject | |||
在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 | DisplayObject | |||
[广播事件] 将要更新和呈现显示列表时调度。 | DisplayObject | |||
在调整组件大小时调度。 | UIComponent | |||
当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | |||
当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | |||
用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | |||
用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | |||
在用户为全选操作激活特定于平台的加速键组合或从文本上下文菜单中选择“全选”时调度。 | InteractiveObject | |||
当对象的状态从不可见变为可见时调度。 | UIComponent | |||
在放开软键盘之后立即调度。 | InteractiveObject | |||
在放开软键盘之前立即调度。 | InteractiveObject | |||
在隐藏软键盘之后立即调度。 | InteractiveObject | |||
在组件进入新状态且切换到该状态的状态转换动画已经播放完时调度。 | UIComponent | |||
在组件中断转换到当前状态从而切换到新状态时调度。 | UIComponent | |||
对象的 tabChildren 标志值发生更改时调度。 | InteractiveObject | |||
对象的 tabEnabled 标志发生更改时调度。 | InteractiveObject | |||
对象的 tabIndex 属性值发生更改时调度。 | InteractiveObject | |||
当用户输入一个或多个文本字符时调度。 | InteractiveObject | |||
要创建 ToolTip 时由组件调度。 | UIComponent | |||
已隐藏组件的 ToolTip 并要将其放弃时由组件调度。 | UIComponent | |||
要隐藏组件的 ToolTip 时由组件调度。 | UIComponent | |||
要显示组件的 ToolTip 时由组件调度。 | UIComponent | |||
显示组件的 ToolTip 时由组件调度。 | UIComponent | |||
用户将鼠标移动到设置了 toolTip 属性的组件上方后,由该组件调度。 | UIComponent | |||
当用户第一次触摸启用触摸的设备时(例如,用手指触摸配有触摸屏的移动电话或平板)调度。 | InteractiveObject | |||
当用户移除与启用触摸的设备的接触时(例如,将手指从配有触摸屏的移动电话或平板电脑上抬起)调度。 | InteractiveObject | |||
不可撤消事件,在组件结束响应 touch 交互用户操作时由组件调度。 | UIComponent | |||
不可撤消事件,在组件开始响应 touch 交互用户操作时由组件调度。 | UIComponent | |||
可撤消事件,在组件试图响应 touch 交互用户操作时由组件调度。 | UIComponent | |||
当用户触碰设备时进行调度,而且会连续调度,直到接触点被删除。 | InteractiveObject | |||
当用户将接触点从启用触摸的设备上的 InteractiveObject 实例移开时(例如,在配有触摸屏的移动电话或平板电脑上,将手指从一个显示对象拖到另一个显示对象)调度。 | InteractiveObject | |||
当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时(例如,在配有触摸屏的移动电话或平板电脑上,将手指从显示对象外的一点拖动到显示对象上的一点)调度。 | InteractiveObject | |||
当用户移动接触点,使其远离启用触摸的设备上的 InteractiveObject 实例时(例如,在配有触摸屏的移动电话或平板电脑上将一个手指从显示对象上的一点移动到显示对象外的一点)调度。 | InteractiveObject | |||
当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时(例如,在配有触摸屏的移动电话或平板电脑上,将手指从显示对象外的一点拖动到显示对象上的一点)调度。 | InteractiveObject | |||
当用户在启用触摸设备上的已启动接触的同一 InteractiveObject 实例上抬起接触点时(例如,在配有触摸屏的移动电话或平板的显示对象上的某一点处按下并释放手指)调度。 | InteractiveObject | |||
当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度(如果需要)。 | UIComponent | |||
当组件由 Validator 监控并且成功通过验证时调度。 | UIComponent | |||
当以编程方式或通过用户交互更改值时调度。 | UIComponent |
样式为常见样式,或与特定主题关联。如果为常见样式,则可以用于任何主题。如果样式与特定主题关联,则只有应用程序使用该主题时才能使用该样式。
样式 | 说明 | 由以下参数定义 | ||
---|---|---|---|---|
backgroundSkin | 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 MenuBar 控件的背景外观。 默认外观类基于主题。例如,在 Halo 主题下,默认外观类为 | MenuBar | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位). | UIComponent | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件底边到其父容器的内容区域底边之间的垂直距离(以像素为单位). | UIComponent | |||
color | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件中文本(包括组件标签)的颜色。Halo 主题的默认值为 0x0B333C 。Spark 主题的默认值为 0x000000 。
| MenuBar | ||
direction | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 此组件显示的文本的方向性。 允许的值为 FTE 和 TLF 在其双向文本布局算法中使用此值,该算法会将 Unicode 字符顺序映射到字型顺序。 注意:仅当 MX 组件将 UIFTETextField 指定为其
"ltr" 。 | MenuBar | ||
disabledColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 禁用时组件中文本的颜色。 默认值为 0xAAB3B3 。 | MenuBar | ||
类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 验证失败时,组件加亮部分的颜色. | UIComponent | |||
focusAlpha | 类型: Number CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 指定焦点外观的 alpha 透明度值。Halo 主题的默认值为 0.4 。Spark 主题的默认值为 0.55 。
| MenuBar | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 焦点矩形使用的混合模式. | UIComponent | |||
focusRoundedCorners | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 指定焦点矩形的哪些角应该是圆角。此值是使用空格分隔的字符串,该字符串可以是 "tl" 、"tr" 、"bl" 和 "br" 的任意组合。例如,要指定右侧的角为圆角,左侧的角为直角,应使用 "tr br" 。cornerRadius 样式属性指定圆角的半径。默认值取决于组件类;如果未覆盖该类的默认值,则默认值为 "tl tr bl br" 。
| MenuBar | ||
类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用于绘制焦点矩形的外观. | UIComponent | |||
类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 焦点矩形轮廓的粗细(以像素为单位). | UIComponent | |||
fontAntiAliasType | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash.text.AntiAliasType.NORMAL ) 和 "advanced" (flash.text.AntiAliasType.ADVANCED )。
默认值为 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不能将其应用于部分字符。 默认值为 "advanced" 。相关 API 元素 | MenuBar | ||
fontFamily | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。Halo 主题的默认字体为 "Verdana" 。Spark 主题的默认字体为 "Arial" 。
| MenuBar | ||
fontGridFitType | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性。可能值为 "none" (flash.text.GridFitType.NONE )、"pixel" (flash.text.GridFitType.PIXEL ) 和"subpixel" (flash.text.GridFitType.SUBPIXEL )。
仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 默认值为 "pixel" 。相关 API 元素 | MenuBar | ||
fontSharpness | 类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。
仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 默认值为 0 。相关 API 元素 | MenuBar | ||
fontSize | 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本的高度,以像素为单位。在 Halo 主题中,除 ColorPicker 控件外,所有其它控件的默认值均为 10。对于 Halo 主题的 ColorPicker 控件,默认值为 11。在 Spark 主题中,除 ColorPicker 控件外,所有其它控件的默认值均为 12。对于 Spark 主题的 ColorPicker 控件,默认值为 11。 | MenuBar | ||
fontStyle | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用斜体。可识别的值为 "normal" 和 "italic" 。
默认值为 "normal" 。 | MenuBar | ||
fontThickness | 类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。
仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 默认值为 0 。相关 API 元素 | MenuBar | ||
fontWeight | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用粗体。可识别的值为 normal 和 bold 。Button 控件的默认值为 bold 。所有其它控件的默认值为 normal 。
| MenuBar | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的水平距离(以像素为单位). | UIComponent | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 2.5 该组件的主要交互模式. | UIComponent | |||
itemDownSkin | 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 选中 MenuBar 项目时的外观。 默认外观类基于主题。例如,在 Halo 主题下,默认外观类为 | MenuBar | ||
itemOverSkin | 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 当焦点悬停于 MenuBar 项目上方时的外观。 默认外观类基于主题。例如,在 Halo 主题下,默认外观类为 | MenuBar | ||
itemSkin | 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 MenuBar 项目的默认外观. 默认外观类基于主题。例如,在 Halo 主题下,默认外观类为 | MenuBar | ||
itemUpSkin | 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 未选中 MenuBar 项目时的外观。 默认外观类基于主题。例如,在 Halo 主题下,默认外观类为 | MenuBar | ||
kerning | 类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 一个布尔值,表示是启用 ( true ) 还是禁用 (false ) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。
默认值为 false 。 | MenuBar | ||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.1 运行时版本: Flash10, AIR 1.5 指定组件的所需布局方向. | UIComponent | |||
leading | 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本行之间附加的垂直空间。 默认值为 2。 ComboBox 控件的默认值为 0。 | MenuBar | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件左边到其父容器的内容区域左边之间的水平距离(以像素为单位). | UIComponent | |||
letterSpacing | 类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。 默认值为 0 。 | MenuBar | ||
locale | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 此组件显示的文本的区域设置。 FTE 和 TLF 使用此区域设置将 Unicode 字符映射到字体字型并查找后备字体。 注意:仅当 MX 组件将 UIFTETextField 指定为其 "en" 。 | MenuBar | ||
menuStyleName | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 CSSStyleDeclaration 的名称,它用于为 MenuBar 控件显示的 Menu 控件指定样式。默认情况下,Menu 控件使用 MenuBar 控件的可继承样式。 您可以使用此类选择器设置 Menu 类的所有样式属性的值,包括 undefined 。 | MenuBar | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件右边到其父容器的内容区域右边之间的水平距离(以像素为单位). | UIComponent | |||
rollOverColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用户将鼠标滑过菜单项时,菜单项背景的颜色。Halo 主题的默认值为 0xB2E1FF 。Spark 主题的默认值为 0xCEDBEF 。
| MenuBar | ||
selectionColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 选中菜单项时,菜单项背景的颜色。Halo 主题的默认值为 0x7FCEFF 。Spark 主题的默认值为 0xA8C6EE 。
| MenuBar | ||
类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 1.5 当此组件无效时,显示错误边框或外观 | UIComponent | |||
类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 1.5 如果此组件无效,当用户将鼠标移到它上方时,将显示错误提示 | UIComponent | |||
textAlign | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器内文本的对齐方式。可能值有: "left" 、"right" 或 "center" 。
大多数组件的默认值为 | MenuBar | ||
textDecoration | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否加下划线。可能值有: "none" 和 "underline" 。
默认值为 "none" 。 | MenuBar | ||
textFieldClass | 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 实现此组件用来呈示文本的 IUITextField 的类。 它可以设置为 mx.core.UITextField 类(以使用 Flash Player 内置经典 TextField 类)或 mx.core.UIFTETextField 类(以使用 Text Layout Framework 改进文本呈示,包括双向布局)。 默认值为 mx.core.UITextField 。 | MenuBar | ||
textIndent | 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本第一行偏离容器左侧的距离(以像素为单位)。 默认值为 0 。 | MenuBar | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件顶边到其父容器的内容区域顶边之间的垂直距离(以像素为单位). | UIComponent | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的垂直距离(以像素为单位). | UIComponent |
样式 | 说明 | 由以下参数定义 | ||
---|---|---|---|---|
类型: uint 格式: Color CSS 继承: 是 主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 组件的主要颜色. | UIComponent | |||
cornerRadius | 类型: Number 格式: Length CSS 继承: 否 主题: halo, spark 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件角的半径。下列组件支持此样式:Alert、Button、ComboBox、LinkButton、MenuBar、NumericStepper、Panel、ScrollBar、Tab、TitleWindow 以及任何支持设置为 "solid" 的 borderStyle 属性的组件。默认值取决于组件类;如果没有覆盖该类的默认值,则 Halo 主题的默认值为 0 ,Spark 主题的默认值为 2 。
| MenuBar | ||
symbolColor | 类型: uint 格式: Color CSS 继承: 是 主题: spark 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 组件的任何元件的颜色。示例包括 CheckBox 的复选标记或 ScrollBar 按钮的箭头。 默认值为 0x000000 。 | MenuBar |
样式 | 说明 | 由以下参数定义 | ||
---|---|---|---|---|
borderColor | 类型: uint 格式: Color CSS 继承: 否 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 边框颜色。下列控件支持此样式:Button、CheckBox、ComboBox、MenuBar、NumericStepper、ProgressBar、RadioButton、ScrollBar、Slider 以及任何支持 borderStyle 样式的组件。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 0xB7BABC 。
| MenuBar | ||
cornerRadius | 类型: Number 格式: Length CSS 继承: 否 主题: halo, spark 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件角的半径。下列组件支持此样式:Alert、Button、ComboBox、LinkButton、MenuBar、NumericStepper、Panel、ScrollBar、Tab、TitleWindow 以及任何支持设置为 "solid" 的 borderStyle 属性的组件。默认值取决于组件类;如果没有覆盖该类的默认值,则 Halo 主题的默认值为 0 ,Spark 主题的默认值为 2 。
| MenuBar | ||
fillAlphas | 类型: Array CSS 继承: 否 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用于填充控件背景的 Alpha。使用 [1, 1] 可使控件背景不透明。 默认值为 [ 0.6, 0.4 ] 。 | MenuBar | ||
fillColors | 类型: Array 格式: Color CSS 继承: 否 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 为控件背景着色所使用的颜色。对具有均匀外观控件的两个值传递相同的颜色。 默认值为 [ 0xFFFFFF, 0xCCCCCC ] 。 | MenuBar | ||
highlightAlphas | 类型: Array CSS 继承: 否 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 Alpha 透明度,用于加亮填充控件。第一个值指定加亮部分顶部的透明度,第二个值指定加亮部分底部的透明度。加亮部分覆盖了外观的上半部分。 默认值为 [ 0.3, 0.0 ] 。 | MenuBar | ||
类型: uint 格式: Color CSS 继承: 是 主题: halo 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件的主题颜色. | UIComponent |
dataDescriptor | 属性 |
dataDescriptor:IMenuDataDescriptor
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
访问并处理数据提供程序中数据的对象。MenuBar 控件使用数据描述符来提供其数据的相关信息。然后,这些数据用于分析和移动数据源。为 MenuBar 定义的数据描述符可供所有子项菜单和子菜单使用。
如果要将此属性指定为 MXML 中的某个属性,则必须使用对数据描述符的引用,而不是描述符的字符串名称。请使用下列格式设置此属性:
<mx:MenuBar id="menubar" dataDescriptor="{new MyCustomDataDescriptor()}"/>
或者,您可以在 MXML 中将该属性指定为嵌套子标签,如下例所示:
<mx:MenuBar> <mx:dataDescriptor> <myCustomDataDescriptor> </mx:dataDescriptor> ...
默认值为 DefaultDataDescriptor 类的内部实例。
实现
public function get dataDescriptor():IMenuDataDescriptor
public function set dataDescriptor(value:IMenuDataDescriptor):void
dataProvider | 属性 |
dataProvider:Object
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
对象的层次结构,显示为 MenuBar 项目和菜单。所有顶级子项都会变为 MenuBar 项目,其子项将变为菜单和子菜单中的项目。MenuBar 控件按如下方式处理源数据对象:
- 包含有效 XML 文本的字符串将转化为 XML 对象。
- XMLNode 将转化为 XML 对象。
- 将 XMLList 转换为 XMLListCollection。
- 将实现 ICollectionView 接口的任何对象转换为 ICollectionView。
- 将 Array 转换为 ArrayCollection。
- 将任何其它类型的对象作为 Array 的唯一条目纳入该 Array 中。
默认值为 "undefined"。
此属性可用作数据绑定的源。修改此属性后,将调度 collectionChange
事件。
实现
public function get dataProvider():Object
public function set dataProvider(value:Object):void
hasRoot | 属性 |
iconField | 属性 |
iconField:String
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
数据提供程序中字段的名称,该字段用于确定要为每个菜单项显示的图标。默认情况下,MenuBar 不会尝试将菜单项中的图标和文本一起显示。您可以通过指定图标字段定义一个图形,将其作为菜单项的图标创建并显示。
MenuItemRenderer 将从数据提供程序中查找由 iconField
属性定义了名称的属性。如果该属性的值为一个 Class,则将实例化此类并需要将其转化为 IFlexDisplayObject 实例。如果该属性的值是一个字符串,则将从应用程序中查找是否存在同名的 Class;如果没有同名类,则从文档中查找同名的属性,并根据需要将该属性映射到一个 Class 中。
默认值为 "icon"。
此属性可用作数据绑定的源。修改此属性后,将调度 iconFieldChanged
事件。
实现
public function get iconField():String
public function set iconField(value:String):void
labelField | 属性 |
labelField:String
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
数据提供程序中的字段名称,用以确定每个菜单项的显示文本。如果数据提供程序是一个字符串 Array,则 Flex 会将每个字符串值作为标签使用。如果数据提供程序是一个 E4X XML 对象,则必须显式设置此属性。例如,使用
默认值为 "label"。
此属性可用作数据绑定的源。修改此属性后,将调度 labelFieldChanged
事件。
实现
public function get labelField():String
public function set labelField(value:String):void
labelFunction | 属性 |
public var labelFunction:Function
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
用于确定每个菜单项的显示文本的函数。标签函数必须在数据提供程序中查找一个或多个相应的字段,并返回一个可显示的字符串。如果省略此属性,Flex 将使用 labelField
属性指定的字段或属性的内容。如果指定了此属性,则 Flex 将忽略任何 labelField
属性值。labelFunction
属性非常适用于处理格式设置和本地化。
标签函数必须使用数据提供程序中的项目作为单个参数,并返回一个字符串。
myLabelFunction(item:Object):String
默认值为 "undefined"。
menuBarItemRenderer | 属性 |
menuBarItemRenderer:IFactory
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
由 MenuBar 控件应用于 MenuBar 控件顶级菜单栏的项呈示器。
您可以为 MenuBar 控件的弹出子菜单定义一个项呈示器。由于每个弹出子菜单都是 Menu 控件的一个实例,您可以使用 MenuItemRenderer 类为弹出子菜单定义项呈示器。要为弹出子菜单设置项呈示器,请使用 menus
属性访问 Menu 对象。
默认值为 "mx.controls.menuClasses.MenuBarItem"。
此属性可用作数据绑定的源。修改此属性后,将调度 menuBarItemRendererChanged
事件。
实现
public function get menuBarItemRenderer():IFactory
public function set menuBarItemRenderer(value:IFactory):void
相关 API 元素
menuBarItems | 属性 |
public var menuBarItems:Array
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
包含 MenuBarItem 对象的 Array,这些对象用于呈示 MenuBar 控件顶级菜单栏中的所有项目。默认情况下,此属性包含 MenuBarItem 类的实例。不应直接将项目添加到 menuBarItems
数组中。若要添加新的 menubar 项目,请将其直接添加到 MenuBar 控件的数据提供程序中。
默认值为 [ ]。
相关 API 元素
menuBarItemStyleFilters | 属性 |
menus | 属性 |
public var menus:Array
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
包含 Menu 对象的 Array,这些对象与 MenuBar 控件的弹出子菜单对应。每个 MenuBar 项目都可以在 Array 中找到对应的 Menu 对象,即使该项目不包含弹出子菜单。Flex 起初不会填充 menus
数组,而是根据需要动态创建菜单。不应直接将项目添加到 menus
Array 中。若要添加新的下拉菜单,请将其直接添加到 MenuBar 控件的数据提供程序中。
默认值为 [ ]。
selectedIndex | 属性 |
showRoot | 属性 |
showRoot:Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
指定是否显示数据提供程序的根节点的布尔值标志。如果数据提供程序具有根节点,并且 showRoot
属性设置为 false
,则 MenuBar 控件上的项目与此根节点的直接子级节点对应。此标志对不包含根节点的数据提供程序(如 List 和 Array)不会产生任何影响。
默认值为 true。
实现
public function get showRoot():Boolean
public function set showRoot(value:Boolean):void
相关 API 元素
MenuBar | () | 构造函数 |
public function MenuBar()
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
构造函数。
getMenuAt | () | 方法 |
itemToIcon | () | 方法 |
itemToLabel | () | 方法 |
measure | () | 方法 |
override protected function measure():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
根据 MenuBar 项目的默认宽度计算 MenuBar 的首选宽度和高度。
updateBackground | () | 方法 |
protected function updateBackground():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
更新 MenuBar 控件的背景外观。当创建 MenuBar 子项或 MenuBar 上的任何样式发生更改时调用此方法。
change | 事件 |
mx.events.MenuEvent
属性 MenuEvent.type =
mx.events.MenuEvent.CHANGE
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当选项由于用户交互操作而发生更改时调度。当用户在弹出子菜单中更改了当前菜单选项时也会调度此事件。如果此事件发生在菜单栏上,则 MenuEvent 对象的 menu
属性将为 null
。如果发生在弹出子菜单中,则 menu
属性将包含对代表弹出子菜单的 Menu 对象的引用。
此事件类型的事件对象属性包含以下值。并非所有属性对于各种事件都有意义。有关详细信息,请参阅详细的属性说明。
属性 | 值 |
---|---|
bubbles | false |
cancelable | true |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
index | 选定菜单项在菜单中的索引。 |
item | dataProvider 中选定的项目。 |
itemRenderer | 选定菜单项的项呈示器。 |
label | 选定菜单项的标签文本。 |
menu | 与此事件关联的特定 Menu 实例;如果 MenuBar 项目正在调度此事件时,则为 null 。 |
menuBar | 作为 Menu 控件父项的 MenuBar 实例;如果 Menu 控件不是 MenuBar 控件的子项,则为 null 。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | MenuEvent.CHANGE |
itemClick | 事件 |
mx.events.MenuEvent
属性 MenuEvent.type =
mx.events.MenuEvent.ITEM_CLICK
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当用户选择弹出子菜单中的项目时调度。
MenuEvent.ITEM_CLICK 事件类型常量指示用户已选择菜单项。此事件类型的事件对象属性包含以下值。并非所有属性对于各种事件都有意义。有关详细信息,请参阅详细的属性说明。
属性 | 值 |
---|---|
bubbles | false |
cancelable | true |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
index | 选定菜单项在菜单中的索引。 |
item | dataProvider 中选定的项目。 |
itemRenderer | 选定菜单项的 ListItemRenderer。 |
label | 选定菜单项的标签文本。 |
menu | 与此事件关联的特定 Menu 实例;如果 MenuBar 项目正在调度此事件时,则为 null 。 |
menuBar | 作为 Menu 控件父项的 MenuBar 实例;如果 Menu 控件不是 MenuBar 控件的子项,则为 null 。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | MenuEvent.ITEM_CLICK |
itemRollOut | 事件 |
mx.events.MenuEvent
属性 MenuEvent.type =
mx.events.MenuEvent.ITEM_ROLL_OUT
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当鼠标指针滑离菜单项时调度。
MenuEvent.ITEM_ROLL_OUT 类型常量指示鼠标指针滑离菜单项。此事件类型的事件对象属性包含以下值。并非所有属性对于各种事件都有意义。有关详细信息,请参阅详细的属性说明。
属性 | 值 |
---|---|
bubbles | false |
cancelable | true |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
index | 鼠标指针滑离的菜单项的菜单中的索引。 |
item | 对应于鼠标指针滑离的菜单项的 dataProvider 中的项目。 |
itemRenderer | 鼠标指针滑离的菜单项的 ListItemRenderer。 |
label | 鼠标指针滑离的菜单项的标签文本。 |
menu | 与此事件关联的特定 Menu 实例;如果 MenuBar 项目正在调度此事件时,则为 null 。 |
menuBar | 作为 Menu 控件父项的 MenuBar 实例;如果 Menu 控件不是 MenuBar 控件的子项,则为 null 。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | MenuEvent.ITEM_ROLL_OUT |
itemRollOver | 事件 |
mx.events.MenuEvent
属性 MenuEvent.type =
mx.events.MenuEvent.ITEM_ROLL_OVER
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当鼠标指针滑过菜单项时调度。
MenuEvent.ITEM_ROLL_OVER 类型常量指示鼠标指针悬停在菜单项上。此事件类型的事件对象属性包含以下值。并非所有属性对于各种事件都有意义。有关详细信息,请参阅详细的属性说明。
属性 | 值 |
---|---|
bubbles | false |
cancelable | true |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
index | 鼠标指针在其上悬停的菜单项的菜单中的索引。 |
item | 与鼠标指针悬停在其上的菜单项关联的 dataProvider 中的项目。 |
itemRenderer | 鼠标指针在其上悬停的菜单项的 ListItemRenderer。 |
label | 鼠标指针在其上悬停的菜单项的标签文本。 |
menu | 与此事件关联的特定 Menu 实例;如果 MenuBar 项目正在调度此事件时,则为 null 。 |
menuBar | 作为 Menu 控件父项的 MenuBar 实例;如果 Menu 控件不是 MenuBar 控件的子项,则为 null 。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | MenuEvent.ITEM_ROLL_OVER |
menuHide | 事件 |
mx.events.MenuEvent
属性 MenuEvent.type =
mx.events.MenuEvent.MENU_HIDE
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当弹出子菜单关闭时调度。
MenuEvent.MENU_HIDE 事件类型常量指示菜单或子菜单已关闭。此事件类型的事件对象属性包含以下值。并非所有属性对于各种事件都有意义。有关详细信息,请参阅详细的属性说明。
属性 | 值 |
---|---|
bubbles | false |
cancelable | true |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
index | -1。对于这种类型的事件未设置此属性。 |
item | null。对于这种类型的事件未设置此属性。 |
itemRenderer | null。对于这种类型的事件未设置此属性。 |
label | null。对于这种类型的事件未设置此属性。 |
menu | 与此事件关联的特定 Menu 实例;如果 MenuBar 项目正在调度此事件时,则为 null 。 |
menuBar | 作为 Menu 控件父项的 MenuBar 实例;如果 Menu 控件不是 MenuBar 控件的子项,则为 null 。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | MenuEvent.MENU_HIDE |
menuShow | 事件 |
mx.events.MenuEvent
属性 MenuEvent.type =
mx.events.MenuEvent.MENU_SHOW
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
当弹出子菜单打开或用户选择的菜单栏项目没有下拉菜单时调度。
MenuEvent.MENU_SHOW 类型常量指示鼠标指针已滑离打开的菜单或子菜单。此事件类型的事件对象属性包含以下值。并非所有属性对于各种事件都有意义。有关详细信息,请参阅详细的属性说明。
属性 | 值 |
---|---|
bubbles | false |
cancelable | true |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
index | -1。对于这种类型的事件未设置此属性。 |
item | null。对于这种类型的事件未设置此属性。 |
itemRenderer | null。对于这种类型的事件未设置此属性。 |
label | null。不为这种类型的事件设置此属性。 |
menu | 与此事件关联的特定 Menu 实例;如果 MenuBar 项目正在调度此事件时,则为 null 。 |
menuBar | 作为 Menu 控件父项的 MenuBar 实例;如果 Menu 控件不是 MenuBar 控件的子项,则为 null 。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | MenuEvent.MENU_SHOW |
<?xml version="1.0" encoding="utf-8"?> <!-- Simple example to demonstrate the Halo MenuBar control. --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx" initialize="initCollections();"> <fx:Script> <![CDATA[ import mx.collections.*; import mx.controls.Alert; import mx.events.MenuEvent; [Bindable] public var menuBarCollection:XMLListCollection; private var menubarXML:XMLList = <> <menuitem label="Menu1" data="top"> <menuitem label="MenuItem 1-A" data="1A"/> <menuitem label="MenuItem 1-B" data="1B"/> </menuitem> <menuitem label="Menu2" data="top"> <menuitem label="MenuItem 2-A" type="check" data="2A"/> <menuitem type="separator"/> <menuitem label="MenuItem 2-B" > <menuitem label="SubMenuItem 3-A" type="radio" groupName="one" data="3A"/> <menuitem label="SubMenuItem 3-B" type="radio" groupName="one" data="3B"/> </menuitem> </menuitem> </>; // Event handler to initialize the MenuBar control. private function initCollections():void { menuBarCollection = new XMLListCollection(menubarXML); } // Event handler for the MenuBar control's itemClick event. private function menuHandler(evt:MenuEvent):void { // Don't open the Alert for a menu bar item that // opens a popup submenu. if (evt.item.@data != "top") { Alert.show("Label: " + evt.item.@label + "\n" + "Data: " + evt.item.@data, "Clicked menu item"); } } ]]> </fx:Script> <s:Panel title="Halo MenuBar Control Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:VGroup left="10" right="10" top="10" bottom="10"> <s:Label width="100%" color="blue" text="Select a menu item."/> <mx:MenuBar labelField="@label" itemClick="menuHandler(event);" dataProvider="{menuBarCollection}" /> </s:VGroup> </s:Panel> </s:Application>
Tue Jun 12 2018, 11:04 AM Z