BubbleSeries  - AS3 Flex

指定返回系列中当前图表项目的填充的方法。如果已设置此属性，则自定义填充函数返回的值将优先于 fill 和 fills 样式属性。但是，如果返回 null，则在该顺序中将优先选择 fills 和 fill。

自定义 fillFunction 包含以下签名：

     function_name (item:ChartItem, index:Number):IFill { ... }
     

自定义的 fillFunction 的使用示例是基于某些阈值返回填充。

     public function myFillFunction(item:ChartItem, index:Number):IFill {
          var curItem:BubbleSeriesItem = BubbleSeriesItem(item);
          if (curItem.zNumber > 10)
              return(new SolidColor(0x123456, .75));
          else
              return(new SolidColor(0x563412, .75));
     }
     

如果您为图表系列指定了自定义填充函数，并希望包含 Legend 控件，则必须手动创建 Legend 控件，然后向其中添加 LegendItems。

为 x 轴上的项定义标签、刻度线和数据位置。使用 LinearAxis 类或 CategoryAxis 类可以设置 horizontalAxis 的属性，将其作为 MXML 中的子标签，或者在 ActionScript 中创建一个 LinearAxis 或 CategoryAxis 对象。

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

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

此系列用于表示各项目的 ChartItem 的子类型。如果子类需要在项目中存储其它信息，则可以覆盖和返回更特定化的类。

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

在此系列中呈示的最大项目的半径。在 BubbleChart 中使用 BubbleSeries 对象时，图表会自动将其 maxRadius 样式值分配给图表中所有系列的此属性。在 CartesianChart 控件中使用 BubbleSeries 对象时，您可以手动管理此属性。

在此系列中呈示的最小项目的半径。在 BubbleChart 中使用 BubbleSeries 对象时，图表会自动将其 minRadius 样式值分配给图表中所有系列的此属性。在 CartesianChart 控件中使用 BubbleSeries 对象时，您可以手动管理此属性。

模块工厂用作上下文，用于为此组件使用嵌入字体以及查找用于控制此组件样式的样式管理器。

冒泡半径映射的轴。冒泡图表将各个冒泡的大小视为数据的第三个尺寸，其转换方式与 x 和 y 位置的转换方式相似。默认情况下，radiusAxis 为 LinearAxis，其中 autoAdjust 属性设置为 false。

指定相对于图表中的其它数据点确定每个元件半径的数据提供程序字段。

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

此系列用于存储所有必须呈示的数据的 ChartRenderData 子类型。如果子类需要存储其它信息以供显示，则可以覆盖和返回更特定化的类。

为 y 轴上的项目定义标签、刻度线和数据位置。使用 LinearAxis 类或 CategoryAxis 类可将 verticalAxis 的属性设置为 MXML 中的子标签，也可以在 ActionScript 中创建 LinearAxis 或 CategoryAxis 对象。

指定用于确定每个数据点的 x 轴位置的数据提供程序字段。如果为 null，则 Flex 将按数据点在数据提供程序中的显示顺序来呈示它们。

默认值为 null。

指定用于确定每个数据点的 y 轴位置的数据提供程序字段。如果为 null，则 BubbleSeries 将假定数据提供程序为数字 Array，并使用这些数字作为数据点的值。

默认值为 null。

构造函数。

对指定的 DisplayObject 应用样式属性。此方法是 InstanceCache 在创建新呈示器时调用的回调。

参数

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

参数

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

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

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

由具有控制地位的 DataTransform 调用，以获得由此 IChartElement 表示的数据描述。实现器填充并返回 mx.charts.chartClasses.DataDescription 对象 Array，以保证它们的数据能够按任一条轴进行正确显示，而这里的轴是根据所显示的数据（如最小值、最大值、间隔和单位大小）自动生成值的。多数元素类型都会返回包含一个 DataDescription 的 Array。聚合元素（如 BarSet 和 ColumnSet）可能会返回多个 DataDescription 实例，用于描述由其子元素显示的数据。调用此方法时，实现器会沿 dimension 参数说明的轴显示数据。对于所包含的图表支持的每条轴，都有可能调用此函数。

