This page was saved using jaction on 2006-09-04 8:33:31.
Address: http://flexdocs.kr/docs/flex2/langref/mx/charts/CategoryAxis.html
Title: mx.charts.CategoryAxis (Flex™ 2 레퍼런스 가이드)  •  Size: 63989
(Adobe Flex Charting 2 컴퍼넌트만)
Packagemx.charts
Classpublic class CategoryAxis
InheritanceCategoryAxis Inheritance AxisBase Inheritance EventDispatcher Inheritance Object
ImplementsIAxis

CategoryAxis 클래스는, 그래프의 축으로 따라 일련의 불연속인 값을 표시합니다. CategoryAxis 클래스는 통상, 그래프의 축으로 따라 표시되는 일련의 label를 정의하기 위해서 사용합니다. 예를 들어, 이 클래스를 사용해, 그래프의 데이터를 City (시), Year (해), Business unit (사업부)별로 표시합니다.

그래프로 사용되는 CategoryAxis 는, 그것을 포함한 그래프의 dataProvider property를 Inheritance하지 않습니다. CategoryAxis 로 dataProvider property를 명시적으로 설정할 필요가 있습니다.

같은 dataProvider 를 사용해 데이터를 그래프에, 카테고리를 CategoryAxis 에 수중에 넣을 수가 있습니다만, CategoryAxis 는 dataProvider 가 정적인 경우에 렌더링을 최적화할 수 있습니다. 가능하면, 카테고리가 정적이고, 가변 데이터가 개별의 dataProvider 에 포함되도록 해 주세요.

dataProvider property에는, string의 배열인가, 카테고리명을 지정하는 property를 가지는 레코드 (object)의 배열을 사용할 수 있습니다. categoryField property를 지정하면, CategoryAxis 는 dataProvider 가 object의 배열이다고 봅니다. categoryFieldnull 의 경우, CategoryAxis 는 dataProvider 가 string의 배열이다고 봅니다.

MXML 문장구조법expandedMXML 문장구조법의 비표시

<mx:CategoryAxis> 태그는, 친클래스의 모든 property를 Inheritance해, 다음의 property를 추가합니다.

 <mx:CategoryAxis Properties categoryField="null" dataProvider="No default" labelFunction="No default" padding="Default depends on chart type" ticksBetweenLabels="true" /> 

View the examples

See also

축의 조작
CategoryAxis 클래스에 도착해


Public property
 property정의
  baseline : Number
[read-only] 축의 baseline 위치입니다.
CategoryAxis
  categoryField : String
label의 텍스트를 포함하는 데이터 프로바이더의 필드를 지정합니다.
CategoryAxis
 InheritedchartDataProvider : Object
주위를 둘러싸는 그래프에 할당할 수 있었던 데이터 프로바이더입니다.
AxisBase
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  dataProvider : Object
label의 이름이 포함되고 있는 데이터 소스를 지정합니다.
CategoryAxis
 InheriteddisplayName : String
축의 이름입니다.
AxisBase
  labelFunction : Function
categoryAxis dataProvider 의 각 아이템용으로 생성된 label를 정의하는 함수를 지정합니다.
CategoryAxis
  padding : Number
데이터를 화면상에 렌더링 할 경우에, 축의 몇개의 구석에 추가되는 스페이스를 지정합니다.
CategoryAxis
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
  ticksBetweenLabels : Boolean
오메 번화가의 축상의 장소를, 카테고리의 label에 대해서 상대적으로 지정합니다.
CategoryAxis
 Inheritedtitle : String
축으로 따라 표시되는 타이틀의 텍스트입니다.
AxisBase
 InheritedunitSize : Number
이 축으로 표시되는 데이터의 1 단위의 크기입니다.
AxisBase
Public Methods
 Methods정의
  CategoryAxis ()
constructor   .
CategoryAxis
 InheritedaddEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
EventDispatcher
 InheriteddataChanged ():void
그래프 데이터가 변경되었을 때에, 범위의 object에 통지를 보내는 이벤트를 방아쇠 합니다.
AxisBase
 InheriteddispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
EventDispatcher
  filterCache (cache:Array , field:String , filteredString:String ):void
