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 데이터 아이템의 데이터 배열