mx.controls
public class DataGrid
继承DataGrid Inheritance DataGridBase Inheritance ListBase Inheritance ScrollControlBase Inheritance UIComponent Inheritance FlexSprite Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
实现 IIMESupport
子类 FileSystemDataGrid, PrintDataGrid

DataGrid 控件与 List 控件相似,但它可以显示多个数据列,这使其适合显示具有多个属性的对象。

DataGrid 控件提供以下功能:

DataGrid 控件用于查看数据,而不是用作类似于 HTML 表的布局工具。mx.containers 包提供以下布局工具。

DataGrid 控件具有以下默认大小特征:

特征说明
默认大小如果列为空,则默认宽度为 300 个像素。如果列包含信息但没有定义显式宽度,则每列的默认宽度为 100 个像素。如果可能,调整 DataGrid 宽度的大小以适应所有列的宽度。默认的显示行数为 7 行,其中包括标题;默认情况下,每行的高度为 20 个像素。
最小大小0 个像素。
最大大小5000 × 5000。

MXML 语法expanded隐藏 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

查看示例

另请参见

mx.controls.dataGridClasses.DataGridItemRenderer
mx.controls.dataGridClasses.DataGridColumn
mx.controls.dataGridClasses.DataGridDragProxy
mx.events.DataGridEvent
Using Data-Driven Controls
Working with item renderers
Examples using item editors with the list-based controls


公共属性
 属性定义方
 InheritedaccessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。
DisplayObject
 InheritedactiveEffects : Array
[只读 (read-only)] 组件上当前播放的效果列表,如 EffectInstance 实例的 Array。
UIComponent
 InheritedallowDragSelection : Boolean = false
一个标志,指示是否启用拖动选择。
ListBase
 InheritedallowMultipleSelection : Boolean
一个标志,指示是否允许您同时选择多个项目。
ListBase
 Inheritedalpha : Number
指示指定对象的 Alpha 透明度值。
DisplayObject
 InheritedautomationDelegate : Object
处理自动化相关功能的委托对象。
UIComponent
 InheritedautomationName : String
可用作此对象的标识符的名称。
UIComponent
 InheritedautomationTabularData : Object
[只读 (read-only)] IAutomationTabularData 接口的实现,可用于检索数据。
UIComponent
 InheritedautomationValue : Array
[只读 (read-only)] 此值通常对应于对象的经渲染的外观,当对象在应用中以可视方式显示时,此值使标识符与该对象相关联。
UIComponent
 InheritedbaselinePosition : Number
[只读 (read-only)] 组件第一行文本的基线的 y 坐标。
UIComponent
 InheritedblendMode : String
BlendMode 类中的一个值,用于指定要使用的混合模式。
DisplayObject
 InheritedblendShader : Shader
[只写] 设置用于混合前景和背景的着色器。
DisplayObject
 InheritedborderMetrics : EdgeMetrics
[只读 (read-only)] 返回 EdgeMetrics 对象,它具有四个属性:left、top、right 和 bottom。
ScrollControlBase
 InheritedbuttonMode : Boolean
指定此 sprite 的按钮模式。
Sprite
 InheritedcacheAsBitmap : Boolean
如果设置为 true,则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。
DisplayObject
 InheritedcacheHeuristic : Boolean
[只写] 供 Flex 使用,表示建议为对象实施位图缓存。
UIComponent
 InheritedcachePolicy : String
指定此对象的位图缓存策略。
UIComponent
 InheritedclassName : String
[只读 (read-only)] 此实例的类的名称,如“Button”。
UIComponent
  columns : Array
DataGridColumn 对象的数组。每个这样的对象对应一个可以显示的列。
DataGrid
 InheritedcolumnWidth : Number
控件中列的宽度。
ListBase
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcontentMouseX : Number
[只读 (read-only)] 返回鼠标在内容坐标系中的 x 位置。
UIComponent
 InheritedcontentMouseY : Number
[只读 (read-only)] 返回内容坐标系中鼠标的 y 位置。
UIComponent
 InheritedcontextMenu : NativeMenu
指定与此对象相关联的上下文菜单。
InteractiveObject
 InheritedcurrentState : String
组件的当前视图状态。
UIComponent
 InheritedcursorManager : ICursorManager
[只读 (read-only)] 获取控制此组件及其同级组件的光标的 CursorManager。
UIComponent
 Inheriteddata : Object
将此组件用作项目渲染器或项目编辑器时,此组件应呈现的数据提供程序中的项目。
ListBase
 InheriteddataProvider : Object
要查看的数据集。
ListBase
 InheriteddataTipField : String
数据提供程序项目中作为数据提示显示的字段名称。
ListBase
 InheriteddataTipFunction : Function
用户提供的函数,在各个项目上运行以确定其数据提示。
ListBase
 Inheriteddescriptor : UIComponentDescriptor
引用 UIComponentDescriptor(如果有),过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。
UIComponent
 Inheriteddocument : Object
引用与此 UIComponent 相关联的文档对象。
UIComponent
 InheriteddoubleClickEnabled : Boolean
指定 UIComponent 对象是否接收 doubleClick 事件。
UIComponent
 InheriteddragEnabled : Boolean
一个标志,指示是否可以将项目拖出此控件并放到其它控件上。
ListBase
  draggableColumns : Boolean
一个标志,指示是否允许用户重排列。
DataGrid
 InheriteddragMoveEnabled : Boolean
一个标志,指示在拖放操作过程中是否可以移动控件中的项目,而不只是从控件中复制这些项目。
ListBase
 InheriteddropEnabled : Boolean
一个标志,指示是否可以将所拖动的项目放到此控件上。
ListBase
 InheriteddropTarget : DisplayObject
[只读 (read-only)] 指定拖动 sprite 时经过的显示对象,或放置 sprite 的显示对象。
Sprite
  editable : Boolean = false
一个标志,指示用户能否编辑数据提供程序中的项目。
DataGrid
  editedItemPosition : Object
正在编辑的数据提供程序项目的项目渲染器的列索引和行索引(如果有)。
DataGrid
  editedItemRenderer : IListItemRenderer
[只读 (read-only)] 对当前正在编辑的项目所属的 DataGrid 控件中项目渲染器的引用。
DataGrid
 Inheritedenabled : Boolean
组件是否可以接受用户交互。
UIComponent
 InheritederrorString : String
当验证程序监视组件并且验证失败时,组件的错误提示中将显示的文本。
UIComponent
 InheritedexplicitHeight : Number
指定该组件在组件坐标中显式高度(以像素为单位)的数字。
UIComponent
 InheritedexplicitMaxHeight : Number
布局过程中父级要考虑的组件最大建议高度。
UIComponent
 InheritedexplicitMaxWidth : Number
布局过程中父级要考虑的组件最大建议宽度。
UIComponent
 InheritedexplicitMinHeight : Number
布局过程中父级要考虑的组件最小建议高度。
UIComponent
 InheritedexplicitMinWidth : Number
布局过程中父级要考虑的组件最小建议宽度。
UIComponent
 InheritedexplicitWidth : Number
指定该组件在组件坐标中显式宽度(以像素为单位)的数字。
UIComponent
 Inheritedfilters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。
DisplayObject
 InheritedflexContextMenu : IFlexContextMenu
此 UIComponent 的上下文菜单。
UIComponent
 InheritedfocusEnabled : Boolean
指示切换到此组件时,是否可以接收焦点。
UIComponent
 InheritedfocusManager : IFocusManager
获取控制此组件及其同级组件的焦点的 FocusManager。
UIComponent
 InheritedfocusPane : Sprite
与此对象相关联的焦点窗格。
UIComponent
 InheritedfocusRect : Object
指定此对象是否显示焦点矩形。
InteractiveObject
 InheritedfontContext : IFlexModuleFactory
为此组件提供字体上下文的模块工厂。
DataGridBase
 Inheritedgraphics : Graphics
[只读 (read-only)] 指定属于此 sprite 的 Graphics 对象,在此 sprite 中可执行矢量绘画命令。
Sprite
 InheritedheaderHeight : Number
列的标题单元格的高度(以像素为单位)。
DataGridBase
 Inheritedheight : Number
指定组件在父坐标中的高度的数字(以像素为单位)。
UIComponent
 InheritedhitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。
Sprite
 InheritedhorizontalScrollPolicy : String
指示水平滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。
ScrollControlBase
  horizontalScrollPosition : Number
内容与左边缘的偏移量。
DataGrid
 Inheritedid : String
组件 ID。
UIComponent
  imeMode : String
指定 IME(输入法编辑器)模式。
DataGrid
 InheritedincludeInLayout : Boolean
指定此组件是否包含在父容器的布局中。
UIComponent
 InheritedinheritingStyles : Object
此组件的继承样式链的开头内容。
UIComponent
 Inheritedinitialized : Boolean
一个标志,用于确定某个对象是否已通过布局的所有三个阶段:提交、测量和布局(假设每个阶段都是必需的)。
UIComponent
 InheritedinstanceIndex : int
[只读 (read-only)] 重复组件的索引。
UIComponent
 InheritedinstanceIndices : Array
一个 Array,包含从此 UIComponent 对象的父文档引用该对象所需的索引。
UIComponent
 InheritedisDocument : Boolean
[只读 (read-only)] 确定此 UIComponent 实例是否为文档对象,也就是说它是否位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构的顶层。
UIComponent
 InheritedisPopUp : Boolean
PopUpManager 将其设置为 true 以指示已弹出该组件。
UIComponent
  itemEditorInstance : IListItemRenderer
对项目编辑器的当前活动实例(如果有)的引用。
DataGrid
 InheriteditemRenderer : IFactory
控件的自定义项目渲染器。
ListBase
 InheritedlabelFunction : Function
用户提供的函数,在每个项目上运行以确定其标签。
ListBase
 InheritedlistData : BaseListData
如果使用组件作为嵌入式项目渲染器或嵌入式项目编辑器,则 Flex 将使用 list 控件中的其它数据初始化组件的 listData 属性。
ListBase
 InheritedliveScrolling : Boolean = true