参数

在给定坐标“下方”查找由该元素表示的最近数据点。

此方法将返回描述范围内数据点的 HitData 结构的数组。如果能够保证 dataPoint 不重叠，则各个 ChartElement 可以选择仅返回一个 dataPoint。

参数

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

参数

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

参数

检测对样式属性的更改。设置任何样式属性后，Flex 将调用 styleChanged() 方法，向其传递所设置样式的名称。

此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。创建自定义组件时，可以覆盖 styleChanged() 方法，以检查传递给它的样式名称，并对更改进行相应处理。这允许您覆盖现有样式的默认行为或添加自己的自定义样式属性。

如果您处理样式属性，覆盖 styleChanged() 方法时应调用 invalidateDisplayList() 方法，以使 Flex 在下次更新屏幕时执行组件的 updateDisplayList() 方法。

参数

当系列表示的基础数据发生更改，并且需要重新从数据提供程序加载时调用此方法。若要实现一个自定义系列类型，则应覆盖此方法，并加载从备用数据提供程序中呈示系列的必要数据。您还必须确保在子类中调用 super.updateData() 方法。通常不直接调用此方法，而是调用 Series 类的 validateData() 方法，从而保证您的数据已在给定点进行了更新。

绘制对象和/或设置其子项的大小和位置。此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。

您无需直接调用此方法。使用 addChild() 方法将组件添加到容器时，以及调用组件的 invalidateDisplayList() 方法时，Flex 将调用 updateDisplayList() 方法。

如果组件没有子项，您就可以借助此方法使用针对组件的 Graphics 对象（如 graphics.drawRect()）上的一些方法以编程方式进行绘制。

如果组件有子项，您就可以借助此方法调用其子项上的 move() 和 setActualSize() 方法。

组件可以通过编程方式进行绘制，即使组件有子项时也不例外。在上述任一操作中，您都应使用组件的 unscaledWidth 和 unscaledHeight 作为其边界。

请注意，您应使用 unscaledWidth 和 unscaledHeight 属性而不是 width 和 height 属性，这很重要。

参数

当系列表示的基础数据需要根据由相关的数据转换轴表示的范围进行过滤时，调用此方法。这适用于以下情况：基础数据发生更改；关联轴的范围发生更改。若要实现一个自定义系列类型，则应覆盖此方法，并使用由自身的关联数据转换管理的轴的 filterCache() 方法筛选出超出范围的数据。filterCache() 方法将所有超出范围的值转换为 NaN。您必须确保在子类中调用了 super.updateFilter() 方法。通常不直接调用此方法，如果需要保证您的数据已在给定点进行了筛选，则调用 Series 类的 validateTransform() 方法。通常情况下，您可以假定调用此方法之前已经调用了 updateData() 和 updateMapping() 方法（如有必要）。

当需要将此系列表示的基础数据映射到数字表示形式时调用此方法。这适用于以下情况：基础数据发生更改；用于呈示系列的轴发生了某种相关更改。若要实现一个自定义系列，则应覆盖此方法，并使用由自身的关联数据转换管理的轴的 mapCache() 方法，将表示的数据转换为数值。您还必须确保在子类中调用了 super.updateMapping() 方法。通常不直接调用此方法，而是调用 Series 类的 validateData() 方法，从而保证您的数据已在给定点进行了映射。通常情况下，您可以假定调用此方法之前已经调用了 updateData() 方法（如有必要）。

当需要按关联数据转换的轴将由系列表示的基础数据转换为屏幕值时，调用此方法。这适用于以下情况：基础数据发生更改；关联轴的范围发生更改；屏幕上的区域大小发生更改。若要实现一个自定义系列类型，则应覆盖此方法，并使用关联数据转换的 transformCache() 方法转换数据。您必须确保在子类中调用 super.updateTransform() 方法。通常不直接调用此方法，如果需要保证您的数据已在给定点进行了筛选，则调用 Series 类的 valiateTransform() 方法。通常情况下，您可以假定调用此方法之前，已经调用了 updateData()、updateMapping() 和 updateFilter() 方法（如有必要）。

半径轴的类型。