| 包 | mx.containers |
| 类 | public class Grid |
| 继承 | Grid Box Container UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
<mx:Grid> 标签定义 Grid 容器。
<mx:GridRow> 标签定义网格行,其中包含一个或多个单元格。网格行必须是 <Grid> 标签的子项。
<mx:GridItem> 标签定义网格单元格,该标签必须是 <GridRow> 标签的子项。<mx:GridItem> 标签可以包含任意数目的子项。
每一行中所有单元格的高度都相同,但各行的高度可以不同。每一列中所有单元格的宽度都相同,但各列的宽度可以不同。您可以为 Grid 容器中的各行或各列定义不同数目的单元格。此外,一个单元格可以跨越容器中的多列或多行。
Grid、GridRow 和 GridItem 容器具有下列默认大小特征:
| 特征 | 说明 |
|---|---|
| 网格高度 | 所有行的默认或显式高度之和加上各行之间的间距。 |
| 网格宽度 | 所有列的默认或显式宽度之和加上各列之间的间距。 |
| 每行以及每个单元格的高度 | 默认值或行中最高项目的显式高度。如果 GridItem 容器未设定显式大小,则其默认高度为单元格中子项的默认或显式高度。 |
| 每列以及每个单元格的宽度 | 默认值或列中最宽项目的显式宽度。如果 GridItem 容器未设定显式宽度,则其默认宽度为单元格中子项的默认或显式宽度。 |
| 行与列的间距 | 由 Grid 类的 horizontalGap 和 verticalGap 属性确定。这两个间距的默认值是 6 个像素。 |
| 默认填充 | 所有三个容器类的 top、bottom、left 和 right 值均为 0 个像素。 |
隐藏 MXML 语法The <mx:Grid> tag inherits all of the tag
attributes of its superclass, except the Box.direction
property, and adds the following tag attributes:
<mx:Grid
Styles
horizontalGap="8"
verticalGap="6"
>
...
These child tags are examples only:
<mx:GridRow id="row1">
<mx:GridItem
rowSpan="1"
colSpan="1">
<mx:Button label="Button 1"/>
</mx:GridItem>
...
</mx:GridRow>
...
</mx:Grid>
另请参见
| 方法 | 定义方 | ||
|---|---|---|---|
Grid() 构造函数。 | Grid | ||
![]() | 向此容器添加一个子 DisplayObject 子项。 | Container | |
![]() | 向此容器添加一个子 DisplayObject 子项。 | Container | |
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | |
![]() | 指示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | |
![]() | 排队稍后调用的函数。 | UIComponent | |
![]() | 删除此组件实例中的样式属性。 | UIComponent | |
![]() | 确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | |
![]() | 将 Point 对象由内容坐标转换为全局坐标。 | Container | |
![]() | 将 Point 对象由内容坐标转换为本地坐标。 | Container | |
![]() | 返回标识此容器中的子项的一组属性。 | UIComponent | |
![]() | 提供一个 UIComponentDescriptor,创建相应的组件并将该组件添加为此 Container 的子项。 | Container | |
![]() | 循环访问 childDescriptor Array,并对每个元素调用 createComponentFromDescriptor() 方法。 | Container | |
![]() | 在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | |
![]() | 在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | |
![]() | 返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | |
![]() | 将事件调度到事件流中。 | UIComponent | |
![]() | 在此组件周围显示或隐藏焦点指示符。 | UIComponent | |
![]() | drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void 通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | |
![]() | 停止在组件上播放效果实例时,由效果实例调用。 | UIComponent | |
![]() | 开始在组件上播放效果实例时,由效果实例调用。 | UIComponent | |
![]() | 结束组件上当前播放的所有效果。 | UIComponent | |
![]() | 执行此 Container 上的所有数据绑定。 | Container | |
![]() | 执行到此 Container 的子 UIComponent 对象的绑定。 | Container | |
![]() | 打印完成后调用。 | UIComponent | |
![]() | 在指定的索引位置提供自动化对象。 | UIComponent | |
![]() | 返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
![]() | 获取第 n 个子组件对象。 | Container | |
![]() | 返回 name 属性为指定 String 的子项。 | Container | |
![]() | 获取特定子项的从零开始的索引。 | Container | |
![]() | 返回由容器的内容子项组成的 DisplayObject 对象的 Array。 | Container | |
![]() | 查找此 UIComponent 实例的类型选择器。 | UIComponent | |
![]() | 返回一个约束布局值,这与获取此组件的约束样式的方式类似。 | UIComponent | |
![]() | 确定是使用显式高度还是测量高度的一种简便方法 | UIComponent | |
![]() | 确定是使用显式宽度还是测量宽度的一种简便方法 | UIComponent | |
![]() | 获取当前具有焦点的对象。 | UIComponent | |
![]() | 返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。 | DisplayObjectContainer | |
![]() | 返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。 | DisplayObject | |
![]() | 返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。 | UIComponent | |
![]() | 获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | |
![]() | 将 Point 对象由全局坐标转换为内容坐标。 | Container | |
![]() | 将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。 | DisplayObject | |
![]() | 将二维点从舞台(全局)坐标转换为三维显示对象的(本地)坐标。 | DisplayObject | |
![]() | 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
![]() |
指示对象是否已经定义了指定的属性。 | Object | |
![]() | 计算显示对象,以确定它是否与 obj 显示对象重叠或相交。 | DisplayObject | |
![]() | 计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
![]() | 返回一个框 Matrix,在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | |
![]() | 初始化此组件的内部结构。 | UIComponent | |
![]() | 初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | |
![]() | 标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | |
![]() | 标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | |
![]() | 标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | |
![]() |
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
![]() | 将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。 | DisplayObject | |
![]() | 将 Point 对象由本地坐标转换为内容坐标。 | Container | |
![]() | 将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。 | DisplayObject | |
![]() | 测量指定的 HTML 文本(该文本中可能包含 <font> 和 <b> 等 HTML 标记),假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | |
![]() | 测量指定的文本,假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | |
![]() | 将组件移动到其父项内的指定位置。 | UIComponent | |
![]() | 将样式更改传播到子项。 | UIComponent | |
![]() | 如果 owner 属性链从 child 指向此 UIComponent,则返回 true。 | UIComponent | |
![]() | 当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | |
![]() | 用于将像素数目转换为相对于容器内容的百分比的方法。 | Box | |
![]() | 准备 IFlexDisplayObject 用于打印。 | UIComponent | |
![]() |
指示指定的属性是否存在、是否可枚举。 | Object | |
![]() | 为此组件构建或重新构建 CSS 样式缓存;如果 recursive 参数为 true,还会为此组件的所有后代执行同样的操作。 | UIComponent | |
![]() | 针对每个效果事件,将 EffectManager 注册为一个事件侦听器。 | UIComponent | |
![]() | 在此容器的子项列表中删除所有子项。 | Container | |
![]() | 从此容器的子项列表中删除子 DisplayObject。 | Container | |
![]() | 从此容器的子项列表中删除指定索引位置的子 DisplayObject。 | Container | |
![]() | 从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
![]() | 重放指定的事件。 | UIComponent | |
![]() | 使用提供的 ID 解析子项。 | UIComponent | |
![]() | [静态] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | |
![]() | 调整对象大小。 | UIComponent | |
![]() | 设置特定子项的索引。 | Container | |
![]() | 设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | |
![]() | 设置当前状态。 | UIComponent | |
![]() | 设置此组件的焦点。 | UIComponent | |
![]() |
设置循环操作动态属性的可用性。 | Object | |
![]() | 对此组件实例设置样式属性。 | UIComponent | |
![]() | 当 visible 属性发生更改时调用。 | UIComponent | |
![]() | 允许用户拖动指定的 Sprite。 | Sprite | |
![]() | 结束 startDrag() 方法。 | Sprite | |
![]() | 检测对样式属性的更改。 | UIComponent | |
![]() | 首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。 | UIComponent | |
![]() | [静态] 阻止对使用 callLater() 排队的方法进行背景处理,直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | |
![]() | 交换两个指定子对象的 Z 轴顺序(从前到后顺序)。 | DisplayObjectContainer | |
![]() | 在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。 | DisplayObjectContainer | |
![]() | 返回一个字符串,用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | |
![]() | 验证子项的位置和大小,并绘制其它可视内容。 | UIComponent | |
![]() | 验证并更新此对象的属性和布局,如果需要的话重绘对象。 | UIComponent | |
![]() | 由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | |
![]() | 如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法,随后在测量时调用了 validateSize() 方法,则验证组件的度量大小。 | UIComponent | |
![]() | 处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | |
![]() |
返回指定对象的原始值。 | Object | |
![]() | 返回一个框 Matrix,在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | |
![]() | 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher | |
| 方法 | 定义方 | ||
|---|---|---|---|
![]() | 调整焦点矩形。 | UIComponent | |
![]() | 供溶解效果在内部用来添加叠加层到容器的镶边。 | Container | |
![]() | 创建子对象后执行任何最终处理。 | UIComponent | |
![]() | 处理对组件设置的属性。 | UIComponent | |
![]() | 如果需要容器的边框外观,但却不存在,则创建容器的边框外观。 | Container | |
![]() | 创建组件的子对象。 | UIComponent | |
![]() | 根据所用的嵌入字体使用上下文创建新对象。 | UIComponent | |
![]() | 使用给定的 moduleFactory 创建对象。 | UIComponent | |
![]() | 当 UIComponent 对象获得焦点时调用的事件处理函数。 | UIComponent | |
![]() | 当 UIComponent 对象失去焦点时调用的事件处理函数。 | UIComponent | |
![]() | 完成对此组件的初始化。 | UIComponent | |
![]() | 初始化此组件的辅助功能代码。 | UIComponent | |
![]() | 通常由包含 UITextField 对象的组件覆盖,其中 UITextField 对象获取焦点。 | UIComponent | |
![]() | 为 keyDown 事件调用的事件处理函数。 | UIComponent | |
![]() | 为 keyUp 事件调用的事件处理函数。 | UIComponent | |
![]() | 通过设置此容器边框的位置和大小响应大小更改。 | Container | |
计算 Grid 的首选大小、最小大小和最大大小。 | Grid | ||
![]() | 构建 UIComponent 时将调用此方法,并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时,都会再次调用此方法。 | UIComponent | |
![]() | 基于 horizontalScrollPosition 和 verticalScrollPosition 属性,确定容器的内容区域相对于可查看区域的位置。 | Container | |
设置 Grid 中每个子项的大小和位置。 | Grid | ||
| 样式 | 说明 | 定义方 | ||
|---|---|---|---|---|
![]() | 类型: Number CSS 继承: nobackgroundColor 属性定义的颜色和 backgroundImage 样式定义的图像或 SWF 文件的 Alpha 级别。有效值范围为从 0. | Container | ||
![]() | 类型: String CSS 继承: no 如果指定了背景图像,则此样式指定它是相对于视域保持固定状态 ( "fixed") 还是随着内容一起滚动 ("scroll")。. | Container | ||
![]() | 类型: uint 格式: Color CSS 继承: no 组件的背景颜色。您可以同时设置 backgroundColor 和 backgroundImage。一些组件没有背景。DataGrid 控件会忽略此样式。默认值为 undefined,即不进行设置。如果此样式和 backgroundImage 样式都为 undefined,则控件将采用透明背景。 对于 Application 容器,此样式指定应用程序加载时的背景色以及运行该应用程序时的背景渐变。Flex 计算比指定颜色略深的颜色和比指定颜色略浅的颜色之间的渐变。 大多数 Flex 控件的默认外观为半透明。因此,容器的背景颜色将在某种程度上“渗入”该容器中的控件。通过将控件的 <mx: Container backgroundColor="0x66CC66"/> <mx: ControlName ... | Container | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 禁用组件时的组件的背景颜色。全局默认值为 undefined。List 控件的默认值为 0xDDDDDD(浅灰)。如果禁用了容器,背景将变暗,而暗淡程度由 disabledOverlayAlpha 样式控制。. | Container | ||
![]() | 类型: Object 格式: File CSS 继承: no 组件的背景图像。此样式可以是绝对或相对 URL 或类。您可以同时设置 backgroundColor 和 backgroundImage。背景图像显示在背景色上面。默认值为 undefined,表示“未设置”。如果此样式和 backgroundColor 样式都未定义,则控件将采用透明背景。 大多数 Flex 控件的默认外观为半透明。因此,容器的背景图像将在某种程度上“渗入”该容器中的控件。通过将控件的 <mx: Container backgroundColor="0x66CC66"/> <mx: ControlName ... | Container | ||
![]() | 类型: String CSS 继承: no 将 backgroundImage 指定的图像缩放到不同的百分比大小。"100%" 值将拉抻该图像以适应整个组件。要指定百分比值,您必须输入百分号 (%)。Application 容器的默认值为 100%。所有其它容器的默认值为 auto,此值将保持图像的原始大小。. | Container | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 确定 ProgressBar 的颜色。将使用此颜色与较明亮的颜色(基于此颜色计算得出)之间的垂直渐变填充 ProgressBar。此样式对其它组件不起作用,但可对某个容器设置此样式,以控制其中所有进度栏的外观。默认值为 undefined,即不进行设置。此时,将使用 themeColor 样式属性。. | Container | ||
![]() | 类型: String CSS 继承: no 从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位)。如果设置此样式,则组件的基线锚定在其内容区域的上边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: uint 格式: Color CSS 继承: no 边框颜色。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 0xB7BABC。. | Container | ||
![]() | 类型: String CSS 继承: no 边框边。指定要显示的边框边的以空格分隔的 String。此 String 可以任意顺序包含 "left"、"top"、"right" 和 "bottom"。默认值为 "left top right bottom",此值会显示所有四条边。仅当 borderStyle 为 "solid" 时才使用此样式。. | Container | ||
![]() | 类型: Class CSS 继承: no 组件的边框外观类。mx. | Container | ||
![]() | 类型: String CSS 继承: no 边框样式。可能值为 "none"、"solid"、"inset" 和 "outset"。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 "inset"。大多数容器的默认值为 "none"。. | Container | ||
![]() | 类型: Number 格式: Length CSS 继承: no 边框厚度。仅在将 borderStyle 设置为 "solid" 时使用。. | Container | ||
![]() | 类型: String CSS 继承: no 从组件的下边缘到其内容区域的下边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的下边缘锚定在其内容区域的下边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 组件中文本(包括组件标签)的颜色。. | Container | ||
![]() | 类型: Number 格式: Length CSS 继承: no 组件角的半径。默认值取决于组件类;如果未覆盖类的默认值,则默认值为 0。对于 ApplicationControlBar,默认值为 5。. | Container | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 禁用时组件中文本的颜色。. | Container | ||
![]() | 类型: Number CSS 继承: no 禁用容器时放置在容器上的叠加层的 alpha 值。. | Container | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 投影颜色。. | Container | ||
![]() | 类型: Boolean CSS 继承: no 指定组件是否具有可见投影的布尔值属性。此样式与 borderStyle="solid" 一起使用。默认值为 false。 注意:对于显示在容器上的投影,需设置 | Container | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 验证失败时,组件加亮部分的颜色。验证失败时,Flex 还会将组件的 borderColor 样式设置为 errorColor。. | UIComponent | ||
![]() | 类型: String CSS 继承: yes 设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash. | Container | ||
![]() | 类型: String CSS 继承: yes 使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。. | Container | ||
![]() | 类型: String CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性。可能值为 "none" (flash. | Container | ||
![]() | 类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。 仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 . | Container | ||
![]() | 类型: Number 格式: Length CSS 继承: yes 文本的高度,以像素为单位。除 ColorPicker 控件之外,所有控件的默认值都为 10。ColorPicker 控件的默认值为 11。. | Container | ||
![]() | 类型: String CSS 继承: yes 确定文本是否使用斜体。可识别的值为 "normal" 和 "italic"。. | Container | ||
![]() | 类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。 仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 . | Container | ||
![]() | 类型: String CSS 继承: yes 确定文本是否使用粗体。可识别的值为 normal 和 bold。Button 控件的默认值为 bold。所有其它控件的默认值为 normal。. | Container | ||
![]() | 类型: String CSS 继承: no 水平对齐容器中的子容器。可能值包括 "left"、"center" 和 "right"。默认值为 "left",但某些容器(如 ButtonBar 和 ToggleButtonBar)具有不同的默认值。. | Box | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的水平距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整组件容器大小后,这两个中心将保持它们的水平间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
horizontalGap | 类型: Number 格式: Length CSS 继承: no 水平方向上各子项间的像素数目。默认值为 8。 | Grid | ||
![]() | 类型: String CSS 继承: no 水平 scrollbar 样式的名称。. | Container | ||
![]() | 类型: Boolean CSS 继承: yes 一个布尔值,指示是启用 ( true) 还是禁用 (false) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。. | Container | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的左边缘到组件左边缘的水平距离(以像素为单位)。如果设置此样式,则组件的左边缘锚定在其内容区域的左边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: Number CSS 继承: yes 各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。. | Container | ||
![]() | 类型: Number 格式: Length CSS 继承: no 容器的下边框与其内容区域底部之间的像素数目。默认值为 0。. | Box | ||
![]() | 类型: Number 格式: Length CSS 继承: no 组件左边框与其内容区域左边缘之间的像素数目。 默认值为 0。 Button 控件的默认值为 10。 ComboBox 控件的默认值为 5。 Form 容器的默认值为 16。 Tree 控件的默认值为 2。 . | Container | ||
![]() | 类型: Number 格式: Length CSS 继承: no 组件右边框与其内容区域右边缘之间的像素数目。 默认值为 0。 Button 控件的默认值为 10。 ComboBox 控件的默认值为 5。 Form 容器的默认值为 16。 . | Container | ||
![]() | 类型: Number 格式: Length CSS 继承: no 容器的上边框与其内容区域顶部之间的像素数目。默认值为 0。. | Box | ||
![]() | 类型: String CSS 继承: no 从组件的右边缘到其内容区域的右边缘的水平距离(以像素为单位)。如果设置此样式,则组件的右边缘锚定在其内容区域的右边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: String CSS 继承: no 投影方向。可能值包括 "left"、"center" 和 "right"。. | Container | ||
![]() | 类型: Number 格式: Length CSS 继承: no 投影距离。如果将此属性设置为负值,此阴影将出现在组件的上方。. | Container | ||
![]() | 类型: String CSS 继承: yes 容器内文本的对齐情况。可能值有: "left"、"right" 或 "center"。 大多数组件的默认值为 | Container | ||
![]() | 类型: String CSS 继承: yes 确定文本是否加下划线。可能值有: "none" 和 "underline"。. | Container | ||
![]() | 类型: Number 格式: Length CSS 继承: yes 文本第一行偏离容器左侧的距离(以像素为单位)。. | Container | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 组件的主题颜色。此属性控制加亮内容的外观、选中组件时的外观和其它相似的形象化提示,但是它对此组件的常规边框和背景颜色不起作用。虽然可以使用任意有效的颜色值,但首选值为 haloGreen、haloBlue、haloOrange 和 haloSilver。 | UIComponent | ||
![]() | 类型: String CSS 继承: no 从控件内容区域的上边缘到组件上边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的上边缘锚定在其内容区域的上边缘;调整其容器大小后,这两个边缘将保持其间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: String CSS 继承: no 垂直对齐容器中的子项。可能值包括 "top"、"middle" 和 "bottom"。默认值为 "top",但某些容器(如 ButtonBar、ControlBar、LinkBar 和 ToggleButtonBar)具有不同的默认值。. | Box | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的垂直距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整其容器大小后,这两个中心将保持其垂直间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
verticalGap | 类型: Number 格式: Length CSS 继承: no 垂直方向上各子项间的像素数目。默认值为 6。 | Grid | ||
![]() | 类型: String CSS 继承: no 垂直 scrollbar 样式的名称。. | Container | ||
| Grid | () | 构造函数 |
public function Grid()构造函数。
| measure | () | 方法 |
override protected function measure():void计算 Grid 的首选大小、最小大小和最大大小。
您不应直接调用此方法;此方法是用于细分类的高级方法。Flex LayoutManger 会在合适的时间调用 measure() 方法。启动应用程序时,Flex LayoutManager 将首先尝试测量包括子项和父项在内的所有组件,然后将其设置为最终大小。
要了解 Grid 容器如何计算其测量值,请假设每个 GridItem 容器的 rowSpan 属性和 colSpan 属性都已设置为 1。Grid 容器中第一列的测量宽度是第一列中所有 GridItem 容器的测量宽度中的最大值。同样,第二列的测量宽度是第二列中所有 GridItem 容器的测量宽度中的最大值,依此类推。整个 Grid 容器的 measuredWidth 是所有列的测量宽度之和加上边框粗细、左右填充以及相邻网格单元格间的水平间距。
measuredHeight、minWidth、minHeight、maxWidth 以及 maxHeight 属性值计算方法类似,都是通过将 GridItem 容器的 measuredHeight、minWidth 等属性值累加得到的。
如果 GridItem 容器的 colSpan 属性为 3,则该 GridItem 容器的 measuredWidth 将在 3 个列之间进行分配。如果是等分 measuredWidth,则三列中的每一列在计算其测量宽度时都假设 GridItem 容器仅位于该列中,并且 GridItem 容器的 measuredWidth 是其实际值的 1/3。
但是,GridItem 容器的 measuredWidth 属性在其跨越的所有列之间并非始终等分。如果部分列的属性是 width 的百分比值,则 GridItem 容器的 measuredWidth 属性将进行相应划分,尝试为每列设置所请求的 Grid 容器百分比值。
上述所有值都是 Grid 的测量宽度和高度。用户可以通过显式为下列属性提供值来覆盖测量值:
minHeight
minWidth
maxHeight
maxWidth
height
width
如果覆盖此方法,则实现必须调用 super.measure() 方法或设置 measuredHeight 和 measuredWidth 属性。您还可以选择设置下列属性:
measuredMinWidth
measuredMinHeight
这些属性对应于上面列出的布局属性,所以不再单独介绍。
| updateDisplayList | () | 方法 |
override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void设置 Grid 中每个子项的大小和位置。
您不应直接调用此方法;此方法是用于细分类的高级方法。Flex LayoutManager 会在合适的时间调用 updateDisplayList 方法。启动应用程序时,Flex LayoutManager 将对每个组件调用 updateDisplayList() 方法,从根组件开始,依次向下。
Grid 容器与 VBox 容器的布局规则相同。计算 GridRow 容器的位置和大小的方法与 VBox 容器确定其子项的位置和大小的方法相同。同样,GridRow 容器定位其 GridItem 容器时也使用与 HBox 容器相似的布局算法。
唯一的区别是,所有的 GridRow 容器是需要相互协调的,因此均为其子项选择相同的位置和大小(以便 Grid 容器的列对齐)。
如果覆盖此方法,则实现应调用 super.updateDisplayList() 方法并对每个子项调用 move() 和 setActualSize() 方法。要执行布局,您应该从 unscaledWidth 和 unscaledHeight 属性中获取此容器的大小,而不是从 width 和 height 属性中进行获取。width 和 height 属性与此容器的 scaleX 和 scaleY 属性值无关。
参数
unscaledWidth:Number —
指定组件在组件坐标中的宽度(以像素为单位),而不考虑该组件的 scaleX 属性值。
| |
unscaledHeight:Number —
指定组件在组件坐标中的高度(以像素为单位),而不考虑该组件的 scaleY 属性值。
|
<?xml version="1.0"?>
<!-- Simple example to demonstrate the Grid layout container.-->
<mx:Application borderStyle="none" xmlns:mx="http://www.adobe.com/2006/mxml">
<mx:Panel title="Grid Container Example" height="75%" width="75%"
paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">
<mx:Label width="100%" color="blue"
text="A 3 by 3 Grid container of Button controls."/>
<mx:Grid>
<mx:GridRow>
<mx:GridItem>
<mx:Button label="Row 1 Col 1" width="100"/>
</mx:GridItem>
<mx:GridItem>
<mx:Button label="Row 1 Col 2" width="100"/>
</mx:GridItem>
<mx:GridItem>
<mx:Button label="Row 1 Col 3" width="100"/>
</mx:GridItem>
</mx:GridRow>
<mx:GridRow>
<mx:GridItem>
<mx:Button label="Row 2 Col 1" width="100"/>
</mx:GridItem>
<mx:GridItem>
<mx:Button label="Row 2 Col 2" width="100"/>
</mx:GridItem>
<mx:GridItem>
<mx:Button label="Row 2 Col 3" width="100"/>
</mx:GridItem>
</mx:GridRow>
<mx:GridRow>
<mx:GridItem>
<mx:Button label="Row 3 Col 1" width="100"/>
</mx:GridItem>
<mx:GridItem>
<mx:Button label="Row 3 Col 2" width="100"/>
</mx:GridItem>
<mx:GridItem>
<mx:Button label="Row 3 Col 3" width="100"/>
</mx:GridItem>
</mx:GridRow>
</mx:Grid>
</mx:Panel>
</mx:Application>