一个标志,指示移动滚动栏滑块时实时滚动视图,还是释放滑块后才更新视图。
ScrollControlBase
 InheritedloaderInfo : LoaderInfo
[只读 (read-only)] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。
DisplayObject
 InheritedlockedColumnCount : int
滚动的控件中第一列的索引。
DataGridBase
 InheritedlockedRowCount : int
滚动的控件中第一行的索引。
DataGridBase
 Inheritedmask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。
DisplayObject
 InheritedmaxHeight : Number
布局过程中父级要考虑的组件最大建议高度。
UIComponent
 InheritedmaxHorizontalScrollPosition : Number
horizontalScrollPosition 属性的最大值。
ScrollControlBase
 InheritedmaxVerticalScrollPosition : Number
verticalScrollPosition 属性的最大值。
ScrollControlBase
 InheritedmaxWidth : Number
布局过程中父级要考虑的组件最大建议宽度。
UIComponent
 InheritedmeasuredHeight : Number
组件的默认高度(以像素为单位)。
UIComponent
 InheritedmeasuredMinHeight : Number
组件的默认最小高度(以像素为单位)。
UIComponent
 InheritedmeasuredMinWidth : Number
组件的默认最小宽度(以像素为单位)。
UIComponent
 InheritedmeasuredWidth : Number
组件的默认宽度(以像素为单位)。
UIComponent
 InheritedmenuSelectionMode : Boolean = false
一个标志,指示是否应使用菜单样式选择。
ListBase
  minColumnWidth : Number
列的最小宽度(以像素为单位)。
DataGrid
 InheritedminHeight : Number
布局过程中父级要考虑的组件最小建议高度。
UIComponent
 InheritedminWidth : Number
布局过程中父级要考虑的组件最小建议宽度。
UIComponent
 InheritedmoduleFactory : IFlexModuleFactory
用于在正确的 SWF 上下文中创建 TextFields 的 moduleFactory。
UIComponent
 InheritedmouseChildren : Boolean
确定对象的子项是否支持鼠标。
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
指定此对象是否接收鼠标消息。
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
单击时是否可接收焦点。
UIComponent
 InheritedmouseX : Number
[只读 (read-only)] 指示鼠标位置的 x 坐标,以像素为单位。
DisplayObject
 InheritedmouseY : Number
[只读 (read-only)] 指示鼠标位置的 y 坐标,以像素为单位。
DisplayObject
 Inheritedname : String
指示 DisplayObject 的实例名称。
DisplayObject
 InheritednestLevel : int
此对象在所属关系层次结构中的深度。
UIComponent
 InheritednonInheritingStyles : Object
此组件的非继承样式链的开头内容。
UIComponent
 InheritednullItemRenderer : IFactory
控件的自定义项目渲染器。
ListBase
 InheritednumAutomationChildren : int
[只读 (read-only)] 此容器包含的自动化子项数。
UIComponent
 InheritednumChildren : int
[只读 (read-only)] 返回此对象的子项数目。
DisplayObjectContainer
 InheritedopaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。
DisplayObject
 Inheritedowner : DisplayObjectContainer
此 UIComponent 的所有者。
UIComponent
 Inheritedparent : DisplayObjectContainer
[只读 (read-only)] 此组件的父容器或组件。
UIComponent
 InheritedparentApplication : Object
[只读 (read-only)] 引用包含此 UIComponent 实例的 Application 对象。
UIComponent
 InheritedparentDocument : Object
[只读 (read-only)] 引用此 UIComponent 的父文档对象。
UIComponent
 InheritedpercentHeight : Number
以组件父项大小百分比的方式指定组件高度的数字。
UIComponent
 InheritedpercentWidth : Number
以组件父项大小百分比形式指定其宽度的数字。
UIComponent
 InheritedprocessedDescriptors : Boolean
临时或延迟子项创建操作后设置为 true,具体取决于发生对象。
UIComponent
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
 Inheritedrepeater : IRepeater
[只读 (read-only)] 对生成此 UIComponent 的父文档中 Repeater 对象的引用。
UIComponent
 InheritedrepeaterIndex : int
[只读 (read-only)] 项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。
UIComponent
 InheritedrepeaterIndices : Array
一个 Array,包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。
UIComponent
 Inheritedrepeaters : Array
一个 Array,包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。
UIComponent
  resizableColumns : Boolean = true
一个标志,指示用户能否更改列的尺寸。
DataGrid
 Inheritedroot : DisplayObject
[只读 (read-only)] 对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。
DisplayObject
 Inheritedrotation : Number
指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。
DisplayObject
 InheritedrotationX : Number
指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转(以度为单位)。
DisplayObject
 InheritedrotationY : Number
指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转(以度为单位)。
DisplayObject
 InheritedrotationZ : Number
指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转(以度为单位)。
DisplayObject
 InheritedrowCount : int
要显示的行数。
ListBase
 InheritedrowHeight : Number
行高(以像素为单位)。
ListBase
 Inheritedscale9Grid : Rectangle
当前有效的缩放网格。
DisplayObject
 InheritedscaleX : Number
用于指定水平缩放系数的数字。
UIComponent
 InheritedscaleY : Number
用于指定垂直缩放系数的数字。
UIComponent
 InheritedscaleZ : Number
指示从对象的注册点开始应用的对象的深度缩放比例(百分比)。
DisplayObject
 Inheritedscreen : Rectangle
[只读 (read-only)] 返回包含此对象的基本绘图表面大小和位置的对象。
UIComponent
 InheritedscrollRect : Rectangle
显示对象的滚动矩形范围。
DisplayObject
 InheritedscrollTipFunction : Function
将要显示的字符串作为 ScrollTip 计算的函数。
ScrollControlBase
 Inheritedselectable : Boolean
一个标志,指示列表是否将所选项目显示为选中状态。
ListBase
 InheritedselectedIndex : int
所选项目的数据提供程序中的索引。
ListBase
 InheritedselectedIndices : Array
数据提供程序中所选项目的索引的数组。
ListBase
 InheritedselectedItem : Object
对数据提供程序中所选项目的引用。
ListBase
 InheritedselectedItems : Array
对数据提供程序中所选项目的引用的数组。
ListBase
 InheritedshowHeaders : Boolean
指示控件是否应显示列标题的标志。
DataGridBase
 InheritedshowInAutomationHierarchy : Boolean
用于确定自动化对象是否显示在自动化层次中的标志。
UIComponent
 InheritedshowScrollTips : Boolean = false
一个标志,指示拖动滚动滑块时是否应在其旁边显示工具提示。
ScrollControlBase
  sortableColumns : Boolean = true
一个标志,指示用户是否可以通过单击列的标题单元格对数据提供程序项目进行排序。
DataGrid
 InheritedsoundTransform : SoundTransform
控制此 sprite 中的声音。
Sprite
 Inheritedstage : Stage
[只读 (read-only)] 显示对象的舞台。
DisplayObject
 Inheritedstates : Array
为此组件定义的视图状态。
UIComponent
 InheritedstyleDeclaration : CSSStyleDeclaration
存储此对象的内嵌继承样式。
UIComponent
 InheritedstyleName : Object
此组件使用的类样式。
UIComponent
 InheritedsystemManager : ISystemManager
返回此组件使用的 SystemManager 对象。
UIComponent
 InheritedtabChildren : Boolean
确定对象的子项是否支持 Tab 键。
DisplayObjectContainer
 InheritedtabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。
InteractiveObject
 InheritedtabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。
InteractiveObject
 InheritedtextSnapshot : TextSnapshot
[只读 (read-only)] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。
DisplayObjectContainer
 InheritedtoolTip : String
要在 ToolTip 中显示的文本。
UIComponent
 Inheritedtransform : Transform
一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。
DisplayObject
 Inheritedtransitions : Array
一个 Transition 对象 Array,其中的每个 Transition 对象都定义一组效果,用于在视图状态发生更改时播放。
UIComponent
 InheritedtweeningProperties : Array
当前在此对象上进行补间的属性数组。
UIComponent
 Inheriteduid : String
对象的唯一标识符。
UIComponent
 InheritedupdateCompletePendingFlag : Boolean
一个标志,确定某个对象是否已通过所有三个阶段的布局验证(假设需要通过所有验证)。
UIComponent
 InheriteduseHandCursor : Boolean
布尔值,指示当鼠标滑过其 buttonMode 属性设置为 true 的 sprite 时是否显示手指形(手形光标)。
Sprite
 InheritedvalidationSubField : String
供验证程序用来将子字段与此组件相关联。
UIComponent
 Inheritedvalue : Object
[只读 (read-only)] 所选项目,或者所选项目的数据或标签字段。
ListBase
 InheritedvariableRowHeight : Boolean
一个标志,指示各行是否可以采用不同的高度。
ListBase
 InheritedverticalScrollPolicy : String
指示垂直滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。
ScrollControlBase
 InheritedverticalScrollPosition : Number
顶边到内容的偏移量。
ScrollControlBase
 InheritedviewMetrics : EdgeMetrics
[只读 (read-only)] 考虑滚动条(如果可见)的 EdgeMetrics 对象。
ScrollControlBase
 Inheritedvisible : Boolean
控制此 UIComponent 的可见性。
UIComponent
 Inheritedwidth : Number
指定组件在父坐标中的宽度的数字(以像素为单位)。
UIComponent
 InheritedwordWrap : Boolean
一个标志,指示行中的文本是否应自动换行。
ListBase
 Inheritedx : Number
指定组件在其父容器中的水平位置(以像素为单位)的数字。
UIComponent
 Inheritedy : Number
指定组件在其父容器中的垂直位置(以像素为单位)的数字。
UIComponent
 Inheritedz : Number
指示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。
DisplayObject
受保护的属性
 属性定义方
 InheritedactualCollection : ICollectionView
