| 包 | spark.components |
| 类 | public class Grid |
| 继承 | Grid  Group GroupBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 实现 | IDataGridElement |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
Grid 组件旨在用作 DataGrid 外观部件或其它自定义组合组件的元素。因此，它的外观不可以设置，它不包含滚动条且不提供默认的鼠标或键盘事件处理。
每个可见 Grid 单元格都由使用 itemRenderer 属性创建的 GridItemRenderer 实例显示。为每列指定一个项呈示器。显示前，每个项呈示器实例会使用相应行的数据提供程序项的值进行配置。根据需要创建项呈示器，然后使创建开销保持最低值、能够共用和重复使用。
Grid 控件根据 selectionMode 属性支持选定内容。可使用选择方法（如 setSelectedIndex 或 selectionContainsIndex()）以编程方式修改或查询所选行或单元格的索引集。
Grid 控件基于 selectionMode 属性以及对应行索引和列索引属性（如 hoverRowIndex 和 columnRowIndex）显示悬停、插入标记和选定内容指示符。指示符可以是任何可视元素。实现 IGridVisualElement 的指示符可以根据在其中使用的行和列来对自身进行配置。
Grid 控件支持平滑滚动。其垂直和水平滚动位置定义网格的可视部件的像素原点，网格的布局仅根据需要显示尽可能多的单元格项呈示器来填充可用空间。
Grid 控件支持基于项呈示器的内容自动计算其高度的高度可变的行。此支持称为网格虚拟化，因为从（像素）滚动位置到行和列索引的映射通常基于有关网格单元格的首选大小的不完整信息。Grid 缓存已滚动到视图的计算的行高度并基于单个 typicalItem 估算其余值。
不支持 DataGrid 项呈示器中的转换。GridItemRenderer 类已禁用了其 transitions 属性，因此对此进行设置也无效。
显示 MXML 语法
隐藏 MXML 语法The <s:Grid> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:Grid
Properties
/>
默认 MXML 属性mxmlContent
相关 API 元素
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | 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 | |
| anchorColumnIndex : int
下一个结合 Shift 键选择的锚点的列索引。 | Grid | ||
| anchorRowIndex : int
下一个结合 Shift 键选择的锚点的行索引。 | Grid | ||
| autoLayout : Boolean
如果为 true，则在更改子项的位置或大小时完成度量和布局。 | GroupBase | |
| 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 坐标。 | Group | |
| baselinePositionElement : IVisualElement
用于计算 GroupBase 的 baselinePosition 的元素
| Group | |
| blendMode : String [覆盖]
BlendMode 类中的一个值，用于指定要使用的混合模式。 | Group | |
| 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 | |
| caretColumnIndex : int
如果 showCaretIndicator 为 true，则为 caretIndicator 的列索引。 | Grid | ||
| caretIndicator : IFactory
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则为针对插入标记行显示的单个可视元素；如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则为针对插入标记单元格显示的可视元素。 | Grid | ||
| caretRowIndex : int
如果 showCaretIndicator 为 true，则为 caretIndicator 的行索引。 | Grid | ||
| className : String [只读]
此实例的类的名称，如“Button”。 | UIComponent | |
| clipAndEnableScrolling : Boolean
如果为 true，指定将子代剪切到视区的边界。 | GroupBase | |
| columns : IList
由该网格显示的 GridColumn 对象列表。 | Grid | ||
| columnSeparator : IFactory
显示在各列之间的可视元素。 | Grid | ||
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| contentHeight : Number [只读]
视域的内容的高度。 | GroupBase | |
| contentMouseX : Number [只读]
返回鼠标在内容坐标系中的 x 位置。 | UIComponent | |
| contentMouseY : Number [只读]
返回内容坐标系中鼠标的 y 位置。 | UIComponent | |
| contentWidth : Number [只读]
视域的内容的宽度。 | GroupBase | |
| contextMenu : NativeMenu
指定与此对象相关联的上下文菜单。 | InteractiveObject | |
| currentState : String
组件的当前视图状态。 | UIComponent | |
| cursorManager : ICursorManager [只读]
获取控制此组件及其同级组件的光标的 CursorManager。 | UIComponent | |
| dataGrid : DataGrid
如果该 Grid 用作网格外观部件，则为 DataGrid 控件。 | Grid | ||
| dataProvider : IList
与网格中的行对应的数据项的列表。 | Grid | ||
| dataTipField : String
数据提供程序中显示为数据提示的字段名称。 | Grid | ||
| dataTipFunction : Function
指定在数据提供程序每个项目上运行的回调函数，以确定其数据提示。 | Grid | ||
| depth : Number
确定容器内各项目的呈示顺序。 | UIComponent | |
| descriptor : UIComponentDescriptor
引用 UIComponentDescriptor（如果有），过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。 | UIComponent | |
| designLayer : DesignLayer
指定与该可视元素关联的可选 DesignLayer 实例。 | UIComponent | |
| document : Object
引用与此 UIComponent 相关联的文档对象。 | UIComponent | |
| doubleClickEnabled : Boolean [覆盖]
指定 UIComponent 对象是否接收 doubleClick 事件。 | UIComponent | |
| dropTarget : DisplayObject [只读]
指定拖动 sprite 时经过的显示对象，或放置 sprite 的显示对象。 | Sprite | |
| enabled : Boolean
组件是否可以接受用户交互。 | UIComponent | |
| errorString : String
当验证程序监视组件并且验证失败时，组件的错误提示中将显示的文本。 | UIComponent | |
| explicitHeight : Number
指定该组件在组件坐标中显式高度（以像素为单位）的数字。 | UIComponent | |
| explicitMaxHeight : Number
布局过程中父级要考虑的组件最大建议高度。 | UIComponent | |
| explicitMaxWidth : Number
布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | |
| explicitMinHeight : Number
布局过程中父级要考虑的组件最小建议高度。 | UIComponent | |
| explicitMinWidth : Number
布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | |
| explicitWidth : Number
指定该组件在组件坐标中显式宽度（以像素为单位）的数字。 | UIComponent | |
| filters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。 | DisplayObject | |
| flexContextMenu : IFlexContextMenu
此 UIComponent 的上下文菜单。 | UIComponent | |
| focusEnabled : Boolean
指示切换到此组件时，是否可以获得焦点。 | UIComponent | |
| focusManager : IFocusManager
获取控制此组件及其同级组件的焦点的 FocusManager。 | UIComponent | |
| focusPane : Sprite
与此对象相关联的焦点窗格。 | UIComponent | |
| focusRect : Object
指定此对象是否显示焦点矩形。 | InteractiveObject | |
| graphics : Graphics [只读]
指定属于此 sprite 的 Graphics 对象，在此 sprite 中可执行矢量绘图命令。 | Sprite | |
| hasFocusableChildren : Boolean
一个标志，指示子对象是否能够获得焦点。 | UIComponent | |
| hasLayoutMatrix3D : Boolean [只读]
如果元素具有 3D 矩阵，则为 true。 | UIComponent | |
| height : Number [覆盖]
指定组件在父坐标中的高度的数字（以像素为单位）。 | UIComponent | |
| hitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。 | Sprite | |
| horizontalCenter : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| horizontalScrollPosition : Number
组件的坐标系中视域原点（默认值为 (0,0)，与组件的左上角相对应）的 x 坐标。 | GroupBase | |
| hoverColumnIndex : int
如果 showHoverIndicator 为 true，则指定 hoverIndicator 的列索引。 | Grid | ||
| hoverIndicator : IFactory
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS。 | Grid | ||
| hoverRowIndex : int
如果 showHoverIndicator 为 true，则指定 hoverIndicator 的列索引。 | Grid | ||
| 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 | |
| itemRenderer : IFactory
项呈示器，用于不指定项呈示器的列。 | Grid | ||
| layout : LayoutBase
此容器的 layout 对象。 | GroupBase | |
| layoutMatrix3D : Matrix3D [只写]
用于相对于其同级组件计算组件的布局的转换矩阵。 | UIComponent | |
| left : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| loaderInfo : LoaderInfo [只读]
返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | |
| luminosityClip : Boolean
控制发光度遮罩是否剪辑设置了遮罩的内容的属性。 | GroupBase | |
| luminosityInvert : Boolean
控制计算由发光度遮罩设置遮罩的图形元素的 RGB 颜色值的属性。 | GroupBase | |
| maintainProjectionCenter : Boolean
如果为 true，则该组件将使其投影矩阵在其边框的中央保持居中。 | UIComponent | |
| mask : DisplayObject [覆盖]
设置遮罩。 | GroupBase | |
| maskType : String
遮罩类型。 | GroupBase | |
| maxHeight : Number
布局过程中父级要考虑的组件最大建议高度。 | UIComponent | |
| maxWidth : Number
布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | |
| measuredHeight : Number
组件的默认高度（以像素为单位）。 | UIComponent | |
| measuredMinHeight : Number
组件的默认最小高度（以像素为单位）。 | UIComponent | |
| measuredMinWidth : Number
组件的默认最小宽度（以像素为单位）。 | UIComponent | |
| measuredWidth : Number
组件的默认宽度（以像素为单位）。 | UIComponent | |
| metaData : Object
如果元数据是通过 PlaceObject4 标记与此 DisplayObject 的实例一起存储在 SWF 文件中的，则获取 DisplayObject 实例的元数据对象。 | DisplayObject | |
| minHeight : Number
布局过程中父级要考虑的组件最小建议高度。 | UIComponent | |
| minWidth : Number
布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | |
| moduleFactory : IFlexModuleFactory
模块工厂用作上下文，用于为此组件使用嵌入字体以及查找用于控制此组件样式的样式管理器。 | UIComponent | |
| mouseChildren : Boolean
确定对象的子级是否支持鼠标或用户输入设备。 | DisplayObjectContainer | |
| mouseEnabled : Boolean
指定此对象是否接收鼠标或其他用户输入、消息。 | InteractiveObject | |
| mouseEnabledWhereTransparent : Boolean
为 true 时，此属性确保 Group 的整个边界响应鼠标事件（如 click、roll over 等）。 | GroupBase | |
| mouseFocusEnabled : Boolean
单击时是否可获得焦点。 | UIComponent | |
| mouseX : Number [只读]
表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。 | DisplayObject | |
| mouseY : Number [只读]
表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。 | DisplayObject | |
| mxmlContent : Array [只写]
此 Group 的可视内容子项。 | Group | |
| name : String
表示 DisplayObject 的实例名称。 | DisplayObject | |
| needsSoftKeyboard : Boolean
指定当该 InteractiveObject 实例获得焦点时，是否显示虚拟键盘（显示在屏幕上的软键盘）。 | InteractiveObject | |
| nestLevel : int
此对象在所属关系层次结构中的深度。 | UIComponent | |
| nonInheritingStyles : Object
此组件的非继承样式链的开头内容。 | UIComponent | |
| numAutomationChildren : int [只读]
此容器包含的自动化子项数。 | UIComponent | |
| numElements : int [只读]
此容器中的可视元素的数量。 | GroupBase | |
| opaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。 | DisplayObject | |
| overlay : DisplayLayer [只读]
此 Group 的叠加平面。 | GroupBase | |
| 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 | |
| preserveSelection : Boolean
如果为 true，数据提供程序刷新其集合时会保留选定内容。 | Grid | ||
| 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 | |
| requestedColumnCount : int
此网格的测量宽度足以显示前面的 requestedColumnCount 个列。 | Grid | ||
| requestedMaxRowCount : int
此网格的测量高度足以显示至多 requestedMaxRowCount 个行。 | Grid | ||
| requestedMinColumnCount : int
此网格的测量宽度足以显示至少 requestedMinColumnCount 个列。 | Grid | ||
| requestedMinRowCount : int
此网格的测量高度足以至少显示 requestedMinRowCount 个行。 | Grid | ||
| requestedRowCount : int
此网格的测量高度足以显示前面的 requestedRowCount 个行。 | Grid | ||
| requireSelection : Boolean
如果为 true 且 selectionMode 属性不是 GridSelectionMode.NONE，则必须始终在网格中选中某一项。 | Grid | ||
| resizableColumns : Boolean
指示用户能否更改列的尺寸。 | Grid | ||
| resizeMode : String
此容器的 ResizeMode。 | GroupBase | |
| 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 | |
| rowBackground : IFactory
为每行显示背景的可视元素。 | Grid | ||
| rowHeight : Number
如果 variableRowHeight 为 false，则此属性指定每行的实际高度（以像素为单位）。 | Grid | ||
| rowSeparator : IFactory
显示在各行之间的可视元素。 | Grid | ||
| scale9Grid : Rectangle
当前有效的缩放网格。 | DisplayObject | |
| scaleGridBottom : Number
指定刻度网格的底部坐标。 | Group | |
| scaleGridLeft : Number
指定刻度网格的左侧坐标。 | Group | |
| scaleGridRight : Number
指定刻度网格的右侧坐标。 | Group | |
| scaleGridTop : Number
指定刻度网格的顶部坐标。 | Group | |
| scaleX : Number [覆盖]
用于指定水平缩放系数的数字。 | UIComponent | |
| scaleY : Number [覆盖]
用于指定垂直缩放系数的数字。 | UIComponent | |
| scaleZ : Number [覆盖]
指定沿着 z 轴的缩放因子的数值。 | UIComponent | |
| screen : Rectangle [只读]
返回包含此对象的基本绘图表面大小和位置的对象。 | UIComponent | |
| scrollRect : Rectangle
显示对象的滚动矩形范围。 | DisplayObject | |
| selectedCell : CellPosition
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则返回第一个选定单元格（起点为 0 行 0 列），并在移动到下一行之前处理行中的每列。 | Grid | ||
| selectedCells : Vector.<CellPosition>
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则返回表示网格中选定单元格位置的 CellPosition 对象的 Vector。 | Grid | ||
| selectedIndex : int
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则返回第一个选定行的 rowIndex。 | Grid | ||
| selectedIndices : Vector.<int>
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则返回选定行索引的 Vector。 | Grid | ||
| selectedItem : Object
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则返回当前选定或 undefined（如果未选定任何行）的数据提供程序中的项。 | Grid | ||
| selectedItems : Vector.<Object>
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则返回当前选择的 dataProvider 项目的 Vector。 | Grid | ||
| selectionIndicator : IFactory
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则为针对每个选定行显示的可视元素；如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则为针对每个选定单元格显示的可视元素。 | Grid | ||
| selectionLength : int [只读]
如果 selectionMode 为 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则返回所选行的数量。 | Grid | ||
| selectionMode : String
控件的选择模式。 | Grid | ||
| showDataTips : Boolean
如果为 true，则显示所有可见单元格的 dataTip。 | Grid | ||
| showInAutomationHierarchy : Boolean
用于确定自动化对象是否显示在自动化层次中的标志。 | UIComponent | |
| softKeyboard : String
控制软键盘的外观。 | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
定义当显示软键盘时应在屏幕上保留的区域（在 iOS 上不支持）。 | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
控制此 sprite 中的声音。 | Sprite | |
| stage : Stage [只读]
显示对象的舞台。 | DisplayObject | |
| states : Array
为此组件定义的视图状态。 | UIComponent | |
| styleDeclaration : CSSStyleDeclaration
存储此对象的内嵌继承样式。 | UIComponent | |
| styleManager : IStyleManager2 [只读]
返回此组件使用的 StyleManager 实例。 | UIComponent | |
| styleName : Object
此组件使用的类样式。 | UIComponent | |
| styleParent : IAdvancedStyleClient
组件的父项用于评估后代选择器。 | UIComponent | |
| systemManager : ISystemManager
返回此组件使用的 SystemManager 对象。 | UIComponent | |
| tabChildren : Boolean
确定对象的子项是否支持 Tab 键。 | DisplayObjectContainer | |
| tabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。 | InteractiveObject | |
| tabFocusEnabled : Boolean
一个标志，指示该对象是否能够通过 Tab 键获得焦点。这与 Flash Player 使用的 tabEnabled 属性类似。对于处理键盘输入的组件该标志通常为 true，但是控件栏中的一些组件将其设置为 false，因为它们不能像编辑器一样从另外的组件窃取焦点。 | UIComponent | |
| tabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。 | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [只读]
返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。 | DisplayObjectContainer | |
| toolTip : String
要在 ToolTip 中显示的文本。 | UIComponent | |
| top : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| transform : flash.geom:Transform [覆盖]
一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。 | UIComponent | |
| transformX : Number
设置组件转换中心的 x 坐标。 | UIComponent | |
| transformY : Number
设置组件转换中心的 y 坐标。 | UIComponent | |
| transformZ : Number
设置组件转换中心的 z 坐标。 | UIComponent | |
| transitions : Array
一个 Transition 对象 Array，其中的每个 Transition 对象都定义一组效果，用于在视图状态发生更改时播放。 | UIComponent | |
| tweeningProperties : Array
当前在此对象上进行补间的属性数组。 | UIComponent | |
| typicalItem : Object
网格的布局确保未指定宽度的列足以显示此默认数据提供程序项的项呈示器。 | Grid | ||
| uid : String
对象的唯一标识符。 | UIComponent | |
| updateCompletePendingFlag : Boolean
一个标志，确定某个对象是否已通过所有三个阶段的布局验证（假设需要通过所有验证）。 | UIComponent | |
| useHandCursor : Boolean
布尔值，表示当指针滑过 buttonMode 属性设置为 true 的 sprite 时是否显示指针手形（手形光标）。 | Sprite | |
| validationSubField : String
供验证程序用来将子字段与此组件相关联。 | UIComponent | |
| variableRowHeight : Boolean
如果为 true，则每行的高度是到目前为止显示的单元格首选高度的最大值。 | Grid | ||
| verticalCenter : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| verticalScrollPosition : Number
组件的坐标系中视区的原点（默认值为 (0,0)，与组件的左上角相对应）的 y 坐标。 | GroupBase | |
| visible : Boolean [覆盖]
显示对象是否可见。 | UIComponent | |
| width : Number [覆盖]
指定组件在父坐标中的宽度的数字（以像素为单位）。 | UIComponent | |
| x : Number [覆盖]
指定组件在其父容器中的水平位置（以像素为单位）的数字。 | UIComponent | |
| y : Number [覆盖]
指定组件在其父容器中的垂直位置（以像素为单位）的数字。 | UIComponent | |
| z : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。 | UIComponent | |
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
Grid()
构造函数。 | Grid | ||
|
将可视元素添加到此容器中。 | Group | |
|
将可视元素添加到此容器中。 | Group | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，将单元格添加到选定内容并将尖号位置设置为该单元格。 | Grid | ||
如果 selectionMode 是 GridSelectionMode.MULTIPLE_ROWS，将此行添加到选定内容并将尖号位置设置为此行。 | Grid | ||
|
将非可视样式客户端添加到该组件实例。 | UIComponent | |
|
表示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | |
|
排队稍后调用的函数。 | UIComponent | |
如果 selectionMode 不是 GridSelectionMode.NONE，则删除所有所选行和单元格。 | Grid | ||
|
删除此组件实例的样式属性。 | UIComponent | |
|
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | |
|
确定指定的 IVisualElement 是否为容器实例的子代或该实例本身。 | GroupBase | |
|
将 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 | |
如果需要，设置 verticalScrollPosition 和 horizontalScrollPosition 属性以使指定的单元格完全可见。 | Grid | ||
|
执行 UIComponent 对象是目标的所有绑定。 | UIComponent | |
|
打印完成后调用。 | UIComponent | |
|
在指定的索引位置提供自动化对象。 | UIComponent | |
|
提供自动化对象列表。 | UIComponent | |
|
返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
|
按指定的元素大小，返回元素边界的 x 坐标。 | UIComponent | |
|
按指定的元素大小，返回元素边界的 y 坐标。 | UIComponent | |
返回在指定网格坐标处重叠像素的单元格的行和列索引。 | Grid | ||
返回指定单元格的当前像素范围，如果不存在这样的单元格，则返回 null。 | Grid | ||
返回 CellPosition 对象的矢量，该对象的 rowIndex 和 columnIndex 属性指定与指定网格区域重叠的单元格的行索引和列索引。 | Grid | ||
返回指定单元格的原点的 X 坐标。 | Grid | ||
返回指定单元格的原点的 Y 坐标。 | Grid | ||
|
返回具有指定名称的子显示对象。 | DisplayObjectContainer | |
|
查找此 UIComponent 实例的类型选择器。 | UIComponent | |
返回指定列的当前像素范围，如果不存在这样的列，则返回 null。 | Grid | ||
返回对应于指定坐标的列索引；如果坐标超出边界，则返回 -1。 | Grid | ||
返回指定列的宽度。 | Grid | ||
|
返回一个约束布局值，这与获取此组件的约束样式的方式类似。 | UIComponent | |
|
返回指定索引处的可视元素。 | GroupBase | |
|
返回可视元素的索引位置。 | GroupBase | |
|
确定是使用显式高度还是测量高度的一种简便方法
| UIComponent | |
|
确定是使用显式宽度还是测量宽度的一种简便方法
| UIComponent | |
|
获取当前具有焦点的对象。 | UIComponent | |
|
返回对水平滚动位置的更改以处理不同的滚动选项。 | GroupBase | |
如果请求的项呈示器可见，则返回对指定单元格当前显示的项呈示器的引用。 | Grid | ||
|
返回元素的布局高度。 | 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 | |
返回指定行的当前像素范围，如果不存在这样的行，则返回 null。 | Grid | ||
返回对应于指定坐标的行索引；如果坐标超出边界，则返回 -1。 | Grid | ||
|
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | |
|
返回对垂直滚动位置的更改以处理不同的滚动选项。 | GroupBase | |
|
支持 useVirtualLayout 标志的布局将在 updateDisplayList() 时使用此方法获取“处于视图中”的布局元素，即， | GroupBase | |
返回当前可见列的索引。 | Grid | ||
返回数据提供程序索引和当前可见行的内边距索引。 | Grid | ||
|
将 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 | |
如果指定的单元格可见，则它会重新显示。 | Grid | ||
|
标记组件，以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | |
|
请注意元素已更改且需要重新绘制的主机组件。 | Group | |
|
请注意元素已更改且需要验证属性的主机组件。 | Group | |
|
请注意元素图层已更改的主机。 | Group | |
|
请注意元素大小已更改的主机组件。 | Group | |
|
由某个组件的项目进行调用，以指示其 depth 属性已更改。 | UIComponent | |
|
当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时，该元素必须调用该方法。 | UIComponent | |
|
标记组件，以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | |
|
标记组件，以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | |
清除基于 typicalItem 属性的缓存列宽数据，并请求新的布局传递。 | Grid | ||
如果指定的单元格至少部分可见，则返回 true。 | Grid | ||
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。 | 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 | |
|
从容器中删除所有可视元素。 | Group | |
|
从 DisplayObjectContainer 实例的子级列表中删除所有子 DisplayObject 实例。 | DisplayObjectContainer | |
|
从此容器的子列表中删除指定的可视元素。 | Group | |
|
从容器中的指定索引位置删除可视元素。 | Group | |
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，删除选定内容中的单元格并将插入标记位置设置为该单元格。 | Grid | ||
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，删除选定内容中的此行并将尖号位置设置为此行。 | Grid | ||
|
从该组件实例删除非可视样式客户端。 | UIComponent | |
|
重放指定的事件。 | UIComponent | |
|
显示虚拟键盘。 | InteractiveObject | |
|
使用提供的 ID 解析子项。 | UIComponent | |
| [静态]
在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | |
如果 selectionMode 是 GridSelectionMode.MULTIPLE_ROWS，选择所有行并删除尖号；如果 selectionMode 是 GridSelectionMode.MULTIPLE_CELLS，选择所有单元格并删除尖号。 | Grid | ||
如果 selectionMode 是 GridSelectionMode.MULTIPLE_CELLS，则将选定内容设置为单元格区域中所有单元格并将尖号位置设置为单元格区域中最后一个单元格。 | Grid | ||
如果 selectionMode 是 GridSelectionMode.MULTIPLE_ROWS，则将选定内容设置为指定行并将尖号位置设置为 endRowIndex。 | Grid | ||
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS 且单元格位于当前选定内容中，则返回 true。 | Grid | ||
如果 selectionMode 是 GridSelectionMode.MULTIPLE_CELLS 且单元格区域中的单元格位于当前选定内容中，则返回 true。 | Grid | ||
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS 且索引处的行位于当前选定内容中，则返回 true。 | Grid | ||
如果 selectionMode 是 GridSelectionMode.MULTIPLE_ROWS 且 indices 中的行位于当前选定内容中，则返回 true。 | Grid | ||
|
调整对象大小。 | UIComponent | |
|
设置一个布局约束值的方式，与设置此组件的约束样式的方式相同。 | UIComponent | |
|
设置 contentWidth 和 contentHeight 属性。 | GroupBase | |
|
设置当前状态。 | UIComponent | |
|
在可视容器中更改现有可视元素的位置。 | Group | |
|
设置此组件的焦点。 | UIComponent | |
|
设置元素在屏幕上进行绘制时所用的坐标。 | UIComponent | |
|
设置元素的布局大小。 | UIComponent | |
|
设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。 | UIComponent | |
|
设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。 | UIComponent | |
|
设置循环操作动态属性的可用性。 | Object | |
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则将选定内容和尖号位置设置为此单元格。 | Grid | ||
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则将选定内容和尖号位置设置为此行。 | Grid | ||
|
对此组件实例设置样式属性。 | UIComponent | |
|
当 visible 属性发生更改时调用。 | UIComponent | |
|
允许用户拖动指定的 Sprite。 | Sprite | |
|
使用户可以在启用触摸的设备上拖动指定的 Sprite。 | Sprite | |
|
对源起于此对象的所有 MovieClip 递归停止时间轴执行。 | DisplayObjectContainer | |
|
结束 startDrag() 方法。 | Sprite | |
|
结束 startTouchDrag() 方法，用于启用触摸的设备。 | Sprite | |
|
检测对样式属性的更改。 | UIComponent | |
|
首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。 | UIComponent | |
| [静态]
阻止对使用 callLater() 排队的方法进行背景处理，直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | |
|
交换两个指定可视元素的索引。 | Group | |
|
交换容器中位于两个指定索引位置的可视元素。 | Group | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | 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 | ||
| 插入标记更改后调度。 | Grid | |||
| 当用户从文本上下文菜单中选择“清除”（或“删除”）时调度。 | 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 | ||
| 将可视元素添加到内容容器时调度。 | Group | ||
| 从内容容器中删除可视元素时调度。 | Group | ||
| [播放事件] 播放头进入新帧时调度。 | 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 | ||
| 在单元格上单击鼠标时调度 | Grid | |||
| 在单元格上双击鼠标时调度 | Grid | |||
| 在 Grid 单元格上按下鼠标按钮时调度。 | Grid | |||
| 如果在释放按钮之前移动鼠标，则在 gridMouseDown 事件后调度。 | Grid | |||
| 在 Grid 单元格上释放鼠标按钮时调度。 | Grid | |||
| 在鼠标离开网格单元格时调度。 | Grid | |||
| 在鼠标指向网格单元格时调度。 | Grid | |||
| 当对象的状态从可见变为不可见时调度。 | UIComponent | ||
| 此事件被调度到任何支持使用 IME 进行内联输入的客户端应用程序 | InteractiveObject | ||
| 当组件完成构建并设置了所有初始化属性后调度。 | UIComponent | ||
| 当组件由 Validator 监控且未通过验证时调度。 | UIComponent | ||
| 用户按下某个键时调度。 | 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 | ||
anchorColumnIndex | 属性 |
anchorColumnIndex:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
下一个结合 Shift 键选择的锚点的列索引。锚点是最近选定的项。它在网格中选择多个项时定义锚点项。当您选择多个项时，这一组项从锚点扩展至插入标记项。
网格事件处理函数应使用此属性记录最近未结合 Shift 键的鼠标按下或键盘事件的位置，该事件定义下一个潜在移动选择的一端。尖号索引定义另一端。
默认值为 0。
此属性可用作数据绑定的源。修改此属性后，将调度 anchorColumnIndexChanged 事件。
实现
public function get anchorColumnIndex():int public function set anchorColumnIndex(value:int):void相关 API 元素
anchorRowIndex | 属性 |
anchorRowIndex:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
下一个结合 Shift 键选择的锚点的行索引。锚点是最近选定的项。它在网格中选择多个项时定义锚点项。当您选择多个项时，这一组项从锚点扩展至插入标记项。
网格事件处理函数应使用此属性记录最近未结合 Shift 键的鼠标按下或键盘事件的位置，该事件定义下一个潜在移动选择的一端。尖号索引定义另一端。
默认值为 0。
此属性可用作数据绑定的源。修改此属性后，将调度 anchorRowIndexChanged 事件。
实现
public function get anchorRowIndex():int public function set anchorRowIndex(value:int):void相关 API 元素
caretColumnIndex | 属性 |
caretColumnIndex:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 showCaretIndicator 为 true，则为 caretIndicator 的列索引。
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则指示符将占用整行，并忽略 caretColumnIndex。如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则 caretIndicator 将占用指定单元格。
将 caretColumnIndex 设置为 -1 表示未定义列索引且不显示单元格插入标记。
默认值为 -1。
此属性可用作数据绑定的源。修改此属性后，将调度 caretColumnIndexChanged 事件。
实现
public function get caretColumnIndex():int public function set caretColumnIndex(value:int):voidcaretIndicator | 属性 |
caretIndicator:IFactory| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则为针对插入标记行显示的单个可视元素；如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则为针对插入标记单元格显示的可视元素。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 caretIndicatorChanged 事件。
实现
public function get caretIndicator():IFactory public function set caretIndicator(value:IFactory):voidcaretRowIndex | 属性 |
caretRowIndex:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 showCaretIndicator 为 true，则为 caretIndicator 的行索引。如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则指示符将占用整行，并忽略 caretColumnIndex 属性。如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则 caretIndicator 将占用指定单元格。
将 caretRowIndex 设置为 -1 表示未定义行索引且不显示插入标记。
默认值为 -1。
此属性可用作数据绑定的源。修改此属性后，将调度 caretRowIndexChanged 事件。
实现
public function get caretRowIndex():int public function set caretRowIndex(value:int):voidcolumns | 属性 |
columns:IList| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
由该网格显示的 GridColumn 对象列表。每列选择要显示的不同数据提供程序项属性。
GridColumn 对象仅可以显示在单个 Grid 控件的 columns 中。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 columnsChanged 事件。
实现
public function get columns():IList public function set columns(value:IList):void相关 API 元素
columnSeparator | 属性 |
dataGrid | 属性 |
dataProvider | 属性 |
dataTipField | 属性 |
dataTipField:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
数据提供程序中显示为数据提示的字段名称。默认情况下，如果 showDataTips 为 true，则关联的网格控件在每个数据提供程序项中查找名为 label 的属性并进行显示。然而，如果数据提供程序不包含 label 属性，则可以设置 dataTipField 属性以指定其它属性名称。例如，在用户查看数据库中包含的一组用户名时，可以将值设置为“FullName”。
GridColumn.dataTipField 的优先级比此属性高。
如果此列或其网格指定了 dataTipFunction 属性的值，则忽略 dataTipField 属性。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 dataTipFieldChanged 事件。
实现
public function get dataTipField():String public function set dataTipField(value:String):voiddataTipFunction | 属性 |
dataTipFunction:Function| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
指定在数据提供程序每个项目上运行的回调函数，以确定其数据提示。此属性由 itemToDataTip 方法使用。
默认情况下，如果 showDataTips 为 true，则该列在每个数据提供程序项中查找名为 label 的属性，并将其显示为它的数据提示。不过，某些数据提供程序没有 label 属性，也没有其它可用于显示行中数据的属性。
例如，您具有包含 lastName 和 firstName 字段的数据提供程序，但您希望将全名显示为数据提示。可以为 dataTipFunction 属性指定一个函数，该函数返回包含这两个字段值的单个 String。还可以使用 dataTipFunction 属性来处理格式和本地化。
dataTipFunction 函数的签名必须与以下内容相匹配：
dataTipFunction(item:Object, column:GridColumn):String
item 参数为整个行的数据提供程序项。第二个参数是此列对象。
典型的函数可能连接项的 firstName 和 lastName 属性，或对 Date 值属性设置某种自定义格式。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 dataTipFunctionChanged 事件。
实现
public function get dataTipFunction():Function public function set dataTipFunction(value:Function):voidhoverColumnIndex | 属性 |
hoverColumnIndex:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 showHoverIndicator 为 true，则指定 hoverIndicator 的列索引。如果 selectionMode 为 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则指示符将占用整行，并忽略 hoverColumnIndex。如果 selectionMode 为 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则 hoverIndicator 将占用指定单元格。
将 hoverColumnIndex 设置为 -1（默认值）表示未定义列索引且不显示单元格悬停指示符。
默认值为 -1。
此属性可用作数据绑定的源。修改此属性后，将调度 hoverColumnIndexChanged 事件。
实现
public function get hoverColumnIndex():int public function set hoverColumnIndex(value:int):voidhoverIndicator | 属性 |
hoverIndicator:IFactory| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS。为鼠标下的行显示的单个可视元素。如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则为单元格的可视元素。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 hoverIndicatorChanged 事件。
实现
public function get hoverIndicator():IFactory public function set hoverIndicator(value:IFactory):voidhoverRowIndex | 属性 |
hoverRowIndex:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 showHoverIndicator 为 true，则指定 hoverIndicator 的列索引。如果 selectionMode 为 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则指示符将占用整行，并忽略 hoverColumnIndex。如果 selectionMode 为 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则 hoverIndicator 将占用指定单元格。
将 hoverRowIndex 设置为 -1（默认值）表示未定义行索引且不显示悬停指示符。
默认值为 -1。
此属性可用作数据绑定的源。修改此属性后，将调度 hoverRowIndexChanged 事件。
实现
public function get hoverRowIndex():int public function set hoverRowIndex(value:int):voiditemRenderer | 属性 |
preserveSelection | 属性 |
requestedColumnCount | 属性 |
requestedColumnCount:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
此网格的测量宽度足以显示前面的 requestedColumnCount 个列。如果 requestedColumnCount 为 -1，则测量宽度足以显示所有列。
如果已显式设置网格的实际大小，则此属性不起作用。
默认值为 -1。
实现
public function get requestedColumnCount():int public function set requestedColumnCount(value:int):voidrequestedMaxRowCount | 属性 |
requestedMaxRowCount:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
此网格的测量高度足以显示至多 requestedMaxRowCount 个行。
如果以下任一项为 true，则此属性无效：
- 已设置
requestedRowCount。 - 已显式设置网格的实际大小。
默认值为 10。
实现
public function get requestedMaxRowCount():int public function set requestedMaxRowCount(value:int):voidrequestedMinColumnCount | 属性 |
requestedMinColumnCount:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
此网格的测量宽度足以显示至少 requestedMinColumnCount 个列。
如果以下任一项为 true，则此属性无效：
- 已设置
requestedColumnCount。 - 已显式设置网格的实际大小。
- 网格位于 Scroller 组件内。
默认值为 -1。
实现
public function get requestedMinColumnCount():int public function set requestedMinColumnCount(value:int):voidrequestedMinRowCount | 属性 |
requestedMinRowCount:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
此网格的测量高度足以至少显示 requestedMinRowCount 个行。
如果以下任一项为 true，则此属性无效：
- 已设置
requestedRowCount。 - 已显式设置网格的实际大小。
默认值为 -1。
实现
public function get requestedMinRowCount():int public function set requestedMinRowCount(value:int):voidrequestedRowCount | 属性 |
requestedRowCount:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
此网格的测量高度足以显示前面的 requestedRowCount 个行。
如果 requestedRowCount 为 -1，则测量大小足以显示所有布局元素。
如果已显式设置网格的实际大小，则此属性不起作用。
默认值为 -1。
实现
public function get requestedRowCount():int public function set requestedRowCount(value:int):voidrequireSelection | 属性 |
resizableColumns | 属性 |
resizableColumns:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
指示用户能否更改列的尺寸。 如果为 true，则用户可以通过在标题单元格之间拖动网格线来伸展或缩短 DataGrid 控件的列。如果为 true，则还必须将单个列的 resizable 设置为 false 以防止用户调整特定列的大小。
默认值为 true。
此属性可用作数据绑定的源。修改此属性后，将调度 resizableColumnsChanged 事件。
实现
public function get resizableColumns():Boolean public function set resizableColumns(value:Boolean):void相关 API 元素
rowBackground | 属性 |
rowHeight | 属性 |
rowHeight:Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 variableRowHeight 为 false，则此属性指定每行的实际高度（以像素为单位）。
如果 variableRowHeight 为 true，将此属性的值用作尚未滚动到可视范围内的行的估计高度，而不是使用 typicalItem 配置的呈示器的首选高度。同样，当 Grid 使用空行填充其显示时，此属性指定空行的高度。
如果 variableRowHeight 为 false，则此属性的默认值是为 typicalItem 创建的每列呈示器的最大首选高度。
此属性可用作数据绑定的源。修改此属性后，将调度 rowHeightChanged 事件。
实现
public function get rowHeight():Number public function set rowHeight(value:Number):voidrowSeparator | 属性 |
selectedCell | 属性 |
selectedCell:CellPosition| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则返回第一个选定单元格（起点为 0 行 0 列），并在移动到下一行之前处理行中的每列。
当用户通过与控件进行交互更改选定内容时，控件将调度 selectionChange 事件。当用户以编程方式更改选定内容时，控件将分派 valueCommit 事件。
此属性可用于初始化或绑定到 MXML 标记中的选择。setSelectedCell() 方法应用于程序选择更新，例如编写 keyboard 或 mouse 事件处理函数时。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 valueCommit 事件。
实现
public function get selectedCell():CellPosition public function set selectedCell(value:CellPosition):voidselectedCells | 属性 |
selectedCells:Vector.<CellPosition>| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则返回表示网格中选定单元格位置的 CellPosition 对象的 Vector。
当用户通过与控件进行交互更改选定内容时，控件将调度 selectionChange 事件。当用户以编程方式更改选定内容时，控件将分派 valueCommit 事件。
此属性可用于初始化或绑定到 MXML 标记中的选择。setSelectedCell() 方法应用于程序选择更新，例如编写 keyboard 或 mouse 事件处理函数时。
默认值为空 Vector.<CellPosition>
此属性可用作数据绑定的源。修改此属性后，将调度 valueCommit 事件。
实现
public function get selectedCells():Vector.<CellPosition> public function set selectedCells(value:Vector.<CellPosition>):voidselectedIndex | 属性 |
selectedIndex:int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则返回第一个选定行的 rowIndex。
当用户通过与控件进行交互更改选定内容时，控件将调度 selectionChange 事件。当用户以编程方式更改选定内容时，控件将分派 valueCommit 事件。
此属性可用于初始化或绑定到 MXML 标记中的选择。setSelectedCell() 方法应用于程序选择更新，例如编写 keyboard 或 mouse 事件处理函数时。
默认值为 -1。
此属性可用作数据绑定的源。修改此属性后，将调度 valueCommit 事件。
实现
public function get selectedIndex():int public function set selectedIndex(value:int):voidselectedIndices | 属性 |
selectedIndices:Vector.<int>| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则返回选定行索引的 Vector。对于所有其它选择模式，此方法不起作用。
当用户通过与控件进行交互更改选定内容时，控件将调度 selectionChange 事件。当用户以编程方式更改选定内容时，控件将分派 valueCommit 事件。
此属性可用于初始化或绑定到 MXML 标记中的选择。setSelectedCell() 方法应用于程序选择更新，例如编写 keyboard 或 mouse 事件处理函数时。
>默认值为空 Vector.<int>
此属性可用作数据绑定的源。修改此属性后，将调度 valueCommit 事件。
实现
public function get selectedIndices():Vector.<int> public function set selectedIndices(value:Vector.<int>):void相关 API 元素
selectedItem | 属性 |
selectedItem:Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则返回当前选定或 undefined（如果未选定任何行）的数据提供程序中的项。
当用户通过与控件进行交互更改选定内容时，控件将调度 selectionChange 事件。当用户以编程方式更改选定内容时，控件将分派 valueCommit 事件。
此属性可用于初始化或绑定到 MXML 标记中的选择。setSelectedCell() 方法应用于程序选择更新，例如编写 keyboard 或 mouse 事件处理函数时。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 valueCommit 事件。
实现
public function get selectedItem():Object public function set selectedItem(value:Object):void相关 API 元素
selectedItems | 属性 |
selectedItems:Vector.<Object>| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则返回当前选择的 dataProvider 项目的 Vector。
当用户通过与控件进行交互更改选定内容时，控件将调度 selectionChange 事件。当用户以编程方式更改选定内容时，控件将分派 valueCommit 事件。
此属性可用于初始化或绑定到 MXML 标记中的选择。setSelectedCell() 方法应用于程序选择更新，例如编写 keyboard 或 mouse 事件处理函数时。
默认值为空 Vector.<Object>
此属性可用作数据绑定的源。修改此属性后，将调度 valueCommit 事件。
实现
public function get selectedItems():Vector.<Object> public function set selectedItems(value:Vector.<Object>):void相关 API 元素
selectionIndicator | 属性 |
selectionIndicator:IFactory| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则为针对每个选定行显示的可视元素；如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则为针对每个选定单元格显示的可视元素。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 selectionIndicatorChanged 事件。
实现
public function get selectionIndicator():IFactory public function set selectionIndicator(value:IFactory):voidselectionLength | 属性 |
selectionLength:int [只读] | 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 为 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则返回所选行的数量；如果 selectionMode 为 GridSelectionMode.SINGLE_CELLS 或 GridSelectionMode.MULTIPLE_CELLS，则返回所选单元格的数量。
默认值为 0。
此属性可用作数据绑定的源。修改此属性后，将调度 valueCommit 事件。
实现
public function get selectionLength():intselectionMode | 属性 |
selectionMode:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
控件的选择模式。可能的值是：GridSelectionMode.MULTIPLE_CELLS、GridSelectionMode.MULTIPLE_ROWS、GridSelectionMode.NONE、GridSelectionMode.SINGLE_CELL 和 GridSelectionMode.SINGLE_ROW。
更改 selectionMode 会导致清除当前选定内容，并将 caretRowIndex 和 caretColumnIndex 设置为 -1。
默认值为 GridSelectionMode.SINGLE_ROW。
此属性可用作数据绑定的源。修改此属性后，将调度 selectionModeChanged 事件。
实现
public function get selectionMode():String public function set selectionMode(value:String):void相关 API 元素
showDataTips | 属性 |
showDataTips:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果为 true，则显示所有可见单元格的 dataTip。如果为 false（默认值），则仅当列的 showDataTips 属性为 true 时才显示 dataTip。
默认值为 false。
此属性可用作数据绑定的源。修改此属性后，将调度 showDataTipsChanged 事件。
实现
public function get showDataTips():Boolean public function set showDataTips(value:Boolean):voidtypicalItem | 属性 |
typicalItem:Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
网格的布局确保未指定宽度的列足以显示此默认数据提供程序项的项呈示器。如果未指定典型项，则使用第一个数据提供程序项。
限制：如果 typicalItem 是 IVisualItem，则它不能同时是数据提供程序的成员。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后，将调度 typicalItemChanged 事件。
实现
public function get typicalItem():Object public function set typicalItem(value:Object):voidvariableRowHeight | 属性 |
variableRowHeight:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果为 true，则每行的高度是到目前为止显示的单元格首选高度的最大值。
如果为 false，则每行的高度恰好是 rowHeight 属性的值。如果未指定 rowHeight，则每行的高度由 typicalItem 属性定义。
默认值为 false。
此属性可用作数据绑定的源。修改此属性后，将调度 variableRowHeightChanged 事件。
实现
public function get variableRowHeight():Boolean public function set variableRowHeight(value:Boolean):voidGrid | () | 构造函数 |
public function Grid()| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
构造函数。
addSelectedCell | () | 方法 |
public function addSelectedCell(rowIndex:int, columnIndex:int):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，将单元格添加到选定内容并将尖号位置设置为该单元格。对于所有其它选择模式，此方法不起作用。
rowIndex 是包含所选单元格的项的数据提供程序中的索引。columnIndex 是包含所选单元格的列的 columns 中的索引。
参数
rowIndex:int — 单元格的从零开始的行索引。
| |
columnIndex:int — 单元格的从零开始的列索引。
|
Boolean — 如果未引发任何错误，则为 true。如果 rowIndex 或 columnIndex 无效，或 selectionMode 无效，则为 false。
|
相关 API 元素
addSelectedIndex | () | 方法 |
public function addSelectedIndex(rowIndex:int):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.MULTIPLE_ROWS，将此行添加到选定内容并将尖号位置设置为此行。对于所有其它选择模式，此方法不起作用。
rowIndex 是包含所选单元格的项的数据提供程序中的索引。
参数
rowIndex:int — 单元格的从零开始的行索引。
|
Boolean — 如果未引发任何错误，则为 true。如果 index 无效或 selectionMode 无效，则为 false。
|
相关 API 元素
clearSelection | () | 方法 |
ensureCellIsVisible | () | 方法 |
public function ensureCellIsVisible(rowIndex:int = -1, columnIndex:int = -1):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果需要，设置 verticalScrollPosition 和 horizontalScrollPosition 属性以使指定的单元格完全可见。如果 rowIndex 为 -1，且指定了 columnIndex，则只需调整 horizontalScrollPosition 以使指定的列可见。如果 columnIndex 为 -1，且指定了 rowIndex，则只需调整 verticalScrollPosition 以使指定的行可见。
参数
rowIndex:int (default = -1) | |
columnIndex:int (default = -1) |
getCellAt | () | 方法 |
public function getCellAt(x:Number, y:Number):CellPosition| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
返回在指定网格坐标处重叠像素的单元格的行和列索引。如果不存在这样的单元格，则返回 null。
以下示例函数使用此方法计算网格单元格的 dataField 的值。
function getCellData(x:Number, y:Number):Object
{
var cell:CellPosition = getCellAt(x, y);
if (!cell)
return null;
var GridColumn:column = grid.columns.getItemAt(cell.columnIndex);
return grid.dataProvider.getItemAt(cell.rowIndex)[column.dataField];
}
参数
x:Number — 相对于网格的像素的 x 坐标。
| |
y:Number — 相对于网格的像素的 y 坐标。
|
CellPosition — 单元格位置，或为 null。
|
getCellBounds | () | 方法 |
public function getCellBounds(rowIndex:int, columnIndex:int):Rectangle| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
返回指定单元格的当前像素范围，如果不存在这样的单元格，则返回 null。报告网格坐标中的单元格范围。
如果指定行的所有列和位于该行之前的所有行都尚未滚动到视图，则基于列的所有 typicalItem 返回的范围可能只是一个近似值。
参数
rowIndex:int — 行的从零开始的索引。
| |
columnIndex:int — 列的从零开始的索引。
|
Rectangle — 表示单元格的像素范围的 Rectangle 或 null。
|
getCellsAt | () | 方法 |
public function getCellsAt(x:Number, y:Number, w:Number, h:Number):Vector.<CellPosition>| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
返回 CellPosition 对象的矢量，该对象的 rowIndex 和 columnIndex 属性指定与指定网格区域重叠的单元格的行索引和列索引。如果不存在这样的单元格，则返回空矢量。
参数
x:Number — 区域原点处的像素的 x 坐标，相对于网格。
| |
y:Number — 区域原点处的像素的 x 坐标，相对于网格。
| |
w:Number — 区域的宽度，以像素为单位。
| |
h:Number — 区域的高度，以像素为单位。
|
Vector.<CellPosition> — 对象的矢量，例如 Vector.<Object>([{rowIndex:0, columnIndex:0}, ...])。
|
getCellX | () | 方法 |
public function getCellX(rowIndex:int, columnIndex:int):Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
返回指定单元格的原点的 X 坐标。如果不需要单元格的整个边界，此方法比 getCellBounds().x 更有效。
如果指定行的所有列和位于该行之前的所有行都尚未滚动到可视范围内，则根据列的所有 typicalItem，返回的值可能只是一个近似值。
参数
rowIndex:int — 行的从零开始的索引。
| |
columnIndex:int — 列的从零开始的索引。
|
Number — 所指定单元格的原点的 X 坐标。
|
getCellY | () | 方法 |
public function getCellY(rowIndex:int, columnIndex:int):Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
返回指定单元格的原点的 Y 坐标。如果不需要单元格的整个边界，此方法比 getCellBounds().y 更有效。
如果指定行的所有列和位于该行之前的所有行都尚未滚动到可视范围内，则根据列的所有 typicalItem，返回的值可能只是一个近似值。
参数
rowIndex:int — 行的从零开始的索引。
| |
columnIndex:int — 列的从零开始的索引。
|
Number — 所指定单元格的原点的 Y 坐标。
|
getColumnBounds | () | 方法 |
getColumnIndexAt | () | 方法 |
public function getColumnIndexAt(x:Number, y:Number):int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
返回对应于指定坐标的列索引；如果坐标超出边界，则返回 -1。相对于网格解析坐标。
如果网格的所有列或行尚未滚动到视图，则基于列的所有 typicalItem 返回的索引可能只是一个近似值。
参数
x:Number — 相对于网格的像素的 x 坐标。
| |
y:Number — 相对于网格的像素的 y 坐标。
|
int — 列索引；如果坐标超出边界，则返回 -1。
|
getColumnWidth | () | 方法 |
getItemRendererAt | () | 方法 |
public function getItemRendererAt(rowIndex:int, columnIndex:int):IGridItemRenderer| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果请求的项呈示器可见，则返回对指定单元格当前显示的项呈示器的引用。请注意，一旦返回的项呈示器不再可见，则会将其回收且重置其属性。
如果请求的项呈示器不可见，则每次调用此方法时创建一个新的项呈示器。新的项呈示器不可见
如果指定的列不具有明显的宽度，则该单元格的宽度基于 typicalItem。如果尚未指定或未测量 typicalItem，则项呈示器的宽度默认为 150。
如果网格属性 variableRowHeight 为 true（默认值），且未对指定行缓存整个行高度，则项呈示器的高度基于 typicalItem。如果尚未指定或未测量 typicalItem，则项呈示器的高度默认为其首选高度。
参数
rowIndex:int — 项呈示器的单元格的从零开始的行索引。
| |
columnIndex:int — 项呈示器的单元格的从零开始的列索引。
|
IGridItemRenderer — 项呈示器；如果单元格位置无效，则为 null。
|
getRowBounds | () | 方法 |
public function getRowBounds(rowIndex:int):Rectangle| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
返回指定行的当前像素范围，如果不存在这样的行，则返回 null。报告网格坐标中的行范围。
如果指定行的所有列和位于该行之前的所有行都尚未滚动到视图，则基于列的所有 typicalItem 返回的范围可能只是一个近似值。
参数
rowIndex:int — 行的从零开始的索引。
|
Rectangle — 表示行的像素范围的 Rectangle 或 null。
|
getRowIndexAt | () | 方法 |
getVisibleColumnIndices | () | 方法 |
public function getVisibleColumnIndices():Vector.<int>| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
返回当前可见列的索引。请注意，第一列和最后一列的项呈示器可能只有部分可见。按矢量内容的显示顺序返回这些内容。
以下示例函数使用此方法计算可见 GridColumn 对象的矢量。
function getVisibleColumns():Vector.<GridColumn>
{
var visibleColumns = new Vector.<GridColumn>;
for each (var columnIndex:int in grid.getVisibleColumnIndices())
visibleColumns.push(grid.columns.getItemAt(columnIndex));
return visibleColumns;
}
返回Vector.<int> — 可见列索引的矢量。
|
getVisibleRowIndices | () | 方法 |
invalidateCell | () | 方法 |
public function invalidateCell(rowIndex:int, columnIndex:int):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果指定的单元格可见，则它会重新显示。如果 variableRowHeight=true，则执行此操作可能会导致对应行的高度发生更改。
如果 columnIndex 为 -1，则整个行无效。同样，如果 rowIndex 为 -1，则整个列无效。
当对位于 rowIndex 处的数据提供程序项的任何方面所做的更改可能会影响指定单元格的显示方式时，应调用该方法。调用该方法与调用 dataProvider.itemUpdated() 方法类似，后者建议 Grid 显示指定项的所有行应重新显示。使用此方法可以相对提高效率，因为它将更改的范围缩小到单个单元格。
参数
rowIndex:int — 发生更改的单元格的从零开始的行索引，或为 -1。
| |
columnIndex:int — 发生更改的单元格的从零开始的列索引，或为 -1。
|
invalidateTypicalItemRenderer | () | 方法 |
public function invalidateTypicalItemRenderer():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
清除基于 typicalItem 属性的缓存列宽数据，并请求新的布局传递。如果应该由 Grid 的布局所反映的 typicalItem 的某些方面发生了更改，则调用该方法。
如果直接对 typicalItem 进行更改，则会自动调用该方法。这说明如果属性设置为某一新值，则该新值与当前值不具有“==”的关系。
isCellVisible | () | 方法 |
public function isCellVisible(rowIndex:int = -1, columnIndex:int = -1):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果指定的单元格至少部分可见，则返回 true。如果 columnIndex == -1，则在指定的行至少部分可见时返回 true。如果 rowIndex == -1，则指定列至少部分可见时返回 true。如果 columnIndex 和 rowIndex 同时为 -1，则返回 false。
参数
rowIndex:int (default = -1) | |
columnIndex:int (default = -1) |
Boolean — 如果指定的单元格（或行，如果 columnIndex == -1）至少部分可见，则为 true
|
removeSelectedCell | () | 方法 |
public function removeSelectedCell(rowIndex:int, columnIndex:int):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，删除选定内容中的单元格并将尖号位置设置为该单元格。对于所有其它选择模式，此方法不起作用。
rowIndex 是包含所选单元格的项的数据提供程序中的索引。columnIndex 是包含所选单元格的列的 columns 中的索引。
参数
rowIndex:int — 单元格的从零开始的行索引。
| |
columnIndex:int — 单元格的从零开始的列索引。
|
Boolean — 如果未引发任何错误，则为 true。如果 rowIndex 或 columnIndex 无效，或 selectionMode 无效，则为 false。
|
相关 API 元素
removeSelectedIndex | () | 方法 |
public function removeSelectedIndex(rowIndex:int):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，删除选定内容中的此行并将尖号位置设置为此行。对于所有其它选择模式，此方法不起作用。
rowIndex 是包含所选单元格的项的数据提供程序中的索引。
参数
rowIndex:int — 单元格的从零开始的行索引。
|
Boolean — 如果未引发任何错误，则为 true。如果 index 无效或 selectionMode 无效，则为 false。
|
相关 API 元素
selectAll | () | 方法 |
public function selectAll():Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.MULTIPLE_ROWS，选择所有行并删除插入标记；如果 selectionMode 是 GridSelectionMode.MULTIPLE_CELLS，选择所有单元格并删除插入标记。对于所有其它选择模式，此方法不起作用。
如果调用此方法后向 dataProvider 添加项目或添加了 columns，将选择新的行或新列中的单元格。
发生以下任一情况时该隐式“全选”模式将结束：
- 使用
clearSelection清除选定内容 - 使用
setSelectedCell、setSelectedCells、setSelectedIndex或selectIndices之一重置选定内容 dataProvider已刷新且preserveSelection为 falsedataProvider已重置columns已刷新，preserveSelection为false且selectionMode为GridSelectionMode.MULTIPLE_CELLScolumns已重置且selectionMode为GridSelectionMode.MULTIPLE_CELLS
Boolean — 如果选定内容发生更改，则为 true。
|
相关 API 元素
selectCellRegion | () | 方法 |
public function selectCellRegion(rowIndex:int, columnIndex:int, rowCount:uint, columnCount:uint):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.MULTIPLE_CELLS，则将选定内容设置为单元格区域中的所有单元格并将尖号位置设置为单元格区域中的最后一个单元格。对于所有其它选择模式，此方法不起作用。
rowIndex 是包含单元格区域的原点的项的数据提供程序中的索引。columnIndex 是包含单元格区域的原点的列的 columns 中的索引。
如果单元格区域没有完全包含在网格中，此方法不起作用。
参数
rowIndex:int — 单元格区域原点的从零开始的行索引。
| |
columnIndex:int — 单元格区域原点的从零开始的列索引。
| |
rowCount:uint — 要包含在单元格区域中的行数，从 rowIndex 开始。
| |
columnCount:uint — 要包含在单元格区域中的列数，从 columnIndex 开始。
|
Boolean — 如果未引发任何错误，则为 true。如果单元格区域无效或 selectionMode 无效，则为 false。
|
相关 API 元素
selectIndices | () | 方法 |
public function selectIndices(rowIndex:int, rowCount:int):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.MULTIPLE_ROWS，则将选定内容设置为指定行并将尖号位置设置为 endRowIndex。对于所有其它选择模式，此方法不起作用。
每个索引表示要包含在选定内容中的数据提供程序中的一项。
参数
rowIndex:int — 选定内容中第一行的从零开始的行索引。
| |
rowCount:int — 选定内容中的行数。
|
Boolean — 如果未引发任何错误，则为 true。如果所有索引都无效或 startRowIndex 大于 endRowIndex 或 selectionMode 无效，则为 false。
|
相关 API 元素
selectionContainsCell | () | 方法 |
public function selectionContainsCell(rowIndex:int, columnIndex:int):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS 且单元格位于当前选定内容中，则返回 true。
rowIndex 必须介于 0 和数据提供程序的长度之间。columnIndex 必须介于 0 和 columns 的长度之间。
参数
rowIndex:int — 单元格的从零开始的行索引。
| |
columnIndex:int — 单元格的从零开始的列索引。
|
Boolean — 如果当前选定内容包含单元格，则返回 true。
|
相关 API 元素
selectionContainsCellRegion | () | 方法 |
public function selectionContainsCellRegion(rowIndex:int, columnIndex:int, rowCount:int, columnCount:int):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.MULTIPLE_CELLS 且单元格区域中的单元格位于当前选定内容中，则返回 true。
rowIndex 必须介于 0 和数据提供程序的长度之间。columnIndex 必须介于 0 和 columns 的长度之间。
参数
rowIndex:int — 单元格的从零开始的行索引。
| |
columnIndex:int — 单元格的从零开始的列索引。
| |
rowCount:int — 要包含在单元格区域中的行数，从 rowIndex 开始。
| |
columnCount:int — 要包含在单元格区域中的列数，从 columnIndex 开始。
|
Boolean — 如果当前选定内容包含单元格区域中的所有单元格，则返回 true。
|
相关 API 元素
selectionContainsIndex | () | 方法 |
public function selectionContainsIndex(rowIndex:int):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS 且 index 处的行位于当前选定内容中，则返回 true。
rowIndex 是包含所选单元格的项的数据提供程序中的索引。
参数
rowIndex:int — 行的从零开始的行索引。
|
Boolean — 如果选定内容包含此行，则返回 true。
|
相关 API 元素
selectionContainsIndices | () | 方法 |
public function selectionContainsIndices(rowIndices:Vector.<int>):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.MULTIPLE_ROWS 且 indices 中的行位于当前选定内容中，则返回 true。
参数
rowIndices:Vector.<int> — 要包含在选定内容中的从零开始的行索引的矢量。
|
Boolean — 如果当前选定内容包含这些行，则返回 true。
|
相关 API 元素
setSelectedCell | () | 方法 |
public function setSelectedCell(rowIndex:int, columnIndex:int):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_CELL 或 GridSelectionMode.MULTIPLE_CELLS，则将选定内容和尖号位置设置为此单元格。对于所有其它选择模式，此方法不起作用。
rowIndex 是包含所选单元格的项的数据提供程序中的索引。columnIndex 是包含所选单元格的列的 columns 中的索引。
参数
rowIndex:int — 单元格的从零开始的行索引。
| |
columnIndex:int — 单元格的从零开始的列索引。
|
Boolean — 如果未引发任何错误，则为 true。如果 rowIndex 或 columnIndex 无效，或 selectionMode 无效，则为 false。
|
相关 API 元素
setSelectedIndex | () | 方法 |
public function setSelectedIndex(rowIndex:int):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果 selectionMode 是 GridSelectionMode.SINGLE_ROW 或 GridSelectionMode.MULTIPLE_ROWS，则将选定内容和尖号位置设置为此行。对于所有其它选择模式，此方法不起作用。
rowIndex 是包含所选单元格的项的数据提供程序中的索引。
参数
rowIndex:int — 单元格的从零开始的行索引。
|
Boolean — 如果未引发任何错误，则为 true。如果 index 无效，或 selectionMode 无效，则为 false。
|
相关 API 元素
caretChange | 事件 |
spark.events.GridCaretEvent属性 GridCaretEvent.type =
spark.events.GridCaretEvent.CARET_CHANGE| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
插入标记更改后调度。
GridSelectionEvent.CARET_CHANGE 常量为 caretChange 事件定义事件对象的 type 属性的值，指示当前尖号位置刚刚更改。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
newColumnIndex | 尖号位置更改后的从零开始的列索引。如果 selectionMode 基于行，则为 -1。 |
newRowIndex | 尖号位置更改后的从零开始的行索引。 |
oldColumnIndex | 尖号位置更改前的从零开始的列索引。如果 selectionMode 基于行，则为 -1。 |
oldRowIndex | 尖号位置更改前的从零开始的行索引。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | GirdCaretEvent.CARET_CHANGE |
gridClick | 事件 |
spark.events.GridEvent属性 GridEvent.type =
spark.events.GridEvent.GRID_CLICK| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
在单元格上单击鼠标时调度
gridClick GridEvent 的 type 属性的值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
column | 发生事件的列；如果事件没有发生在列中，则为 null。 |
columnIndex | 发生事件的列索引；如果在网格列中没有发生事件，则为 -1。 |
grid | 与此事件关联的网格。 |
item | 此行的数据提供程序项；如果在网格行中没有发生事件，则为 null。 |
itemRenderer | 显示此单元格的项呈示器；如果在可见单元格中没有发生事件，则为 null。 |
rowIndex | 发生事件的行索引；如果在网格行中没有发生事件，则为 -1。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | GirdEvent.GRID_CLICK |
gridDoubleClick | 事件 |
spark.events.GridEvent属性 GridEvent.type =
spark.events.GridEvent.GRID_DOUBLE_CLICK| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
在单元格上双击鼠标时调度
gridDoubleClick GridEvent 的 type 属性的值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
column | 发生事件的列；如果事件没有发生在列中，则为 null。 |
columnIndex | 发生事件的列索引；如果在网格列中没有发生事件，则为 -1。 |
grid | 与此事件关联的网格。 |
item | 此行的数据提供程序项；如果在网格行中没有发生事件，则为 null。 |
itemRenderer | 显示此单元格的项呈示器；如果在可见单元格中没有发生事件，则为 null。 |
rowIndex | 发生事件的行索引；如果在网格行中没有发生事件，则为 -1。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | GirdEvent.GRID_DOUBLE_CLICK |
gridMouseDown | 事件 |
spark.events.GridEvent属性 GridEvent.type =
spark.events.GridEvent.GRID_MOUSE_DOWN| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
在 Grid 单元格上按下鼠标按钮时调度。
gridMouseDown GridEvent 的 type 属性的值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
column | 发生事件的列；如果事件没有发生在列中，则为 null。 |
columnIndex | 发生事件的列索引；如果在网格列中没有发生事件，则为 -1。 |
grid | 与此事件关联的网格。 |
item | 此行的数据提供程序项；如果在网格行中没有发生事件，则为 null。 |
itemRenderer | 显示此单元格的项呈示器；如果在可见单元格中没有发生事件，则为 null。 |
rowIndex | 发生事件的行索引；如果在网格行中没有发生事件，则为 -1。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | GirdEvent.GRID_MOUSE_DOWN |
gridMouseDrag | 事件 |
spark.events.GridEvent属性 GridEvent.type =
spark.events.GridEvent.GRID_MOUSE_DRAG| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
如果在释放按钮之前移动鼠标，则在 gridMouseDown 事件后调度。
gridMouseDrag GridEvent 的 type 属性的值。仅当侦听器处理完 mouseDown 事件，然后按住按钮的同时移动鼠标时，才会调度此事件。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
column | 发生事件的列；如果事件没有发生在列中，则为 null。 |
columnIndex | 发生事件的列索引；如果在网格列中没有发生事件，则为 -1。 |
grid | 与此事件关联的网格。 |
item | 此行的数据提供程序项；如果在网格行中没有发生事件，则为 null。 |
itemRenderer | 显示此单元格的项呈示器；如果在可见单元格中没有发生事件，则为 null。 |
rowIndex | 发生事件的行索引；如果在网格行中没有发生事件，则为 -1。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | GirdEvent.GRID_MOUSE_DRAG |
gridMouseUp | 事件 |
spark.events.GridEvent属性 GridEvent.type =
spark.events.GridEvent.GRID_MOUSE_UP| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
在 Grid 单元格上释放鼠标按钮时调度。在拖动操作期间，释放鼠标按钮时也会在 gridMouseDown 事件后调度，即使鼠标不再位于 Grid 中也如此。
gridMouseUp GridEvent 的 type 属性的值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
column | 发生事件的列；如果事件没有发生在列中，则为 null。 |
columnIndex | 发生事件的列索引；如果在网格列中没有发生事件，则为 -1。 |
grid | 与此事件关联的网格。 |
item | 此行的数据提供程序项；如果在网格行中没有发生事件，则为 null。 |
itemRenderer | 显示此单元格的项呈示器；如果在可见单元格中没有发生事件，则为 null。 |
rowIndex | 发生事件的行索引；如果在网格行中没有发生事件，则为 -1。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | GirdEvent.GRID_MOUSE_UP |
gridRollOut | 事件 |
spark.events.GridEvent属性 GridEvent.type =
spark.events.GridEvent.GRID_ROLL_OUT| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
在鼠标离开网格单元格时调度。
gridRollOut GridEvent 的 type 属性的值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
column | 发生事件的列；如果事件没有发生在列中，则为 null。 |
columnIndex | 发生事件的列索引；如果在网格列中没有发生事件，则为 -1。 |
grid | 与此事件关联的网格。 |
item | 此行的数据提供程序项；如果在网格行中没有发生事件，则为 null。 |
itemRenderer | 显示此单元格的项呈示器；如果在可见单元格中没有发生事件，则为 null。 |
rowIndex | 发生事件的行索引；如果在网格行中没有发生事件，则为 -1。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | GirdEvent.GRID_ROLL_OUT |
gridRollOver | 事件 |
spark.events.GridEvent属性 GridEvent.type =
spark.events.GridEvent.GRID_ROLL_OVER| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
在鼠标指向网格单元格时调度。
gridRollOver GridEvent 的 type 属性的值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
column | 发生事件的列；如果事件没有发生在列中，则为 null。 |
columnIndex | 发生事件的列索引；如果在网格列中没有发生事件，则为 -1。 |
grid | 与此事件关联的网格。 |
item | 此行的数据提供程序项；如果在网格行中没有发生事件，则为 null。 |
itemRenderer | 显示此单元格的项呈示器；如果在可见单元格中没有发生事件，则为 null。 |
rowIndex | 发生事件的行索引；如果在网格行中没有发生事件，则为 -1。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
type | GirdEvent.GRID_ROLL_OVER |
Tue Jun 12 2018, 11:04 AM Z