임의의 타입의 값세트에 필터를 걸어 MAP 할 수 있는 숫자세트로 합니다.
CategoryAxis
  formatForScreen (value:Object ):String
DataTips 에서의 표시용으로치를 포맷 합니다.
CategoryAxis
  getLabelEstimate ():AxisLabelSet
축label를 예측하기 위한 범위를 결정합니다.
CategoryAxis
  getLabels (minimumAxisLength:Number ):AxisLabelSet
렌더링 되는 label 텍스트를 취득합니다.
CategoryAxis
 InheritedhasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
EventDispatcher
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
  invertTransform (value:Number ):Object
축으로 대하는 위치를 수치 데이터의 값에 MAP 해 되돌립니다.
CategoryAxis
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
  mapCache (cache:Array , field:String , convertedField:String , indexValues:Boolean = false):void
임의의 타입의 값세트를, 화면의 좌표로 환산할 수 있는 수치세트로 변환합니다.
CategoryAxis
  preferDropLabels ():Boolean
축으로 밤 겹치는 label의 처리 방법을 결정합니다.
CategoryAxis
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
  reduceLabels (intervalStart:AxisLabel , intervalEnd:AxisLabel ):AxisLabelSet
AxisRenderer 가 label를 겹치지 않게 렌더링 하지 못하고, Axis object에 의해 label세트가 줄여지도록(듯이) 하는 경우에 기동됩니다.
CategoryAxis
 InheritedregisterDataTransform (transform:DataTransform , dimensionName:String ):void
축을 사용하는 각 DataTransform 가, 그 축으로 자동적으로 등록됩니다.
AxisBase
 InheritedremoveEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
EventDispatcher
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
  transformCache (cache:Array , field:String , convertedField:String ):void
값세트를 데이터 area로부터 스크린 area에 MAP 합니다.
CategoryAxis
 InheritedunregisterDataTransform (transform:DataTransform ):void
축을 사용하는 각 DataTransform 가, 그 축으로 자동적으로 등록됩니다.
AxisBase
  update ():void
그래프를 갱신합니다.
CategoryAxis
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
 InheritedwillTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
EventDispatcher
Protected Methods
 Methods정의
 InheriteddescribeData (dimension:String , requiredFields:uint ):Array
이 IChartElement 로 나타내지는 데이터의 기술을 취득하기 위해서, 관리하는 DataTransform 에 의해 불려 갑니다.
AxisBase
property의 상세
baselineproperty
baseline:Number   [read-only]

축의 baseline 위치입니다. ColumnSeries 나 AreaSeries 등의 일부의 계열에서는, 최소치가 지정되지 않는 경우에, 이 값을 사용해 전부 칠해진 area의 하단이 정의됩니다.

Implements
    public function get baseline():Number
categoryFieldproperty 
categoryField:String   [read-write]

label의 텍스트를 포함하는 데이터 프로바이더의 필드를 지정합니다. 이 property가 null 의 경우, CategoryAxis 는 dataProvider 에 string의 배열이 포함된다고 봅니다.

디폴트치null.

Implements
    public function get categoryField():String
    public function set categoryField(value:String ):void
dataProviderproperty 
dataProvider:Object   [read-write]

label의 이름이 포함되고 있는 데이터 소스를 지정합니다. dataProvider 에는 string의 배열, object의 배열, 혹은 IList 또는 ICollectionView 인터페이스를 Implements하는 몇개의 object를 지정할 수가 있습니다. dataProvider 가 string의 배열인 경우는,categoryField property가 null 로 설정되어 있는 것을 확인합니다. dataProvider 가 object의 배열의 경우는,categoryField property를, label의 텍스트를 포함한 필드의 이름으로 설정합니다.

Implements
    public function get dataProvider():Object
    public function set dataProvider(value:Object ):void
labelFunctionproperty 
labelFunction:Function   [read-write]

categoryAxis dataProvider 의 각 아이템용으로 생성된 label를 정의하는 함수를 지정합니다. labelFunction 를 지정하지 않는 경우는, 디폴트 설정에 의해, 카테고리 자체의 값이 축label가 됩니다.