通常存储于运行数据更改效果时使用的 collection 中的值副本。
ListBase
 InheritedactualIterator : IViewCursor
通常存储于运行数据更改效果时使用的 iterator 中的值副本。
ListBase
 InheritedallowItemSizeChangeNotification : Boolean
[只写] 如果设置为 false,则渲染器无法使 List 的大小失效.
ListBase
 InheritedanchorBookmark : CursorBookmark
作为锚点的项目的书签。
ListBase
 InheritedanchorIndex : int = -1
作为选择锚点的数据提供程序中项目的偏移量。
ListBase
 Inheritedborder : IFlexDisplayObject
边框对象。
ScrollControlBase
 InheritedcachedItemsChangeEffect : IEffect = null
当控件的数据提供程序中发生更改时播放的效果,通过 itemsChangeEffect 样式设置。
ListBase
 InheritedcaretBookmark : CursorBookmark
尖号下方项目的书签。
ListBase
 InheritedcaretIndex : int = -1
作为选择尖号点的数据提供程序中项目的偏移量。
ListBase
 InheritedcaretIndicator : Sprite
包含图形的 DisplayObject,该图形指示哪个渲染器是尖号。
ListBase
 InheritedcaretItemRenderer : IListItemRenderer
尖号下方项目的渲染器。
ListBase
 InheritedcaretUID : String
尖号下方项目的 UID。
ListBase
 Inheritedcollection : ICollectionView
用于提供数据提供程序的 ICollectionView。
ListBase
 InheritedcolumnCaretIndicator : Sprite
包含图形的 DisplayObject,该图形指示哪个渲染器是 lockedColumns 的尖号。
DataGridBase
 InheritedcolumnHighlightIndicator : Sprite
包含图形的 DisplayObject,该图形指示为 lockedColumns 加亮哪个渲染器。
DataGridBase
 InheritedcolumnMap : Object
项目渲染器到列的映射。
DataGridBase
 InheriteddataEffectCompleted : Boolean = false
一个标志,指示数据更改效果已完成。
ListBase
 InheriteddataItemWrappersByRenderer : Dictionary
将项目渲染器映射到 ItemWrappers(用于提供其数据)的 dictionary。
ListBase
 InheriteddefaultColumnCount : int = 4
要显示的默认列数。
ListBase
 InheriteddefaultRowCount : int = 4
要显示的默认行数。
ListBase
 InheriteddragImage : IUIComponent
[只读 (read-only)] 获取可显示拖放操作中的可视效果的类实例。
ListBase
 InheriteddragImageOffsets : Point
[只读 (read-only)] 获取所拖动图像在拖放后的偏移量。
ListBase
 InheritedexplicitColumnCount : int = -1
显式设置 columnCount 属性时需要的列计数。
ListBase
 InheritedexplicitColumnWidth : Number
显式设置 columnWidth 时需要的列宽。
ListBase
 InheritedexplicitRowCount : int = -1
显式设置 rowCount 时需要的行计数。
ListBase
 InheritedexplicitRowHeight : Number
显式设置 rowHeight 时需要的行高。
ListBase
 InheritedfactoryMap : Dictionary
项目渲染器基于工厂的映射。
ListBase
 InheritedfreeItemRenderers : Array
闲置项目渲染器的堆栈。
ListBase
 InheritedfreeItemRenderersByFactory : Dictionary
空闲项目渲染器基于工厂的映射。
ListBase
 InheritedfreeItemRenderersTable : Dictionary
未使用的项目渲染器的每列表格。
DataGridBase
 Inheritedheader : DataGridHeaderBase
标题子组件.
DataGridBase
 InheritedhighlightIndicator : Sprite
包含图形的 DisplayObject,用以指示加亮哪个渲染器。
ListBase
 InheritedhighlightItemRenderer : IListItemRenderer
当前滚动到尖号上方或下方的渲染器。
ListBase
 InheritedhighlightUID : String
当前滚动到尖号上方或下方的项目的 UID。
ListBase
 InheritedhorizontalScrollBar : ScrollBar
水平滚动条。
ScrollControlBase
 InheriteditemsNeedMeasurement : Boolean = true
一个标志,指示是否需要计算 columnWidth 和 rowHeight 属性。
ListBase
 InheriteditemsSizeChanged : Boolean = false
一个标志,指示渲染器的大小可能已更改。
ListBase
 Inheritediterator : IViewCursor
主 IViewCursor,用于从数据提供程序中获取项目并将这些项目传递到渲染器。
ListBase
 InheritediteratorValid : Boolean = true
一个标志,指示发生页面错误和迭代器位置无效(未放置在所显示的最上方项目处)。
ListBase
 InheritedkeySelectionPending : Boolean = false
一个标志,指示键盘选择是否由于页面错误而中断。
ListBase
 InheritedlastDropIndex : int
最近计算出的索引,这是拖动项目在放置目标中的添加位置。
ListBase
 InheritedlastSeekPending : ListBaseSeekPending
导致页面错误的最新一次搜寻。
ListBase
 InheritedlistContent : ListBaseContentHolder
一个内部显示对象,是所有项目渲染器、选择内容、亮显指示符以及其它支持图形的父级。
ListBase
 InheritedlistContentStyleFilters : Object
[只读 (read-only)] 从 ListBase 传递到 listContent 的一组样式。
ListBase
 InheritedlistItems : Array
[只读 (read-only)] 一个由数组组成的数组,其中包含用于呈现每个数据提供程序项目的 itemRenderer 实例。
ListBase
 InheritedlockedColumnAndRowContent : DataGridLockedRowContentHolder
包含锁定列的锁定行的子组件.
DataGridBase
 InheritedlockedColumnContent : ListBaseContentHolder
包含锁定列的子组件.
DataGridBase
 InheritedlockedColumnHeader : DataGridHeaderBase
锁定的列的标题子组件.
DataGridBase
 InheritedlockedRowContent : DataGridLockedRowContentHolder
包含锁定行的子组件.
DataGridBase
 InheritedmaskShape : Shape
遮罩。
ScrollControlBase
 InheritedmodifiedCollectionView : ModifiedCollectionView
集合视图,用于暂时保留上次的数据提供程序状态,以方便运行数据更改效果。
ListBase
 InheritedrendererChanged : Boolean = false
一个标志,指示渲染器已更改。
ListBase
 InheritedreservedItemRenderers : Object
当前闲置但近期可能会用到的项目渲染器的哈希映射。
ListBase
 InheritedresourceManager : IResourceManager
[只读 (read-only)] 引用管理所有应用程序本地化资源的对象。
UIComponent
 InheritedrowInfo : Array
[只读 (read-only)] ListRowInfo 对象数组,这些对象用于缓存行高和 listItems 中行的其它跟踪信息。
ListBase
 InheritedrowMap : Object
项目渲染器与其各自 ListRowInfo 对象的哈希映射。
ListBase
 InheritedrunDataEffectNextUpdate : Boolean = false
一个标志,指示下次更新显示时是否应该启动数据效果。
ListBase
 InheritedrunningDataEffect : Boolean = false
一个标志,指示当前是否正在运行数据更改效果.
ListBase
 InheritedscrollAreaChanged : Boolean
一个标志,指示滚动区域随滚动条的出现或消失进行更改。
ScrollControlBase
 InheritedselectedData : Object
用于跟踪当前所选项目的 ListBaseSelectionData 对象的哈希表。
ListBase
 InheritedselectionIndicators : Object
所选指示符的哈希表。
ListBase
 InheritedselectionLayer : Sprite
listContent 中的图层,用于绘制所有选择内容和加亮指示符。
ListBase
 InheritedselectionTweens : Object
所选内容补间的哈希表。
ListBase
 InheritedshowCaret : Boolean
一个标志,指示是否显示尖号。
ListBase
 InheritedunconstrainedRenderers : Dictionary
不受列表布局算法影响的项目渲染器的哈希映射.
ListBase
 InheritedunscaledHeight : Number
[只读 (read-only)] 用于确定组件的未缩放高度的简便方法。
UIComponent
 InheritedunscaledWidth : Number
[只读 (read-only)] 用于确定组件的未缩放宽度的简便方法。组件的绘图和子布局的所有设置均应在以此宽度为宽的矩形边框中完成,还应将此宽度作为参数传递到 updateDisplayList() 中。
UIComponent
 InheritedverticalScrollBar : ScrollBar
垂直滚动条。
ScrollControlBase
 InheritedvisibleData : Object
[只读 (read-only)] 视图中当前使用的数据提供程序项目渲染器的哈希表。
ListBase
 InheritedwordWrapChanged : Boolean = false
一个标志,指示自上次更新显示列表后 wordWrap 属性值是否已更改。
ListBase
公共方法
 方法定义方
  
构造函数。
DataGrid
 Inherited
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
DisplayObjectContainer
 Inherited
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
DisplayObjectContainer
 Inherited
如果正在运行数据更改效果,则添加项目渲染器。
ListBase
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
指示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。
DisplayObjectContainer
 Inherited
返回将放置项目添加到放置目标中的位置的索引。
ListBase
 Inherited
callLater(method:Function, args:Array = null):void
排队稍后调用的函数。
UIComponent
 Inherited
删除此组件实例中的样式属性。
UIComponent
 Inherited
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。
DisplayObjectContainer
 Inherited
将 Point 对象由内容坐标转换为全局坐标。
UIComponent
 Inherited
将 Point 对象由内容坐标转换为本地坐标。
UIComponent
 Inherited
返回标识此容器中的子项的一组属性。
UIComponent
 Inherited
返回列单元格或列标题的项目渲染器。
DataGridBase
  
createItemEditor(colIndex:int, rowIndex:int):void
使用由 itemEditor 属性指定的编辑器在 editedItemPosition 为项目渲染器创建项目编辑器。
DataGrid
 Inherited
创建一个给定了数据对象的项目渲染器.
ListBase
 Inherited
在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。
UIComponent
 Inherited
在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。
UIComponent
  
