Packagekor.series
Classpublic class Bar3DSeries

Bar3DChart 컨트롤의 series 속성에 할당되는 데이터 시리즈 입니다.
데이터를 바탕으로 실제적인 가로줄 모양의 바를 표현하는 클래스입니다.

레이아웃은 다음과 같은 형식으로 작성됩니다.

 <rMateChart backgroundColor="0xFFFFEE"  cornerRadius="12" borderStyle="solid">
   <Options>
    <Caption text="Anual Report"/>
  </Options>
  <Bar3DChart showDataTips="true">
    <horizontalAxis>
     <CategoryAxis categoryField="Month" />
    </horizontalAxis>
    <series>
     <Bar3DSeries xField="Profit"/>
     <Bar3DSeries xField="Cost" />
     <Bar3DSeries xField="Revenue" />
    </series>
   </Bar3DChart>
  </rMateChart>
 



Styles
 StyleDescriptionDefined by
  
alwayShowLabels
Type: Boolean

시리즈 출력 영역보다 insideLabel 과 outsideLabel 이 작아진 경우 라벨들의 처리 방법을 결정합니다.
alwayShowLabels = true 라면 항상 라벨들을 표시하지만 false 인 경우 공간이 부족하면 출력하지 않습니다.

The default value is true.
Bar3DSeries
  
alwayShowLines
Type: Boolean

lineToEachItems가 true일 경우 다음 데이터가 0인 값은 라인을 그리지 않습니다.

The default value is false.
Bar3DSeries
  
barWidthRatio
Type: String
표시하는 바(Bar)의 width 를 카테고리의 width에 대한 비율(범위는 0~1)로 지정합니다.
값이 1인 경우는 영역 전체가 사용되며, 0.6인 경우 바의 사용 가능 영역은 60%입니다.

실제 바(Bar)의 width 는 barWidthRatio property 와 maxBarWidth property 를 계산하여 작은 값이 적용됩니다

The default value is 0.65.
Bar3DSeries
  
buttonMode
Type: Boolean

buttonMode 가 true 로 설정되면 해당 시리즈에 마우스 오버 시 커서가 손모양으로 나타납니다.

The default value is false.
Bar3DSeries
  
color
Type: uint   Format: Color

글자색을 RGB로 지정합니다.

The default value is 0x0B333C.
Bar3DSeries
  
cubeAngleRatio
Type: Number

그리려는 정육면체의 각도 비율입니다. 정육면체 구현시 cubeDepth에 대해 세로비율을 나타냅니다. 1이면 45도를 의미합니다.

The default value is 0.6.
Bar3DSeries
  
cubeDepth
Type: Number

그리려는 큐브의 깊이입니다.

The default value is 10.
Bar3DSeries
  
displayName
Type: String

시리즈의 이름을 지정합니다. 설정된 값은 기본적으로 데이터팁(툴팁)에서 보여지게 되며 범례(Legend) 설정 시 Legend에 표시됩니다.

Bar3DSeries
  
fill
Type: Object
시리즈 아이템렌더러의 채우기 색을 지정합니다. 유효값은 SolidColor, LinearGradient, RadialGradient 입니다.
Bar3DSeries
  
fillJsFunction
Type: String
차트의 채우기 색을 특정 조건에 따라 지정하는 사용자 정의 함수입니다. layout XML 에서 Series 속성을 넣을 때 fillJsFunction 을 주고, 만든 javascript 함수명을 넣어줍니다.
 예) <Bar3DSeries field="Profit" fillJsFunction="fillJsFunc">
 

fillJsFunction 의 signature 는 아래와 같습니다.

 function_name(seriesId, index, values) { ... }
 