CategoryAxis 의 labelFunction 에는, 이하의 서명이 포함되어 있을 필요가 있습니다.

labelFunction(categoryValue:Object, previousCategoryValue:Object, axis:CategoryAxis, categoryItem:Object);

다음에, 각 지정 항목에 대해 설명합니다.

categoryValue 는, 표시되는 카테고리의 값입니다.

previousCategoryValue 는, 축상에 있는, 전의 카테고리의 값입니다.

axis 는, 렌더링 되는 CategoryAxis 입니다.

categoryItem 는, 표시되는 dataProvider 로부터의 아이템입니다.

CategoryAxis.categoryField 가 설정되어 있지 않은 경우는,categoryValue property와 같은 값이 됩니다.

Implements
    public function get labelFunction():Function
    public function set labelFunction(value:Function ):void
paddingproperty 
padding:Number   [read-write]

데이터를 화면상에 렌더링 할 경우에, 축의 몇개의 구석에 추가되는 스페이스를 지정합니다. 0 으로 설정하면, 최초의 카테고리가 축의 첨단에, 마지막 카테고리가 말단에 매핑 됩니다. 0.5 로 설정하면, 카테고리폭의 반의 스페이스가, 축의 첨단과 최초의 카테고리의 사이, 및 마지막 카테고리와 축의 말단의 사이에 삽입됩니다.

이것은, 세로의 곧은 선 그래프나 가로줄 그래프 등, 카테고리의 경계를 넘어 렌더링 하는 타입의 그래프에 편리합니다. 다만, LineChart 또는 AreaChart 로 horizontalAxis 로서 사용하면, 0 에 리셋트 됩니다.

디폴트치0.5.

Implements
    public function get padding():Number
    public function set padding(value:Number ):void
ticksBetweenLabelsproperty 
ticksBetweenLabels:Boolean   [read-write]

오메 번화가의 축상의 장소를, 카테고리의 label에 대해서 상대적으로 지정합니다. true 로 설정하면, 카테고리간에 눈금, 및 관련하는 grid lines이 표시됩니다. false 의 경우는, 눈금이 카테고리의 중앙에, label와 정렬해 배치됩니다.

Implements
    public function get ticksBetweenLabels():Boolean
    public function set ticksBetweenLabels(value:Boolean ):void
constructor    의 상세
CategoryAxis()constructor   
public 함수 CategoryAxis()

constructor   .

Methods의 상세
filterCache()Methods
public function filterCache(cache:Array , field:String , filteredString:String ):void

임의의 타입의 값세트에 필터를 걸어 MAP 할 수 있는 숫자세트로 합니다.

Parameters
cache:Array — 변환된 값의 독해원 및 보관처인 object의 배열입니다.
 
field:String — 필터의 적용전의 값을 포함한, 캐쉬 배열안의 object의 필드입니다.
 
filteredString:String — 필터가 적용된 값의 보관처가 되는, 캐쉬 배열안의 object의 필드입니다.
formatForScreen()Methods 
public function formatForScreen(value:Object ):String

DataTips 에서의 표시용으로치를 포맷 합니다. 유저가 읽어낼 수 있는 string를 돌려줍니다.

Parameters
value:Object — string에 변환되는 값입니다.

반환값
String — DataTip 의 텍스트입니다.
getLabelEstimate()Methods 
public function getLabelEstimate():AxisLabelSet

축label를 예측하기 위한 범위를 결정합니다. 축은 즉시 getLabels() Methods를 호출해 실제의 값을 취득합니다. 축은 예측한 값을 사용해, 그래프의 margin를 조정해, 예측한 label와 정확한 label (getLabels() Methods로부터 돌려주어진 label)의 사이의 차이가 있어도, label가 적절히 확대·축소되도록(듯이) 합니다.

축이 예측한 label를 돌려줄 때는, 최소 label 및 최대 label만을 돌려줄 필요가 있습니다. label세트가 꽤 정적이어, 화면에 렌더링 되는 축의 크기에 의존하지 않는 경우는, 축이 label 세트 전체를 이 함수로부터 돌려주어, 예측한 label에 정확한 것을 나타내는 마크를 붙일 수가 있습니다.

