mx.charts.CategoryAxis （Flex 3.2）

	プロパティ	定義元
		baseline : Number [読み取り専用] 軸のベースライン位置です。	CategoryAxis
		categoryField : String ラベルのテキストを格納するデータプロバイダのフィールドを指定します。	CategoryAxis
		chartDataProvider : Object [書き込み専用] 周りを囲むグラフに割り当てられたデータプロバイダです。	AxisBase
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		dataFunction : Function 現在のアイテムの categoryValue として使用する値を返すメソッドを指定します。このプロパティが設定されている場合、カスタムのデータ関数の戻り値は categoryField よりも優先されます。カスタムの dataFunction には、次のシグネチャがあります。function_name (axis:CategoryAxis, item:Object):Object { ...	CategoryAxis
		dataProvider : Object ラベルの名前が格納されているデータソースを指定します。	CategoryAxis
		displayName : String 軸の名前です。	AxisBase
		labelFunction : Function CategoryAxis の dataProvider の各アイテム用に生成されたラベルを定義する関数を指定します。	CategoryAxis
		padding : Number データを画面上にレンダリングするときに、軸のいずれかの端に追加されるスペースを指定します。	CategoryAxis
		prototype : Object [静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		ticksBetweenLabels : Boolean 大目盛りの軸上の場所を、カテゴリのラベルに対して相対的に指定します。	CategoryAxis
		title : String 軸に沿って表示されるタイトルのテキストです。	AxisBase
		unitSize : Number [読み取り専用] この軸に表示されるデータの 1 単位のサイズです。	AxisBase

	メソッド	定義元
		CategoryAxis() コンストラクタです。	CategoryAxis
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		dataChanged():void グラフデータが変更されたときに、範囲のオブジェクトに通知を送るイベントをトリガします。	AxisBase
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		filterCache(cache:Array, field:String, filteredString:String):void 任意のタイプの値のセットにフィルタをかけ、マップできる数字のセットにします。	CategoryAxis
		formatForScreen(value:Object):String DataTips での表示用に値をフォーマットします。	CategoryAxis
		getLabelEstimate():AxisLabelSet 軸ラベルを予測するための範囲を決定します。	CategoryAxis
		getLabels(minimumAxisLength:Number):AxisLabelSet レンダリングされるラベルテキストを取得します。	CategoryAxis
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		invertTransform(value:Number):Object 軸に対する位置を数値データの値にマップして戻します。	CategoryAxis
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		mapCache(cache:Array, field:String, convertedField:String, indexValues:Boolean = false):void 任意のタイプの値のセットを、画面の座標に換算できる数値のセットに変換します。	CategoryAxis
		preferDropLabels():Boolean 軸による重なるラベルの処理方法を決定します。	CategoryAxis
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		reduceLabels(intervalStart:AxisLabel, intervalEnd:AxisLabel):AxisLabelSet AxisRenderer がラベルを重ならないようにレンダリングできず、Axis オブジェクトによりラベルのセットが減らされるようにする場合に起動されます。	CategoryAxis
		registerDataTransform(transform:DataTransform, dimensionName:String):void 軸を使用する各 DataTransform が、その軸に自動的に登録されます。	AxisBase
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		transformCache(cache:Array, field:String, convertedField:String):void 値のセットをデータ領域からスクリーン領域にマップします。	CategoryAxis
		unregisterDataTransform(transform:DataTransform):void 軸を使用する各 DataTransform が、その軸に自動的に登録されます。	AxisBase
		update():void グラフを更新します。	CategoryAxis
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

	メソッド	定義元
		describeData(dimension:String, requiredFields:uint):Array この IChartElement で表されるデータの記述を取得するために、管理する DataTransform によって呼び出されます。	AxisBase

	イベント	概要	定義元
		activate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
		deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher

プロパティの詳細

baseline

プロパティ

baseline:Number [読み取り専用]

軸のベースライン位置です。 ColumnSeries や AreaSeries などの一部の系列では、最小値が指定されない場合に、この値を使用して塗りつぶされた領域の下端が定義されます。

実装
public function get baseline():Number

categoryField

プロパティ

categoryField:String

ラベルのテキストを格納するデータプロバイダのフィールドを指定します。このプロパティが null の場合、CategoryAxis は dataProvider にストリングの配列が含まれると見なします。

デフォルト値 : null.

実装
public function get categoryField():String
public function set categoryField(value:String):void

dataFunction

プロパティ

dataFunction:Function

現在のアイテムの categoryValue として使用する値を返すメソッドを指定します。このプロパティが設定されている場合、カスタムのデータ関数の戻り値は categoryField よりも優先されます。

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

     function_name (axis:CategoryAxis, item:Object):Object { ... }

axis は、この dataFunctionitem を使用する現在の軸です。は、考慮される dataProvider 内のアイテムです。この関数はオブジェクトを返します。

カスタマイズした dataFunction の使用方法の例としては、ネストされたフィールドを持つアイテムのある dataProvider から値を返させることができます。

実装
public function get dataFunction():Function
public function set dataFunction(value:Function):void

例
例の使用法

     public function myFunction(axis:CategoryAxis,item:Object):Object {
          return(item.Country.State);
     }

dataProvider

プロパティ

dataProvider:Object

ラベルの名前が格納されているデータソースを指定します。dataProvider にはストリングの配列、オブジェクトの配列、あるいは IList または ICollectionView インターフェイスを実装するいずれかのオブジェクトを指定することができます。 dataProvider がストリングの配列である場合は、categoryField プロパティが null に設定されていることを確認します。 dataProvider がオブジェクトの配列の場合は、categoryField プロパティを、ラベルのテキストを含むフィールドの名前に設定します。

実装
public function get dataProvider():Object
public function set dataProvider(value:Object):void

labelFunction

プロパティ

labelFunction:Function

CategoryAxis の dataProvider の各アイテム用に生成されたラベルを定義する関数を指定します。 labelFunction を指定しない場合は、デフォルト設定により、カテゴリ自体の値が軸ラベルとなります。

CategoryAxis の labelFunction メソッドのシグネチャを次に示します。

      function function_name(categoryValue:Object, previousCategoryValue:Object, axis:CategoryAxis, categoryItem:Object):String { ... }

次に、各指定アイテムについて説明します。

categoryValueは、表示されるカテゴリの値です。
previousCategoryValue は、軸上にある前のカテゴリの値です。
axisは、レンダリングされる CategoryAxis です。
categoryItemは、表示される dataProvider からのアイテムです。

返されたストリングが軸のラベルとして表示されます。

categoryField プロパティが設定されていない場合は、categoryValue プロパティと同じ値となります。

実装
public function get labelFunction():Function
public function set labelFunction(value:Function):void

padding

プロパティ

padding:Number

データを画面上にレンダリングするときに、軸のいずれかの端に追加されるスペースを指定します。0 に設定すると、最初のカテゴリが軸の先端に、最後のカテゴリが末端にマッピングされます。0.5 に設定すると、カテゴリ幅の半分のスペースが、軸の先端と最初のカテゴリの間、および最後のカテゴリと軸の末端の間に挿入されます。

これは、縦棒グラフや横棒グラフなど、カテゴリの境界を超えてレンダリングするタイプのグラフに便利です。ただし、LineChart または AreaChart で horizontalAxis として使用すると、0 にリセットされます。

デフォルト値 : 0.5.

実装
public function get padding():Number
public function set padding(value:Number):void

ticksBetweenLabels

プロパティ

ticksBetweenLabels:Boolean

大目盛りの軸上の場所を、カテゴリのラベルに対して相対的に指定します。 true に設定すると、カテゴリ間に目盛り、および関連するグリッド線が表示されます。 false の場合は、目盛りがカテゴリの中央に、ラベルと整列して配置されます。

実装
public function get ticksBetweenLabels():Boolean
public function set ticksBetweenLabels(value:Boolean):void

コンストラクタの詳細

CategoryAxis

()

コンストラクタ

public function CategoryAxis()

コンストラクタです。

メソッドの詳細

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 オブジェクトの配列です。

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

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

例例の使用法

HLOCChartExample.mxml

<?xml version="1.0"?>
<!-- Simple example to demonstrate the HLOCChart control. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
    <mx:Script>
        <![CDATA[          
        import mx.collections.ArrayCollection;

        [Bindable]
        private var stockDataAC:ArrayCollection = new ArrayCollection( [
            { Date: "25-Jul", Open: 40.55,  High: 40.75, Low: 40.24, Close:40.31},
            { Date: "26-Jul", Open: 40.15,  High: 40.78, Low: 39.97, Close:40.34},
            { Date: "27-Jul", Open: 40.38,  High: 40.66, Low: 40, Close:40.63},
            { Date: "28-Jul", Open: 40.49,  High: 40.99, Low: 40.3, Close:40.98},
            { Date: "29-Jul", Open: 40.13,  High: 40.4, Low: 39.65, Close:39.95},
            { Date: "1-Aug", Open: 39.00,  High: 39.50, Low: 38.7, Close:38.6}, 
            { Date: "2-Aug", Open: 38.68,  High: 39.34, Low: 37.75, Close:38.84}, 
            { Date: "3-Aug", Open: 38.76,  High: 38.76, Low: 38.03, Close:38.12}, 
            { Date: "4-Aug", Open: 37.98,  High: 37.98, Low: 36.56, Close:36.69},                       
            { Date: "5-Aug", Open: 36.61,  High: 37, Low: 36.48, Close:36.86} ]); 
        ]]>
    </mx:Script>

    <!-- Define custom Stroke for the wick and ticks. -->
    <mx:Stroke id="s1" color="0x000000" weight="5" joints="bevel" caps="square"/>

    <mx:Panel title="HLOCChart Control Example" height="100%" width="100%">
        <mx:HLOCChart id="hlocchart" height="100%" width="100%"
            paddingRight="5" paddingLeft="5" 
            showDataTips="true" dataProvider="{stockDataAC}">
            
            <mx:verticalAxis>
                <mx:LinearAxis id="vaxis" baseAtZero="false" title="Price"/>
            </mx:verticalAxis>

            <mx:horizontalAxis>
                <mx:CategoryAxis id="haxis" categoryField="Date" title="Date"/>
            </mx:horizontalAxis>

            <mx:horizontalAxisRenderers>
                <mx:AxisRenderer axis="{haxis}" canDropLabels="true"/>
            </mx:horizontalAxisRenderers>

            <mx:series>
                <mx:HLOCSeries 
                    openField="Open" 
                    highField="High" 
                    lowField="Low" 
                    closeField="Close"
                    stroke="{s1}"
                    openTickStroke="{s1}"
                    closeTickStroke="{s1}"
                    openTickLength="7"
                    closeTickLength="7"
                />
            </mx:series>
        </mx:HLOCChart>
    </mx:Panel>
</mx:Application>

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

Adobe® Flex™ 3.2 リファレンスガイド This Help system only	すべてのパッケージ \| すべてのクラス \| 言語エレメント \| 索引 \| 付録 \| 規則 \| フレームフレームなし
CategoryAxis	プロパティ \| メソッド \| イベント \| 例

パッケージ	mx.charts
クラス	public class CategoryAxis
継承	CategoryAxis AxisBase EventDispatcher Object
実装	IAxis