index : 해당 아이템의 인덱스
values : 해당 item의 값입니다. 배열로 전달되며 차트의 종류에 따라 아래와 같습니다.
  • 바시리즈(Bar2DSeries, Bar3DSeries) 0:x축 값, 1:y축 값
  • 칼럼시리즈(Column2DSeries, Column3DSeries) 0:x축 값, 1:y축 값
  • 영역시리즈(Area2DSeries) 0:x축 값, 1:y축 값
  • 버블시리즈(Bubble3DSeries) 0:x축 값, 1:y축 값, 2:radius 값
  • 라인시리즈(Line2DSeries) 0:x축 값, 1:y축 값
  • 파이시리즈(Pie2DSeries, Pie3DSeries) 0:값, 1:퍼센티지, 2:nameField
  • From-To Chart 에서 minField 를 지정했다면 values 의 마지막 인덱스 값에 minField 값이 들어옵니다.
  • 매트릭스시리즈 (Matrix2DSeries) 0:x축 값, 1:y축 값, 2:z축 값
Bar3DSeries
  
fills
Type: Array
시리즈에서 각각의 아이템렌더러의 fill 컬러를 지정하는 fill 객체 배열을 정의합니다.
만약 시리즈의 모든 아이템렌더러에 충분한 fill 컬러를 지정하지 않았다면 지정된 색깔이 반복됩니다. 예를 들어, 시리즈의 아이템이 10개 인 경우 5개의 fill 컬러를 지정하였다면 5개를 칠한 후 다시 5개를 칠하게 됩니다.
    <Area2DSeries ... >
     <fills>
      <SolidColor color="0xCC66FF"/>
      <SolidColor color="0x9966CC"/>
      <SolidColor color="0x9999CC"/>
     </fills>
    </Area2DSeries>
   
Bar3DSeries
  
fontFamily
Type: String

사용할 폰트명을 지정합니다. 기본적으로 시스템 폰트를 사용합니다.

The default value is "Verdana".
Bar3DSeries
  
fontSize
Type: Number   Format: Length

글자의 크기를 픽셀단위로 지정합니다.

The default value is 12.
Bar3DSeries
  
fontStyle
Type: String

이텔릭체로 글자를 표현할지를 나타냅니다. 유효값은 "normal", "italic" 입니다..

The default value is "normal".
Bar3DSeries
  
fontWeight
Type: String

볼드체로 글자를 표현할지를 나타냅니다. 유효값은 "normal", "bold" 입니다..

The default value is "bold".
Bar3DSeries
  
formatter
Type: Object

수치 라벨을 NumberFormatter 또는 CurrencyFormatter, DateFormatter 로 재설정 하여 출력시키게끔 포매터를 지정합니다.

Bar3DSeries
  
horizontalAxis
Type: Object
시리즈가 참조할 수평축을 정의합니다. 정의하지 않은 경우 차트의 horizontalAxis 를 참조합니다.
Bar3DSeries
  
id
Type: String

id를 설정합니다. id는 사용자에 의해 정의된 임의의 고유값입니다.

설정된 id를 통해 해당 객체에 접근이 가능합니다.
Bar3DSeries
  
insideLabelField
Type: String
inside 라벨에 나타날 dataProvider 에 있는 필드명을 지정합니다.
만약 insideLabelJsFunction 이 정의 되었다면 이 속성은 무시됩니다.
Bar3DSeries
  
insideLabelJsFunction
Type: String

inside 라벨을 사용자 정의하기 위한 콜백함수입니다. 자바스크립트 함수를 설정하십시오.

Bar3DSeries
  
insideLabelXOffset
Type: Number
labelPosition 을 inside 또는 both 로 설정한 경우 라벨의 X 위치를 추가적으로 지정합니다.(픽셀단위)
Bar3DSeries
  
insideLabelYOffset
Type: Number
labelPosition 을 inside 또는 both 로 설정한 경우 라벨의 Y 위치를 추가적으로 지정합니다.(픽셀단위)
Bar3DSeries
  
itemRenderer
Type: Object
차트에서 개개의 아이템을 표현하기 위해 시리즈가 사용하게 될 클래스가 되는 팩토리입니다.