此方法将关闭项目渲染器上当前打开着的项目编辑器。
DataGrid
 Inherited
返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。
UIComponent
 Inherited
将事件调度到事件流中。
UIComponent
 Inherited
在此组件周围显示或隐藏焦点指示符。
UIComponent
 Inherited
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
 Inherited
停止在组件上播放效果实例时,由效果实例调用。
UIComponent
 Inherited
开始在组件上播放效果实例时,由效果实例调用。
UIComponent
 Inherited
结束组件上当前播放的所有效果。
UIComponent
 Inherited
executeBindings(recurse:Boolean = false):void
将数据绑定到此 UIComponent 对象。
UIComponent
 Inherited
根据 String 查找列表中的项目,并将所选内容移至该项目。
ListBase
 Inherited
打印完成后调用。
UIComponent
 Inherited
在指定的索引位置提供自动化对象。
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。
DisplayObject
 Inherited
返回位于指定索引处的子显示对象实例。
DisplayObjectContainer
 Inherited
返回具有指定名称的子显示对象。
DisplayObjectContainer
 Inherited
返回 DisplayObject 的 child 实例的索引位置。
DisplayObjectContainer
 Inherited
查找此 UIComponent 实例的类型选择器。
UIComponent
 Inherited
getConstraintValue(constraintName:String):*
返回一个约束布局值,这与获取此组件的约束样式的方式类似。
UIComponent
 Inherited
确定是使用显式高度还是测量高度的一种简便方法
UIComponent
 Inherited
确定是使用显式宽度还是测量宽度的一种简便方法
UIComponent
 Inherited
获取当前具有焦点的对象。
UIComponent
 Inherited
返回相应的工厂;如果尚未指定,则使用默认工厂。
ListBase
 Inherited
返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。
DisplayObject
 Inherited
getRendererSemanticValue(target:Object, semanticProperty:String):Object
返回 true 或 false 以指示是否应在目标上播放效果。
ListBase
 Inherited
getRepeaterItem(whichRepeater:int = -1):Object
返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。
UIComponent
 Inherited
getStyle(styleProp:String):*
获取已在此组件的样式查找链中的某个位置设置过的样式属性。
UIComponent
 Inherited
将 Point 对象由全局坐标转换为内容坐标。
UIComponent
 Inherited
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。
DisplayObject
 Inherited
将二维点从舞台(全局)坐标转换为三维显示对象的(本地)坐标。
DisplayObject
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
在鼠标指针下方隐藏指示允许执行拖放操作的放置指示符。
ListBase
 Inherited
计算显示对象,以确定它是否与 obj 显示对象重叠或相交。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。
DisplayObject
 Inherited
返回一个框 Matrix,在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。
UIComponent
 Inherited
针对数据提供程序中某个项目的索引获取项目渲染器(如果存在)。
ListBase
 Inherited
indicesToIndex(rowIndex:int, colIndex:int):int
计算 colIndex 和 rowIndex 处项目的数据提供程序中的偏移量。
ListBase
 Inherited
初始化此组件的内部结构。
UIComponent
 Inherited
初始化用于跟踪此组件的重复实例的各个属性。
UIComponent
 Inherited
标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。
UIComponent
 Inherited
在下次更新时刷新所有行。
ListBase
 Inherited
标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。
UIComponent
 Inherited
标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。
UIComponent
  
确定是否允许按行编辑 dataprovider 项目。
DataGrid
 Inherited
确定是否加亮显示数据提供者项目的项目渲染器(当鼠标滑过它,或者通过键盘导航使它位于尖号下方时)。
ListBase
 Inherited
确定数据提供程序项目的项目渲染器是否可选。
ListBase
 Inherited
确定是否已选中数据提供程序项目的项目渲染器。
ListBase
 Inherited
确定渲染器是否显示某个项目。
ListBase
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
确定渲染器是否包含(或拥有)显示对象。
ListBase
 Inherited
返回通过此项目渲染器呈现的该项目在数据提供程序中的项目索引。
ListBase
 Inherited
返回渲染器根据 dataTipField 和 dataTipFunction 属性显示给定数据对象的数据提示字符串。
ListBase
 Inherited
根据 iconField 和 iconFunction 属性返回表示数据项目图标的类(如果存在)。
ListBase
 Inherited
返回数据提供程序中给定项目的项目渲染器(如果存在)。
ListBase
 Inherited
返回渲染器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。
ListBase
 Inherited
将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。
DisplayObject
 Inherited
将 Point 对象由本地坐标转换为内容坐标。
UIComponent
 Inherited
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。
DisplayObject
 Inherited
measureHeightOfItems(index:int = -1, count:int = 0):Number
使用当前项目渲染器测量数据提供程序中的一组项目,并返回这些项目的高度之和。
ListBase
 Inherited
测量指定的 HTML 文本(该文本中可能包含 <font> 和 <b> 等 HTML 标记),假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。
UIComponent
 Inherited
测量指定的文本,假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。
UIComponent
 Inherited
measureWidthOfItems(index:int = -1, count:int = 0):Number
使用当前项目渲染器测量数据提供程序中的一组项目,并返回找到的最大宽度。
ListBase
 Inherited
将组件移动到其父项内的指定位置。
UIComponent
 Inherited
将样式更改传播到子项。
UIComponent
 Inherited
如果 owner 属性链从 child 指向此 UIComponent,则返回 true。
UIComponent
 Inherited
当在父项中添加或删除 UIComponent 对象时由 Flex 调用。
UIComponent
 Inherited
准备 IFlexDisplayObject 用于打印。
UIComponent
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
为此组件构建或重新构建 CSS 样式缓存;如果 recursive 参数为 true,还会为此组件的所有后代执行同样的操作。
UIComponent
 Inherited
针对每个效果事件,将 EffectManager 注册为一个事件侦听器。
UIComponent
 Inherited
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。
DisplayObjectContainer
 Inherited
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。
DisplayObjectContainer
 Inherited
如果正在运行数据更改效果,则移除项目渲染器。
ListBase
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
重放指定的事件。
UIComponent
 Inherited
使用提供的 ID 解析子项。
UIComponent
 Inherited
[静态] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。
UIComponent
 Inherited
确保给定索引处的数据提供程序项目可见。
ListBase
 Inherited
调整对象大小。
UIComponent
 Inherited
更改现有子项在显示对象容器中的位置。
DisplayObjectContainer
 Inherited
setConstraintValue(constraintName:String, value:*):void
设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。
UIComponent
 Inherited
setCurrentState(stateName:String, playTransition:Boolean = true):void
设置当前状态。
UIComponent
 Inherited
设置此组件的焦点。
UIComponent
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
setStyle(styleProp:String, newValue:*):void
对此组件实例设置样式属性。
UIComponent
 Inherited
setVisible(value:Boolean, noEvent:Boolean = false):void
当 visible 属性发生更改时调用。
UIComponent
 Inherited
在鼠标指针下方显示拖放指示符表示允许拖放操作以及项目的放置位置。
ListBase
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
允许用户拖动指定的 Sprite。
Sprite
 Inherited
结束 startDrag() 方法。
Sprite
 Inherited
检测对样式属性的更改。
UIComponent
 Inherited
首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。
UIComponent
 Inherited
[静态] 阻止对使用 callLater() 排队的方法进行背景处理,直到调用 resumeBackgroundProcessing() 为止。
UIComponent
 Inherited
交换两个指定子对象的 Z 轴顺序(从前到后顺序)。
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。
DisplayObjectContainer
 Inherited
返回一个字符串,用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。
FlexSprite
 Inherited
如果对应于特定数据项目的项目渲染器需要移动到控件中项目渲染器的正常位置之外,则将作为数据更改效果的一部分由 UnconstrainItemAction 效果调用。
ListBase
 Inherited
验证子项的位置和大小,并绘制其它可视内容。
UIComponent
 Inherited
验证并更新此对象的属性和布局,如果需要的话重绘对象。
UIComponent
 Inherited
由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。
UIComponent
 Inherited
validateSize(recursive:Boolean = false):void
如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法,随后在测量时调用了 validateSize() 方法,则验证组件的度量大小。
UIComponent
 Inherited
处理分配给此组件的验证程序调度的 valid 和 invalid 事件。
UIComponent
 Inherited
返回指定对象的原始值。
Object
 Inherited
返回一个框 Matrix,在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。
UIComponent
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
受保护的方法
 方法定义方
 Inherited
作为拖放操作的一部分,将所选项目添加到 DragSource 对象。
ListBase
 Inherited
将渲染器添加到循环使用的渲染器列表,使其不可见并清除对该渲染器的引用。
ListBase
 Inherited
从用于存储对行的引用的数组开头添加一个空白行.
ListBase
 Inherited
调整焦点矩形。
UIComponent
  
adjustListContent(unscaledWidth:Number = -1, unscaledHeight:Number = -1):void
从 updateDisplayList() 方法中调用,用以调整 listContent 的大小和位置。
DataGrid
 Inherited
adjustRow(contentHolder:ListBaseContentHolder, rowNum:int, yy:Number, hh:Number):void
针对给定的 rowNum、行位置和行高调整渲染器的大小和位置。
DataGridBase
 Inherited
设置应用选择指示符的效果。
ListBase
 Inherited
这是一个内部方法,供 Flex 框架用于支持 Dissolve 效果。
UIComponent
 Inherited
在执行拖放操作时计算放置指示符的 y 位置。
ListBase
 Inherited
calculateRowHeight(data:Object, hh:Number, skipVisible:Boolean = false):Number
计算一行中列的行高。
DataGridBase
 Inherited
创建子对象后执行任何最终处理。
UIComponent
 Inherited
清除给定 Sprite 中的尖号指示符。.
ListBase
 Inherited
清除给定 Sprite 中的加亮指示符.
ListBase
 Inherited
删除所有选定、加亮显示和尖号指示符。
ListBase
 Inherited
clearRow(contentHolder:ListBaseContentHolder, rowNum:int):void
从对于给定 rowNum 应为空的行中删除渲染器。
DataGridBase
 Inherited
