Class: Column2DWingSeries

Column2DWingSeries

new Column2DWingSeries()

Column2DWingSeries 클래스는 Column2DWingChart 클래스 인스턴스의 series 속성에 설정됩니다.

차트에 설정된 데이터를 처리하고 세로 막대(컬럼)로 상,하에 하나씩 차트를 표현합니다.

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

<rMateChart>
  <Options>
    <Caption text="Annual Report" />
  </Options>
  <Column2DWingChart showDataTips="true">
    <horizontalAxis>
      <CategoryAxis categoryField="Month" />
    </horizontalAxis>
    <series>
      <Column2DWingSeries yField="Profit" yFieldOpp="ProfitOpp" />
      <Column2DWingSeries yField="Cost" yFieldOpp="CostOpp" />
      <Column2DWingSeries yField="Revenue" yFieldOpp="RevenueOpp" />
    </series>
  </Column2DWingChart>
</rMateChart>

Extends

Members

alwayShowLinesBoolean

lineToEachItems 속성값이 true 인 경우, 값이 0 인 데이터 포인트(데이터 아이템)에도 선을 연결할 지 여부를 설정합니다.

Default Value:
  • false

columnWidthRatioNumber

표시하는 컬럼(column)의 넓이값을 카테고리의 넓이값에 대한 비율(범위는 0 ~ 1)로 설정합니다.

값이 1 이면 영역 전체가 사용되며, 값이 0.6 이면 컬럼(column)의 사용 가능 영역은 60% 가 됩니다.

실제 컬럼(column)의 넓이는 columnWidthRatio 속성과 maxColumnWidth 속성을 계산하여 그중 작은 값이 적용됩니다.

Default Value:
  • 0.5

displayNameString

시리즈의 이름을 설정합니다.

설정된 값은 기본적으로 데이터 팁(툴팁)에서 보여지게 되고 범례의 항목으로 표시됩니다.

Default Value:
  • null

fillObject

시리즈 아이템렌더러의 채우기 색을 설정합니다.

Default Value:
  • null

fillsArray

차트에 표시되는 데이터가 여러개 일 때, 각 데이터에 서로 다른 색상을 설정합니다.

만약 데이터 수만큼의 색상 객체(SolidColor)가 설정되지 않으면 설정된 색상이 반복 적용됩니다.

예를 들어, 시리즈의 데이터 수가 10 이고 5 개의 색상 객체(SolidColor)가 설정되었다면, 5 개의 색상 객체가 처음 5 개의 데이터에 순서대로 적용되고 나머지 5 개의 데이터에는 5 개의 색상 객체가 다시 순차적으로 적용됩니다.

유효값은 SolidColor 클래스의 인스턴스 배열입니다.

<fills>
  <SolidColor color="0xCC66FF" />
  <SolidColor color="0x9966CC" />
  <SolidColor color="0x9999CC" />
</fills>
Default Value:
  • null

formatterObject

숫자값을 원하는 숫자(통화, 날짜) 형식으로 표현하기 위한 포맷터(NumberFormatter, CurrencyFormatter, DateFormatter)를 설정합니다.

Default Value:
  • NumberFormatter

halfWidthOffsetNumber

다중 컬럼(Column) 윙 시리즈가 존재할 경우, 이웃한 컬럼 사이의 간격을 픽셀 단위로 설정합니다.

두 개의 Column2DWingSeries 가 존재하고, halfWidthOffset 속성값이 0.5 이면 두 컬럼(Column) 사이에는 1px 의 여백이 생깁니다.

Default Value:
  • 0

idString

식별자(Identifier)를 설정합니다.

식별자(Identifier)는 사용자에 의해 정의된 임의의 고유값입니다.

설정된 식별자(Identifier)를 통해 해당 객체에 접근이 가능합니다.

Default Value:
  • null

insideLabelFieldString

labelPosition 속성값이 inside 또는 both 인 경우 라벨로 표시될 데이터 필드명을 설정합니다.

insideLabelJsFunction 속성이 설정되어 자바스크립트에 의한 사용자 정의 라벨이 표시될 경우 이 속성은 무시됩니다.

Default Value:
  • null

insideLabelFieldOppString

labelPosition 속성값이 inside 또는 both 인 경우 왼쪽 영역 라벨로 표시될 데이터 필드명을 설정합니다.

insideLabelJsFunction 속성이 설정되어 자바스크립트에 의한 사용자 정의 라벨이 표시될 경우 이 속성은 무시됩니다.

Default Value:
  • null

insideLabelRollOverVisibleNumber

LabelPosition이 inside인 라벨을 안보이게 만든 후, 마우스 롤 오버(rollover) 시에만 보이게 하는 속성

Default Value:
  • 8

insideLabelXOffsetNumber