유효값은 다음과 같습니다.

  • "CubeBarItemRenderer"
  • The default value is "CubeBarItemRenderer".
    Bar3DSeries
      
    labelAlign
    Type: String
    바의 너비에서 왼쪽, 가운데, 오른쪽에 라벨을 표시합니다. left,center,right 가 있습니다.
    Bar3DSeries
      
    labelPosition
    Type: String

    수치 라벨의 위치(position)을 결정합니다. 유효값은 "inside" , "outside", "both" 그리고 "none" 입니다.

    The default value is "none".
    Bar3DSeries
      
    lineToEachItems
    Type: Boolean
    시리즈 아이템들을 서로 잇는 라인을 그릴지 말지를 결정합니다. The default value is false.
    Bar3DSeries
      
    linkLineStroke
    Type: Object
    시리즈 아이템들을 서로 잇는 라인의 스타일을 정의합니다. 유효값은 Stroke 입니다.
    Bar3DSeries
      
    maxBarWidth
    Type: String
    바(Bar)의 맥시멈 width를 픽셀 단위로 지정합니다.

    실제 바(Bar)의 width 는 barWidthRatio property 와 maxBarWidth property 를 계산하여 작은 값이 적용됩니다

    Bar3DSeries
      
    minField
    Type: String

    수직 축과 데이터의 매핑에 맞는 값을 추가적으로 지정합니다.
    즉, 최소값(minimum) 값에 해당되는 데이터 필드명을 추가로 설정하여 From-To 차트 생성을 할 수 있도록합니다.

    Bar3DSeries
      
    outsideLabelField
    Type: String
    outside 라벨에 나타날 dataProvider 에 있는 필드명을 지정합니다.
    만약 outsideLabelJsFunction 이 정의 되었다면 이 속성은 무시됩니다.
    Bar3DSeries
      
    outsideLabelJsFunction
    Type: String

    outside 라벨을 사용자 정의하기 위한 콜백함수입니다. 자바스크립트 함수를 설정하십시오

    Bar3DSeries
      
    outsideLabelXOffset
    Type: Number
    labelPosition 을 outside 또는 both 로 설정한 경우 라벨의 Y 위치를 추가적으로 지정합니다.(픽셀단위)
    Bar3DSeries
      
    outsideLabelYOffset
    Type: Number
    labelPosition 을 outside 또는 both 로 설정한 경우 라벨의 Y 위치를 추가적으로 지정합니다.(픽셀단위)
    Bar3DSeries
      
    showDataEffect
    Type: Object
    차트에 데이터가 삽입되었을 경우 재생할 애니메이션 이펙트를 정의합니다. 유효값은 SeriesInterpolate, SeriesSlide, SeriesZoom 입니다.
    Bar3DSeries
      
    stroke
    Type: Object
    시리즈 아이템의 테두리 선을 정의합니다. 유효 값은 Stroke 입니다.
    Bar3DSeries
      
    styleName
    Type: String

    Style 노드에서 정의한 스타일 이름을 지정합니다.

    Bar3DSeries
      
    textDecoration
    Type: String

    텍스트에 밑줄을 표시할지 결정합니다. 유효값은 "none", "underline" 입니다.

    The default value is "none".
    Bar3DSeries
      
    textIndent
    Type: Number   Format: Length

    텍스트에 들어쓰기를 픽셀단위로 결정합니다.

    The default value is 0.
    Bar3DSeries
      
    verticalAxis
    Type: Object
    시리즈가 참조할 수직축을 정의합니다. 정의하지 않은 경우 차트의 verticalAxis 를 참조합니다.
    Bar3DSeries
      
    visible
    Type: Boolean

    visible 이 false 라면 화면 상에 표시하지 않습니다.

    The default value is true.
    Bar3DSeries
      
    xField
    Type: String

    수평 축(horizontalAxis)의 위치를 결정하는 데이터의 필드명를 지정합니다.

    Bar3DSeries
      
    yField
    Type: String

    수직 축(verticalAxis)의 위치를 결정하는 데이터의 필드명를 지정합니다.

    Bar3DSeries