Series  - AS3 Flex

指定一个返回数值的方法，该数值用于在系列中放置当前图表项目。如果已经设置了此属性，则对于 AreaSeries、BarSeries、BubbleSeries、ColumnSeries、LineSeries 和 PlotSeries 来说，自定义数据函数的返回值将优先于其他相关属性，如 xField 和 yField。对于 BubbleSeries 来说，该返回值优先于 radiusField 属性。对于 PieSeries 来说，该返回值优先于 field 属性。

系列的自定义 dataFunction 包含以下签名：

     function_name (series:Series, item:Object, fieldName:String):Object { ... }
     

通常可以使用 dataFunction 属性来访问数据提供程序中嵌套的字段（非标量值）。例如，下列数据需要使用数据函数才能访问图表的数据提供程序中的字段：

      {month: "Aug", close: {High:45.87,Low:12.2}, open:25.19}
      

以下示例返回来自此数据提供程序的值：

     public function myDataFunction(series:Series, item:Object, fieldName:String):Object {
          if (fieldName == 'yValue')
              return(item.close.High);
          else if (fieldName == "xValue")
              return(item.month);
          else
              return null;
     }     
     

一个图表项目数组，将在图表上以非交互方式为这些项目显示数据提示。

与元素关联的 DataTransform 对象。DataTransform 对象给出一组元素与一组轴对象之间的关系，用于将这些元素从数据空间转换到屏幕坐标，然后返回。图表元素使用其关联的 DataTransform 对象，来设计显示其数据的方法。

显示给用户的系列名称。此属性用于表示用户可见的标签中的系列，如数据提示。

如果设置了 filterFuction 或 filterDataValues，则会忽略 filterData。如果在显示系列之前对数据进行筛选，则为 true。如果系列呈示的数据中包含缺失值（如 null、undefined 或 NaN），或者呈示的值超出了图表轴范围，则应将此属性设置为 true（默认设置）。如果您获知系列中的所有数据都有效，则可以将此属性设置为 false 以提高性能。

如果设置了 filterFuction，则会忽略 filterDataValues 和 filterData。如果将 filterDataValues 属性设置为 none，则系列将在显示之前不过滤其数据。如果将 filterDataValues 设置为 null，则系列会在显示之前过滤诸如 null、undefined 或 NaN 等数据。如果将此属性设置为 outsideRange，则系列会过滤诸如 null、undefined 或 NaN 等数据以及图表轴范围之外的值。如果您获知系列中的所有数据都有效，则可以将此属性设置为 none 以提高性能。

指定一种方法，用于返回系列中要显示的图表项的数组。如果已设置此属性，则自定义过滤函数的返回值将优先于 filterDataValues 和 filterData 属性。但是，如果返回 null，则按该顺序将优先选择 filterDataValues 和 filterData。

自定义 filterFunction 包含以下签名：

     function_name (cache:Array):Array { ... }
     

     public function myFilterFunction(cache:Array):Array {
          var filteredCache:Array=[];
          var n:int = cache.length;  
          for(var i:int = 0; i < n; i++)
          {
              var item:ColumnSeriesItem = ColumnSeriesItem(cache[i]);
              if(item.yNumber > 0 && item.yNumber < 700)
              {
                  filteredCache.push(item);
              }
          }
          return filteredCache;
     }
     

如果为图表系列指定自定义过滤函数，且希望过滤 null 值或轴范围之外的值，则必须使用自定义过滤函数手动进行过滤。无法使用 filterDataValues 或 filterData。

确定当用户与屏幕上的图表数据进行交互时是否显示数据提示。设置为 false 可阻止系列显示数据提示或生成点击数据。

默认值为 true。

获取系列中筛选之后所得的所有项目。

单个系列确定要返回的项目列表。

一个 LegendData 实例 Array，描述应在表示此系列的图例中显示的项目。派生的系列类会覆盖此 getter 函数并返回特定于其样式和数据表示方法的图例数据。虽然大多数系列类型仅返回一个 LegendData 实例，但仍有部分系列类型（如 PieSeries 和 StackedSeries）会返回多个实例，表示 Array 中的各个项目或多种数据呈示方式。

存储必要信息以呈示此系列。

指示系列是否可选。

默认值为 true。

系列的数据提供程序中所选项目的索引。如果选择了多个项目，则此属性指示最近选择的项目。

