mx.controls.advancedDataGridClasses.AdvancedDataGridRendererProvider (Flex 3.2)

（仅限 Flex 数据可视化组件）

包	mx.controls.advancedDataGridClasses
类	public class AdvancedDataGridRendererProvider
继承	AdvancedDataGridRendererProvider Object
实现	IAdvancedDataGridRendererProvider

AdvancedDataGridRendererProvider 实例定义由 AdvancedDataGrid 控件使用的单个项目渲染器的特征。使用 AdvancedDataGridRendererProvider 类的属性可配置 AdvancedDataGrid 控件中使用项目渲染器的位置。

下例使用 AdvancedDataGridRendererProvider 类在 myComponents 子目录中配置了名为 EstimateRenderer.mxml 的自定义项目渲染器。

<mx:AdvancedDataGrid>
      <mx:columns>
          <mx:AdvancedDataGridColumn dataField="Region"/>
          <mx:AdvancedDataGridColumn dataField="Territory_Rep"
              headerText="Territory Rep"/>
          <mx:AdvancedDataGridColumn dataField="Actual"/>
          <mx:AdvancedDataGridColumn dataField="Estimate"/>
      </mx:columns>
  
      <mx:rendererProviders>
          <mx:AdvancedDataGridRendererProvider 
              columnIndex="3"
              columnSpan="1" 
              renderer="myComponents.EstimateRenderer"/>
      </mx:rendererProviders>
  </mx:AdvancedDataGrid>

MXML 语法

隐藏 MXML 语法

The <mx:AdvancedDataGridRendererProvider> tag defines the following tag attributes:

  <mx:AdvancedDataGridRendererProvider
    Properties
    column="Not defined"
    columnIndex="-1"
    columnSpan="1"
    dataField="No default"
    depth="All depths of the tree"
    renderer="null"
    rowSpan="1"
  />

查看示例

另请参见

mx.controls.AdvancedDataGrid

	属性	定义方
		column : AdvancedDataGridColumn 使用渲染器的列的 ID。	AdvancedDataGridRendererProvider
		columnIndex : int = -1 使用渲染器的列索引，其中第一列的索引为 0。	AdvancedDataGridRendererProvider
		columnSpan : int = 1 指定渲染器应跨的列数。	AdvancedDataGridRendererProvider
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		dataField : String 渲染器的数据提供程序中的数据字段。	AdvancedDataGridRendererProvider
		depth : int = -1 在树中使用渲染器的深度，树最上面的节点的深度为 1。	AdvancedDataGridRendererProvider
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		renderer : IFactory 用于创建项目渲染器的实例的 ItemRenderer IFactory。	AdvancedDataGridRendererProvider
		rowSpan : int = 1 指定渲染器应跨的行数。	AdvancedDataGridRendererProvider

	方法	定义方
		AdvancedDataGridRendererProvider() 构造函数。	AdvancedDataGridRendererProvider
		describeRendererForItem(data:Object, dataDepth:int, column:AdvancedDataGridColumn, description:AdvancedDataGridRendererDescription):void 使用此 AdvancedDataGridRendererProvider 实例的相关信息更新 AdvancedDataGridRendererDescription 实例。	AdvancedDataGridRendererProvider
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

column

属性

public var column:AdvancedDataGridColumn

使用渲染器的列的 id。如果省略此属性，可以使用 columnIndex 属性指定列。

columnIndex

属性

public var columnIndex:int = -1

使用渲染器的列索引，其中第一列的索引为 0。

默认值为 -1.

columnSpan

属性

public var columnSpan:int = 1

指定渲染器应跨的列数。将此属性指定为 0 可以跨所有列。AdvancedDataGrid 控件利用此信息来设置项目渲染器的宽度。

默认值为 1.

dataField

属性

public var dataField:String

渲染器的数据提供程序中的数据字段。此属性是可选的。

depth

属性

public var depth:int = -1

