包 | mx.controls |
类 | public class ButtonBar |
继承 | ButtonBar NavBar Box Container UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
实现 | IFocusManagerComponent |
子类 | ToggleButtonBar |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
从 Flex 4.0 开始,Adobe 建议您使用 spark.components.ButtonBar 类来替代此类。 |
ButtonBar 控件可定义一组具有普通外观和导航的逻辑上相关的按压按钮,这组按钮可以是水平的也可以是垂直的。
按压按钮是一种在被选中后不会记住其选中状态的按钮。按钮栏中按压按钮的典型用途是将一组相关按钮组合到一起,提供共同的外观和导航,并在一个位置处理 click
事件的逻辑。
ButtonBar 控件可基于其 dataProvider
属性的值创建 Button 控件。虽然 ButtonBar 是容器的一个子类,但请勿使用 Container.addChild()
和 Container.removeChild()
等方法添加或删除 Button 控件。而应该使用 addItem()
和 removeItem()
等方法处理 dataProvider
属性。ButtonBar 控件会根据对 dataProvider
属性所做的更改自动添加或删除必要的子项。
要控制 ButtonBar 控件的按钮样式,请使用 buttonStyleName
、firstButtonStyleName
和 lastButtonStyleName
样式属性;请勿尝试设置组成 ButtonBar 控件的各个 Button 控件的样式。
可以使用 ToggleButtonBar 控件定义一组切换按钮。
ButtonBar 控件具有下列默认特征:
特征 | 说明 |
---|---|
首选大小 | 宽度足以包含所有按钮及其标签文本和图标(如果有),以及任何填充和分隔条;高度足以容纳按钮。 |
控件的大小调整规则 | 默认情况下不调整控件大小。如果希望 ButtonBar 基于其父容器的大小进行调整,请指定百分比大小。 |
填充 | top、bottom、left 和 right 属性均为 0 个像素。 |
The <mx:ButtonBar>
tag inherits all the tag attributes
of its superclass, and adds the following tag attributes:
<mx:ButtonBar Styles buttonHeight="undefined" buttonStyleName="Name of CSS style declaration, which specifies styles for the buttons" buttonWidth="undefined" firstButtonStyleName="The value ofbuttonStyleName
" horizontalAlign="center|left|right" horizontalGap="0" lastButtonStyleName="The value ofbuttonStyleName
" verticalAlign="middle|top|bottom" verticalGap="0" Events itemClick="No default" > ... child tags ... </mx:ButtonBar>
默认 MXML 属性dataProvider
相关 API 元素
方法 | 由以下参数定义 | ||
---|---|---|---|
构造函数。 | ButtonBar | ||
[覆盖]
向此容器添加一个子 DisplayObject 子项。 | Container | ||
[覆盖]
向此容器添加一个子 DisplayObject 子项。 | Container | ||
将可视元素添加到此容器中。 | Container | ||
将可视元素添加到此容器中。 | Container | ||
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 对象由内容坐标转换为全局坐标。 | Container | ||
[覆盖]
将 Point 对象由内容坐标转换为本地坐标。 | Container | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
提供一个 UIComponentDescriptor,创建相应的组件并将该组件添加为此容器的子项。 | Container | ||
循环访问 childDescriptor Array,并对每个元素调用 createComponentFromDescriptor() 方法。 | Container | ||
为实现 IDeferredContentOwner 接口以支持延迟实例化的容器,执行调用 createComponentsFromDescriptors(true) 方法的等效操作。 | Container | ||
在 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 | ||
[覆盖]
执行此 Container 上的所有数据绑定。 | Container | ||
执行到此 Container 的子 UIComponent 对象的绑定。 | Container | ||
打印完成后调用。 | UIComponent | ||
在指定的索引位置提供自动化对象。 | UIComponent | ||
提供自动化对象列表。 | UIComponent | ||
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | ||
按指定的元素大小,返回元素边界的 x 坐标。 | UIComponent | ||
按指定的元素大小,返回元素边界的 y 坐标。 | UIComponent | ||
[覆盖]
获取第 n 个子组件对象。 | Container | ||
[覆盖]
返回 name 属性为指定 String 的子项。 | Container | ||
[覆盖]
获取特定子项的从零开始的索引。 | Container | ||
返回由容器的内容子项组成的 DisplayObject 对象的 Array。 | Container | ||
查找此 UIComponent 实例的类型选择器。 | UIComponent | ||
返回一个约束布局值,这与获取此组件的约束样式的方式类似。 | UIComponent | ||
返回指定索引处的可视元素。 | Container | ||
返回可视元素的索引位置。 | Container | ||
确定是使用显式高度还是测量高度的一种简便方法
| UIComponent | ||
确定是使用显式宽度还是测量宽度的一种简便方法
| UIComponent | ||
获取当前具有焦点的对象。 | UIComponent | ||
返回元素的布局高度。 | UIComponent | ||
返回元素的布局宽度。 | UIComponent | ||
返回元素在屏幕上进行绘制时所用的 x 坐标。 | UIComponent | ||
返回元素在屏幕上进行绘制时所用的 y 坐标。 | UIComponent | ||
返回用于相对于其同级组件计算组件的布局的转换矩阵。 | UIComponent | ||
返回此元素的布局转换 Matrix3D。 | UIComponent | ||
返回元素的最大高度。 | UIComponent | ||
返回元素的最大宽度。 | UIComponent | ||
返回元素的最小高度。 | UIComponent | ||
返回元素的最小宽度。 | UIComponent | ||
返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。 | DisplayObjectContainer | ||
返回元素的首选高度。 | UIComponent | ||
返回元素的首选宽度。 | UIComponent | ||
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。 | DisplayObject | ||
返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。 | UIComponent | ||
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | ||
[覆盖]
将 Point 对象由全局坐标转换为内容坐标。 | Container | ||
将 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 | ||
返回呈示器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。 | NavBar | ||
将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。 | DisplayObject | ||
[覆盖]
将 Point 对象由本地坐标转换为内容坐标。 | Container | ||
将 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 | ||
用于将像素数目转换为相对于容器内容的百分比的方法。 | Box | ||
准备 IFlexDisplayObject 用于打印。 | UIComponent | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
为此组件及其所有后代生成或重新生成 CSS 样式缓存,前提条件是递归参数为 true。 | UIComponent | ||
针对每个效果事件,将 EffectManager 注册为一个事件侦听器。 | UIComponent | ||
在此容器的子项列表中删除所有子项。 | Container | ||
从容器中删除所有可视元素。 | Container | ||
[覆盖]
从此容器的子项列表中删除子 DisplayObject。 | Container | ||
[覆盖]
从此容器的子项列表中删除指定索引位置的子 DisplayObject。 | Container | ||
从 DisplayObjectContainer 实例的子级列表中删除所有子 DisplayObject 实例。 | DisplayObjectContainer | ||
从此容器的子列表中删除指定的可视元素。 | Container | ||
从容器中的指定索引位置删除可视元素。 | Container | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
从该组件实例删除非可视样式客户端。 | UIComponent | ||
重放指定的事件。 | UIComponent | ||
显示虚拟键盘。 | InteractiveObject | ||
使用提供的 ID 解析子项。 | UIComponent | ||
[静态]
在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | ||
调整对象大小。 | UIComponent | ||
[覆盖]
设置特定子项的索引。 | Container | ||
设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | ||
设置当前状态。 | UIComponent | ||
在可视容器中更改现有可视元素的位置。 | Container | ||
设置此组件的焦点。 | 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 | ||
交换两个指定可视元素的索引。 | Container | ||
交换容器中位于两个指定索引位置的可视元素。 | Container | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | 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 |
事件 | 摘要 | 由以下参数定义 | ||
---|---|---|---|---|
[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | |||
当组件通过使用 addChild()、addChildAt()、addElement() 或 addElementAt() 方法作为内容子项添加到容器后调度。 | UIComponent | |||
将显示对象添加到显示列表中时调度。 | DisplayObject | |||
在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 | DisplayObject | |||
将子项添加到容器后调度。 | Container | |||
容器子项的索引(在容器子项中)发生更改后调度。 | Container | |||
删除容器的子项之前调度。 | Container | |||
当用户从文本上下文菜单中选择“清除”(或“删除”)时调度。 | InteractiveObject | |||
当用户手势触发 AIR 应用程序中与此交互式对象相关联的上下文菜单时调度。 | InteractiveObject | |||
在用户为复制操作激活特定于平台的加速键组合或从文本上下文菜单中选择“复制”时调度。 | InteractiveObject | |||
当组件完成其构建、属性处理、测量、布置和绘制时调度。 | UIComponent | |||
视图状态更改后调度。 | UIComponent | |||
在 currentState 属性更改后但视图状态更改前调度。 | UIComponent | |||
在用户为剪切操作激活特定于平台的加速键组合或从文本上下文菜单中选择“剪切”时调度。 | InteractiveObject | |||
当 data 属性更改时进行调度。 | Container | |||
[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | |||
如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。 | InteractiveObject | |||
在拖动操作完成时(将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时)由拖动启动器(作为要拖动的数据源的组件)调度。 | UIComponent | |||
用户在放置目标上释放鼠标时由放置目标调度。 | UIComponent | |||
当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时,由该组件调度。 | UIComponent | |||
用户在组件外拖动但没有将数据放置到目标时,由组件调度。 | UIComponent | |||
在拖动操作期间,当用户在鼠标位于组件上方的情况下移动鼠标时,由组件调度。 | UIComponent | |||
启动拖动操作时,由拖动启动器调度。 | UIComponent | |||
在一个效果结束后调度。 | UIComponent | |||
在即将开始播放效果前调度。 | UIComponent | |||
在停止某个效果(仅当对该效果调用 stop() 时发生)之后调度。 | UIComponent | |||
[播放事件] 播放头进入新帧时调度。 | DisplayObject | |||
在组件已进入视图状态之后调度。 | UIComponent | |||
[广播事件] 播放头退出当前帧时调度。 | DisplayObject | |||
在组件即将退出视图状态之前调度。 | UIComponent | |||
[广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。 | 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 | |||
用户单击按钮时调度。 | ButtonBar | |||
用户按下某个键时调度。 | InteractiveObject | |||
用户尝试使用键盘导航更改焦点时调度。 | InteractiveObject | |||
用户释放某个键时调度。 | InteractiveObject | |||
当用户在同一 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 |
样式为常见样式,或与特定主题关联。如果为常见样式,则可以用于任何主题。如果样式与特定主题关联,则只有应用程序使用该主题时才能使用该样式。
样式 | 说明 | 由以下参数定义 | ||
---|---|---|---|---|
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位). | UIComponent | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件底边到其父容器的内容区域底边之间的垂直距离(以像素为单位). | UIComponent | |||
buttonHeight | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 每个按钮的高度(以像素为单位)。如果尚未定义,则每个按钮的高度由应用于该容器的字体样式确定。如果设置了此属性,则指定的值将覆盖此计算值。 | ButtonBar | ||
buttonStyleName | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 为按钮指定样式的 CSS 样式声明的名称。 | ButtonBar | ||
buttonWidth | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 每个按钮的宽度(以像素为单位)。如果尚未定义,将根据每个按钮的标签文本计算其默认宽度。 | ButtonBar | ||
类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件中文本(包括组件标签)的颜色. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 此组件显示的文本的方向性. | Container | |||
类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 禁用时组件中文本的颜色. | Container | |||
类型: Number CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 禁用容器时放置在容器上的叠加层的 alpha 值. | Container | |||
类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 验证失败时,组件加亮部分的颜色. | UIComponent | |||
firstButtonStyleName | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 为第一个按钮指定样式的 CSS 样式声明的名称。如果未指定,则使用 buttonStyleName 样式属性的默认值。
| ButtonBar | ||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置内部 TextField 的 antiAliasType 属性. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 使用的字体的名称. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性. | Container | |||
类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性. | Container | |||
类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本的高度,以像素为单位. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用斜体. | Container | |||
类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否使用粗体. | Container | |||
horizontalAlign | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 ButtonBar 中的所有按钮水平对齐。因为各个按钮可以拉伸以填充整个 ButtonBar,所以仅当使用 buttonWidth 样式并且按钮的宽度和小于 ButtonBar 的宽度时,才使用此样式。可能值包括 "left" 、"center" 和 "right" 。
默认值为 "center" 。 | ButtonBar | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的水平距离(以像素为单位). | UIComponent | |||
horizontalGap | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 水平方向上各子代之间的像素数。Halo 主题的默认值为 0 。Spark 主题的默认值为 -1 。
| ButtonBar | ||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 2.5 该组件的主要交互模式. | UIComponent | |||
类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 一个布尔值,表示是启用 ( true ) 还是禁用 (false ) 字距调整. | Container | |||
lastButtonStyleName | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 指定最后一个按钮样式的 CSS 样式声明的名称。如果未指定,则使用 buttonStyleName 样式属性的默认值。
| ButtonBar | ||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.1 运行时版本: Flash10, AIR 1.5 指定组件的所需布局方向. | UIComponent | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件左边到其父容器的内容区域左边之间的水平距离(以像素为单位). | UIComponent | |||
类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 各字符之间显示的附加像素数. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 此组件显示的文本的区域设置. | Container | |||
类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器的下边框与其内容区域底部之间的像素数目. | Box | |||
类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件左边框与其内容区域左边缘之间的像素数目. | Container | |||
类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 组件右边框与其内容区域右边缘之间的像素数目. | Container | |||
类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器的上边框与其内容区域顶部之间的像素数目. | Box | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件右边到其父容器的内容区域右边之间的水平距离(以像素为单位). | UIComponent | |||
类型: 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 | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 容器内文本的对齐方式. | Container | |||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 确定文本是否加下划线. | Container | |||
类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 实现此组件用来呈示文本的 IUITextField 的类. | Container | |||
类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 文本第一行偏离容器左侧的距离(以像素为单位). | Container | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件顶边到其父容器的内容区域顶边之间的垂直距离(以像素为单位). | UIComponent | |||
verticalAlign | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 ButtonBar 中的所有按钮垂直对齐。因为各个按钮可以拉伸以填充整个 ButtonBar,所以仅当使用 buttonHeight 样式并且按钮的高度和小于 ButtonBar 的宽度时,才使用此样式。可能值包括 "top" 、"middle" 和 "bottom" 。
默认值为 "middle" 。 | ButtonBar | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的垂直距离(以像素为单位). | UIComponent | |||
verticalGap | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 垂直方向上各子项间的像素数目。 默认值为 0 。 | ButtonBar |
ButtonBar | () | 构造函数 |
public function ButtonBar()
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
构造函数。
itemClick | 事件 |
mx.events.ItemClickEvent
属性 ItemClickEvent.type =
mx.events.ItemClickEvent.ITEM_CLICK
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
用户单击按钮时调度。此事件只在 dataProvider
属性不引用 ViewStack 容器时调度。
ItemClickEvent.ITEM_CLICK
常量可为 itemClick
事件定义事件对象的 type
属性值。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
index | 单击的导航项目的索引。 |
item | 单击的导航项目在数据提供程序中的项目。 |
label | 单击的导航项目的标签。 |
relatedObject | 生成事件的子对象。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
<?xml version="1.0" encoding="utf-8"?> <!-- Simple example to demonstrate the Halo ButtonBar 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"> <fx:Script> <![CDATA[ import mx.events.ItemClickEvent; // Event handler function to print a message // describing the selected Halo Button control. private function clickHandler(evt:ItemClickEvent):void { myTA.text="Selected button index: " + String(evt.index) + "\n" + "Selected button label: " + evt.label; } ]]> </fx:Script> <s:Panel title="Halo ButtonBar 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 button in the Halo ButtonBar control."/> <s:TextArea id="myTA" width="100%" height="100%"/> <mx:ButtonBar itemClick="clickHandler(event);"> <mx:dataProvider> <fx:Array> <fx:String>Flex</fx:String> <fx:String>Flash</fx:String> <fx:String>ColdFusion</fx:String> <fx:String>Dreamweaver</fx:String> <fx:String>Director</fx:String> </fx:Array> </mx:dataProvider> </mx:ButtonBar> </s:VGroup> </s:Panel> </s:Application>
Tue Jun 12 2018, 11:04 AM Z