clearSelected(transition:Boolean = false):void
清除所选项目组,并移除表示那些项目的选定状态的所有图形。
ListBase
  
移除用户通常用于调整列大小的列标题分隔符。
DataGrid
 Inherited
清空 visibleData 哈希表.
ListBase
 Inherited
当数据发生更改时,处理从数据提供程序中调度的 CollectionEvent。
ListBase
 Inherited
根据是否已显式设置 columnCountcolumnWidth、rowHeight 和 rowCount 等属性来计算列宽、行高以及行数和列数。
ListBase
 Inherited
根据行数、列数以及可查看的行和列配置 ScrollBar。
ListBase
 Inherited
通过调用 ObjectUtil.copy() 方法为此对象制作一个深层副本,然后通过调用 UIDUtil.createUID() 方法用一个新值替代该副本的 uid 属性(如果存在)。
ListBase
 Inherited
copySelectedItems(useDataField:Boolean = true):Array
按照选择时的顺序复制所选项目。
ListBase
 Inherited
为此组件创建边框。
ScrollControlBase
 Inherited
创建对象作为此 ListBase 的子对象,在这种情况下为将容纳所有项目渲染器的 listContent 对象。
ListBase
 Inherited
根据所用的嵌入字体使用上下文创建新对象。
UIComponent
 Inherited
使用给定的 moduleFactory 创建对象。
UIComponent
 Inherited
destroyRow(i:int, numCols:int):void
循环使用不再需要的行,并删除其指示符。
ListBase
 Inherited
处理 DragEvent.DRAG_COMPLETE 事件。
ListBase
 Inherited
处理 DragEvent.DRAG_DROP 事件。
ListBase
 Inherited
处理 DragEvent.DRAG_ENTER 事件。
ListBase
 Inherited
处理 DragEvent.DRAG_EXIT 事件。
ListBase
 Inherited
处理 DragEvent.DRAG_OVER 事件。
ListBase
 Inherited
Interval 函数,用于在鼠标位于列表上方或下方时上下滚动列表。
ListBase
 Inherited
dragStart 事件的默认处理函数。
ListBase
 Inherited
drawCaretIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void
使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制尖号指示符。
ListBase
  
drawColumnBackground(s:Sprite, columnIndex:int, color:uint, column:DataGridColumn):void
使用建议的颜色为列绘制列背景。
DataGrid
  
在给定的 UIComponent 中绘制标题的背景。
DataGrid
 Inherited
drawHighlightIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void
使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制加亮指示符。
ListBase
  
drawHorizontalLine(s:Sprite, rowIndex:int, color:uint, y:Number):void
绘制行之间的直线。
DataGrid
 Inherited
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
  
drawRowBackground(s:Sprite, rowIndex:int, y:Number, height:Number, color:uint, dataIndex:int):void
使用指定的颜色在指定的位置按指定的高度绘制行背景。
DataGrid
 Inherited
绘制行中所有交替行的颜色、边框和背景。
ListBase
 Inherited
drawSelectionIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void
使用指定的颜色在给定的 Sprite 中采用指定的位置、宽度和高度绘制选择指示符。
ListBase
  
创建用户通常用于调整列大小的列标题分隔符并将其显示出来。
DataGrid
  
drawVerticalLine(s:Sprite, colIndex:int, color:uint, x:Number):void
绘制列之间的直线。
DataGrid
 Inherited
drawVisibleItem(uid:String, selected:Boolean = false, highlighted:Boolean = false, caret:Boolean = false, transition:Boolean = false):void
绘制可见的项目。
DataGridBase
 Inherited
findKey(eventCode:int):Boolean
尝试在数据提供程序中查找下一个以 eventCode 参数中的字符开头的项目。
ListBase
 Inherited
在数据更改效果运行完毕后,通过恢复原始集合和迭代器并移除此效果使用的所有缓存值进行清理。
ListBase
 Inherited
基于 caretIndex 和 anchorIndex 属性设置所选项目。
DataGridBase
 Inherited
当 UIComponent 对象获得焦点时调用的事件处理函数。
UIComponent
 Inherited
当 UIComponent 对象失去焦点时调用的事件处理函数。
UIComponent
 Inherited
检索已创建但当前未使用的项目渲染器。
ListBase
 Inherited
给定索引处数据提供程序项目所在的列。
ListBase
 Inherited
给定索引处数据提供程序项目所在的行。
ListBase
 Inherited
完成对此组件的初始化。
UIComponent
 Inherited
初始化此组件的辅助功能代码。
UIComponent
 Inherited
initiateDataChangeEffect(unscaledWidth:Number, unscaledHeight:Number):void
当数据提供程序中发生更改时应用数据更改效果。
ListBase
 Inherited
通常由包含 UITextField 对象的组件覆盖,其中 UITextField 对象获取焦点。
UIComponent
 Inherited
如果项目渲染器不再根据列表的布局算法定位,则返回 true,尽管由于调用 unconstrainRenderer() 方法正在运行数据更改效果。
ListBase
 Inherited
返回一个 Point 对象,用于定义项目渲染器的 columnIndex 和 rowIndex 属性。
DataGridBase
 Inherited
确定数据提供程序项目的 UID。
ListBase
 Inherited
为 keyDown 事件调用的事件处理函数。
UIComponent
 Inherited
为 keyUp 事件调用的事件处理函数。
UIComponent
 Inherited
layoutChrome(unscaledWidth:Number, unscaledHeight:Number):void
通过设置此控件边框的位置和大小来响应大小更改。
ScrollControlBase
 Inherited
针对某列确定 itemRenderer 的大小和临时位置,同时以 Point 的形式返回其大小。
DataGridBase
 Inherited
makeListData(data:Object, uid:String, rowNum:int, columnNum:int, column:DataGridColumn):BaseListData
创建新 DataGridListData 实例,并基于输入数据提供程序项目来填充字段。
DataGridBase
 Inherited
makeRow(contentHolder:ListBaseContentHolder, rowNum:int, left:Number, right:Number, yy:Number, data:Object, uid:String):Number
针对给定的 rowNum、dataObject 和 uid 创建渲染器。
DataGridBase
 Inherited
makeRowsAndColumns(left:Number, top:Number, right:Number, bottom:Number, firstColumn:int, firstRow:int, byCount:Boolean = false, rowsNeeded:uint = 0):Point
创建足够的行和列以填充左侧、顶部、右侧和底部描述的区域。
ListBase
 Inherited
根据 rowCount、columnCount、rowHeight 和 columnWidth 属性计算组件的度量宽度和高度。
ListBase
 Inherited
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_CLICK 事件。
ListBase
 Inherited
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_DOUBLE_CLICK 事件。
ListBase
 Inherited
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_DOWN 事件。
ListBase
 Inherited
确定哪种项目渲染器位于鼠标下方。
ListBase
 Inherited
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_MOVE 事件。
ListBase
 Inherited
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_OUT 事件。
ListBase
 Inherited
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_OVER 事件。
ListBase
 Inherited
处理列表中所有鼠标目标(包括渲染器)的 MouseEvent.MOUSE_DOWN 事件。
ListBase
 Inherited
通过更改滚动位置处理 mouseWheel 事件。
ListBase
 Inherited
水平移动所选项目并加亮指示符.
ListBase
 Inherited
moveIndicatorsVertically(uid:String, moveBlockDistance:Number):void
垂直移动所选项目并加亮指示符.
ListBase
 Inherited
moveRowVertically(i:int, numCols:int, moveBlockDistance:Number):void
垂直移动行,并更新 rowInfo 记录.
ListBase
 Inherited
沿水平方向移动所选项目,以响应用户使用向左键或向右键以及功能键(如 Shift 和 Ctrl 键)选择项目的操作。
ListBase
 Inherited
沿垂直方向移动所选项目,以响应用户用向上键或向下键以及功能键(如 Shift 和 Ctrl 键)选择项目的操作。
DataGridBase
  
在作为当前排序键的列上绘制排序箭头图形。
DataGrid
 Inherited
准备集合事件的数据效果。
ListBase
 Inherited
确保行数组中有一个槽对应给定的行号。
DataGridBase
 Inherited
当渲染器发生更改时,updateDisplayList() 方法将调用此方法,用以删除现有的项目渲染器并清理各种缓存结构。
ListBase
 Inherited
更新 visibleData 哈希表中的键.
ListBase
 Inherited
从 contentHolder 的末尾删除额外行。
DataGridBase
 Inherited
从用于存储对行的引用的数组中删除一行.
ListBase
 Inherited
清理数据提供程序中给定项目的选项亮显及其它关联图形。
ListBase
 Inherited
构建 UIComponent 时将调用此方法,并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时,都会再次调用此方法。
UIComponent
 Inherited
从用于存储对行的引用的数组开头删除请求的行数.
ListBase
 Inherited
roomForScrollBar(bar:ScrollBar, unscaledWidth:Number, unscaledHeight:Number):Boolean
确定此组件中的空间是否足以显示给定的滚动条。
ScrollControlBase
 Inherited
scroll 事件的默认事件处理函数。
ScrollControlBase
 Inherited
scrollHorizontally(pos:int, deltaPos:int, scrollUp:Boolean):void
调整渲染器以响应滚动位置的更改。
ListBase
  
scrollPositionToIndex(horizontalScrollPosition:int, verticalScrollPosition:int):int
返回给定滚动位置第一个可见行和列处的项目的数据提供程序索引。
DataGrid
  
scrollVertically(pos:int, deltaPos:int, scrollUp:Boolean):void
调整渲染器以响应滚动位置的更改。
DataGrid
 Inherited
当由于页面错误而导致寻找失败时的默认故障处理函数。
ListBase
 Inherited
当由于页面错误而导致寻找失败时的默认结果处理函数。
ListBase
 Inherited
搜寻位置,并在必要时处理 ItemPendingError。
ListBase
 Inherited
