| 包 | mx.controls |
| 类 | public class DataGrid |
| 继承 | DataGrid DataGridBase ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 实现 | IIMESupport |
| 子类 | FileSystemDataGrid, PrintDataGrid |
DataGrid 控件与 List 控件相似,但它可以显示多个数据列,这使其适合显示具有多个属性的对象。
DataGrid 控件提供以下功能:
DataGrid 控件具有以下默认大小特征:
| 特征 | 说明 |
|---|---|
| 默认大小 | 如果列为空,则默认宽度为 300 个像素。如果列包含信息但没有定义显式宽度,则每列的默认宽度为 100 个像素。如果可能,调整 DataGrid 宽度的大小以适应所有列的宽度。默认的显示行数为 7 行,其中包括标题;默认情况下,每行的高度为 20 个像素。 |
| 最小大小 | 0 个像素。 |
| 最大大小 | 5000 × 5000。 |
隐藏 MXML 语法
The <mx:DataGrid> tag inherits all of the tag
attributes of its superclass, except for labelField,
iconField, and iconFunction, and adds the
following tag attributes:
<mx:DataGrid
Properties
columns="From dataProvider"
draggableColumns="true|false"
editable="false|true"
editedItemPosition="null"
horizontalScrollPosition="null"
imeMode="null"
itemEditorInstance="null"
minColumnWidth="NaN"
resizableColumns="true|false"
sortableColumns="true|false"
Styles
backgroundDisabledColor="0xEFEEEF"
columnDropIndicatorSkin="DataGridColumnDropIndicator"
columnResizeSkin="DataGridColumnResizeSkin"
disabledIconColor="0x999999"
headerColors="[#FFFFFF, #E6E6E6]"
headerDragProxyStyleName="headerDragProxyStyle"
headerSeparatorSkin="DataGridHeaderSeparator"
headerStyleName="dataGridStyles"
horizontalGridLineColor="No default"
horizontalGridLines="false|true"
horizontalLockedSeparatorSkin="undefined"
horizontalSeparatorSkin="undefined"
iconColor="0x111111"
rollOverColor="#E3FFD6"
selectionColor="#CDFFC1"
sortArrowSkin="DataGridSortArrow"
stretchCursor=""cursorStretch" symbol from the Assets.swf file"
verticalGridLineColor="#666666"
verticalGridLines="false|true"
verticalLockedSeparatorSkin="undefined"
verticalSeparatorSkin="undefined"
Events
columnStretch="No default"
headerRelease="No default"
headerShift="No default"
itemEditBegin="No default"
itemEditBeginning="No default"
itemEditEnd="No default"
itemFocusIn="No default"
itemFocusOut="No default"
/>
The following DataGrid code sample specifies the column order:
<mx:DataGrid>
<mx:dataProvider>
<mx:Object Artist="Pavement" Price="11.99"
Album="Slanted and Enchanted"/>
<mx:Object Artist="Pavement"
Album="Brighten the Corners" Price="11.99"/>
</mx:dataProvider>
<mx:columns>
<mx:DataGridColumn dataField="Album"/>
<mx:DataGridColumn dataField="Price"/>
</mx:columns>
</mx:DataGrid>
默认 MXML 属性dataProvider
另请参见
| 属性 | 定义方 | ||
|---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties 此显示对象的当前辅助功能选项。 | DisplayObject | |
![]() | activeEffects : Array [只读 (read-only)] 组件上当前播放的效果列表,如 EffectInstance 实例的 Array。 | UIComponent | |
![]() | allowDragSelection : Boolean = false 一个标志,指示是否启用拖动选择。 | ListBase | |
![]() | allowMultipleSelection : Boolean 一个标志,指示是否允许您同时选择多个项目。 | ListBase | |
![]() | alpha : Number 指示指定对象的 Alpha 透明度值。 | DisplayObject | |
![]() | automationDelegate : Object 处理自动化相关功能的委托对象。 | UIComponent | |
![]() | automationName : String 可用作此对象的标识符的名称。 | UIComponent | |
![]() | automationTabularData : Object [只读 (read-only)] IAutomationTabularData 接口的实现,可用于检索数据。 | UIComponent | |
![]() | automationValue : Array [只读 (read-only)] 此值通常对应于对象的经渲染的外观,当对象在应用中以可视方式显示时,此值使标识符与该对象相关联。 | UIComponent | |
![]() | baselinePosition : Number [只读 (read-only)] 组件第一行文本的基线的 y 坐标。 | UIComponent | |
![]() | blendMode : String BlendMode 类中的一个值,用于指定要使用的混合模式。 | DisplayObject | |
![]() | blendShader : Shader [只写] 设置用于混合前景和背景的着色器。 | DisplayObject | |
![]() | borderMetrics : EdgeMetrics [只读 (read-only)] 返回 EdgeMetrics 对象,它具有四个属性:left、top、right 和 bottom。 | ScrollControlBase | |
![]() | buttonMode : Boolean 指定此 sprite 的按钮模式。 | Sprite | |
![]() | cacheAsBitmap : Boolean 如果设置为 true,则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。 | DisplayObject | |
![]() | cacheHeuristic : Boolean [只写] 供 Flex 使用,表示建议为对象实施位图缓存。 | UIComponent | |
![]() | cachePolicy : String 指定此对象的位图缓存策略。 | UIComponent | |
![]() | className : String [只读 (read-only)] 此实例的类的名称,如“Button”。 | UIComponent | |
| columns : Array DataGridColumn 对象的数组。每个这样的对象对应一个可以显示的列。 | DataGrid | ||
![]() | columnWidth : Number 控件中列的宽度。 | ListBase | |
![]() | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
![]() | contentMouseX : Number [只读 (read-only)] 返回鼠标在内容坐标系中的 x 位置。 | UIComponent | |
![]() | contentMouseY : Number [只读 (read-only)] 返回内容坐标系中鼠标的 y 位置。 | UIComponent | |
![]() | contextMenu : NativeMenu 指定与此对象相关联的上下文菜单。 | InteractiveObject | |
![]() | currentState : String 组件的当前视图状态。 | UIComponent | |
![]() | cursorManager : ICursorManager [只读 (read-only)] 获取控制此组件及其同级组件的光标的 CursorManager。 | UIComponent | |
![]() | data : Object 将此组件用作项目渲染器或项目编辑器时,此组件应呈现的数据提供程序中的项目。 | ListBase | |
![]() | dataProvider : Object 要查看的数据集。 | ListBase | |
![]() | dataTipField : String 数据提供程序项目中作为数据提示显示的字段名称。 | ListBase | |
![]() | dataTipFunction : Function 用户提供的函数,在各个项目上运行以确定其数据提示。 | ListBase | |
![]() | descriptor : UIComponentDescriptor 引用 UIComponentDescriptor(如果有),过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。 | UIComponent | |
![]() | document : Object 引用与此 UIComponent 相关联的文档对象。 | UIComponent | |
![]() | doubleClickEnabled : Boolean 指定 UIComponent 对象是否接收 doubleClick 事件。 | UIComponent | |
![]() | dragEnabled : Boolean 一个标志,指示是否可以将项目拖出此控件并放到其它控件上。 | ListBase | |
| draggableColumns : Boolean 一个标志,指示是否允许用户重排列。 | DataGrid | ||
![]() | dragMoveEnabled : Boolean 一个标志,指示在拖放操作过程中是否可以移动控件中的项目,而不只是从控件中复制这些项目。 | ListBase | |
![]() | dropEnabled : Boolean 一个标志,指示是否可以将所拖动的项目放到此控件上。 | ListBase | |
![]() | dropTarget : DisplayObject [只读 (read-only)] 指定拖动 sprite 时经过的显示对象,或放置 sprite 的显示对象。 | Sprite | |
| editable : Boolean = false 一个标志,指示用户能否编辑数据提供程序中的项目。 | DataGrid | ||
| editedItemPosition : Object 正在编辑的数据提供程序项目的项目渲染器的列索引和行索引(如果有)。 | DataGrid | ||
| editedItemRenderer : IListItemRenderer [只读 (read-only)] 对当前正在编辑的项目所属的 DataGrid 控件中项目渲染器的引用。 | DataGrid | ||
![]() | 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 | |
![]() | fontContext : IFlexModuleFactory 为此组件提供字体上下文的模块工厂。 | DataGridBase | |
![]() | graphics : Graphics [只读 (read-only)] 指定属于此 sprite 的 Graphics 对象,在此 sprite 中可执行矢量绘画命令。 | Sprite | |
![]() | headerHeight : Number 列的标题单元格的高度(以像素为单位)。 | DataGridBase | |
![]() | height : Number 指定组件在父坐标中的高度的数字(以像素为单位)。 | UIComponent | |
![]() | hitArea : Sprite 指定一个 sprite 用作另一个 sprite 的点击区域。 | Sprite | |
![]() | horizontalScrollPolicy : String 指示水平滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。 | ScrollControlBase | |
| horizontalScrollPosition : Number 内容与左边缘的偏移量。 | DataGrid | ||
![]() | id : String 组件 ID。 | UIComponent | |
| imeMode : String 指定 IME(输入法编辑器)模式。 | DataGrid | ||
![]() | includeInLayout : Boolean 指定此组件是否包含在父容器的布局中。 | UIComponent | |
![]() | inheritingStyles : Object 此组件的继承样式链的开头内容。 | UIComponent | |
![]() | initialized : Boolean 一个标志,用于确定某个对象是否已通过布局的所有三个阶段:提交、测量和布局(假设每个阶段都是必需的)。 | UIComponent | |
![]() | instanceIndex : int [只读 (read-only)] 重复组件的索引。 | UIComponent | |
![]() | instanceIndices : Array 一个 Array,包含从此 UIComponent 对象的父文档引用该对象所需的索引。 | UIComponent | |
![]() | isDocument : Boolean [只读 (read-only)] 确定此 UIComponent 实例是否为文档对象,也就是说它是否位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构的顶层。 | UIComponent | |
![]() | isPopUp : Boolean PopUpManager 将其设置为 true 以指示已弹出该组件。 | UIComponent | |
| itemEditorInstance : IListItemRenderer 对项目编辑器的当前活动实例(如果有)的引用。 | DataGrid | ||
![]() | itemRenderer : IFactory 控件的自定义项目渲染器。 | ListBase | |
![]() | labelFunction : Function 用户提供的函数,在每个项目上运行以确定其标签。 | ListBase | |
![]() | listData : BaseListData 如果使用组件作为嵌入式项目渲染器或嵌入式项目编辑器,则 Flex 将使用 list 控件中的其它数据初始化组件的 listData 属性。 | ListBase | |
![]() | liveScrolling : Boolean = true 一个标志,指示移动滚动栏滑块时实时滚动视图,还是释放滑块后才更新视图。 | ScrollControlBase | |
![]() | loaderInfo : LoaderInfo [只读 (read-only)] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | |
![]() | lockedColumnCount : int 滚动的控件中第一列的索引。 | DataGridBase | |
![]() | lockedRowCount : int 滚动的控件中第一行的索引。 | DataGridBase | |
![]() | mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。 | DisplayObject | |
![]() | maxHeight : Number 布局过程中父级要考虑的组件最大建议高度。 | UIComponent | |
![]() | maxHorizontalScrollPosition : Number horizontalScrollPosition 属性的最大值。 | ScrollControlBase | |
![]() | maxVerticalScrollPosition : Number verticalScrollPosition 属性的最大值。 | ScrollControlBase | |
![]() | maxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | |
![]() | measuredHeight : Number 组件的默认高度(以像素为单位)。 | UIComponent | |
![]() | measuredMinHeight : Number 组件的默认最小高度(以像素为单位)。 | UIComponent | |
![]() | measuredMinWidth : Number 组件的默认最小宽度(以像素为单位)。 | UIComponent | |
![]() | measuredWidth : Number 组件的默认宽度(以像素为单位)。 | UIComponent | |
![]() | menuSelectionMode : Boolean = false 一个标志,指示是否应使用菜单样式选择。 | ListBase | |
| minColumnWidth : Number 列的最小宽度(以像素为单位)。 | DataGrid | ||
![]() | minHeight : Number 布局过程中父级要考虑的组件最小建议高度。 | UIComponent | |
![]() | minWidth : Number 布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | |
![]() | moduleFactory : IFlexModuleFactory 用于在正确的 SWF 上下文中创建 TextFields 的 moduleFactory。 | UIComponent | |
![]() | mouseChildren : Boolean 确定对象的子项是否支持鼠标。 | DisplayObjectContainer | |
![]() | mouseEnabled : Boolean 指定此对象是否接收鼠标消息。 | InteractiveObject | |
![]() | mouseFocusEnabled : Boolean 单击时是否可接收焦点。 | UIComponent | |
![]() | mouseX : Number [只读 (read-only)] 指示鼠标位置的 x 坐标,以像素为单位。 | DisplayObject | |
![]() | mouseY : Number [只读 (read-only)] 指示鼠标位置的 y 坐标,以像素为单位。 | DisplayObject | |
![]() | name : String 指示 DisplayObject 的实例名称。 | DisplayObject | |
![]() | nestLevel : int 此对象在所属关系层次结构中的深度。 | UIComponent | |
![]() | nonInheritingStyles : Object 此组件的非继承样式链的开头内容。 | UIComponent | |
![]() | nullItemRenderer : IFactory 控件的自定义项目渲染器。 | ListBase | |
![]() | numAutomationChildren : int [只读 (read-only)] 此容器包含的自动化子项数。 | UIComponent | |
![]() | numChildren : int [只读 (read-only)] 返回此对象的子项数目。 | DisplayObjectContainer | |
![]() | opaqueBackground : Object 指定显示对象是否由于具有某种背景颜色而不透明。 | DisplayObject | |
![]() | owner : DisplayObjectContainer 此 UIComponent 的所有者。 | UIComponent | |
![]() | parent : DisplayObjectContainer [只读 (read-only)] 此组件的父容器或组件。 | UIComponent | |
![]() | parentApplication : Object [只读 (read-only)] 引用包含此 UIComponent 实例的 Application 对象。 | UIComponent | |
![]() | parentDocument : Object [只读 (read-only)] 引用此 UIComponent 的父文档对象。 | UIComponent | |
![]() | percentHeight : Number 以组件父项大小百分比的方式指定组件高度的数字。 | UIComponent | |
![]() | percentWidth : Number 以组件父项大小百分比形式指定其宽度的数字。 | UIComponent | |
![]() | processedDescriptors : Boolean 临时或延迟子项创建操作后设置为 true,具体取决于发生对象。 | UIComponent | |
![]() | prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | |
![]() | repeater : IRepeater [只读 (read-only)] 对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | |
![]() | repeaterIndex : int [只读 (read-only)] 项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。 | UIComponent | |
![]() | repeaterIndices : Array 一个 Array,包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。 | UIComponent | |
![]() | repeaters : Array 一个 Array,包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | |
| resizableColumns : Boolean = true 一个标志,指示用户能否更改列的尺寸。 | DataGrid | ||
![]() | root : DisplayObject [只读 (read-only)] 对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。 | DisplayObject | |
![]() | rotation : Number 指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。 | DisplayObject | |
![]() | rotationX : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转(以度为单位)。 | DisplayObject | |
![]() | rotationY : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转(以度为单位)。 | DisplayObject | |
![]() | rotationZ : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转(以度为单位)。 | DisplayObject | |
![]() | rowCount : int 要显示的行数。 | ListBase | |
![]() | rowHeight : Number 行高(以像素为单位)。 | ListBase | |
![]() | scale9Grid : Rectangle 当前有效的缩放网格。 | DisplayObject | |
![]() | scaleX : Number 用于指定水平缩放系数的数字。 | UIComponent | |
![]() | scaleY : Number 用于指定垂直缩放系数的数字。 | UIComponent | |
![]() | scaleZ : Number 指示从对象的注册点开始应用的对象的深度缩放比例(百分比)。 | DisplayObject | |
![]() | screen : Rectangle [只读 (read-only)] 返回包含此对象的基本绘图表面大小和位置的对象。 | UIComponent | |
![]() | scrollRect : Rectangle 显示对象的滚动矩形范围。 | DisplayObject | |
![]() | scrollTipFunction : Function 将要显示的字符串作为 ScrollTip 计算的函数。 | ScrollControlBase | |
![]() | selectable : Boolean 一个标志,指示列表是否将所选项目显示为选中状态。 | ListBase | |
![]() | selectedIndex : int 所选项目的数据提供程序中的索引。 | ListBase | |
![]() | selectedIndices : Array 数据提供程序中所选项目的索引的数组。 | ListBase | |
![]() | selectedItem : Object 对数据提供程序中所选项目的引用。 | ListBase | |
![]() | selectedItems : Array 对数据提供程序中所选项目的引用的数组。 | ListBase | |
![]() | showHeaders : Boolean 指示控件是否应显示列标题的标志。 | DataGridBase | |
![]() | showInAutomationHierarchy : Boolean 用于确定自动化对象是否显示在自动化层次中的标志。 | UIComponent | |
![]() | showScrollTips : Boolean = false 一个标志,指示拖动滚动滑块时是否应在其旁边显示工具提示。 | ScrollControlBase | |
| sortableColumns : Boolean = true 一个标志,指示用户是否可以通过单击列的标题单元格对数据提供程序项目进行排序。 | DataGrid | ||
![]() | soundTransform : SoundTransform 控制此 sprite 中的声音。 | Sprite | |
![]() | stage : Stage [只读 (read-only)] 显示对象的舞台。 | DisplayObject | |
![]() | states : Array 为此组件定义的视图状态。 | UIComponent | |
![]() | styleDeclaration : CSSStyleDeclaration 存储此对象的内嵌继承样式。 | UIComponent | |
![]() | styleName : Object 此组件使用的类样式。 | UIComponent | |
![]() | systemManager : ISystemManager 返回此组件使用的 SystemManager 对象。 | UIComponent | |
![]() | tabChildren : Boolean 确定对象的子项是否支持 Tab 键。 | DisplayObjectContainer | |
![]() | tabEnabled : Boolean 指定此对象是否遵循 Tab 键顺序。 | InteractiveObject | |
![]() | tabIndex : int 指定 SWF 文件中的对象按 Tab 键顺序排列。 | InteractiveObject | |
![]() | textSnapshot : TextSnapshot [只读 (read-only)] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。 | DisplayObjectContainer | |
![]() | toolTip : String 要在 ToolTip 中显示的文本。 | UIComponent | |
![]() | transform : Transform 一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。 | DisplayObject | |
![]() | transitions : Array 一个 Transition 对象 Array,其中的每个 Transition 对象都定义一组效果,用于在视图状态发生更改时播放。 | UIComponent | |
![]() | tweeningProperties : Array 当前在此对象上进行补间的属性数组。 | UIComponent | |
![]() | uid : String 对象的唯一标识符。 | UIComponent | |
![]() | updateCompletePendingFlag : Boolean 一个标志,确定某个对象是否已通过所有三个阶段的布局验证(假设需要通过所有验证)。 | UIComponent | |
![]() | useHandCursor : Boolean 布尔值,指示当鼠标滑过其 buttonMode 属性设置为 true 的 sprite 时是否显示手指形(手形光标)。 | Sprite | |
![]() | validationSubField : String 供验证程序用来将子字段与此组件相关联。 | UIComponent | |
![]() | value : Object [只读 (read-only)] 所选项目,或者所选项目的数据或标签字段。 | ListBase | |
![]() | variableRowHeight : Boolean 一个标志,指示各行是否可以采用不同的高度。 | ListBase | |
![]() | verticalScrollPolicy : String 指示垂直滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。 | ScrollControlBase | |
![]() | verticalScrollPosition : Number 顶边到内容的偏移量。 | ScrollControlBase | |
![]() | viewMetrics : EdgeMetrics [只读 (read-only)] 考虑滚动条(如果可见)的 EdgeMetrics 对象。 | ScrollControlBase | |
![]() | visible : Boolean 控制此 UIComponent 的可见性。 | UIComponent | |
![]() | width : Number 指定组件在父坐标中的宽度的数字(以像素为单位)。 | UIComponent | |
![]() | wordWrap : Boolean 一个标志,指示行中的文本是否应自动换行。 | ListBase | |
![]() | x : Number 指定组件在其父容器中的水平位置(以像素为单位)的数字。 | UIComponent | |
![]() | y : Number 指定组件在其父容器中的垂直位置(以像素为单位)的数字。 | UIComponent | |
![]() | z : Number 指示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。 | DisplayObject | |
| 方法 | 定义方 | ||
|---|---|---|---|
DataGrid() 构造函数。 | DataGrid | ||
![]() | 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
![]() | 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
![]() | 如果正在运行数据更改效果,则添加项目渲染器。 | ListBase | |
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | |
![]() | 指示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | |
![]() | 返回将放置项目添加到放置目标中的位置的索引。 | ListBase | |
![]() | 排队稍后调用的函数。 | UIComponent | |
![]() | 删除此组件实例中的样式属性。 | UIComponent | |
![]() | 确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | |
![]() | 将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | |
![]() | 将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | |
![]() | 返回标识此容器中的子项的一组属性。 | UIComponent | |
![]() | 返回列单元格或列标题的项目渲染器。 | DataGridBase | |
使用由 itemEditor 属性指定的编辑器在 editedItemPosition 为项目渲染器创建项目编辑器。 | DataGrid | ||
![]() | 创建一个给定了数据对象的项目渲染器. | ListBase | |
![]() | 在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | |
![]() | 在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | |
此方法将关闭项目渲染器上当前打开着的项目编辑器。 | DataGrid | ||
![]() | 返回与此 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 | |
![]() | 将数据绑定到此 UIComponent 对象。 | UIComponent | |
![]() | 根据 String 查找列表中的项目,并将所选内容移至该项目。 | ListBase | |
![]() | 打印完成后调用。 | UIComponent | |
![]() | 在指定的索引位置提供自动化对象。 | UIComponent | |
![]() | 返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
![]() | 返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | |
![]() | 返回具有指定名称的子显示对象。 | DisplayObjectContainer | |
![]() | 返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | |
![]() | 查找此 UIComponent 实例的类型选择器。 | UIComponent | |
![]() | 返回一个约束布局值,这与获取此组件的约束样式的方式类似。 | UIComponent | |
![]() | 确定是使用显式高度还是测量高度的一种简便方法 | UIComponent | |
![]() | 确定是使用显式宽度还是测量宽度的一种简便方法 | UIComponent | |
![]() | 获取当前具有焦点的对象。 | UIComponent | |
![]() | 返回相应的工厂;如果尚未指定,则使用默认工厂。 | ListBase | |
![]() | 返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。 | DisplayObjectContainer | |
![]() | 返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。 | DisplayObject | |
![]() | 返回 true 或 false 以指示是否应在目标上播放效果。 | ListBase | |
![]() | 返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。 | UIComponent | |
![]() | 获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | |
![]() | 将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | |
![]() | 将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。 | DisplayObject | |
![]() | 将二维点从舞台(全局)坐标转换为三维显示对象的(本地)坐标。 | DisplayObject | |
![]() | 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
![]() |
指示对象是否已经定义了指定的属性。 | Object | |
![]() | 在鼠标指针下方隐藏指示允许执行拖放操作的放置指示符。 | ListBase | |
![]() | 计算显示对象,以确定它是否与 obj 显示对象重叠或相交。 | DisplayObject | |
![]() | 计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
![]() | 返回一个框 Matrix,在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | |
![]() | 针对数据提供程序中某个项目的索引获取项目渲染器(如果存在)。 | ListBase | |
![]() | 计算 colIndex 和 rowIndex 处项目的数据提供程序中的偏移量。 | ListBase | |
![]() | 初始化此组件的内部结构。 | UIComponent | |
![]() | 初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | |
![]() | 标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | |
![]() | 在下次更新时刷新所有行。 | ListBase | |
![]() | 标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | |
![]() | 标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | |
确定是否允许按行编辑 dataprovider 项目。 | DataGrid | ||
![]() | 确定是否加亮显示数据提供者项目的项目渲染器(当鼠标滑过它,或者通过键盘导航使它位于尖号下方时)。 | ListBase | |
![]() | 确定数据提供程序项目的项目渲染器是否可选。 | ListBase | |
![]() | 确定是否已选中数据提供程序项目的项目渲染器。 | ListBase | |
![]() | 确定渲染器是否显示某个项目。 | ListBase | |
![]() |
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
![]() | 确定渲染器是否包含(或拥有)显示对象。 | ListBase | |
![]() | 返回通过此项目渲染器呈现的该项目在数据提供程序中的项目索引。 | ListBase | |
![]() | 返回渲染器根据 dataTipField 和 dataTipFunction 属性显示给定数据对象的数据提示字符串。 | ListBase | |
![]() | 根据 iconField 和 iconFunction 属性返回表示数据项目图标的类(如果存在)。 | ListBase | |
![]() | 返回数据提供程序中给定项目的项目渲染器(如果存在)。 | ListBase | |
![]() | 返回渲染器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。 | ListBase | |
![]() | 将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。 | DisplayObject | |
![]() | 将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | |
![]() | 将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。 | DisplayObject | |
![]() | 使用当前项目渲染器测量数据提供程序中的一组项目,并返回这些项目的高度之和。 | ListBase | |
![]() | 测量指定的 HTML 文本(该文本中可能包含 <font> 和 <b> 等 HTML 标记),假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | |
![]() | 测量指定的文本,假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | |
![]() | 使用当前项目渲染器测量数据提供程序中的一组项目,并返回找到的最大宽度。 | ListBase | |
![]() | 将组件移动到其父项内的指定位置。 | UIComponent | |
![]() | 将样式更改传播到子项。 | UIComponent | |
![]() | 如果 owner 属性链从 child 指向此 UIComponent,则返回 true。 | UIComponent | |
![]() | 当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | |
![]() | 准备 IFlexDisplayObject 用于打印。 | UIComponent | |
![]() |
指示指定的属性是否存在、是否可枚举。 | Object | |
![]() | 为此组件构建或重新构建 CSS 样式缓存;如果 recursive 参数为 true,还会为此组件的所有后代执行同样的操作。 | UIComponent | |
![]() | 针对每个效果事件,将 EffectManager 注册为一个事件侦听器。 | UIComponent | |
![]() | 从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | |
![]() | 从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | |
![]() | 如果正在运行数据更改效果,则移除项目渲染器。 | ListBase | |
![]() | 从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
![]() | 重放指定的事件。 | UIComponent | |
![]() | 使用提供的 ID 解析子项。 | UIComponent | |
![]() | [静态] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | |
![]() | 确保给定索引处的数据提供程序项目可见。 | ListBase | |
![]() | 调整对象大小。 | UIComponent | |
![]() | 更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | |
![]() | 设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | |
![]() | 设置当前状态。 | UIComponent | |
![]() | 设置此组件的焦点。 | UIComponent | |
![]() |
设置循环操作动态属性的可用性。 | Object | |
![]() | 对此组件实例设置样式属性。 | UIComponent | |
![]() | 当 visible 属性发生更改时调用。 | UIComponent | |
![]() | 在鼠标指针下方显示拖放指示符表示允许拖放操作以及项目的放置位置。 | ListBase | |
![]() | 允许用户拖动指定的 Sprite。 | Sprite | |
![]() | 结束 startDrag() 方法。 | Sprite | |
![]() | 检测对样式属性的更改。 | UIComponent | |
![]() | 首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。 | UIComponent | |
![]() | [静态] 阻止对使用 callLater() 排队的方法进行背景处理,直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | |
![]() | 交换两个指定子对象的 Z 轴顺序(从前到后顺序)。 | DisplayObjectContainer | |
![]() | 在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。 | DisplayObjectContainer | |
![]() | 返回一个字符串,用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | |
![]() | 如果对应于特定数据项目的项目渲染器需要移动到控件中项目渲染器的正常位置之外,则将作为数据更改效果的一部分由 UnconstrainItemAction 效果调用。 | ListBase | |
![]() | 验证子项的位置和大小,并绘制其它可视内容。 | UIComponent | |
![]() | 验证并更新此对象的属性和布局,如果需要的话重绘对象。 | UIComponent | |
![]() | 由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | |
![]() | 如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法,随后在测量时调用了 validateSize() 方法,则验证组件的度量大小。 | UIComponent | |
![]() | 处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | |
![]() |
返回指定对象的原始值。 | Object | |
![]() | 返回一个框 Matrix,在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | |
![]() | 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher | |
| 方法 | 定义方 | ||
|---|---|---|---|
![]() | 作为拖放操作的一部分,将所选项目添加到 DragSource 对象。 | ListBase | |
![]() | 将渲染器添加到循环使用的渲染器列表,使其不可见并清除对该渲染器的引用。 | ListBase | |
![]() | 从用于存储对行的引用的数组开头添加一个空白行. | ListBase | |
![]() | 调整焦点矩形。 | UIComponent | |
从 updateDisplayList() 方法中调用,用以调整 listContent 的大小和位置。 | DataGrid | ||
![]() | 针对给定的 rowNum、行位置和行高调整渲染器的大小和位置。 | DataGridBase | |
![]() | 设置应用选择指示符的效果。 | ListBase | |
![]() | 这是一个内部方法,供 Flex 框架用于支持 Dissolve 效果。 | UIComponent | |
![]() | 在执行拖放操作时计算放置指示符的 y 位置。 | ListBase | |
![]() | 计算一行中列的行高。 | DataGridBase | |
![]() | 创建子对象后执行任何最终处理。 | UIComponent | |
![]() | 清除给定 Sprite 中的尖号指示符。. | ListBase | |
![]() | 清除给定 Sprite 中的加亮指示符. | ListBase | |
![]() | 删除所有选定、加亮显示和尖号指示符。 | ListBase | |
![]() | 从对于给定 rowNum 应为空的行中删除渲染器。 | DataGridBase | |
![]() | 清除所选项目组,并移除表示那些项目的选定状态的所有图形。 | ListBase | |
移除用户通常用于调整列大小的列标题分隔符。 | DataGrid | ||
![]() | 清空 visibleData 哈希表. | ListBase | |
![]() | 当数据发生更改时,处理从数据提供程序中调度的 CollectionEvent。 | ListBase | |
![]() | 根据是否已显式设置 columnCountcolumnWidth、rowHeight 和 rowCount 等属性来计算列宽、行高以及行数和列数。 | ListBase | |
![]() | 根据行数、列数以及可查看的行和列配置 ScrollBar。 | ListBase | |
![]() | 通过调用 ObjectUtil.copy() 方法为此对象制作一个深层副本,然后通过调用 UIDUtil.createUID() 方法用一个新值替代该副本的 uid 属性(如果存在)。 | ListBase | |
![]() | 按照选择时的顺序复制所选项目。 | ListBase | |
![]() | 为此组件创建边框。 | ScrollControlBase | |
![]() | 创建对象作为此 ListBase 的子对象,在这种情况下为将容纳所有项目渲染器的 listContent 对象。 | ListBase | |
![]() | 根据所用的嵌入字体使用上下文创建新对象。 | UIComponent | |
![]() | 使用给定的 moduleFactory 创建对象。 | UIComponent | |
![]() | 循环使用不再需要的行,并删除其指示符。 | ListBase | |
![]() | 处理 DragEvent.DRAG_COMPLETE 事件。 | ListBase | |
![]() | 处理 DragEvent.DRAG_DROP 事件。 | ListBase | |
![]() | 处理 DragEvent.DRAG_ENTER 事件。 | ListBase | |
![]() | 处理 DragEvent.DRAG_EXIT 事件。 | ListBase | |
![]() | 处理 DragEvent.DRAG_OVER 事件。 | ListBase | |
![]() | Interval 函数,用于在鼠标位于列表上方或下方时上下滚动列表。 | ListBase | |
![]() | dragStart 事件的默认处理函数。 | ListBase | |
![]() | drawCaretIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void 使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制尖号指示符。 | ListBase | |
使用建议的颜色为列绘制列背景。 | DataGrid | ||
在给定的 UIComponent 中绘制标题的背景。 | DataGrid | ||
![]() | drawHighlightIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void 使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制加亮指示符。 | ListBase | |
绘制行之间的直线。 | DataGrid | ||
![]() | drawItem(item:IListItemRenderer, selected:Boolean = false, highlighted:Boolean = false, caret:Boolean = false, transition:Boolean = false):void 绘制带有指示符(加亮显示的或选中的)或尖号的渲染器。 | ListBase | |
绘制列之间的直线,以及列背景。 | DataGrid | ||
drawLinesAndColumnGraphics(contentHolder:ListBaseContentHolder, visibleColumns:Array, separators:Object):void 绘制列之间的直线,以及列背景。 | DataGrid | ||
使用指定的颜色在指定的位置按指定的高度绘制行背景。 | DataGrid | ||
![]() | 绘制行中所有交替行的颜色、边框和背景。 | ListBase | |
![]() | drawSelectionIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void 使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制选择指示符。 | ListBase | |
创建用户通常用于调整列大小的列标题分隔符并将其显示出来。 | DataGrid | ||
绘制列之间的直线。 | DataGrid | ||
![]() | drawVisibleItem(uid:String, selected:Boolean = false, highlighted:Boolean = false, caret:Boolean = false, transition:Boolean = false):void 绘制可见的项目。 | DataGridBase | |
![]() | 尝试在数据提供程序中查找下一个以 eventCode 参数中的字符开头的项目。 | ListBase | |
![]() | 在数据更改效果运行完毕后,通过恢复原始集合和迭代器并移除此效果使用的所有缓存值进行清理。 | ListBase | |
![]() | 基于 caretIndex 和 anchorIndex 属性设置所选项目。 | DataGridBase | |
![]() | 当 UIComponent 对象获得焦点时调用的事件处理函数。 | UIComponent | |
![]() | 当 UIComponent 对象失去焦点时调用的事件处理函数。 | UIComponent | |
![]() | 检索已创建但当前未使用的项目渲染器。 | ListBase | |
![]() | 给定索引处数据提供程序项目所在的列。 | ListBase | |
![]() | 给定索引处数据提供程序项目所在的行。 | ListBase | |
![]() | 完成对此组件的初始化。 | UIComponent | |
![]() | 初始化此组件的辅助功能代码。 | UIComponent | |
![]() | 当数据提供程序中发生更改时应用数据更改效果。 | ListBase | |
![]() | 通常由包含 UITextField 对象的组件覆盖,其中 UITextField 对象获取焦点。 | UIComponent | |
![]() | 如果项目渲染器不再根据列表的布局算法定位,则返回 true,尽管由于调用 unconstrainRenderer() 方法正在运行数据更改效果。 | ListBase | |
![]() | 返回一个 Point 对象,用于定义项目渲染器的 columnIndex 和 rowIndex 属性。 | DataGridBase | |
![]() | 确定数据提供程序项目的 UID。 | ListBase | |
![]() | 为 keyDown 事件调用的事件处理函数。 | UIComponent | |
![]() | 为 keyUp 事件调用的事件处理函数。 | UIComponent | |
![]() | 通过设置此控件边框的位置和大小来响应大小更改。 | ScrollControlBase | |
![]() | 针对某列确定 itemRenderer 的大小和临时位置,同时以 Point 的形式返回其大小。 | DataGridBase | |
![]() | makeListData(data:Object, uid:String, rowNum:int, columnNum:int, column:DataGridColumn):BaseListData 创建新 DataGridListData 实例,并基于输入数据提供程序项目来填充字段。 | DataGridBase | |
![]() | makeRow(contentHolder:ListBaseContentHolder, rowNum:int, left:Number, right:Number, yy:Number, data:Object, uid:String):Number 针对给定的 rowNum、dataObject 和 uid 创建渲染器。 | DataGridBase | |
![]() | makeRowsAndColumns(left:Number, top:Number, right:Number, bottom:Number, firstColumn:int, firstRow:int, byCount:Boolean = false, rowsNeeded:uint = 0):Point 创建足够的行和列以填充左侧、顶部、右侧和底部描述的区域。 | ListBase | |
![]() | 根据 rowCount、columnCount、rowHeight 和 columnWidth 属性计算组件的度量宽度和高度。 | ListBase | |
![]() | 处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_CLICK 事件。 | ListBase | |
![]() | 处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_DOUBLE_CLICK 事件。 | ListBase | |
![]() | 处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_DOWN 事件。 | ListBase | |
![]() | 确定哪种项目渲染器位于鼠标下方。 | ListBase | |
![]() | 处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_MOVE 事件。 | ListBase | |
![]() | 处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_OUT 事件。 | ListBase | |
![]() | 处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_OVER 事件。 | ListBase | |
![]() | 处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_DOWN 事件。 | ListBase | |
![]() | 通过更改滚动位置处理 mouseWheel 事件。 | ListBase | |
![]() | 水平移动所选项目并加亮指示符. | ListBase | |
![]() | 垂直移动所选项目并加亮指示符. | ListBase | |
![]() | 垂直移动行,并更新 rowInfo 记录. | ListBase | |
![]() | 沿水平方向移动所选项目,以响应用户使用向左键或向右键以及功能键(如 Shift 和 Ctrl 键)选择项目的操作。 | ListBase | |
![]() | 沿垂直方向移动所选项目,以响应用户用向上键或向下键以及功能键(如 Shift 和 Ctrl 键)选择项目的操作。 | DataGridBase | |
在作为当前排序键的列上绘制排序箭头图形。 | DataGrid | ||
![]() | 准备集合事件的数据效果。 | ListBase | |
![]() | 确保行数组中有一个槽对应给定的行号。 | DataGridBase | |
![]() | 当渲染器发生更改时,updateDisplayList() 方法将调用此方法,用以删除现有的项目渲染器并清理各种缓存结构。 | ListBase | |
![]() | 更新 visibleData 哈希表中的键. | ListBase | |
![]() | 从 contentHolder 的末尾删除额外行。 | DataGridBase | |
![]() | 从用于存储对行的引用的数组中删除一行. | ListBase | |
![]() | 清理数据提供程序中给定项目的选项亮显及其它关联图形。 | ListBase | |
![]() | 构建 UIComponent 时将调用此方法,并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时,都会再次调用此方法。 | UIComponent | |
![]() | 从用于存储对行的引用的数组开头删除请求的行数. | ListBase | |
![]() | 确定此组件中的空间是否足以显示给定的滚动条。 | ScrollControlBase | |
![]() | scroll 事件的默认事件处理函数。 | ScrollControlBase | |
![]() | 调整渲染器以响应滚动位置的更改。 | ListBase | |
返回给定滚动位置第一个可见行和列处的项目的数据提供程序索引。 | DataGrid | ||
调整渲染器以响应滚动位置的更改。 | DataGrid | ||
![]() | 当由于页面错误而导致寻找失败时的默认故障处理函数。 | ListBase | |
![]() | 当由于页面错误而导致寻找失败时的默认结果处理函数。 | ListBase | |
![]() | 搜寻位置,并在必要时处理 ItemPendingError。 | ListBase | |
![]() | selectItem(item:IListItemRenderer, shiftKey:Boolean, ctrlKey:Boolean, transition:Boolean = true):Boolean 如果使用鼠标单击提供的项目渲染器,并且键盘功能键处于给定状态,则更新所选项目组。 | ListBase | |
![]() | 设置 rowCount 属性不会导致 invalidation,也不会设置将永久锁定行数的 explicitRowCount 属性。 | ListBase | |
![]() | 设置 rowHeight 属性不会导致 invalidation,也不会设置将永久锁定行高的 explicitRowHeight。 | ListBase | |
![]() | 针对给定的 rowNum、行位置和行高设置 rowInfo。 | DataGridBase | |
![]() | 使 ScrollControlBase 基于传递的参数显示或隐藏滚动条。 | ScrollControlBase | |
![]() | setupColumnItemRenderer(c:DataGridColumn, contentHolder:ListBaseContentHolder, rowNum:int, colNum:int, data:Object, uid:String):IListItemRenderer 为某列设置项目渲染器,并将其放置在 listItems 数组中所请求的位置。 | DataGridBase | |
![]() | 移动引用多行的数组中的某一行. | ListBase | |
![]() | 确定所请求的行集的高度. | ListBase | |
![]() | 从用于存储对行的引用的数组末端删除所有剩余行. | ListBase | |
![]() | Find an item renderer based on its UID if it is visible. | ListBase | |
![]() | 当可显示的项目数发生更改时添加或移除项目渲染器。 | ListBase | |
![]() | 刷新所有行。 | ListBase | |
![]() | 同步重绘渲染器。 | DataGridBase | |
| 事件 | 摘要 | 定义方 | ||
|---|---|---|---|---|
![]() | [广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | ||
![]() | 使用 addChild() 或 addChildAt() 方法将组件作为内容子项添加到容器时调度。 | UIComponent | ||
![]() | 将显示对象添加到显示列表中时调度。 | DisplayObject | ||
![]() | 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 | DisplayObject | ||
![]() | 当用户操作导致 selectedIndex 或 selectedItem 属性更改时调度此事件。 | ListBase | ||
![]() | 当用户从文本上下文菜单中选择“清除”(或“删除”)时调度。 | InteractiveObject | ||
![]() | 用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。 | InteractiveObject | ||
| 当用户更改列宽时调度,指示此列中显示的数据量可能会更改。 | DataGrid | |||
![]() | 当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。 | InteractiveObject | ||
![]() | 当用户激活特定于平台的复制操作的快捷键组合或从文本上下文菜单中选择“复制”时调度。 | InteractiveObject | ||
![]() | 当组件完成其构建、属性处理、测量、布置和绘制时调度。 | UIComponent | ||
![]() | 视图状态更改后调度。 | UIComponent | ||
![]() | 在 currentState 属性更改后但视图状态更改前调度。 | UIComponent | ||
![]() | 当用户激活特定于平台的剪切操作的快捷键组合或从文本上下文菜单中选择“剪切”时调度。 | InteractiveObject | ||
![]() | 当 data 属性更改时进行调度。 | ListBase | ||
![]() | [广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | ||
![]() | 如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。 | InteractiveObject | ||
![]() | 在拖动操作完成时(将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时)由拖动启动器(作为要拖动的数据源的组件)调度。 | UIComponent | ||
![]() | 用户在放置目标上释放鼠标时由放置目标调度。 | UIComponent | ||
![]() | 当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时,由该组件调度。 | UIComponent | ||
![]() | 用户在组件外拖动但没有将数据放置到目标时,由组件调度。 | UIComponent | ||
![]() | 在拖动操作期间,当用户在鼠标位于组件上方的情况下移动鼠标时,由组件调度。 | UIComponent | ||
![]() | 启动拖动操作时,由拖动启动器调度。 | UIComponent | ||
![]() | 在一个效果结束后调度。 | UIComponent | ||
![]() | 在即将开始播放效果前调度。 | UIComponent | ||
![]() | [播放事件] 播放头进入新帧时调度。 | DisplayObject | ||
![]() | 组件返回到根视图状态之后调度。 | UIComponent | ||
![]() | [广播事件] 播放头退出当前帧时调度。 | DisplayObject | ||
![]() | 组件退出根视图状态之前调度。 | UIComponent | ||
![]() | 显示对象获得焦点后调度。 | InteractiveObject | ||
![]() | 显示对象失去焦点后调度。 | InteractiveObject | ||
![]() | [广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。 | DisplayObject | ||
| 当用户在列标题上释放鼠标按键以请求控件基于列内容对网格内容进行排序时调度。 | DataGrid | |||
| 当用户将列拖动到新位置使该列移动到新索引处后,在列标题上释放鼠标按键时调度。 | DataGrid | |||
![]() | 当对象的状态从可见变为不可见时调度。 | UIComponent | ||
![]() | 当组件完成构建并设置了所有初始化属性后调度。 | UIComponent | ||
![]() | 当组件由 Validator 监控且未通过验证时调度。 | UIComponent | ||
![]() | 当用户单击控件中的某个项目时调度此事件。 | ListBase | ||
![]() | 当用户双击控件中的某个项目时调度此事件。 | ListBase | ||
| 当 editedItemPosition 属性已设置且项目可编辑时调度。 | DataGrid | |||
| 当用户在某个项目渲染器上方释放鼠标按键时,使用 tab 键导航到 DataGrid 控件或 DataGrid 控件内部时,或者以任何其它方式尝试编辑某一项目时调度。 | DataGrid | |||
| 当项目编辑会话因任何原因而结束时调度。 | DataGrid | |||
| 当项目渲染器获得焦点时调度。在下列情况下项目渲染器可能获得焦点:当用户单击 DataGrid 控件中的某个项目或者使用键盘导航到该项目时。 | DataGrid | |||
| 当项目渲染器失去焦点时调度。在下列情况下项目渲染器可能失去焦点:当用户单击 DataGrid 控件中的其它项目或在此控件外部单击时,或使用键盘导航到 DataGrid 控件中的其它项目或导航到该控件外部时。 | DataGrid | |||
![]() | 当用户将鼠标指针移出控件中的某个项目时调度此事件。 | ListBase | ||
![]() | 当用户将鼠标指针滚至控件中的某个项目时调度此方法。 | ListBase | ||
![]() | 用户按下某个键时调度。 | 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 | ||
![]() | 使用 removeChild() 或 removeChildAt() 方法将组件作为内容子项从容器中删除时调度。 | UIComponent | ||
![]() | 将要从显示列表中删除显示对象时调度。 | DisplayObject | ||
![]() | 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 | DisplayObject | ||
![]() | [广播事件] 将要更新和呈现显示列表时调度。 | DisplayObject | ||
![]() | 在调整组件大小时调度。 | UIComponent | ||
![]() | 当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。 | InteractiveObject | ||
![]() | 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | ||
![]() | 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | ||
![]() | 用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | ||
![]() | 用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | ||
![]() | 当滚动内容时调度。 | ScrollControlBase | ||
![]() | 当用户激活特定于平台的全选操作的快捷键组合或从文本上下文菜单中选择“全选”时调度。 | InteractiveObject | ||
![]() | 当对象的状态从不可见变为可见时调度。 | UIComponent | ||
![]() | 对象的 tabChildren 标志值发生更改时调度。 | InteractiveObject | ||
![]() | 对象的 tabEnabled 标志发生更改时调度。 | InteractiveObject | ||
![]() | 对象的 tabIndex 属性值发生更改时调度。 | InteractiveObject | ||
![]() | 要创建 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 已隐藏组件的 ToolTip 并要将其放弃时由组件调度。 | UIComponent | ||
![]() | 要隐藏组件的 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 要显示组件的 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 显示组件的 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 用户将鼠标移动到设置了 toolTip 属性的组件上方后,由该组件调度。 | UIComponent | ||
![]() | 当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度(如果需要)。 | UIComponent | ||
![]() | 当组件由 Validator 监控并且成功通过验证时调度。 | UIComponent | ||
![]() | 当以编程方式或通过用户交互更改值时调度。 | UIComponent | ||
| 样式 | 说明 | 定义方 | ||
|---|---|---|---|---|
![]() | 类型: Array 格式: Color CSS 继承: yes 列表中项目使用的背景色。此值是由两种或更多种颜色组成的数组。列表项目的背景色将从数组中的各种颜色之间选取。 对于 DataGrid 控件,行中的所有项目都使用相同的背景色,而每行的背景色都由颜色数组确定。 对于只使用一个列表填充二维显示的 TileList 控件,此样式可根据指定的列数、行数和颜色数生成棋盘外观、条纹或其它图案。TileList 循环使用各种颜色,根据布局方向设置各个项目的背景色。如果您的 TileList 为水平布局,并且颜色数和列数均为偶数,则显示条纹图案。如果列数为奇数,则显示棋盘图案。 仅当未指定 | ListBase | ||
![]() | 类型: Number CSS 继承: nobackgroundColor 属性定义的颜色和 backgroundImage 样式定义的图像或 SWF 文件的 Alpha 级别。有效值范围为从 0. | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: no 组件的背景颜色。您可以同时设置 backgroundColor 和 backgroundImage。一些组件没有背景。DataGrid 控件会忽略此样式。默认值为 undefined,即不进行设置。如果此样式和 backgroundImage 样式都为 undefined,则控件将采用透明背景。 对于 Application 容器,此样式指定应用程序加载时的背景色以及运行该应用程序时的背景渐变。Flex 计算比指定颜色略深的颜色和比指定颜色略浅的颜色之间的渐变。 大多数 Flex 控件的默认外观为半透明。因此,容器的背景颜色将在某种程度上“渗入”该容器中的控件。通过将控件的 <mx: Container backgroundColor="0x66CC66"/> <mx: ControlName ... | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 禁用组件时的组件的背景颜色。全局默认值为 undefined。List 控件的默认值为 0xDDDDDD(浅灰)。如果禁用了容器,背景将变暗,而暗淡程度由 disabledOverlayAlpha 样式控制。. | ScrollControlBase | ||
![]() | 类型: Object 格式: File CSS 继承: no 组件的背景图像。此样式可以是绝对或相对 URL 或类。您可以同时设置 backgroundColor 和 backgroundImage。背景图像显示在背景色上面。默认值为 undefined,表示“未设置”。如果此样式和 backgroundColor 样式都未定义,则控件将采用透明背景。 大多数 Flex 控件的默认外观为半透明。因此,容器的背景图像将在某种程度上“渗入”该容器中的控件。通过将控件的 <mx: Container backgroundColor="0x66CC66"/> <mx: ControlName ... | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 将 backgroundImage 指定的图像缩放到不同的百分比大小。"100%" 值将拉抻该图像以适应整个组件。要指定百分比值,您必须输入百分号 (%)。Application 容器的默认值为 100%。所有其它容器的默认值为 auto,此值将保持图像的原始大小。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位)。如果设置此样式,则组件的基线锚定在其内容区域的上边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: uint 格式: Color CSS 继承: no 边框颜色。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 0xB7BABC。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 边框边。指定要显示的边框边的以空格分隔的 String。此 String 可以任意顺序包含 "left"、"top"、"right" 和 "bottom"。默认值为 "left top right bottom",此值会显示所有四条边。仅当 borderStyle 为 "solid" 时才使用此样式。. | ScrollControlBase | ||
![]() | 类型: Class CSS 继承: no 组件的边框外观类。mx. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 边框样式。可能值为 "none"、"solid"、"inset" 和 "outset"。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 "inset"。大多数容器的默认值为 "none"。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 边框厚度。仅在将 borderStyle 设置为 "solid" 时使用。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 从组件的下边缘到其内容区域的下边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的下边缘锚定在其内容区域的下边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 组件中文本(包括组件标签)的颜色。. | ScrollControlBase | ||
columnDropIndicatorSkin | 类型: Class CSS 继承: no 用作指示可将列放在当前位置的外观的类。 默认值为 mx.skins.halo.DataGridColumnDropIndicator. | DataGrid | ||
columnResizeSkin | 类型: Class CSS 继承: no 用作要调整大小的列的外观的类。 默认值为 mx.skins.halo.DataGridColumnResizeSkin. | DataGrid | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 禁用时组件中文本的颜色。. | ScrollControlBase | ||
disabledIconColor | 类型: uint 格式: Color CSS 继承: yes 已禁用外观中图标的颜色。例如,CheckBoxIcon 外观类可使用此样式来绘制禁用的 CheckBox 控件的复选标记;ComboBoxSkin 类可使用此样式来绘制禁用的 ComboBox 控件的向下箭头;DateChooserMonthArrowSkin 外观类可使用此样式来绘制禁用的 DateChooser 控件的月箭头。默认值取决于组件类;如果此类未覆盖默认值,则默认值为 0x999999。
| DataGrid | ||
![]() | 类型: Class CSS 继承: no 用于指示所拖动项目的放置位置的外观。如果拖放操作的目标位置可能是 ListBase-derived 组件,则调用 showDropFeedback() 方法将产生此类的实例,并将该实例定位在所放置项目之后项目的 itemRenderer 上方一个像素处(如果进行放置)。. | ListBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 投影颜色。. | ScrollControlBase | ||
![]() | 类型: Boolean CSS 继承: no 指定组件是否具有可见投影的布尔值属性。此样式与 borderStyle="solid" 一起使用。默认值为 false。 注意:对于显示在容器上的投影,需设置 | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 验证失败时,组件加亮部分的颜色。验证失败时,Flex 还会将组件的 borderColor 样式设置为 errorColor。. | UIComponent | ||
![]() | 类型: Number CSS 继承: no 指定焦点外观的 alpha 透明度值。. | ListBase | ||
![]() | 类型: String CSS 继承: no 焦点矩形使用的混合模式。有关详细信息,请参阅 flash. | UIComponent | ||
![]() | 类型: String CSS 继承: no 指定焦点矩形的哪些角应该是圆角。此值是使用空格分隔的 String,该 String 可以是 "tl"、"tr"、"bl" 和 "br" 的任意组合。例如,要指定右侧的角为圆角,左侧的角为直角,应使用 "tr br"。cornerRadius 样式属性指定圆角的半径。默认值取决于组件类;如果未覆盖该类的默认值,则默认值为 "tl tr bl br"。. | ListBase | ||
![]() | 类型: Class CSS 继承: no 用于绘制焦点矩形的外观。. | UIComponent | ||
![]() | 类型: Number 格式: Length CSS 继承: no 焦点矩形轮廓的粗细,以像素为单位。. | UIComponent | ||
![]() | 类型: String CSS 继承: yes 设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性。可能值为 "none" (flash. | ScrollControlBase | ||
![]() | 类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。 仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 . | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: yes 文本的高度,以像素为单位。除 ColorPicker 控件之外,所有控件的默认值都为 10。ColorPicker 控件的默认值为 11。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 确定文本是否使用斜体。可识别的值为 "normal" 和 "italic"。. | ScrollControlBase | ||
![]() | 类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。 仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 . | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 确定文本是否使用粗体。可识别的值为 normal 和 bold。Button 控件的默认值为 bold。所有其它控件的默认值为 normal。. | ScrollControlBase | ||
headerBackgroundSkin | 类型: Class CSS 继承: no 用作定义 DataGrid 控件中列标题的背景外观的外观的类。 默认值为 mx.skins.halo.DataGridHeaderSeparator. | DataGrid | ||
headerColors | 类型: Array 格式: Color CSS 继承: yes 用于绘制标题背景渐变的两种颜色的数组。第一种颜色是顶层颜色。第二种颜色是底层颜色。 默认值为 [0xFFFFFF, 0xE6E6E6]. | DataGrid | ||
headerDragProxyStyleName | 类型: String CSS 继承: no 适用于当用户将列外观拖动到另一位置时,控制其各个方面的 CSS 样式声明的名称。 默认值为 "headerDragProxyStyle". | DataGrid | ||
headerSeparatorSkin | 类型: Class CSS 继承: no 用作定义 DataGrid 控件中列标题之间的分隔符外观的外观的类。 默认值为 mx.skins.halo.DataGridHeaderSeparator. | DataGrid | ||
headerStyleName | 类型: String CSS 继承: no 用于控制列标题外观其它方面的 CSS 样式声明的名称。 默认值为 "dataGridStyles". | DataGrid | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的水平距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整组件容器大小后,这两个中心将保持它们的水平间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
horizontalGridLineColor | 类型: uint 格式: Color CSS 继承: yes 水平网格线的颜色。 | DataGrid | ||
horizontalGridLines | 类型: Boolean CSS 继承: no 一个标志,指示是否显示行之间的水平网格线。如果为 true,则显示水平网格线。如果为 false,则隐藏水平网格线。
默认值为 false. | DataGrid | ||
horizontalLockedSeparatorSkin | 类型: Class CSS 继承: no 用作定义 DataGrid 控件中锁定和未锁定行之间的分隔符外观的外观的类。默认情况下,DataGrid 控件使用 drawHorizontalLine() 和 drawVerticalLine() 方法绘制分隔符。
默认值为 undefined. | DataGrid | ||
![]() | 类型: String CSS 继承: no 水平 scrollbar 的样式名称。通过它,可以更精细地控制滚动条的外观。. | ScrollControlBase | ||
horizontalSeparatorSkin | 类型: Class CSS 继承: no 用作定义 DataGrid 控件中各行之间的分隔符外观的外观的类。默认情况下,DataGrid 控件使用 drawHorizontalLine() 和 drawVerticalLine() 方法绘制分隔符。
默认值为 undefined. | DataGrid | ||
iconColor | 类型: uint 格式: Color CSS 继承: yes 某个外观中图标的颜色。例如,CheckBoxIcon 外观类可使用此样式来绘制 CheckBox 控件的复选标记;ComboBoxSkin 类可使用此样式来绘制 ComboBox 控件的向下箭头;DateChooserMonthArrowSkin 外观类可使用此样式来绘制 DateChooser 控件的月箭头。默认值取决于组件类;如果此类未覆盖默认值,则默认值为 0x111111。
| DataGrid | ||
![]() | 类型: Boolean CSS 继承: yes 一个布尔值,指示是启用 ( true) 还是禁用 (false) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: yes 文本行之间附加的垂直空间。 默认值为 2。 ComboBox 控件的默认值为 0。 . | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的左边缘到组件左边缘的水平距离(以像素为单位)。如果设置此样式,则组件的左边缘锚定在其内容区域的左边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: Number CSS 继承: yes 各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 行的底部与该行中渲染器底部之间的像素数目。. | ListBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 组件左边框与其内容区域左边缘之间的像素数目。 默认值为 0。 Button 控件的默认值为 10。 ComboBox 控件的默认值为 5。 Form 容器的默认值为 16。 Tree 控件的默认值为 2。 . | ListBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 组件右边框与其内容区域右边缘之间的像素数目。 默认值为 0。 Button 控件的默认值为 10。 ComboBox 控件的默认值为 5。 Form 容器的默认值为 16。 . | ListBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 行的顶部与该行中渲染器顶部之间的像素数目。. | ListBase | ||
![]() | 类型: String CSS 继承: no 从组件的右边缘到其内容区域的右边缘的水平距离(以像素为单位)。如果设置此样式,则组件的右边缘锚定在其内容区域的右边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
rollOverColor | 类型: uint 格式: Color CSS 继承: yes 用户将鼠标滑过行时的行背景颜色。 默认值为 0xE3FFD6. | DataGrid | ||
selectionColor | 类型: uint 格式: Color CSS 继承: yes 用户选择行中的项目渲染器时的行背景颜色。 默认值为 0xCDFFC1. | DataGrid | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 禁用此组件时渲染器的背景色。. | ListBase | ||
![]() | 类型: Number 格式: Time CSS 继承: no 选择效果的持续时间。如果选中了某个项目,则在背景着色时会播放相应的效果。设置为 0 可禁用此效果。. | ListBase | ||
![]() | 类型: Function CSS 继承: no 针对选项效果的 easingFunction。如果选中了某个项目,则在背景着色时会播放相应的效果。默认效果为颜色的线性淡入淡出。easingFunction 可用于控制选择效果。. | ListBase | ||
![]() | 类型: String CSS 继承: no 投影方向。可能值包括 "left"、"center" 和 "right"。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 投影距离。如果将此属性设置为负值,此阴影将出现在组件的上方。. | ScrollControlBase | ||
sortArrowSkin | 类型: Class CSS 继承: no 用作指示列排序方向的箭头外观的类。 默认值为 mx.skins.halo.DataGridSortArrow. | DataGrid | ||
stretchCursor | 类型: Class CSS 继承: no 用作指示可调整列大小的光标外观的类。默认值为 Assets.swf 文件中的 "cursorStretch" 符号。 | DataGrid | ||
![]() | 类型: String CSS 继承: yes 容器内文本的对齐情况。可能值有: "left"、"right" 或 "center"。 大多数组件的默认值为 | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 确定文本是否加下划线。可能值有: "none" 和 "underline"。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: yes 文本第一行偏离容器左侧的距离(以像素为单位)。. | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 用户滚过鼠标时渲染器文本的颜色。. | ListBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 用户选中渲染器时其文本的颜色。. | ListBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 组件的主题颜色。此属性控制加亮内容的外观、选中组件时的外观和其它相似的形象化提示,但是它对此组件的常规边框和背景颜色不起作用。虽然可以使用任意有效的颜色值,但首选值为 haloGreen、haloBlue、haloOrange 和 haloSilver。 | UIComponent | ||
![]() | 类型: String CSS 继承: no 从控件内容区域的上边缘到组件上边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的上边缘锚定在其内容区域的上边缘;调整其容器大小后,这两个边缘将保持其间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: Boolean CSS 继承: no 一个标志,控制当鼠标滚过项目时是否加亮显示该项目。如果为 true,则当鼠标滚过行时加亮显示这些行。如果为 false,则只在选中行时才进行加亮显示。. | ListBase | ||
![]() | 类型: String CSS 继承: no 垂直对齐行中的渲染器。可能值包括 "top"、"middle" 和 "bottom"。DataGrid 根据此样式以及 paddingTop 和 paddingBottom 样式在行中定位渲染器。如果某一行上各列中项目的高度不等,则其它列表类不使用 verticalAlign,但项目渲染器可以检查此样式属性,并根据检查结果调整其布局。. | ListBase | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的垂直距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整其容器大小后,这两个中心将保持其垂直间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
verticalGridLineColor | 类型: uint 格式: Color CSS 继承: yes 垂直网格线的颜色。 默认值为 0x666666. | DataGrid | ||
verticalGridLines | 类型: Boolean CSS 继承: no 一个标志,指示是否显示列之间的垂直网格线。如果为 true,则显示垂直网格线。如果为 false,则隐藏垂直网格线。
默认值为 true. | DataGrid | ||
verticalLockedSeparatorSkin | 类型: Class CSS 继承: no 用作定义 DataGrid 控件中锁定和未锁定列之间的分隔符外观的外观的类。默认情况下,DataGrid 控件使用 drawHorizontalLine() 和 drawVerticalLine() 方法绘制分隔符。
默认值为 undefined. | DataGrid | ||
![]() | 类型: String CSS 继承: no 垂直 scrollbar 的样式名称。通过它,可以更精细地控制滚动条的外观。. | ScrollControlBase | ||
verticalSeparatorSkin | 类型: Class CSS 继承: no 用作定义 DataGrid 控件中各列之间的分隔符外观的外观的类。默认情况下,DataGrid 控件使用 drawHorizontalLine() 和 drawVerticalLine() 方法绘制分隔符。
默认值为 undefined. | DataGrid | ||
| columns | 属性 |
columns:Array [读写] DataGridColumn 对象的数组。每个这样的对象对应一个可以显示的列。如果未显式设置,DataGrid 控件将尝试检查第一个数据提供程序项目以确定属性集,并按字母顺序显示这些属性。
若要更改列集,则必须获取此数组,然后修改数组中的列及其顺序,并为 columns 属性指定新数组。这是由于 DataGrid 返回了列数组的一个新副本,所以不会通知已发生更改。
此属性可用作数据绑定的源。修改此属性后,将调度 columnsChanged 事件。
public function get columns():Array public function set columns(value:Array):void| draggableColumns | 属性 |
draggableColumns:Boolean [读写]
一个标志,指示是否允许用户重排列。如果为 true,则用户可以通过拖动标题单元格重排 DataGrid 控件的列。
默认值为 true.
public function get draggableColumns():Boolean public function set draggableColumns(value:Boolean):void| editable | 属性 |
public var editable:Boolean = false
一个标志,指示用户能否编辑数据提供程序中的项目。如果为 true,则控件中的项目渲染器可编辑。用户单击项目渲染器将可以打开一个编辑器。
您可以关闭编辑 DataGrid 控件各个列的功能,方法是使用 DataGridColumn.editable 属性或处理 itemEditBeginning 和 itemEditBegin 事件。
默认值为 false.
| editedItemPosition | 属性 |
editedItemPosition:Object [读写] 正在编辑的数据提供程序项目的项目渲染器的列索引和行索引(如果有)。
此 Object 包含 columnIndex 和 rowIndex 两个字段,分别是项目的从零开始的行索引和列索引。例如:{ columnIndex:2, rowIndex:3}
设置此属性可以在视图中滚动项目,并会调度 itemEditBegin 事件以打开指定项目渲染器上的项目编辑器。
默认值为 null.
此属性可用作数据绑定的源。修改此属性后,将调度 itemFocusIn 事件。
public function get editedItemPosition():Object public function set editedItemPosition(value:Object):void| editedItemRenderer | 属性 |
editedItemRenderer:IListItemRenderer [只读 (read-only)] 对当前正在编辑的项目所属的 DataGrid 控件中项目渲染器的引用。
在 itemEditBegin 和 itemEditEnd 事件的事件侦听器中,您可以使用 editedItemRenderer.data 属性访问所编辑的项目的当前值。
public function get editedItemRenderer():IListItemRenderer| horizontalScrollPosition | 属性 |
horizontalScrollPosition:Number [读写]
内容与左边缘的偏移量。在某些子类中,这可能是一个像素偏移量;也可能是其它度量,如 DataGrid 控件中的列数。DataGrid 以列为单位进行滚动,因此 horizontalScrollPosition 属性的值始终在 0 到能够使最后的列可见的列索引之间。这与以像素为单位进行滚动的 List 控件不同。DataGrid 控件始终将列的左边缘与 DataGrid 控件的左边缘对齐。
public function get horizontalScrollPosition():Number public function set horizontalScrollPosition(value:Number):void| imeMode | 属性 |
imeMode:String [读写] 指定 IME(输入法编辑器)模式。IME 使用户能够用中文、日文和韩文输入文本。当控件获得焦点时,Flex 设置指定的 IME 模式;当该控件失去焦点时,则将其设置回为先前的值。
flash.system.IMEConversionMode 类定义此属性的有效值的常量。您还可以指定 null 不指定任何 IME 模式。
默认值为 null.
public function get imeMode():String public function set imeMode(value:String):void另请参见
| itemEditorInstance | 属性 |
public var itemEditorInstance:IListItemRenderer对项目编辑器的当前活动实例(如果有)的引用。
若要在编辑项目时访问项目编辑器实例和新项目值,则应使用 itemEditorInstance 属性。只有在执行 itemEditBegin 事件的事件侦听器之后,itemEditorInstance 属性才有效。因此,您通常只从 itemEditEnd 事件的事件侦听器中访问 itemEditorInstance 属性。
DataGridColumn.itemEditor 属性定义项目编辑器的类,从而定义项目编辑器实例的数据类型。
不要以 MXML 方式设置此属性。
| minColumnWidth | 属性 |
minColumnWidth:Number [读写] 列的最小宽度(以像素为单位)。如果不是 NaN,则 DataGrid 控件会将此值作为所有列的最小宽度。否则,各列可以使用自己的最小宽度。
默认值为 NaN.
public function get minColumnWidth():Number public function set minColumnWidth(value:Number):void| resizableColumns | 属性 |
public var resizableColumns:Boolean = true
一个标志,指示用户能否更改列的尺寸。如果为 true,则用户可以通过在标题单元格之间拖动网格线来伸展或缩短 DataGrid 控件的列。如果为 true,则还必须将单个列的 resizable 设置为 false 以防止用户调整特定列的大小。
默认值为 true.
| sortableColumns | 属性 |
public var sortableColumns:Boolean = true
一个标志,指示用户是否可以通过单击列的标题单元格对数据提供程序项目进行排序。如果为 true,则用户可以通过单击列的标题单元格对数据提供程序项目进行排序。列的 DataGridColumn.dataField 属性或 DataGridColumn.sortCompareFunction 属性将用作排序字段。如果用户在某列上单击了多次,则排序将在升序和降序之间交替。如果为 true,则可以通过将列的 sortable 属性设置为 false 将各个列设置为不响应对标题的单击。
当用户在标题单元格上方释放鼠标按键时,如果此属性以及列的 sortable 属性均为 true,则 DataGrid 控件将调度 headerRelease 事件。如果没有处理函数对事件调用 preventDefault() 方法,则 DataGrid 将使用该列的 DataGridColumn.dataField 或 DataGridColumn.sortCompareFunction 属性进行排序。
默认值为 true.
另请参见
| DataGrid | () | 构造函数 |
public function DataGrid()构造函数。
| adjustListContent | () | 方法 |
override protected function adjustListContent(unscaledWidth:Number = -1, unscaledHeight:Number = -1):void
从 updateDisplayList() 方法中调用,用以调整 listContent 的大小和位置。
参数
unscaledWidth:Number (default = -1) — listContent 的宽度。此值忽略外部组件或设置中对宽度的更改。 | |
unscaledHeight:Number (default = -1) — listContent 的高度。此值忽略外部组件或设置中对高度的更改。 |
| clearSeparators | () | 方法 |
protected function clearSeparators():void移除用户通常用于调整列大小的列标题分隔符。
| createItemEditor | () | 方法 |
public function createItemEditor(colIndex:int, rowIndex:int):void
使用由 itemEditor 属性指定的编辑器在 editedItemPosition 为项目渲染器创建项目编辑器。
此方法将编辑器实例设置为 itemEditorInstance 属性。
您可能只可以从 itemEditBegin 事件的事件侦听器中调用此方法。若要在其它时间创建编辑器,请设置 editedItemPosition 属性以生成 itemEditBegin 事件。
参数
colIndex:int — 要编辑项目的数据提供程序中的列索引。 | |
rowIndex:int — 要编辑项目的数据提供程序中的行索引。 |
| destroyItemEditor | () | 方法 |
public function destroyItemEditor():void
此方法将关闭项目渲染器上当前打开着的项目编辑器。您通常只从 itemEditEnd 事件的事件侦听器中调用此方法,但在这之前需要调用 preventDefault() 方法阻止默认事件侦听器的执行。
| drawColumnBackground | () | 方法 |
protected function drawColumnBackground(s:Sprite, columnIndex:int, color:uint, column:DataGridColumn):void使用建议的颜色为列绘制列背景。此实现将创建一个 Shape 作为输入 Sprite 的子项,并使用合适的颜色进行填充。
参数
s:Sprite — 一个 Sprite,其中的显示对象包含该列的图形。 | |
columnIndex:int — 列在所显示的一组列中的索引。最左端可见列的列索引为 0。这用于跟踪绘制背景所用的对象,这样即使特定列的 DataGridColumn 的索引已更改,该列也能够重新使用同一个显示对象。 | |
color:uint — 建议的指示符颜色 | |
column:DataGridColumn — 要为其绘制背景的 DataGrid 控件列。 |
| drawHeaderBackground | () | 方法 |
protected function drawHeaderBackground(headerBG:UIComponent):void在给定的 UIComponent 中绘制标题的背景。如果组件的宽度发生更改,则绘制的图形可能会水平缩放;或再次调用此方法以使用不同的宽度/高度重新绘制。
参数
headerBG:UIComponent — 将包含标题背景图形的 UIComponent。 |
| drawHorizontalLine | () | 方法 |
protected function drawHorizontalLine(s:Sprite, rowIndex:int, color:uint, y:Number):void绘制行之间的直线。此实现直接在给定的 Sprite 中绘制一条直线。在 Sprite 中绘制直线之前已将其清除。
参数
s:Sprite — 一个 Sprite,其中的显示对象包含该行的图形。 | |
rowIndex:int — 行在所显示的一组行中的索引。最顶部可见行(不算标题)的行索引为 0。这用于跟踪绘制背景所用的对象,这样即使特定行呈现的项目的索引已更改,该行也能够重新使用同一个显示对象。 | |
color:uint — 建议的指示符颜色 | |
y:Number — 建议的背景 y 位置 |
| drawLinesAndColumnBackgrounds | () | 方法 |
protected function drawLinesAndColumnBackgrounds():void
绘制列之间的直线,以及列背景。此实现将根据需要调用 drawHorizontalLine()、drawVerticalLine() 和 drawColumnBackground() 方法。它将创建包含所有这些图形的 Sprite,并将其作为 listContent 的子项添加到 Z 顺序的前端。
| drawLinesAndColumnGraphics | () | 方法 |
protected function drawLinesAndColumnGraphics(contentHolder:ListBaseContentHolder, visibleColumns:Array, separators:Object):void
绘制列之间的直线,以及列背景。此实现将根据需要调用 drawHorizontalLine()、drawVerticalLine() 和 drawColumnBackground() 方法。它将创建包含所有这些图形的 Sprite,并将其作为 listContent 的子项添加到 Z 顺序的前端。
参数
contentHolder:ListBaseContentHolder — DataGrid 的所有项目渲染器和项目编辑器的容器。 | |
visibleColumns:Array — DataGrid 中可见列的数组。 | |
separators:Object — 定义行和列的顶部、底部、左侧和右侧分隔线的对象。 |
| drawRowBackground | () | 方法 |
protected function drawRowBackground(s:Sprite, rowIndex:int, y:Number, height:Number, color:uint, dataIndex:int):void
使用指定的颜色在指定的位置按指定的高度绘制行背景。此实现将创建一个 Shape 作为输入 Sprite 的子项,并使用合适的颜色进行填充。此方法还使用 backgroundAlpha 样式属性设置来确定背景颜色的透明度。
参数
s:Sprite — 一个 Sprite,其中的显示对象包含该行的图形。 | |
rowIndex:int — 行在所显示的一组行中的索引。最顶部可见行(不算标题)的行索引为 0。这用于跟踪绘制背景所用的对象,这样即使特定行呈现的项目的索引已更改,该行也能够重新使用同一个显示对象。 | |
y:Number — 建议的背景 y 位置 | |
height:Number — 建议的指示符高度 | |
color:uint — 建议的指示符颜色 | |
dataIndex:int — 数据提供程序中该行的项目的索引。例如,这可用于为第 10 个项目设置不同的颜色。 |
| drawSeparators | () | 方法 |
protected function drawSeparators():void
创建用户通常用于调整列大小的列标题分隔符并将其显示出来。此实现使用相同的 Sprite 作为行和列背景,并添加了 headerSeparatorSkin 实例,另外还附加了鼠标侦听器,以了解用户何时想要调整列。
| drawVerticalLine | () | 方法 |
protected function drawVerticalLine(s:Sprite, colIndex:int, color:uint, x:Number):void绘制列之间的直线。此实现直接在给定的 Sprite 中绘制一条直线。在 Sprite 中绘制直线之前已将其清除。
参数
s:Sprite — 一个 Sprite,其中的显示对象包含该行的图形。 | |
colIndex:int — 列在所显示的一组列中的索引。最左端可见列的列索引为 0。 | |
color:uint — 建议的指示符颜色 | |
x:Number — 建议的背景 x 位置 |
| isItemEditable | () | 方法 |
public function isItemEditable(data:Object):Boolean
确定是否允许按行编辑 dataprovider 项目。如果 editable 为 false,或 dataprovider 项目为 null,则此方法的默认实现仅检查 DataGrid 的 editable 属性,并返回 false。
可以覆盖此方法以更精细地控制哪些 dataprovider 项目可编辑。例如,如果要禁止编辑分组行或摘要行,则要用针对此行为的自定义逻辑覆盖此方法。
参数
data:Object —
数据提供程序项目. 如果数据对象是 null,则此方法的默认实现返回 false。
|
Boolean —
如果 DataGrid 的 editable 属性为 true,且数据对象不为 null,则默认行为是返回 true。
|
| placeSortArrow | () | 方法 |
protected function placeSortArrow():void
在作为当前排序键的列上绘制排序箭头图形。此实现将创建或重新使用由 sortArrowSkin 样式属性指定的外观实例,并将其放置在合适的列标题中。如果排序箭头遮挡了标题中的文本,它还将缩小列标题的尺寸。
| scrollPositionToIndex | () | 方法 |
override protected function scrollPositionToIndex(horizontalScrollPosition:int, verticalScrollPosition:int):int返回给定滚动位置第一个可见行和列处的项目的数据提供程序索引。
参数
horizontalScrollPosition:int —
与滚动位置相对应的 horizontalScrollPosition 属性值。
| |
verticalScrollPosition:int —
与滚动位置相对应的 verticalScrollPosition 属性值。
|
int — 数据提供程序索引。 |
| scrollVertically | () | 方法 |
override protected function scrollVertically(pos:int, deltaPos:int, scrollUp:Boolean):void调整渲染器以响应滚动位置的更改。
当滚动位置的更改量低于可见行数时,列表类将尝试优化滚动。此时,一些行只需进行移动即可而无需进行其它更改,另一些行则需要删除,然后添加新行。如果滚动位置更改量过大,将删除所有旧行,并调用 makeRowsAndColumns() 方法在整个可查看区域添加新行。
参数
pos:int — 新的滚动位置。 | |
deltaPos:int — 位置的变化。此值始终为正数。 | |
scrollUp:Boolean —
如果滚动位置正在逐渐缩小,则为 true。
|
| columnStretch | 事件 |
mx.events.DataGridEventmx.events.DataGridEvent.COLUMN_STRETCH
当用户更改列宽时调度,指示此列中显示的数据量可能会更改。如果 horizontalScrollPolicy 设置为 "off",则其它列将缩短或伸展以补偿该列的大小调整,同时这些列也会调度此事件。
columnStretch 事件定义事件对象的 type 属性的值,指示用户已将列水平展开。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles
| false |
cancelable
| false |
columnIndex
|
DataGrid 对象的 columns 数组中项目列的从零开始的索引。
|
currentTarget
|
用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
|
dataField
| 与列关联的数据中的字段或属性的名称。 |
itemRenderer
| null |
localX
| 鼠标的 X 位置 |
reason
| null |
rowIndex
| 数据提供者中项目的索引(从零开始)。 |
target
|
调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
|
type
| DataGridEvent.COLUMN_STRETCH |
| headerRelease | 事件 |
mx.events.DataGridEventmx.events.DataGridEvent.HEADER_RELEASE
当用户在列标题上释放鼠标按键以请求控件基于列内容对网格内容进行排序时调度。仅在列可排序且数据提供程序支持排序时才调度。DataGrid 控件具有此可实现单列排序的事件的默认处理函数。通过调用 preventDefault() 方法阻止单列排序,并设置数据提供程序的 sort 属性,可以实现多列排序。
注意:排序箭头由 headerRelease 事件的默认事件处理函数定义。如果在事件处理函数中调用 preventDefault() 方法,则不绘制箭头。
headerRelease 事件定义事件对象的 type 属性值,指示用户已在列标题上按下和释放鼠标。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles
| false |
cancelable
| true |
columnIndex
|
DataGrid 对象的 columns 数组中项目列的从零开始的索引。
|
currentTarget
|
用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
|
dataField
| 与列关联的数据中的字段或属性的名称。 |
itemRenderer
| 要释放的标题渲染器。 |
localX
| NaN |
reason
| null |
rowIndex
| null |
target
|
调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
|
type
| DataGridEvent.HEADER_RELEASE |
| headerShift | 事件 |
mx.events.IndexChangedEventmx.events.IndexChangedEvent.HEADER_SHIFT当用户将列拖动到新位置使该列移动到新索引处后,在列标题上释放鼠标按键时调度。
IndexChangedEvent.HEADER_SHIFT 常数可为headerShift 事件定义事件对象的 type 属性的值,指示标题已更改其索引,如,当用户将 DataGrid 列拖动到新的位置时即进行了更改。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles
| false |
cancelable
| false |
currentTarget
|
用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
|
inputType
| 指示此事件是否是由鼠标或键盘交互操作导致的。 |
newIndex
| 更改后标题的从零开始的索引。 |
oldIndex
| 更改前标题的从零开始的索引。 |
relatedObject
| null |
target
|
调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
|
TriggerEvent
| 触发此事件的事件。 |
类型
| IndexChangedEvent.HEADER_SHIFT |
| itemEditBegin | 事件 |
mx.events.DataGridEventmx.events.DataGridEvent.ITEM_EDIT_BEGIN
当 editedItemPosition 属性已设置且项目可编辑时调度。
itemEditBegin 事件定义事件对象的 type 属性的值,指示项目可进行编辑。
此事件的默认侦听器执行下列操作:
createItemEditor() 方法创建项目编辑器对象。
data 属性从项目复制到编辑器。默认情况下,项目编辑器对象是 TextInput 控件的实例。您可以使用 list 控件的 itemEditor 属性指定自定义项目编辑器类。
itemEditorInstance 属性,以引用项目编辑器实例。
您可以为此事件编写事件侦听器以修改传递到项目编辑器的数据。例如,您可以修改项目编辑器使用的数据、数据格式或其它信息。
您还可以创建事件侦听器以指定用于编辑项目的项目编辑器。例如,您可能有两个不同的项目编辑器。在事件侦听器中,您可以通过执行下列操作检查要编辑的数据或其它信息,并打开相应的项目编辑器:
preventDefault() 以阻止 Flex 在默认事件侦听器中调用 createItemEditor() 方法。
itemEditor 属性设置为相应编辑器。
createItemEditor() 方法。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles
| false |
cancelable
| true |
columnIndex
|
DataGrid 对象的 columns 数组中项目列的从零开始的索引。
|
currentTarget
|
用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
|
dataField
| null |
itemRenderer
| 所编辑的项目的项目渲染器。 |
localX
| NaN |
reason
| null |
rowIndex
| 数据提供者中项目的索引(从零开始)。 |
target
|
调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
|
type
| DataGridEvent.ITEM_EDIT_BEGIN |
| itemEditBeginning | 事件 |
mx.events.DataGridEventmx.events.DataGridEvent.ITEM_EDIT_BEGINNING当用户在某个项目渲染器上方释放鼠标按键时,使用 tab 键导航到 DataGrid 控件或 DataGrid 控件内部时,或者以任何其它方式尝试编辑某一项目时调度。
DataGridEvent.ITEM__EDIT_BEGINNING 常数可为itemEditBeginning 事件定义事件对象的 type 属性的值,指示用户已准备编辑项目,例如通过在项目上释放鼠标按键。
此事件的默认侦听器将 DataGrid.editedItemPosition 属性设置为具有焦点的项目,该项目开始项目编辑会话。
您通常可以为此事件编写自己的事件侦听器,以禁止编辑特定项目。在为此事件自己编写的事件侦听器内调用 preventDefault() 方法可以阻止默认侦听器执行。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles
| false |
cancelable
| true |
columnIndex
|
DataGrid 对象的 columns 数组中项目列的从零开始的索引。
|
currentTarget
|
用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
|
dataField
| 与项目的列关联的数据中的字段或属性的名称。 |
itemRenderer
| 要编辑的项目的项目渲染器。如果此事件由键盘生成,则此属性为 null,因为要编辑的项目可能未在屏幕范围内显示。 |
localX
| NaN |
reason
| null |
rowIndex
| 数据提供者中项目的索引(从零开始)。 |
target
|
调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
|
type
| DataGridEvent.ITEM_EDIT_BEGINNING |
| itemEditEnd | 事件 |
mx.events.DataGridEventmx.events.DataGridEvent.ITEM_EDIT_END当项目编辑会话因任何原因而结束时调度。
DataGridEvent.ITEM_EDIT_END 常数可为itemEditEnd 事件定义事件对象的 type 属性的值,指示编辑会话结束。
列表组件具有针对此事件的默认处理函数,此程序将数据从项目编辑器复制到 list 控件的数据提供程序。默认事件侦听器执行下列操作:
editorDataField 属性确定包含新数据的项目编辑器的属性,并使用这些新数据更新数据提供程序项目。因为默认项目编辑器是 TextInput 控件,所以 editorDataField 属性的默认值为 "text",以指定 TextInput 的 text 属性包含新项目数据。
destroyItemEditor() 方法以关闭项目编辑器。
通常,您可以为此事件编写事件侦听器,以执行下列操作:
itemEditEnd 事件编写事件侦听器。
preventDefault() 方法阻止 Flex 将新数据传递回 list 控件和关闭编辑器。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles
| false |
cancelable
| true |
columnIndex
|
DataGrid 对象的 columns 数组中项目列的从零开始的索引。
|
currentTarget
|
用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
|
dataField
| 与项目的列关联的数据中的字段或属性的名称。 |
itemRenderer
| 所编辑的项目的项目渲染器。 |
localX
| NaN |
reason
|
定义事件原因的常量。该值必须是 DataGridEventReason 类的成员。
|
rowIndex
| 数据提供者中项目的索引(从零开始)。 |
target
|
调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
|
type
| DataGridEvent.ITEM_EDIT_END |
| itemFocusIn | 事件 |
mx.events.DataGridEventmx.events.DataGridEvent.ITEM_FOCUS_IN当项目渲染器获得焦点时调度。在下列情况下项目渲染器可能获得焦点:当用户单击 DataGrid 控件中的某个项目或者使用键盘导航到该项目时。仅当项目可编辑时调度。
DataGridEvent.ITEM_FOCUS_IN 常数可为itemFocusIn 事件定义事件对象的 type 属性的值,指示项目已获得焦点。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles
| false |
cancelable
| false |
columnIndex
|
DataGrid 对象的 columns 数组中项目列的从零开始的索引。
|
currentTarget
|
用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
|
dataField
| null |
itemRenderer
| 所编辑的项目的项目编辑器实例。 |
localX
| NaN |
reason
| null |
rowIndex
| 数据提供者中项目的索引(从零开始)。 |
target
|
调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
|
type
| DataGridEvent.ITEM_FOCUS_IN |
| itemFocusOut | 事件 |
mx.events.DataGridEventmx.events.DataGridEvent.ITEM_FOCUS_OUT当项目渲染器失去焦点时调度。在下列情况下项目渲染器可能失去焦点:当用户单击 DataGrid 控件中的其它项目或在此控件外部单击时,或使用键盘导航到 DataGrid 控件中的其它项目或导航到该控件外部时。仅当项目可编辑时调度。
DataGridEvent.ITEM_FOCUS_OUT 常数可为itemFocusOut 事件定义事件对象的 type 属性的值,指示项目已失去焦点。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles
| false |
cancelable
| false |
columnIndex
|
DataGrid 对象的 columns 数组中项目列的从零开始的索引。
|
currentTarget
|
用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
|
dataField
| null |
itemRenderer
| 所编辑的项目的项目编辑器实例。 |
localX
| NaN |
reason
| null |
rowIndex
| 数据提供者中项目的索引(从零开始)。 |
target
|
调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
|
type
| DataGridEvent.ITEM_FOCUS_OUT |
<?xml version="1.0"?>
<!-- DataGrid control example. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
<mx:XMLList id="employees">
<employee>
<name>Christina Coenraets</name>
<phone>555-219-2270</phone>
<email>ccoenraets@fictitious.com</email>
<active>true</active>
</employee>
<employee>
<name>Joanne Wall</name>
<phone>555-219-2012</phone>
<email>jwall@fictitious.com</email>
<active>true</active>
</employee>
<employee>
<name>Maurice Smith</name>
<phone>555-219-2012</phone>
<email>maurice@fictitious.com</email>
<active>false</active>
</employee>
<employee>
<name>Mary Jones</name>
<phone>555-219-2000</phone>
<email>mjones@fictitious.com</email>
<active>true</active>
</employee>
</mx:XMLList>
<mx:Panel title="DataGrid Control Example" height="100%" width="100%"
paddingTop="10" paddingLeft="10" paddingRight="10">
<mx:Label width="100%" color="blue"
text="Select a row in the DataGrid control."/>
<mx:DataGrid id="dg" width="100%" height="100%" rowCount="5" dataProvider="{employees}">
<mx:columns>
<mx:DataGridColumn dataField="name" headerText="Name"/>
<mx:DataGridColumn dataField="phone" headerText="Phone"/>
<mx:DataGridColumn dataField="email" headerText="Email"/>
</mx:columns>
</mx:DataGrid>
<mx:Form width="100%" height="100%">
<mx:FormItem label="Name">
<mx:Label text="{dg.selectedItem.name}"/>
</mx:FormItem>
<mx:FormItem label="Email">
<mx:Label text="{dg.selectedItem.email}"/>
</mx:FormItem>
<mx:FormItem label="Phone">
<mx:Label text="{dg.selectedItem.phone}"/>
</mx:FormItem>
</mx:Form>
</mx:Panel>
</mx:Application>