系列的数据提供程序中所选项目的索引 Array。

系列中选定的图表项目。如果选择了多个项目，则此属性指示最近选择的项目。

系列中选定的图表项目 Array。

通过运行过渡传入的呈示数据结构。如果系列效果设置为对某一系列起作用，它将首先通过请求其呈示数据来捕获系列的当前状态。此过渡修改呈示数据以创建所需的效果，并将结构传回系列以供显示。如果 transitionRenderData 属性的值并非 null，则系列将使用其内容更新其显示。

构造函数。

此方法由 SeriesInterpolate 效果调用，用以启动 interpolation 效果。此效果传入源数据和目标数据，以便系列在二者之间进行插补。此效果将该方法的返回值重复传递给系列的 interpolate() 方法，以改进呈示此效果期间的动画效果。此系列计算执行 interpolation 所需的数据，并在此方法中将其返回。

参数

将存储在原始 dataProvider 项目的 measureName 属性中的值缓存到图表项目的 fieldName 属性中。如果 measureName 属性的值为 null 或空字符串，则此方法假设原始数据提供者项目是原始值，并改为对其进行缓存。

参数

将存储在原始 dataProvider 项目的 measureName 属性中的值缓存到图表项目的 fieldName 属性中。如果 measureName 属性为 null 或空字符串，则此方法将存储 fieldName 属性中的项目索引。

参数

将存储在原始 dataProvider 项目的 measureName 属性中的值缓存到图表项目的 fieldName 属性中。

参数

图表调用此方法来允许相关元素声明其 chartSeriesStyles Array 中的样式选择器。每个图表都有一组相关的选择器，这些选择器被隐式分配给图表中包含的需要它们的元素中。实现此函数可以使元素根据需要“声明”该组中的元素。需要 N 个样式选择器的元素声明值介于 styles[firstAvailable] 和 styles[firstAvailable + N - 1] 之间。

参数

处理对组件设置的属性。此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。

您无需直接调用此方法。当您使用 addChild() 方法向容器中添加组件时，或调用组件的 invalidateProperties() 方法时，Flex 都会调用 commitProperties() 方法。应在调用 measure() 方法之前调用 commitProperties() 方法。这允许您设置 measure() 方法可能会用到的属性值。

一些组件的属性可能会影响需要创建的子对象的数目或种类，也有些组件的属性彼此之间会相互影响（例如 horizontalScrollPolicy 和 horizontalScrollPosition 属性）。通常，最好在启动时一次性处理所有这些属性以避免重复工作。

如果您没有将自定义函数设置为这些系列的 filterFunction，则会使用此方法。单独的系列应该覆盖此方法。

参数

dragStart 事件的默认处理函数。

参数

此方法由 SeriesInterpolate 效果调用，用以结束 interpolation 效果。这种效果使用此方法来完成 interpolation，并清除与此效果关联的所有临时状态。

参数

提取最小值和最大值，还可以提取与 ChartItem 对象 Array 的最小间隔。派生的类可以通过实现 describeData() 方法来调用此方法，以填充 DataDescription 结构的详细信息。

参数

提取最小值和最大值，还可以提取与 ChartItem 对象 Array 的最小间隔。派生的类可以通过实现 describeData() 方法来调用此方法，以填充 DataDescription 结构的详细信息。

参数

通常应通过已命名属性来直接检索 Axis 实例（如基于笛卡尔的系列 horizontalAxis、verticalAxis 或 radiusAxis）。

这是一个低级存取器。

参数

填充由该系列生成的 renderData 结构的 elementBounds、bounds 和 visibleBounds 属性。效果类调用此方法来填充这些字段，用于实现各种效果类型。仅当被请求时，派生的类才应该实现此方法，以生成系列项目的绑定。

参数

获取此系列矩形区域中的所有项目。调用此函数以确定该系列特定矩形区域中包含的项目。

各系列都可确定其图表项目是否在其区域中。点应位于全局坐标空间内。

参数

相关 API 元素

在 interpolation 结构中填充缺失值。当系列调用 initializeInterpolationData() 方法时，会为 interpolation 传递源值和目标值数组。如果其中一个数组不完整，则此系列必须为 interpolation 提供“适当的”占位符值。这些占位符值是特定于系列类型确定的。系列扩展者应覆盖此方法，以提供上述占位符值。

参数