selectItem(item:IListItemRenderer, shiftKey:Boolean, ctrlKey:Boolean, transition:Boolean = true):Boolean
如果使用鼠标单击提供的项目渲染器,并且键盘功能键处于给定状态,则更新所选项目组。
ListBase
 Inherited
设置 rowCount 属性不会导致 invalidation,也不会设置将永久锁定行数的 explicitRowCount 属性。
ListBase
 Inherited
设置 rowHeight 属性不会导致 invalidation,也不会设置将永久锁定行高的 explicitRowHeight。
ListBase
 Inherited
setRowInfo(contentHolder:ListBaseContentHolder, rowNum:int, yy:Number, hh:Number, uid:String):void
针对给定的 rowNum、行位置和行高设置 rowInfo。
DataGridBase
 Inherited
setScrollBarProperties(totalColumns:int, visibleColumns:int, totalRows:int, visibleRows:int):void
使 ScrollControlBase 基于传递的参数显示或隐藏滚动条。
ScrollControlBase
 Inherited
为某列设置项目渲染器,并将其放置在 listItems 数组中所请求的位置。
DataGridBase
 Inherited
shiftRow(oldIndex:int, newIndex:int, numCols:int, shiftItems:Boolean):void
移动引用多行的数组中的某一行.
ListBase
 Inherited
sumRowHeights(startRowIdx:int, endRowIdx:int):Number
确定所请求的行集的高度.
ListBase
 Inherited
从用于存储对行的引用的数组末端删除所有剩余行.
ListBase
 Inherited
Find an item renderer based on its UID if it is visible.
ListBase
 Inherited
updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void
当可显示的项目数发生更改时添加或移除项目渲染器。
ListBase
 Inherited
刷新所有行。
ListBase
 Inherited
同步重绘渲染器。
DataGridBase
事件
 事件 摘要 定义方
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited使用 addChild() 或 addChildAt() 方法将组件作为内容子项添加到容器时调度。UIComponent
 Inherited将显示对象添加到显示列表中时调度。DisplayObject
 Inherited在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。DisplayObject
 Inherited当用户操作导致 selectedIndex 或 selectedItem 属性更改时调度此事件。ListBase
 Inherited当用户从文本上下文菜单中选择“清除”(或“删除”)时调度。InteractiveObject
 Inherited用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。InteractiveObject
  当用户更改列宽时调度,指示此列中显示的数据量可能会更改。DataGrid
 Inherited当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。InteractiveObject
 Inherited当用户激活特定于平台的复制操作的快捷键组合或从文本上下文菜单中选择“复制”时调度。InteractiveObject
 Inherited当组件完成其构建、属性处理、测量、布置和绘制时调度。UIComponent
 Inherited视图状态更改后调度。UIComponent
 Inherited在 currentState 属性更改后但视图状态更改前调度。UIComponent
 Inherited当用户激活特定于平台的剪切操作的快捷键组合或从文本上下文菜单中选择“剪切”时调度。InteractiveObject
 Inherited当 data 属性更改时进行调度。ListBase
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
 Inherited如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。InteractiveObject
 Inherited在拖动操作完成时(将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时)由拖动启动器(作为要拖动的数据源的组件)调度。UIComponent
 Inherited用户在放置目标上释放鼠标时由放置目标调度。UIComponent
 Inherited当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时,由该组件调度。UIComponent
 Inherited用户在组件外拖动但没有将数据放置到目标时,由组件调度。UIComponent
 Inherited在拖动操作期间,当用户在鼠标位于组件上方的情况下移动鼠标时,由组件调度。UIComponent
 Inherited启动拖动操作时,由拖动启动器调度。UIComponent
 Inherited在一个效果结束后调度。UIComponent
 Inherited在即将开始播放效果前调度。UIComponent
 Inherited[播放事件] 播放头进入新帧时调度。DisplayObject
 Inherited组件返回到根视图状态之后调度。UIComponent
 Inherited[广播事件] 播放头退出当前帧时调度。DisplayObject
 Inherited组件退出根视图状态之前调度。UIComponent
 Inherited显示对象获得焦点后调度。InteractiveObject
 Inherited显示对象失去焦点后调度。InteractiveObject
 Inherited[广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。DisplayObject
  当用户在列标题上释放鼠标按键以请求控件基于列内容对网格内容进行排序时调度。DataGrid
  当用户将列拖动到新位置使该列移动到新索引处后,在列标题上释放鼠标按键时调度。DataGrid
 Inherited当对象的状态从可见变为不可见时调度。UIComponent
 Inherited当组件完成构建并设置了所有初始化属性后调度。UIComponent
 Inherited当组件由 Validator 监控且未通过验证时调度。UIComponent
 Inherited当用户单击控件中的某个项目时调度此事件。ListBase
 Inherited当用户双击控件中的某个项目时调度此事件。ListBase
  当 editedItemPosition 属性已设置且项目可编辑时调度。DataGrid
  当用户在某个项目渲染器上方释放鼠标按键时,使用 tab 键导航到 DataGrid 控件或 DataGrid 控件内部时,或者以任何其它方式尝试编辑某一项目时调度。DataGrid
  当项目编辑会话因任何原因而结束时调度。DataGrid
  当项目渲染器获得焦点时调度。在下列情况下项目渲染器可能获得焦点:当用户单击 DataGrid 控件中的某个项目或者使用键盘导航到该项目时。DataGrid
  当项目渲染器失去焦点时调度。在下列情况下项目渲染器可能失去焦点:当用户单击 DataGrid 控件中的其它项目或在此控件外部单击时,或使用键盘导航到 DataGrid 控件中的其它项目或导航到该控件外部时。DataGrid
 Inherited当用户将鼠标指针移出控件中的某个项目时调度此事件。ListBase
 Inherited当用户将鼠标指针滚至控件中的某个项目时调度此方法。ListBase
 Inherited用户按下某个键时调度。InteractiveObject
 Inherited用户尝试使用键盘导航更改焦点时调度。InteractiveObject
 Inherited用户释放某个键时调度。InteractiveObject
 Inherited当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上按下指针设备按钮时调度。InteractiveObject
 Inherited当用户在使用 PopUpManager 打开的某个组件外部单击时,从该组件调度。UIComponent
 Inherited用户尝试使用指针设备更改焦点时调度。InteractiveObject
 Inherited用户移动 InteractiveObject 上的指针设备时调度。InteractiveObject
 Inherited用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited当鼠标滚轮滚动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited当用户使用鼠标滚轮滚动到使用 PopUpManager 打开的某个组件外部时,从该组件调度。UIComponent
 Inherited移动对象后调度。UIComponent
 Inherited当用户释放拖动动作时由拖动启动器 InteractiveObject 调度。InteractiveObject
 Inherited在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时,由目标 InteractiveObject 调度。InteractiveObject
 Inherited当拖动动作进入其边界时由 InteractiveObject 调度。InteractiveObject
 Inherited当拖动动作离开其边界时由 InteractiveObject 调度。InteractiveObject
 Inherited当拖动动作保持在其边界内时,由 InteractiveObject 持续调度。InteractiveObject
 Inherited在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。InteractiveObject
 Inherited在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。InteractiveObject
 Inherited当用户激活特定于平台的粘贴操作的快捷键组合或从文本上下文菜单中选择“粘贴”时调度。InteractiveObject
 Inherited在组件初始化序列开始时调度。UIComponent
 Inherited使用 removeChild() 或 removeChildAt() 方法将组件作为内容子项从容器中删除时调度。UIComponent
 Inherited将要从显示列表中删除显示对象时调度。DisplayObject
 Inherited在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。DisplayObject
 Inherited[广播事件] 将要更新和呈现显示列表时调度。DisplayObject
 Inherited在调整组件大小时调度。UIComponent
 Inherited当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上按下指针设备按钮时调度。InteractiveObject
 Inherited当用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited当滚动内容时调度。ScrollControlBase
 Inherited当用户激活特定于平台的全选操作的快捷键组合或从文本上下文菜单中选择“全选”时调度。InteractiveObject
 Inherited当对象的状态从不可见变为可见时调度。UIComponent
 Inherited对象的 tabChildren 标志值发生更改时调度。InteractiveObject
 Inherited对象的 tabEnabled 标志发生更改时调度。InteractiveObject
 Inherited对象的 tabIndex 属性值发生更改时调度。InteractiveObject
 Inherited要创建 ToolTip 时由组件调度。UIComponent
 Inherited已隐藏组件的 ToolTip 并要将其放弃时由组件调度。UIComponent
 Inherited要隐藏组件的 ToolTip 时由组件调度。UIComponent
 Inherited要显示组件的 ToolTip 时由组件调度。UIComponent
 Inherited显示组件的 ToolTip 时由组件调度。UIComponent
 Inherited用户将鼠标移动到设置了 toolTip 属性的组件上方后,由该组件调度。UIComponent
 Inherited当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度(如果需要)。UIComponent
 Inherited当组件由 Validator 监控并且成功通过验证时调度。UIComponent
 Inherited当以编程方式或通过用户交互更改值时调度。UIComponent
样式
 样式 说明 定义方
 Inherited类型: Array 格式: Color CSS 继承: yes
列表中项目使用的背景色。此值是由两种或更多种颜色组成的数组。列表项目的背景色将从数组中的各种颜色之间选取。

对于 DataGrid 控件,行中的所有项目都使用相同的背景色,而每行的背景色都由颜色数组确定。

对于只使用一个列表填充二维显示的 TileList 控件,此样式可根据指定的列数、行数和颜色数生成棋盘外观、条纹或其它图案。TileList 循环使用各种颜色,根据布局方向设置各个项目的背景色。如果您的 TileList 为水平布局,并且颜色数和列数均为偶数,则显示条纹图案。如果列数为奇数,则显示棋盘图案。

仅当未指定 backgroundColor 时才会生效。

.
ListBase
 Inherited类型: Number CSS 继承: no
backgroundColor 属性定义的颜色和 backgroundImage 样式定义的图像或 SWF 文件的 Alpha 级别。有效值范围为从 0.
ScrollControlBase
 Inherited类型: uint 格式: Color CSS 继承: no
组件的背景颜色。您可以同时设置 backgroundColorbackgroundImage。一些组件没有背景。DataGrid 控件会忽略此样式。默认值为 undefined,即不进行设置。如果此样式和 backgroundImage 样式都为 undefined,则控件将采用透明背景。

对于 Application 容器,此样式指定应用程序加载时的背景色以及运行该应用程序时的背景渐变。Flex 计算比指定颜色略深的颜色和比指定颜色略浅的颜色之间的渐变。

大多数 Flex 控件的默认外观为半透明。因此,容器的背景颜色将在某种程度上“渗入”该容器中的控件。通过将控件的 fillAlphas 属性的 alpha 值设置为 1 可以避免此情况,如以下示例所示:

 <mx: Container backgroundColor="0x66CC66"/> <mx: ControlName ...
ScrollControlBase
 Inherited类型: uint 格式: Color CSS 继承: yes
禁用组件时的组件的背景颜色。全局默认值为 undefined。List 控件的默认值为 0xDDDDDD(浅灰)。如果禁用了容器,背景将变暗,而暗淡程度由 disabledOverlayAlpha 样式控制。.
ScrollControlBase
 Inherited类型: Object 格式: File CSS 继承: no
组件的背景图像。此样式可以是绝对或相对 URL 或类。您可以同时设置 backgroundColorbackgroundImage。背景图像显示在背景色上面。默认值为 undefined,表示“未设置”。如果此样式和 backgroundColor 样式都未定义,则控件将采用透明背景。

大多数 Flex 控件的默认外观为半透明。因此,容器的背景图像将在某种程度上“渗入”该容器中的控件。通过将控件的 fillAlphas 属性的 alpha 值设置为 1 可以避免此情况,如以下示例所示:

 <mx: Container backgroundColor="0x66CC66"/> <mx: ControlName ...
ScrollControlBase
 Inherited类型: String CSS 继承: no
backgroundImage 指定的图像缩放到不同的百分比大小。"100%" 值将拉抻该图像以适应整个组件。要指定百分比值,您必须输入百分号 (%)。Application 容器的默认值为 100%。所有其它容器的默认值为 auto,此值将保持图像的原始大小。.
ScrollControlBase
 Inherited类型: String CSS 继承: no
从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位)。如果设置此样式,则组件的基线锚定在其内容区域的上边缘;调整组件容器大小后,这两个边缘将保持它们的间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
UIComponent
 Inherited类型: uint 格式: Color CSS 继承: no
