PieSeries  - AS3 Flex

データ値を 0 と 2 PI 間の角度にマッピングするために使用される軸オブジェクトです。 デフォルトでは、autoAdjust プロパティが false の線状軸になります。 したがって、データ値はグラフに均等にマッピングされます。

0 から 1 までの数値です。円系列の全区分をグラフの中心からどのくらい分離するかを全半径のパーセンテージで指定します。

この値は、円系列の全区分を均一に分離する値です。 perWedgeExplodeRadius プロパティでは、この分離する値を区分ごとに設定できます。

各区分の分離半径は、explodeRadius プロパティの値に、perWedgeExplodeRadius 配列内のそれぞれの区分の値を加えたものになります。

円系列をグラフの境界内に留める一方、各区分を取り出せるようにする目的で、円グラフの全半径が縮小されることがあります。 実行時に動的に区分を取り出すと、円グラフの全半径が縮小されます。 この影響を回避するには、実行時に設定しようとしている最大分離半径を reserveExplodeRadius プロパティの値として指定することにより、領域を "予約" して、あらかじめ全半径を縮小しておきます。

PieChart コントロールの各区分のデータを決定するデータプロバイダーのフィールドを指定します。

デフォルト値： null。

系列内の現在のグラフアイテムの塗りを返すメソッドを指定します。 このプロパティを設定すると、カスタムの塗り関数の戻り値は fills スタイルプロパティよりも優先されます。 ただし null が返された場合は、fills が優先されます。

カスタムの fillFunction には、次のシグネチャがあります。

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

カスタマイズした fillFunction の使用方法の例としては、任意のしきい値に基づく塗りを返させることができます。

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

グラフ系列にカスタムの塗り関数を指定した場合に、Legend コントロールを使用するには、手動で Legend コントロールを作成してそれに LegendItems を追加する必要があります。

この系列が個々のアイテムを表現する場合に使用する ChartItem のサブタイプです。 アイテムにさらに情報を格納する必要がある場合には、サブクラスでオーバーライドし、さらに特化したクラスを返すことができます。

値がラベルとして表示される、データプロバイダー内のフィールドの名前です。labelFunction が指定されている場合は無視されます。

PieSeries の各ラベルのレンダリングに使用されるコールバック関数を指定します。 コールバック関数の形式を以下に示します。

      function_name(data:Object, field:String, index:Number, percentValue:Number):String { ... }
      

ラベルに割り当て可能な PieSeries の半径の最大値です。 この値は、系列がコールアウトラベルをレンダリングしているときにのみ適用できます。

コールアウトラベルをレンダリングすると、ラベルを両側に配置するための領域が確保されるよう、区分の半径が小さくなります。 ラベルに割り当てられた領域がこの上限値に達すると、最大サイズ内に留まるよう、ラベルのサイズが小さくなります。

PieChart コントロールの各区分の名前を決定するデータプロバイダーのフィールドを指定します。

デフォルト値： null。

領域全体のうち PieSeries が系列の内容をレンダリングする場合に使用可能な領域の割合です。 この値はグラフによって管理されるため、直接割り当てないでください。

値の範囲は 0 から 1 になります。

0 から 1 までの数値の配列です。円系列の各区分をグラフの中心からどのくらい分離するかを全半径のパーセンテージで指定します。

この配列の n 番目の値は、n 番目の区分に対応しています。 例えば、3 番目の区分を半径の 1/2 だけ分離するには、perWedgeExplodeRadius = [ 0, 0, 50]; のように値を割り当てます。

配列内の null 値または欠損値は、0 として扱われます。

円系列をグラフの境界内に留める一方、各区分を取り出せるようにする目的で、円グラフの全半径が縮小されることがあります。

実行時に動的に区分を取り出すと、円グラフの全半径が縮小されます。 この影響を回避するには、実行時に設定しようとしている最大分離半径を reserveExplodeRadius プロパティの値として指定することにより、領域を "予約" して、あらかじめ全半径を縮小しておきます。

perWedgeExplodeRadius 配列内の個々の区分の値が、系列の explodeRadius プロパティの値に追加され、該当の区分に対する分離半径の合計が計算されます。

この系列がレンダリングに必要な全データを格納する場合に使用する ChartRenderData のサブタイプです。 レンダリング用にさらに情報を格納する必要がある場合には、サブクラスでオーバーライドし、さらに特化したクラスを返すことができます。

0 から 1 までの数値です。円系列の全半径のうち実行時に区分を分離するために予約しておく割合を指定します。 区分を分離するときには、グラフの境界を超えないよう、円グラフの全半径を縮小する必要があります。 このため、開発者が実行時に区分の分離値を変更した場合、区分を 1 つだけ取り出すという所期の効果が得られるのではなく、全区分を効率よく縮小できるようになります。 これを回避するには、実行時に区分を最大でどのくらい分離するのかを reserveExplodeRadius に設定します。

PieChart コントロールの最初の区分の開始角度を指定します。 デフォルト値は 0 で、PieChart コントロール右側が水平になります。

コンストラクターです。

パラメーター

パラメーター

パラメーター