반환값
AxisLabelSet — AxisLabel object의 배열입니다.
getLabels()Methods 
public function getLabels(minimumAxisLength:Number ):AxisLabelSet

렌더링 되는 label 텍스트를 취득합니다. 이 Methods가 불려 갔을 때는, 이미 축으로야는 label의 최소의 길이가 결정되고 있습니다.

Parameters
minimumAxisLength:Number — 축의 최소의 길이 (픽셀 단위)입니다. 축은 이 값보다 길게 할 수가 있습니다만, 짧게 할 수 없습니다.

반환값
AxisLabelSet — AxisLabel object의 배열입니다.
invertTransform()Methods 
public function invertTransform(value:Number ):Object

축으로 대하는 위치를 수치 데이터의 값에 MAP 해 되돌립니다.

Parameters
value:Number — 축의 경계입니다. 이 Parameters는 0 으로 1 의 사이일 필요가 있습니다. 여기서 0 은 축의 최소의 경계를, 1 은 최대의 경계를 나타냅니다.

반환값
Object
mapCache()Methods 
public function mapCache(cache:Array , field:String , convertedField:String , indexValues:Boolean = false):void

임의의 타입의 값세트를, 화면의 좌표로 환산할 수 있는 수치세트로 변환합니다.

Parameters
cache:Array — 변환된 값의 독해원 및 보관처인 object의 배열입니다.
 
field:String — 변환전의 값을 포함한, 캐쉬 배열안의 object의 필드입니다.
 
convertedField:String — 변환된 값의 보관처가 되는, 캐쉬 배열안의 object의 필드입니다.
 
indexValues:Boolean (default = false) — 이 Parameters는, MAP 되는 값이 인덱스치인 경우는 true, 자연 데이터치인 경우는 false 입니다.
preferDropLabels()Methods 
public function preferDropLabels():Boolean

축으로 밤 겹치는 label의 처리 방법을 결정합니다. 통상, 수치 범위에서는 true 가 돌려주어집니다만, 개별의 값에 근거하는 범위에서는 true 는 돌려주어지지 않습니다. 이 property는, 축상에 직접 설정하는 것으로써 재정의(override) 할 수가 있습니다.

반환값
Boolean — 데이터가 없어지는 일 없이, label를 드롭 할 수 있는 경우는 true, 그렇지 않은 경우는 false 입니다.
reduceLabels()Methods 
public function reduceLabels(intervalStart:AxisLabel , intervalEnd:AxisLabel ):AxisLabelSet

AxisRenderer 가 label를 겹치지 않게 렌더링 하지 못하고, Axis object에 의해 label세트가 줄여지도록(듯이) 하는 경우에 기동됩니다. 겹친 2 개의 label가 Methods에게 건네집니다.

Parameters
intervalStart:AxisLabel — label가 겹치는 간격의 시작입니다.
 
intervalEnd:AxisLabel — label가 겹치는 간격의 마지막입니다.

반환값
AxisLabelSet — label의 수를 줄여 중복을 해결하는 새로운 label세트입니다.
transformCache()Methods 
public function transformCache(cache:Array , field:String , convertedField:String ):void

값세트를 데이터 area로부터 스크린 area에 MAP 합니다.

Parameters
cache:Array — MAP 된 값의 독해원 및 보관처인 object의 배열입니다.
 
field:String — MAP전의 값을 포함한, 캐쉬 배열안의 object의 필드입니다.
 
convertedField:String — MAP 된 값의 보관처가 되는, 캐쉬 배열안의 object의 필드입니다.
update()Methods 
public function update():void

그래프를 갱신합니다. 프레임 마다 여러 차례 호출할 수가 있습니다.

Examples
HLOCChartExample
<? 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>

    <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 baseAtZero="false" />
            </mx:verticalAxis>

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

            <mx:horizontalAxisRenderer>
                <mx:AxisRenderer canDropLabels="true"/>
            </mx:horizontalAxisRenderer>

            <mx:series>
                <mx:HLOCSeries openField="Open" highField="High" 
                    lowField="Low" closeField="Close"/>
            </mx:series>
        </mx:HLOCChart>

    </mx:Panel>
</mx:Application>






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/charts/CategoryAxis.html