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 が nulls に設定されている場合、系列の 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 インスタンスの配列です。 派生系列クラスはこの getter をオーバーライドするものであり、それぞれのクラスのスタイルおよびデータ表現メソッドに固有の凡例データを返します。 ほとんどの系列タイプが LegendData インスタンスを 1 つだけ返すのに対して、PieSeries や StackedSeries などの系列タイプのように、配列内の個別のアイテムを示す複数のインスタンスを返すものやいくつもの方法でデータをレンダリングするものもあります。

この系列のレンダリングに必要な情報を格納します。

系列が選択可能かどうかを指定します。

デフォルト値： true。

系列のデータプロバイダー内の選択されたアイテムのインデックスです。 複数のアイテムが選択されている場合、このプロパティは最も新しく選択されたアイテムを指定します。

系列のデータプロバイダー内の選択されたアイテムのインデックスの配列です。

系列内の選択されたグラフアイテムです。 複数のアイテムが選択されている場合、このプロパティは最も新しく選択されたアイテムを指定します。

系列内の選択されたグラフアイテムの配列です。

実行中のトランジションによって渡されるレンダリングデータ構造です。 系列で再生するように系列のエフェクトが設定されると、まずこのレンダリングデータを調べて系列の現在の状態が取得されます。 トランジションでは、レンダリングデータを変更して必要なエフェクトが作成され、その構造が表示する系列に戻されます。 transitionRenderData プロパティ値が null でない場合、系列ではその内容を使用して表示が更新されます。

コンストラクターです。

補間エフェクトを開始するために SeriesInterpolate エフェクトによって呼び出されます。 このエフェクトは、補間する範囲の系列のソースと宛先のデータを渡します。エフェクトは、このメソッドの戻り値を系列の interpolate() メソッドに繰り返し渡すことによって、このエフェクトの間のアニメーションを更新します。 系列は補間を実行するために必要なデータを算出し、それをこのメソッドに戻します。

パラメーター

元の dataProvider アイテムから measureName プロパティに格納された値をグラフアイテムの fieldName プロパティにキャッシュします。 measureName プロパティの値が null または空のストリングの場合は、元のデータプロバイダーアイテムは生の値と見なされ、これらの値が代わりにキャッシュされます。

パラメーター

元の dataProvider アイテムから measureName プロパティに格納された値をグラフアイテムの fieldName プロパティにキャッシュします。 measureName プロパティが null または空のストリングの場合は、代わりに fieldName プロパティのアイテムのインデックスが格納されます。

パラメーター

元の dataProvider アイテムから measureName プロパティに格納された値をグラフアイテムの fieldName プロパティにキャッシュします。

パラメーター

関連付けられたエレメントで chartSeriesStyles の配列からスタイルセレクターを要求できるようにするために、グラフによって呼び出されます。 各グラフには、セレクターを必要とするグラフのエレメントに暗黙的に割り当てられる、関連付けられたセレクターのセットがあります。 この関数を実装すると、必要に応じて、エレメントがこのセットからエレメントに "要求" を行うことができます。 N スタイルセレクターを必要とするエレメントは、styles[firstAvailable] から styles[firstAvailable + N - 1] までの値を要求します。

パラメーター

コンポーネントに設定されたプロパティを処理します。これは、UIComponent のサブクラスを作成するときにオーバーライド可能な高度なメソッドです。

このメソッドは直接呼び出さないでください。 commitProperties() メソッドは、addChild() メソッドを使用してコンポーネントがコンテナに追加されたとき、またはコンポーネントの invalidateProperties() メソッドが呼び出されたときに、Flex によって呼び出されます。commitProperties() メソッドの呼び出しは、measure() メソッドの呼び出しの前に実行されます。このため、measure() メソッドが使用する可能性のあるプロパティの値を設定することができます。

一部のコンポーネントには、作成する必要のある子オブジェクトの数や種類に影響するプロパティがあります。また、horizontalScrollPolicy プロパティと horizontalScrollPosition プロパティのように相互に作用し合うプロパティを持つコンポーネントもあります。多くの場合、作業の重複を避けるため、起動時にこれらのプロパティを一度に処理することが最善です。

系列の filterFunction としてカスタム関数を設定しない場合に使用されます。この設定は個々の系列で上書きする必要があります。

パラメーター

dragStart イベントのデフォルトハンドラーです。

パラメーター

補間エフェクトを終了するために SeriesInterpolate エフェクトによって呼び出されます。 エフェクトはこのメソッドを使用して補間を完了し、このエフェクトに関連付けられた一時的状態があればそれをクリーンアップします。

パラメーター

ChartItem オブジェクトの配列から最小値および最大値を抽出するだけでなく、オプションで最小間隔を抽出することもできます。 派生クラスによって、その describeData() メソッドの実装からこのメソッドを呼び出して、DataDescription 構造の詳細を入力することができます。

パラメーター

ChartItem オブジェクトの配列から最小値および最大値を抽出するだけでなく、オプションで最小間隔を抽出することもできます。 派生クラスによって、その describeData() メソッドの実装からこのメソッドを呼び出して、DataDescription 構造の詳細を入力することができます。

パラメーター

通常は、名前付きプロパティ (直交ベースの系列の horizontalAxis、verticalAxis または radiusAxis など) により軸インスタンスを直接取得します。

これは低レベルのアクセッサーです。

パラメーター

この系列で生成された renderData 構造の elementBounds、bounds および visibleBounds の各プロパティに値を入力します。 エフェクトクラスは、様々なエフェクトタイプの実装に使用される各フィールドに値を入力するためにこのメソッドを呼び出します。 要求されたときにのみ系列のアイテムの境界を生成するには、派生クラスにこのメソッドを実装する必要があります。

パラメーター

系列の矩形領域内にあるすべてのアイテムを取得します。 この関数は、どのアイテムが系列内で特定の矩形領域にあるかを判断するために呼び出します。

個々の系列によって、それぞれのグラフアイテムが領域の下にあるかどうかが決まります。 ポイントは、グローバルな座標空間内にある必要があります。

パラメーター

関連する API エレメント

補間構造内の欠損値を埋めます。 系列が initializeInterpolationData() メソッドを呼び出す場合、補間のためのソースと宛先の値の配列を渡します。 これらの 2 つの配列のいずれかが不完全である場合、系列は補間のための "適切な" プレースホルダーを提供する必要があります。 これらのプレースホルダーーが決定される方法は、系列のタイプに固有です。 系列エクステンダーは、このメソッドをオーバーライドして、これらのプレースホルダー値を提供する必要があります。

パラメーター