边框颜色。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 0xB7BABC。.
ScrollControlBase
 Inherited类型: String CSS 继承: no
边框边。指定要显示的边框边的以空格分隔的 String。此 String 可以任意顺序包含 "left""top""right""bottom"。默认值为 "left top right bottom",此值会显示所有四条边。仅当 borderStyle 为 "solid" 时才使用此样式。.
ScrollControlBase
 Inherited类型: Class CSS 继承: no
组件的边框外观类。mx.
ScrollControlBase
 Inherited类型: String CSS 继承: no
边框样式。可能值为 "none""solid""inset""outset"。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 "inset"。大多数容器的默认值为 "none"。.
ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: no
边框厚度。仅在将 borderStyle 设置为 "solid" 时使用。.
ScrollControlBase
 Inherited类型: String CSS 继承: no
从组件的下边缘到其内容区域的下边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的下边缘锚定在其内容区域的下边缘;调整组件容器大小后,这两个边缘将保持它们的间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
UIComponent
 Inherited类型: uint 格式: Color CSS 继承: yes
组件中文本(包括组件标签)的颜色。.
ScrollControlBase
  
columnDropIndicatorSkin
类型: Class CSS 继承: no
用作指示可将列放在当前位置的外观的类。 默认值为 mx.skins.halo.DataGridColumnDropIndicator.
DataGrid
  
columnResizeSkin
类型: Class CSS 继承: no
用作要调整大小的列的外观的类。 默认值为 mx.skins.halo.DataGridColumnResizeSkin.
DataGrid
 Inherited类型: uint 格式: Color CSS 继承: yes
禁用时组件中文本的颜色。.
ScrollControlBase
  
disabledIconColor
类型: uint 格式: Color CSS 继承: yes
已禁用外观中图标的颜色。例如,CheckBoxIcon 外观类可使用此样式来绘制禁用的 CheckBox 控件的复选标记;ComboBoxSkin 类可使用此样式来绘制禁用的 ComboBox 控件的向下箭头;DateChooserMonthArrowSkin 外观类可使用此样式来绘制禁用的 DateChooser 控件的月箭头。默认值取决于组件类;如果此类未覆盖默认值,则默认值为 0x999999
DataGrid
 Inherited类型: Class CSS 继承: no
用于指示所拖动项目的放置位置的外观。如果拖放操作的目标位置可能是 ListBase-derived 组件,则调用 showDropFeedback() 方法将产生此类的实例,并将该实例定位在所放置项目之后项目的 itemRenderer 上方一个像素处(如果进行放置)。.
ListBase
 Inherited类型: uint 格式: Color CSS 继承: yes
投影颜色。.
ScrollControlBase
 Inherited类型: Boolean CSS 继承: no
指定组件是否具有可见投影的布尔值属性。此样式与 borderStyle="solid" 一起使用。默认值为 false

注意:对于显示在容器上的投影,需设置 backgroundColorbackgroundImage 属性。否则,由于容器的背景默认为透明,阴影将显示在容器后。

.
ScrollControlBase
 Inherited类型: uint 格式: Color CSS 继承: yes
验证失败时,组件加亮部分的颜色。验证失败时,Flex 还会将组件的 borderColor 样式设置为 errorColor。.
UIComponent
 Inherited类型: Number CSS 继承: no
指定焦点外观的 alpha 透明度值。.
ListBase
 Inherited类型: String CSS 继承: no
焦点矩形使用的混合模式。有关详细信息,请参阅 flash.
UIComponent
 Inherited类型: String CSS 继承: no
指定焦点矩形的哪些角应该是圆角。此值是使用空格分隔的 String,该 String 可以是 "tl""tr""bl""br" 的任意组合。例如,要指定右侧的角为圆角,左侧的角为直角,应使用 "tr br"cornerRadius 样式属性指定圆角的半径。默认值取决于组件类;如果未覆盖该类的默认值,则默认值为 "tl tr bl br"。.
ListBase
 Inherited类型: Class CSS 继承: no
用于绘制焦点矩形的外观。.
UIComponent
 Inherited类型: Number 格式: Length CSS 继承: no
焦点矩形轮廓的粗细,以像素为单位。.
UIComponent
 Inherited类型: String CSS 继承: yes
设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash.
ScrollControlBase
 Inherited类型: String CSS 继承: yes
使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。.
ScrollControlBase
 Inherited类型: String CSS 继承: yes
