(Flex データ視覚化コンポーネントのみ)
パッケージmx.charts.chartClasses
クラスpublic class NumericAxis
継承NumericAxis Inheritance AxisBase Inheritance EventDispatcher Inheritance Object
実装 IAxis
サブクラス DateTimeAxis, LinearAxis, LogAxis

NumericAxis クラスは、軸タイプの共通基本クラスとして動作し、定義された最小値および最大値の間の連続する範囲を表します。 組み込みの LinearAxis、LogAxis、および DateTimeAxis クラスはすべて、この基本クラスを拡張します。

関連項目

mx.charts.DateTimeAxis
mx.charts.LinearAxis
mx.charts.LogAxis
About the NumericAxis class
Adding axis titles
Defining axis labels


パブリックプロパティ
 プロパティ定義元
  autoAdjust : Boolean
Flex で値の四捨五入が行われるかどうかを指定します。
NumericAxis
  baseAtZero : Boolean
Flex で minimum および maximum の値を 0 のままにするかどうかを指定します。
NumericAxis
  baseline : Number
[読み取り専用] 計算された軸の最小値です(この値が 0 より大きい場合に限り)。
NumericAxis
 InheritedchartDataProvider : Object
[書き込み専用] 周りを囲むグラフに割り当てられたデータプロバイダです。
AxisBase
  computedMaximum : Number
この軸が表す計算された最大値です。
NumericAxis
  computedMinimum : Number
この軸が表す計算された最小値です。
NumericAxis
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 InheriteddisplayName : String
軸の名前です。
AxisBase
  labelFunction : Function
ラベルとして表示するために、軸の値をフォーマットするために呼び出されます。
NumericAxis
  minorTicks : Array
[読み取り専用] この軸を表すために生成された小さな目盛りの配列です。
NumericAxis
  padding : Number
値を画面上にレンダリングする際に、計算された軸の最小値および最大値に追加するスペースを指定します。
NumericAxis
  parseFunction : Function
グラフによりレンダリングされた値の数値への変換方法をカスタマイズする parseFunction を指定します。
NumericAxis
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 Inheritedtitle : String
軸に沿って表示されるタイトルのテキストです。
AxisBase
 InheritedunitSize : Number
[読み取り専用] この軸に表示されるデータの 1 単位のサイズです。
AxisBase
プロテクトプロパティ
 プロパティ定義元
  assignedMaximum : Number
明示的に割り当てられた最大値です。
NumericAxis
  assignedMinimum : Number
明示的に割り当てられた最小値です。
NumericAxis
  computedInterval : Number
この軸が表す計算された間隔です。
NumericAxis
  dataDescriptions : Array
[読み取り専用] グラフで表されるデータを記述した DataDescription 構造体の配列です。
NumericAxis
  labelCache : Array
この軸を表すために生成された AxisLabel オブジェクトの最新のセットです。
NumericAxis
  labelMaximum : Number
ラベルが配置される最大値です。
NumericAxis
  labelMinimum : Number
ラベルが配置される最小値です。
NumericAxis
  minorTickCache : Array
この軸を表すために生成された、小さな目盛りの最新のセットです。
NumericAxis
  requiredDescribedFields : uint
[読み取り専用] この軸に影響する DescribeData 構造体のフィールドです。
NumericAxis
  ticks : Array
[読み取り専用] この軸で使用される小さな目盛りの配列です。
NumericAxis
パブリックメソッド
 メソッド定義元
  
コンストラクタです。
NumericAxis
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
グラフデータが変更されたときに、範囲のオブジェクトに通知を送るイベントをトリガします。
AxisBase
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
  
filterCache(cache:Array, field:String, filteredString:String):void
任意のタイプの値のセットにフィルタをかけ、マップできる数字のセットにします。
NumericAxis
  
DataTips での表示用に値をフォーマットします。
NumericAxis
  
軸ラベルを予測するための範囲を決定します。
NumericAxis
  