labelPosition 속성값이 inside 또는 both 인 경우 가로위치(X축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • 0

insideLabelYOffsetNumber

labelPosition 속성값이 inside 또는 both 인 경우 세로위치(Y축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • 0

interactiveBoolean

시리즈에 마우스 오버시 데이터 팁을 보여줄 지 여부를 설정합니다.

Default Value:
  • true

interpolateValueLinesBoolean

연결선 중간에 Null 데이터가 존재할 경우 Null 데이터를 0으로 처리할 지 여부를 설정합니다.

Default Value:
  • false

itemRendererObject

차트상의 데이터 포인트(데이터 아이템)에 표현될 막대의 모양을 렌더링하는 클래스를 설정합니다.

유효값은 BoxItemRenderer, GradientColumnItemRenderer, SemiCircleColumnItemRenderer 입니다.

Default Value:
  • GradientColumnItemRenderer

itemRollOverColorHexadecimal

데이터 아이템에 마우스 오버했을 때의 색상을 설정합니다.

Default Value:
  • null

itemRollOverEmphasizeBoolean

데이터 아이템에 마우스 오버했을 때의 아이템을 강조합니다.

Default Value:
  • false

itemSelectionColorHexadecimal

데이터 아이템을 선택했을 떄의 색상을 설정합니다.

Default Value:
  • null

labelBackgroundColorString

라벨 배경의 색상을 설정합니다.

Default Value:
  • transparent

labelBorderRadiusNumber

라벨 테두리의 둥근 정도를 설정합니다.

Default Value:
  • 0

labelBoxHeightOffsetNumber

라벨 배경의 추가 높이값을 설정합니다.

Default Value:
  • 0

labelBoxWidthOffsetNumber

라벨 배경의 추가 너비값을 설정합니다.

Default Value:
  • 0

lineToEachItemsBoolean

데이터 포인트들에 대한 연결선을 표시할 지 여부를 설정합니다.

Default Value:
  • false

linkLabelColorHexadecimal

연결선 라벨에 대한 색상(RGB)을 설정합니다.

Default Value:
  • #000000

linkLabelFontFamilyString

연결선 라벨에 대한 폰트명을 설정합니다.

Default Value:
  • arial

linkLabelFontSizeNumber

연결선 라벨에 대한 폰트 크기를 픽셀 단위로 설정합니다.

Default Value:
  • 11

linkLabelFontWeightString

볼드체로 연결선 라벨을 표시할 지 여부를 설정합니다.

유효값은 normal, bold 입니다.

Default Value:
  • normal

linkLabelNegativeColorHexadecimal

연결선 라벨이 음수일 경우 선의 색상을 설정합니다.

Default Value:
  • #0054ff

linkLabelPositiveColorHexadecimal

연결선 라벨이 양수일 경우 선의 색상을 설정합니다.

Default Value:
  • #ff3636

linkLabelXOffsetNumber

연결선 라벨에 가로위치(X축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • 0

linkLabelYOffsetNumber

연결선 라벨에 세로위치(Y축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • 0

linkLineStrokeObject

데이터 포인트들에 대한 연결선을 설정합니다.

유효값은 Stroke 클래스 인스턴스입니다.

Default Value:
  • null

maxColumnWidthNumber

컬럼(column)의 최대 넓이값을 픽셀 단위로 설정합니다.

실제 컬럼(column)의 넓이는 columnWidthRatio 속성과 maxColumnWidth 속성을 계산하여 그중 작은 값이 적용됩니다.

Default Value:
  • NaN

minFieldString

X, Y 좌표값 외에 추가적인 정보를 제공하는 데이터 필드명을 설정합니다.

예를 들어, 최소값(minimum)에 해당되는 데이터 필드명을 추가로 설정하여 From-To 차트를 생성할 수 있습니다.

Default Value:
  • null

outsideLabelFieldString

labelPosition 속성값이 outside 또는 both 인 경우 라벨로 표시될 데이터 필드명을 설정합니다.

outsideLabelJsFunction 속성이 설정되어 자바스크립트에 의한 사용자 정의 라벨이 표시될 경우 이 속성은 무시됩니다.

Default Value:
  • null

outsideLabelFieldOppString

labelPosition 속성값이 outside 또는 both 인 경우 왼쪽 영역 라벨로 표시될 데이터 필드명을 설정합니다.

outsideLabelJsFunction 속성이 설정되어 자바스크립트에 의한 사용자 정의 라벨이 표시될 경우 이 속성은 무시됩니다.

Default Value:
  • null

outsideLabelRollOverVisibleNumber

LabelPosition이 outside인 라벨을 안보이게 만든 후, 마우스 롤 오버(rollover) 시에만 보이게 하는 속성

Default Value:
  • 8

outsideLabelXOffsetNumber

labelPosition 속성값이 outside 또는 both 인 경우 가로위치(X축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • 0

outsideLabelYOffsetNumber

labelPosition 속성값이 outside 또는 both 인 경우 세로위치(Y축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • 0

sameAxisRatioBoolean

horizontalAxis 와 horizontalAxisOpp 속성에 설정된 축들의 최대값을 동일하게 할 지 여부를 설정합니다.

Default Value:
  • true

selectableBoolean

마우스로 데이터를 선택 가능하도록 할 지 여부를 설정합니다.

Default Value:
  • true

showLinkLabelsBoolean

lineToEachItems 속성값이 true 일 경우, 이전 데이터와 현재 데이터의 비교값 라벨을 출력할 지 여부를 설정합니다.

Default Value:
  • true

showValueLabelsArray

labelPosition 속성에 의해서 라벨이 표시되는 경우 설정된 데이터 아이템만 표시하도록 설정합니다.

데이터 아이템들의 인덱스 배열을 설정합니다.

예를 들어, 1, 5, 10 인덱스의 데이터 아이템들만 표시할 필요가 있으면, showValueLabels = "[1,5,10]" 와 같이 설정합니다.

Default Value:
  • null

strokeObject

윈드로즈로 표현되는 선을 설정합니다.

유효값은 Stroke 클래스 인스턴스입니다.

Default Value:
  • null

styleNameString

스타일을 <Style> 노드에 설정할 경우, <Style> 노드에 정의된 이름을 설정합니다.

<Style> 노드에 스타일을 정의할 때는 반드시 스타일명 앞에 마침표가 위치해야 합니다.

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

<Bar3DChart>
  <Bar3DSeries xField="Profit" styleName="seriesStyle">
  ...
</Bar3DChart>
<Style>
  .seriesStyle {fontFamily:"Malgun Gothic";labelPosition:inside;fontSize:11;paddingTop:4;color:0x000099;}
</Style>
Default Value:
  • null

verticalAxisOppObject

차트의 아래쪽 영역의 세로축을 설정합니다.

유효값은 LinearAxis 클래스의 인스턴스입니다.

Default Value:
  • null

visibleBoolean

시리즈를 차트에 출력할 지 여부를 설정합니다.

Default Value:
  • true

xFieldString

데이터 아이템의 X 좌표값(수평축에서의 위치)을 결정하는 데이터 필드명을 설정합니다.

Default Value:
  • null

yFieldString

윙의 위쪽 데이터 아이템의 Y 좌표값(수직축에서의 위치)을 결정하는 데이터 필드명을 설정합니다.

Default Value:
  • null

yFieldOppString

윙의 아래쪽 데이터 아이템의 Y 좌표값(수직축에서의 위치)을 결정하는 데이터 필드명을 설정합니다.

Default Value:
  • null

Methods

inherited fillJsFunction(seriesId, index, data, values)

사용자 정의 색상을 설정하는 자바스크립트 함수명을 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 fillJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" fillJsFunction="fillJsFunc">
...
fillJsFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값
Name Type Description
seriesId String

시리즈 식별자(Identifier)

index Number

데이터 아이템의 인덱스

data Object

데이터 아이템의 데이터 객체

values Array

데이터 아이템의 데이터 배열

inherited htmlJsFunction(seriesId, index, data, values)

차트의 데이터 아이템들 중에서 설정된 조건을 만족하는 데이터 아이템에 대해서 실핼될 자바스크립트 함수명을 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 htmlJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" htmlJsFunction="userElementFunc">
...
userElementFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값
Name Type Description
seriesId String

시리즈 식별자(Identifier)

index Number

데이터 아이템의 인덱스

data Object

데이터 아이템의 데이터 객체

values Array

데이터 아이템의 데이터 배열

inherited insideLabelJsFunction(seriesId, index, data, values)

labelPosition 속성값이 inside 또는 both 인 경우 사용자 정의 라벨을 출력할 자바스크립트 함수명을 설정합니다.

<Bar2DWingSeries xField="Profit" insideLabelJsFunction="insideLabelFunc">
...
insideLabelFunc(seriesId, index, data, values) {
  ...
}
Name Type Description
seriesId String

시리즈 식별자(Identifier)

index Number

데이터 아이템의 인덱스

data Object

데이터 아이템의 데이터 객체

values Array

데이터 아이템의 데이터 배열
0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값

inherited outsideLabelJsFunction(seriesId, index, data, values)

labelPosition 속성값이 outside 또는 both 인 경우 사용자 정의 라벨을 출력할 자바스크립트 함수명을 설정합니다.

<Bar2DWingSeries xField="Profit" outsideLabelJsFunction="outsideLabelFunc">
...
outsideLabelFunc(seriesId, index, data, values) {
  ...
}
Name Type Description
seriesId String

시리즈 식별자(Identifier)

index Number

데이터 아이템의 인덱스

data Object

데이터 아이템의 데이터 객체

values Array

데이터 아이템의 데이터 배열
0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값

inherited strokeJsFunction(seriesId, index, data, values)

아이템 렌더러에 의해 표현되는 아이템 테두리에 대한 사용자 정의 함수를 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 strokeJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" strokeJsFunction="strokeJsFunc">
...
strokeJsFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값
Name Type Description
seriesId String

시리즈 식별자(Identifier)

index Number

데이터 아이템의 인덱스

data Object

데이터 아이템의 데이터 객체

values Array

데이터 아이템의 데이터 배열