设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性。可能值为 "none" (flash.
ScrollControlBase
 Inherited类型: Number CSS 继承: yes
设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。

仅当使用嵌入字体并将 fontAntiAliasType 属性设置为 "advanced" 时,才应用此属性。

此样式对系统字体不起作用。

此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。

.
ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: yes
文本的高度,以像素为单位。除 ColorPicker 控件之外,所有控件的默认值都为 10。ColorPicker 控件的默认值为 11。.
ScrollControlBase
 Inherited类型: String CSS 继承: yes
确定文本是否使用斜体。可识别的值为 "normal""italic"。.
ScrollControlBase
 Inherited类型: Number CSS 继承: yes
设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。

仅当使用嵌入字体并将 fontAntiAliasType 属性设置为 "advanced" 时,才应用此属性。

此样式对系统字体不起作用。

此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。

.
ScrollControlBase
 Inherited类型: String CSS 继承: yes
确定文本是否使用粗体。可识别的值为 normalbold。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
 Inherited类型: String CSS 继承: no
从组件内容区域的中心到组件中心的水平距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整组件容器大小后,这两个中心将保持它们的水平间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
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
 Inherited类型: 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
 Inherited类型: Boolean CSS 继承: yes
一个布尔值,指示是启用 (true) 还是禁用 (false) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。.
ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: yes
文本行之间附加的垂直空间。

默认值为 2。

ComboBox 控件的默认值为 0。

.
ScrollControlBase
 Inherited类型: String CSS 继承: no
从组件内容区域的左边缘到组件左边缘的水平距离(以像素为单位)。如果设置此样式,则组件的左边缘锚定在其内容区域的左边缘;调整组件容器大小后,这两个边缘将保持它们的间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
UIComponent
 Inherited类型: Number CSS 继承: yes
各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。.
ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: no
行的底部与该行中渲染器底部之间的像素数目。.
ListBase
 Inherited类型: Number 格式: Length CSS 继承: no
组件左边框与其内容区域左边缘之间的像素数目。

默认值为 0。

Button 控件的默认值为 10。

ComboBox 控件的默认值为 5。

Form 容器的默认值为 16。

Tree 控件的默认值为 2。

.
ListBase
 Inherited类型: Number 格式: Length CSS 继承: no
组件右边框与其内容区域右边缘之间的像素数目。

默认值为 0。

Button 控件的默认值为 10。

ComboBox 控件的默认值为 5。

Form 容器的默认值为 16。

.
ListBase
 Inherited类型: Number 格式: Length CSS 继承: no
行的顶部与该行中渲染器顶部之间的像素数目。.
ListBase
 Inherited类型: String CSS 继承: no
从组件的右边缘到其内容区域的右边缘的水平距离(以像素为单位)。如果设置此样式,则组件的右边缘锚定在其内容区域的右边缘;调整组件容器大小后,这两个边缘将保持它们的间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
UIComponent
  
rollOverColor
类型: uint 格式: Color CSS 继承: yes
用户将鼠标滑过行时的行背景颜色。 默认值为 0xE3FFD6.
DataGrid
  
selectionColor
类型: uint 格式: Color CSS 继承: yes
用户选择行中的项目渲染器时的行背景颜色。 默认值为 0xCDFFC1.
DataGrid
 Inherited类型: uint 格式: Color CSS 继承: yes
禁用此组件时渲染器的背景色。.
ListBase
 Inherited类型: Number 格式: Time CSS 继承: no
选择效果的持续时间。如果选中了某个项目,则在背景着色时会播放相应的效果。设置为 0 可禁用此效果。.
ListBase
 Inherited类型: Function CSS 继承: no
针对选项效果的 easingFunction。如果选中了某个项目,则在背景着色时会播放相应的效果。默认效果为颜色的线性淡入淡出。easingFunction 可用于控制选择效果。.
ListBase
 Inherited类型: String CSS 继承: no
投影方向。可能值包括 "left""center""right"。.
ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: no
投影距离。如果将此属性设置为负值,此阴影将出现在组件的上方。.
ScrollControlBase
  
sortArrowSkin
类型: Class CSS 继承: no
用作指示列排序方向的箭头外观的类。 默认值为 mx.skins.halo.DataGridSortArrow.
DataGrid
  
stretchCursor
类型: Class CSS 继承: no
用作指示可调整列大小的光标外观的类。默认值为 Assets.swf 文件中的 "cursorStretch" 符号。
DataGrid
 Inherited类型: String CSS 继承: yes
容器内文本的对齐情况。可能值有:"left""right""center"

大多数组件的默认值为 "left"。对于 FormItem 组件,默认值为 "right"。对于 Button、LinkButton 和 AccordionHeader 组件,默认值为 "center",且仅当将 labelPlacement 属性设置为 "left""right" 时,才能识别此属性。如果将 labelPlacement 设置为 "top""bottom",将居中文本及所有图标。

.
ScrollControlBase
 Inherited类型: String CSS 继承: yes
确定文本是否加下划线。可能值有:"none""underline"。.
ScrollControlBase
 Inherited类型: Number 格式: Length CSS 继承: yes
文本第一行偏离容器左侧的距离(以像素为单位)。.
ScrollControlBase
 Inherited类型: uint 格式: Color CSS 继承: yes
用户滚过鼠标时渲染器文本的颜色。.
ListBase
 Inherited类型: uint 格式: Color CSS 继承: yes
用户选中渲染器时其文本的颜色。.
ListBase
 Inherited类型: uint 格式: Color CSS 继承: yes
组件的主题颜色。此属性控制加亮内容的外观、选中组件时的外观和其它相似的形象化提示,但是它对此组件的常规边框和背景颜色不起作用。虽然可以使用任意有效的颜色值,但首选值为 haloGreenhaloBluehaloOrangehaloSilver

rollOverColorselectionColor 样式的默认值基于 themeColor 值。

.
UIComponent
 Inherited类型: String CSS 继承: no
从控件内容区域的上边缘到组件上边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的上边缘锚定在其内容区域的上边缘;调整其容器大小后,这两个边缘将保持其间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
UIComponent
 Inherited类型: Boolean CSS 继承: no
一个标志,控制当鼠标滚过项目时是否加亮显示该项目。如果为 true,则当鼠标滚过行时加亮显示这些行。如果为 false,则只在选中行时才进行加亮显示。.
ListBase
 Inherited类型: String CSS 继承: no
垂直对齐行中的渲染器。可能值包括 "top""middle""bottom"。DataGrid 根据此样式以及 paddingToppaddingBottom 样式在行中定位渲染器。如果某一行上各列中项目的高度不等,则其它列表类不使用 verticalAlign,但项目渲染器可以检查此样式属性,并根据检查结果调整其布局。.
ListBase
 Inherited类型: String CSS 继承: no
从组件内容区域的中心到组件中心的垂直距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整其容器大小后,这两个中心将保持其垂直间距。

此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器(layout 属性设置为 absolute)中的组件上使用时才发挥作用。

默认值为 undefined,即不进行设置。

.
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
 Inherited类型: String CSS 继承: no
垂直 scrollbar 的样式名称。通过它,可以更精细地控制滚动条的外观。.
ScrollControlBase
  
verticalSeparatorSkin
类型: Class CSS 继承: no
用作定义 DataGrid 控件中各列之间的分隔符外观的外观的类。默认情况下,DataGrid 控件使用 drawHorizontalLine()drawVerticalLine() 方法绘制分隔符。 默认值为 undefined.
DataGrid
效果
 效果 说明 定义方
 Inherited 触发事件: added
将组件作为子项添加到 Container 时播放。
UIComponent
 Inherited 触发事件: creationComplete
创建组件时播放。
UIComponent
 Inherited 触发事件: focusIn
组件获得键盘焦点时播放。
UIComponent
 Inherited 触发事件: focusOut
组件失去键盘焦点时播放。
UIComponent
 Inherited 触发事件: hide
组件变为不可见时播放。
UIComponent
 Inherited 触发事件: mouseDown
用户在组件上方按下鼠标按键时播放。
UIComponent
 Inherited 触发事件: mouseUp
用户在组件上方释放鼠标按键时播放。
UIComponent
 Inherited 触发事件: move
移动组件时播放。
UIComponent
 Inherited 触发事件: removed
从 Container 中删除组件时播放。
UIComponent
 Inherited 触发事件: resize
调整组件大小时播放。
UIComponent
 Inherited 触发事件: rollOut
用户将鼠标指针滚离组件上方时播放。
UIComponent
 Inherited 触发事件: rollOver
用户将鼠标指针滚动到组件上方时播放。
UIComponent
 Inherited 触发事件: show
组件变为可见时播放。
UIComponent
公共常量
 常量定义方
 InheritedDEFAULT_MAX_HEIGHT : Number = 10000
[静态] maxHeight 属性的默认值。
UIComponent
 InheritedDEFAULT_MAX_WIDTH : Number = 10000
[静态] maxWidth 属性的默认值。
UIComponent
 InheritedDEFAULT_MEASURED_HEIGHT : Number = 22
[静态] measuredHeight 属性的默认值。
UIComponent
 InheritedDEFAULT_MEASURED_MIN_HEIGHT : Number = 22
[静态] measuredMinHeight 属性的默认值。
UIComponent
 InheritedDEFAULT_MEASURED_MIN_WIDTH : Number = 40
[静态] measuredMinWidth 属性的默认值。
UIComponent
 InheritedDEFAULT_MEASURED_WIDTH : Number = 160
[静态] measuredWidth 属性的默认值。
UIComponent
属性详细信息
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 属性或处理 itemEditBeginningitemEditBegin 事件。

默认值为 false.

editedItemPosition属性 
editedItemPosition:Object  [读写]

正在编辑的数据提供程序项目的项目渲染器的列索引和行索引(如果有)。

此 Object 包含 columnIndexrowIndex 两个字段,分别是项目的从零开始的行索引和列索引。例如:{ 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 控件中项目渲染器的引用。

itemEditBeginitemEditEnd 事件的事件侦听器中,您可以使用 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.dataFieldDataGridColumn.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 项目。如果 editablefalse,或 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.DataGridEvent
属性 DataGridEvent.type = mx.events.DataGridEvent.COLUMN_STRETCH

当用户更改列宽时调度,指示此列中显示的数据量可能会更改。如果 horizontalScrollPolicy 设置为 "off",则其它列将缩短或伸展以补偿该列的大小调整,同时这些列也会调度此事件。

DataGridEvent.COLUMN_STRETCH 常数可为 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.DataGridEvent
属性 DataGridEvent.type = mx.events.DataGridEvent.HEADER_RELEASE

当用户在列标题上释放鼠标按键以请求控件基于列内容对网格内容进行排序时调度。仅在列可排序且数据提供程序支持排序时才调度。DataGrid 控件具有此可实现单列排序的事件的默认处理函数。通过调用 preventDefault() 方法阻止单列排序,并设置数据提供程序的 sort 属性,可以实现多列排序。

注意:排序箭头由 headerRelease 事件的默认事件处理函数定义。如果在事件处理函数中调用 preventDefault() 方法,则不绘制箭头。

DataGridEvent.HEADER_RELEASE 常数可为 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.IndexChangedEvent
属性 IndexChangedEvent.type = mx.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.DataGridEvent
属性 DataGridEvent.type = mx.events.DataGridEvent.ITEM_EDIT_BEGIN

editedItemPosition 属性已设置且项目可编辑时调度。

DataGridEvent.ITEM_EDIT_BEGIN 常数可为 itemEditBegin 事件定义事件对象的 type 属性的值,指示项目可进行编辑。

此事件的默认侦听器执行下列操作:

您可以为此事件编写事件侦听器以修改传递到项目编辑器的数据。例如,您可以修改项目编辑器使用的数据、数据格式或其它信息。

您还可以创建事件侦听器以指定用于编辑项目的项目编辑器。例如,您可能有两个不同的项目编辑器。在事件侦听器中,您可以通过执行下列操作检查要编辑的数据或其它信息,并打开相应的项目编辑器:

  1. 调用 preventDefault() 以阻止 Flex 在默认事件侦听器中调用 createItemEditor() 方法。
  2. itemEditor 属性设置为相应编辑器。
  3. 调用 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.DataGridEvent
属性 DataGridEvent.type = mx.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.DataGridEvent
属性 DataGridEvent.type = mx.events.DataGridEvent.ITEM_EDIT_END

当项目编辑会话因任何原因而结束时调度。

DataGridEvent.ITEM_EDIT_END 常数可为 itemEditEnd 事件定义事件对象的 type 属性的值,指示编辑会话结束。

列表组件具有针对此事件的默认处理函数,此程序将数据从项目编辑器复制到 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.DataGridEvent
属性 DataGridEvent.type = mx.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.DataGridEvent
属性 DataGridEvent.type = mx.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
示例 如何使用示例
SimpleDataGrid.mxml
<?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>