getLabels(minimumAxisLength:Number):AxisLabelSet
レンダリングされるラベルテキストを取得します。
NumericAxis
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
  
軸に対する位置を数値データの値にマップして戻します。
NumericAxis
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
mapCache(cache:Array, field:String, convertedField:String, indexValues:Boolean = false):void
任意のタイプの値のセットを、画面の座標に換算できる数値のセットに変換します。
NumericAxis
  
軸による重なるラベルの処理方法を決定します。
NumericAxis
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
  
reduceLabels(intervalStart:AxisLabel, intervalEnd:AxisLabel):AxisLabelSet
AxisRenderer がラベルを重ならないようにレンダリングできず、Axis オブジェクトによりラベルのセットが減らされるようにする場合に起動されます。
NumericAxis
 Inherited
軸を使用する各 DataTransform が、その軸に自動的に登録されます。
AxisBase
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
  
transformCache(cache:Array, field:String, convertedField:String):void
値のセットをデータ領域からスクリーン領域にマップします。
NumericAxis
 Inherited
軸を使用する各 DataTransform が、その軸に自動的に登録されます。
AxisBase
  
グラフを更新します。
NumericAxis
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
プロテクトメソッド
 メソッド定義元
  
adjustMinMax(minValue:Number, maxValue:Number):void
軸のラベルの生成または割り当て範囲を調整します。
NumericAxis
  
軸の現在の値を表すラベルで labelCache プロパティの値を設定します。
NumericAxis
  
この軸によって生成される小さな目盛りの配列に対する位置の配列を構築します。
NumericAxis
 Inherited
describeData(dimension:String, requiredFields:uint):Array
この IChartElement で表されるデータの記述を取得するために、管理する DataTransform によって呼び出されます。
AxisBase
  
この軸タイプについて、所定の範囲を無効な値から保護します。
NumericAxis
  