在树中使用渲染器的深度，树最上面的节点的深度为 1。如果只能在树展开到一定深度时才使用渲染器，而不对树中的所有节点使用，请使用此属性。默认情况下，控件对树的所有级别使用渲染器。

renderer

属性

public var renderer:IFactory

用于创建项目渲染器的实例的 ItemRenderer IFactory。

rowSpan

属性

public var rowSpan:int = 1

指定渲染器应跨的行数。AdvancedDataGrid 控件使用此信息来设置渲染器的高度。

当前，在 AdvancedDataGrid 控件中未实现此属性。

默认值为 1.

构造函数详细信息

AdvancedDataGridRendererProvider

()

构造函数

public function AdvancedDataGridRendererProvider()

构造函数。

方法详细信息

describeRendererForItem

()

方法

 public function describeRendererForItem(data:Object, dataDepth:int, column:AdvancedDataGridColumn, description:AdvancedDataGridRendererDescription):void

使用此 AdvancedDataGridRendererProvider 实例的相关信息更新 AdvancedDataGridRendererDescription 实例。

参数

	`data:Object` — 要显示的数据项目。

	`dataDepth:int` — 数据项目在 AdvancedDataGrid 控件中的深度。

	`column:AdvancedDataGridColumn` — 与此项目相关联的列。

	`description:AdvancedDataGridRendererDescription` — 使用渲染器和列范围信息进行填充的 AdvancedDataGridRendererDescription 对象。

示例如何使用示例

AdvancedDataGridChartRendererExample.mxml

<?xml version="1.0"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

  <mx:Script>
    <![CDATA[
      import mx.collections.ArrayCollection;
                             
      [Bindable]
      private var dpHierarchy:ArrayCollection= new ArrayCollection([
        {name:"Barbara Jennings", region: "Arizona", total:70, children:[  
          {detail:[{amount:5},{amount:10},{amount:20},{amount:45}]}]},
        {name:"Dana Binn", region: "Arizona", total:130,  children:[ 
          {detail:[{amount:15},{amount:25},{amount:35},{amount:55}]}]},
        {name:"Joe Smith", region: "California", total:229,  children:[ 
          {detail:[{amount:26},{amount:32},{amount:73},{amount:123}]}]},
        {name:"Alice Treu", region: "California", total:230, children:[ 
          {detail:[{amount:159},{amount:235},{amount:135},{amount:155}]}
        ]}
      ]);                                            
    ]]>
  </mx:Script>

    <mx:Panel title="OLAPCube Control Example"
        height="75%" width="75%" layout="horizontal"
        paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10">

      <mx:AdvancedDataGrid id="myADG" 
          width="100%" height="100%" 
          variableRowHeight="true">
          <mx:dataProvider>
             <mx:HierarchicalData source="{dpHierarchy}"/>
          </mx:dataProvider>
          <mx:columns>
              <mx:AdvancedDataGridColumn dataField="name" headerText="Name"/>
              <mx:AdvancedDataGridColumn dataField="total" headerText="Total"/>
          </mx:columns>   
            
          <mx:rendererProviders>            
              <mx:AdvancedDataGridRendererProvider 
                  dataField="detail" 
                  renderer="ChartRenderer" 
                  columnIndex="0"
                  columnSpan="0"/>         
          </mx:rendererProviders>   
        </mx:AdvancedDataGrid>
    </mx:Panel>
    
</mx:Application>

ChartRenderer.mxml

<?xml version="1.0"?>
<!-- dpcontrols/adg/myComponents/ChartRenderer.mxml -->
<mx:VBox height="200" width="100%" xmlns:mx="http://www.adobe.com/2006/mxml">
    <mx:PieChart dataProvider="{data.detail}"
        width="100%"
        height="100%"
        showDataTips="true">
        <mx:series>
            <mx:PieSeries labelPosition="callout" field="amount"  />
        </mx:series>
    </mx:PieChart>    
</mx:VBox>

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
AdvancedDataGridRendererProvider	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例