| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
 | 从 Flex 4.0 开始，Adobe 建议您使用 spark.components.BorderContainer 类来替代此类。 |
| 从 Flex 4.0 开始，Adobe 建议您使用 spark.components.VGroup 类来替代此类。 |
Halo VBox 容器将其子项放在同一垂直列上。使用
<mx:VBox> 标签（而非 <mx:Box> 标签）作为快捷方式可以不必将 direction 属性设为 "vertical"。
注意：Adobe 建议您，如果可能，请使用具有 VerticalLayout 的 Spark 容器，而不使用 Halo VBox 容器。
VBox 容器具有以下默认大小特性：
| 特征 | 说明 |
|---|---|
| 默认大小 | 高度足以容纳使用默认或明确指定的高度的所有子项、各子项之间的所有垂直间隔，以及容器的上下填充。宽度为最宽的子容器的默认宽度或明确指定的宽度与容器的左填充和右填充之和。 |
| 默认填充 | 上、下、左、右的值均为 0 像素。 |
显示 MXML 语法
隐藏 MXML 语法The <mx:VBox> tag inherits all of the tag
attributes of its superclass, except direction, and adds
no new tag attributes.
相关 API 元素
受保护的属性
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
VBox()
构造函数。 | VBox | ||
 | [覆盖]
向此容器添加一个子 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 | |
|
将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。 | 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 | |
受保护的方法
构造函数详细信息
VBox | () | 构造函数 |
public function VBox()| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
构造函数。
示例 如何使用本示例
VBoxExample.mxml
<?xml version="1.0"?>
<!-- Simple example to demonstrate the Halo VBox layout container. -->
<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">
<s:Panel title="VBox Container 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="A VBox container with vertically aligned children."/>
<mx:VBox borderStyle="solid"
paddingLeft="10" paddingRight="10" paddingTop="10" paddingBottom="10">
<s:Button label="Button 1"/>
<s:Button label="Button 2"/>
<s:Button label="Button 3"/>
<s:DropDownList/>
</mx:VBox>
</s:VGroup>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 11:04 AM Z