この軸の値を表すキャッシュされたラベルおよび目盛りを無効化します。
NumericAxis
イベント
 イベント 概要 定義元
 Inherited[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
プロパティの詳細
assignedMaximumプロパティ
protected var assignedMaximum:Number

明示的に割り当てられた最大値です。 値が割り当てられない場合、この値は NaN となります。 通常、計算は computedMaximum フィールドで実行されます。

assignedMinimumプロパティ 
protected var assignedMinimum:Number

明示的に割り当てられた最小値です。 値が割り当てられない場合、この値は NaN となります。 通常、計算は computedMinimum フィールドで実行されます。

autoAdjustプロパティ 
autoAdjust:Boolean

Flex で値の四捨五入が行われるかどうかを指定します。 false の場合、minimum プロパティおよび maximum プロパティで設定された値は四捨五入されず、また、デフォルトの minimummaximum の値も修正されません。

デフォルト値 : true.



実装
    public function get autoAdjust():Boolean
    public function set autoAdjust(value:Boolean):void
baseAtZeroプロパティ 
baseAtZero:Boolean

Flex で minimum および maximum の値を 0 のままにするかどうかを指定します。 軸の値がすべて正の場合は、軸の最小値がゼロになります。 軸の値がすべて負の場合は、軸の最大値がゼロになります。

デフォルト値 : true.



実装
    public function get baseAtZero():Boolean
    public function set baseAtZero(value:Boolean):void
baselineプロパティ 
baseline:Number  [読み取り専用]

計算された軸の最小値です(この値が 0 より大きい場合に限り)。 最大値が 0 以下の場合、baseline プロパティは計算された最大値となります。 いずれの値も 0 より大きい場合、baseline プロパティは 0 となります。



実装
    public function get baseline():Number
computedIntervalプロパティ 
protected var computedInterval:Number

この軸が表す計算された間隔です。 computedInterval は、AxisRenderer クラスおよび Gridlines クラスにより、目盛りとグリッド線をレンダリングする場所を決定する場合に使用されます。 NumericAxis 基本クラスはこのフィールドが変更されたかどうかを監視し、グラフをレンダリングする必要があるかどうかを決定します。 このフィールドの値を計算するのは、派生クラスの役割です。

computedMaximumプロパティ 
public var computedMaximum:Number

この軸が表す計算された最大値です。 ユーザーが明示的に最大値を割り当てた場合は、通常、computedMaximum プロパティと assignedMaximum プロパティが同じです。 そうでない場合は、computedMaximum が、グラフ内に表示された値から生成されます。

computedMinimumプロパティ 
public var computedMinimum:Number

この軸が表す計算された最小値です。 ユーザーが明示的に最小値を割り当てた場合は、通常、computedMinimum プロパティと assignedMinimum プロパティが同じです。 そうでない場合は、computedMinimum が、グラフ内に表示された値から生成されます。

dataDescriptionsプロパティ 
dataDescriptions:Array  [読み取り専用]

グラフで表されるデータを記述した DataDescription 構造体の配列です。 軸はこのプロパティを使用して、範囲などの、プロパティの値を生成することができます。



実装
    protected function get dataDescriptions():Array
labelCacheプロパティ 
protected var labelCache:Array

この軸を表すために生成された AxisLabel オブジェクトの最新のセットです。 軸が変更されて新しいラベルが必要な場合、このプロパティは null となります。 labelCacheプロパティの値が必ず正しくなるようにするには buildLabelCache() メソッドを labelCache プロパティにアクセスする前に呼び出します。

labelFunctionプロパティ 
labelFunction:Function

ラベルとして表示するために、軸の値をフォーマットするために呼び出されます。 labelFunction には、次のシグネチャがあります。

      function function_name(labelValue:Object, previousValue:Object, axis:IAxis):String { ... }
      

使用する関数でフォーマットされるデータのタイプがわかっている場合は、labelValue パラメータおよび previousValue パラメータに明示的なタイプを指定できます。



実装
    public function get labelFunction():Function
    public function set labelFunction(value:Function):void
labelMaximumプロパティ 
protected var labelMaximum:Number

ラベルが配置される最大値です。 調整済みの最小値を計算した後、多くの軸タイプはグラフ内で軸の範囲をさらに拡大し、ラベルや境界線の生成結果がレンダリングされるスペースを確保します。 この値は、これらの生成結果のためにグラフが調整されるのグラフ内の最大値を表します。 通常、この値に必ずラベルが付けられるよう、軸によりラベルが生成されます。調整された軸の最大値が生成されるわけではありません。

labelMinimumプロパティ 
protected var labelMinimum:Number

ラベルが配置される最小値です。 調整済みの最小値を計算した後、多くの軸タイプはグラフ内で軸の範囲をさらに拡大し、ラベルや境界線の生成結果がレンダリングされるスペースを確保します。 この値は、これらの生成結果のためにグラフが調整されるのグラフ内の最小値を表します。 通常、この値に必ずラベルが付けられるよう、軸によりラベルが生成されます。調整された軸の最大値が生成されるわけではありません。

minorTickCacheプロパティ 
protected var minorTickCache:Array

この軸を表すために生成された、小さな目盛りの最新のセットです。 軸が変更され、新しいラベルと目盛りが必要な場合、このプロパティは null となることがあります。 パブリックアクセサ minorTicks を使用して、要求時に小さな目盛りを作成します。

minorTicksプロパティ 
minorTicks:Array  [読み取り専用]

この軸を表すために生成された小さな目盛りの配列です。



実装
    public function get minorTicks():Array
paddingプロパティ 
padding:Number

値を画面上にレンダリングする際に、計算された軸の最小値および最大値に追加するスペースを指定します。



実装
    public function get padding():Number
    public function set padding(value:Number):void
parseFunctionプロパティ 
parseFunction:Function

グラフによりレンダリングされた値の数値への変換方法をカスタマイズする parseFunction を指定します。 カスタムの parseFunction にデータ値が渡され、同じ値を表す対応数値が返されます。 デフォルトでは、この軸で ECMA 関数 parseFloat() () が使用されます。



実装
    public function get parseFunction():Function
    public function set parseFunction(value:Function):void
requiredDescribedFieldsプロパティ 
requiredDescribedFields:uint  [読み取り専用]

この軸に影響する DescribeData 構造体のフィールドです。



実装
    protected function get requiredDescribedFields():uint
ticksプロパティ 
ticks:Array  [読み取り専用]

この軸で使用される小さな目盛りの配列です。



実装
    protected function get ticks():Array
コンストラクタの詳細
NumericAxis()コンストラクタ
public function NumericAxis()

コンストラクタです。

メソッドの詳細
adjustMinMax()メソッド
protected function adjustMinMax(minValue:Number, maxValue:Number):void

軸のラベルの生成または割り当て範囲を調整します。 このメソッドは軸の更新サイクル中に呼び出されます。 サブクラスはこのメソッドをオーバーライドして、値に対して特別な処理を行うことができます。 デフォルトでは、この範囲には調整が行われません。

パラメータ

minValue:Number — 計算された最小値です。
 
maxValue:Number — 計算された最大値です。

buildLabelCache()メソッド 
protected function buildLabelCache():Boolean

軸の現在の値を表すラベルで labelCache プロパティの値を設定します。 サブクラスではこの関数を実装する必要があります。 この関数は何度も呼び出されるため、計算の実行前に labelCache プロパティが null であるかどうかをチェックする必要があります。

戻り値
Boolean — ラベルが再生成されている場合は true です。
buildMinorTickCache()メソッド 
protected function buildMinorTickCache():Array

この軸によって生成される小さな目盛りの配列に対する位置の配列を構築します。 サブクラスではこの関数を実装する必要があります。 この関数は、NumericAxis によって自動的に呼び出されます。 この関数を直接呼び出すのではなく、minorTicks プロパティにアクセスする必要があります。

戻り値
Array — 小さな目盛りがレンダリングされる箇所の、軸の最小値と最大値の間のポイントを表す 0 から 1 までの位置の配列です。
filterCache()メソッド 
public function filterCache(cache:Array, field:String, filteredString:String):void

任意のタイプの値のセットにフィルタをかけ、マップできる数字のセットにします。

パラメータ

cache:Array — 変換された値の読み取り元および保管先であるオブジェクトの配列です。
 
field:String — フィルタの適用前の値を含む、キャッシュ配列の中のオブジェクトのフィールドです。
 
filteredString:String — フィルタが適用された値の保管先となる、キャッシュ配列の中のオブジェクトのフィールドです。

formatForScreen()メソッド 
public function formatForScreen(value:Object):String

DataTips での表示用に値をフォーマットします。 ユーザーが読み取れるストリングを返します。

パラメータ

value:Object — ストリングに変換される値です。

戻り値
String — DataTip のテキストです。
getLabelEstimate()メソッド 
public function getLabelEstimate():AxisLabelSet

軸ラベルを予測するための範囲を決定します。 軸は直ちに getLabels() メソッドを呼び出して実際の値を取得します。軸は予測した値を使用して、グラフの余白を調整し、予測したラベルと正確なラベル (getLabels() メソッドから返されたラベル) の間の差があっても、ラベルが適切に拡大・縮小されるようにします。

軸が予測したラベルを返すときは、最小ラベルおよび最大ラベルのみを返す必要があります。 ラベルのセットがかなり静的で、画面にレンダリングされる軸のサイズに依存しない場合は、軸がラベルセット全体をこの関数から返し、予測したラベルに正確であることを示すマークを付けることができます。

戻り値
AxisLabelSet — AxisLabel オブジェクトの配列です。
getLabels()メソッド 
public function getLabels(minimumAxisLength:Number):AxisLabelSet

レンダリングされるラベルテキストを取得します。 このメソッドが呼び出されたときは、既に軸によってラベルの最小の長さが決定されています。

パラメータ

minimumAxisLength:Number — 軸の最小の長さ(ピクセル単位)です。 軸はこの値より長くすることができますが、短くすることはできません。

戻り値
AxisLabelSet — AxisLabel オブジェクトの配列です。
guardMinMax()メソッド 
protected function guardMinMax(min:Number, max:Number):Array

この軸タイプについて、所定の範囲を無効な値から保護します。 この関数は、無効な範囲が生成されないようにするため、軸の更新サイクル中に呼び出されます。 サブクラスはこのクラスをオーバーライドして、その軸タイプに適したロジックを定義できます。

パラメータ

min:Number — 計算された最小値です。
 
max:Number — 計算された最大値です。

戻り値
Array — 調整が不要な場合、または [min,max] の形式の調整済み値が含まれる配列の場合は null です。
invalidateCache()メソッド 
protected function invalidateCache():void

この軸の値を表すキャッシュされたラベルおよび目盛りを無効化します。 派生クラスは、ラベルと目盛りの計算に使用された値が変更された場合は必ずこの関数を呼び出す必要があります。

invertTransform()メソッド 
public function invertTransform(value:Number):Object

軸に対する位置を数値データの値にマップして戻します。

パラメータ

value:Number — 軸の境界です。 このパラメータは 0 と 1 の間である必要があります。ここで 0 は軸の最小の境界を、1 は最大の境界を表します。

戻り値
Object — 変換された値を保持するオブジェクトです。
mapCache()メソッド 
public function mapCache(cache:Array, field:String, convertedField:String, indexValues:Boolean = false):void

任意のタイプの値のセットを、画面の座標に換算できる数値のセットに変換します。

パラメータ

cache:Array — 変換された値の読み取り元および保管先であるオブジェクトの配列です。
 
field:String — 変換前の値を含む、キャッシュ配列の中のオブジェクトのフィールドです。
 
convertedField:String — 変換された値の保管先となる、キャッシュ配列の中のオブジェクトのフィールドです。
 
indexValues:Boolean (default = false) — このパラメータは、マップされる値がインデックス値である場合は true、自然データ値である場合は false です。

preferDropLabels()メソッド 
public function preferDropLabels():Boolean

軸による重なるラベルの処理方法を決定します。 通常、数値範囲では true が返されますが、個別の値に基づく範囲では true は返されません。 このプロパティは、軸上に直接設定することによりオーバーライドすることができます。

戻り値
Boolean — データが失われることなく、ラベルをドロップできる場合は true、そうでない場合は false です。
reduceLabels()メソッド 
public function reduceLabels(intervalStart:AxisLabel, intervalEnd:AxisLabel):AxisLabelSet

AxisRenderer がラベルを重ならないようにレンダリングできず、Axis オブジェクトによりラベルのセットが減らされるようにする場合に起動されます。 重なった 2 つのラベルがメソッドに渡されます。

パラメータ

intervalStart:AxisLabel — ラベルが重なる間隔の始まりです。
 
intervalEnd:AxisLabel — ラベルが重なる間隔の終わりです。

戻り値
AxisLabelSet — ラベルの数を減らして重複を解決する新しいラベルのセットです。
transformCache()メソッド 
public function transformCache(cache:Array, field:String, convertedField:String):void

値のセットをデータ領域からスクリーン領域にマップします。

パラメータ

cache:Array — マップされた値の読み取り元および保管先であるオブジェクトの配列です。
 
field:String — マップ前の値を含む、キャッシュ配列の中のオブジェクトのフィールドです。
 
convertedField:String — マップされた値の保管先となる、キャッシュ配列の中のオブジェクトのフィールドです。

update()メソッド 
public function update():void

グラフを更新します。 フレームごとに複数回呼び出すことができます。





 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/charts/chartClasses/NumericAxis.html