new HalfPie2DSeries()
HalfPie2DSeries 클래스는 HalfPie2DChart 클래스 인스턴스의 series 속성에 설정됩니다.
차트에 설정된 데이터를 처리하고 반원 파이를 표현합니다.
레이아웃은 다음과 같은 형식으로 작성됩니다.
<rMateChart>
<Options>
<Caption text="Half-Pie Chart" />
</Options>
<HalfPie2DChart showDataTips="true">
<series>
<HalfPie2DSeries field="Profit" nameFiled="Month" />
</series>
</HalfPie2DChart>
</rMateChart>
Extends
Members
-
alwaysShowInsideLabelBoolean
-
labelPosition 속성값이 inside 인 경우 라벨(수치값)을 항상 표시할 지 여부를 설정합니다.
- Default Value:
- false
-
calloutGapNumber
-
labelPosition 속성값이 callout 또는 insideWithCallout 일 때 차트와 라벨간의 여백 값을 설정합니다.
- Default Value:
- 20
-
calloutLabelRollOverVisibleNumber
-
LabelPosition이 callout인 라벨을 안보이게 만든 후, 마우스 롤 오버(rollover) 시에만 보이게 하는 속성
- Default Value:
- 8
-
calloutModeString
-
수치 라벨이 표시될 슬라이스 공간이 충분하지 않을 경우, 표시하는 방식을 설정합니다.
labelPosition 속성값이 inside 또는 insideWithCallout 일 경우에 적용됩니다.유효값은 다음과 같습니다.
- area - 라벨을 표시하기 위한 슬라이스 공간이 충분하지 않을 경우 라벨을 바깥쪽에 표시합니다.
- label - 라벨들이 서로 겹치게 될 경우 라벨을 바깥쪽에 표시합니다.
- Default Value:
- area
-
calloutTypeString
-
차트 외부에 라벨을 표시하고 해당되는 슬라이스를 선으로 연결할 때(callout) 라벨의 위치를 설정합니다.
유효값은 edge, around 입니다.
- Default Value:
- edge
-
displayNameString
-
시리즈의 이름을 설정합니다.
설정된 값은 기본적으로 데이터 팁(툴팁)에서 보여지게 되고 범례의 항목으로 표시됩니다.- Default Value:
- null
-
explodableBoolean
-
파이 차트 클릭 시 클릭된 슬라이스를 팝업 형태로 표시할 지 여부를 설정합니다.
- Default Value:
- true
-
fieldString
-
차트에서 사용될 데이터 중에서 슬라이스의 크기에 해당하는 데이터 필드명을 설정합니다.
- 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
-
idString
-
식별자(Identifier)를 설정합니다.
식별자(Identifier)는 사용자에 의해 정의된 임의의 고유값입니다.
설정된 식별자(Identifier)를 통해 해당 객체에 접근이 가능합니다.- Default Value:
- null
-
innerRadiusNumber
-
차트 중앙의 구멍(도넛 차트)의 크기를 설정합니다.
이 속성은 반원 파이 차트의 전체 반지름 대비 중앙 원(구멍, hole) 반지름의 퍼센트 값입니다.
도넛형 반원 차트를 만들기 위해서 이 속성을 사용할 수 있습니다.유효값은 0 과 1 사이의 값입니다.
- Default Value:
- 0.5
-
insideLabelRatioNumber
-
라벨의 위치를 설정합니다. 파이 차트의 중심에서 가장자리까지의 거리를 1에 대한 비율로 설정합니다.
labelPosition 속성값이 inside 인 경우만 적용됩니다.- Default Value:
- 0.7
-
insideLabelRollOverVisibleNumber
-
LabelPosition이 inside인 라벨을 안보이게 만든 후, 마우스 롤 오버(rollover) 시에만 보이게 하는 속성
- Default Value:
- 8
-
insideWithCalloutCompareAreaNumber
-
이 속성에 설정된 값 이상의 여유 공간이 없으면 라벨에 대한 callout 을 수행합니다.
- Default Value:
- 0
-
interactiveBoolean
-
시리즈에 마우스 오버시 데이터 팁을 보여줄 지 여부를 설정합니다.
- Default Value:
- true
-
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
-
labelFieldString
-
차트에서 사용될 데이터 중에서 라벨로 표시될 데이터 필드명을 설정합니다.
- Default Value:
- null
-
labelPositionString
-
라벨(수치값)을 표시하는 방법을 설정합니다.
유효값은 다음과 같습니다.
- none - 라벨을 표시하지 않습니다.
- outside - 차트의 가장자리에 라벨을 표시합니다.
- callout - 차트 외부에 라벨을 표시하고 해당되는 슬라이스를 선으로 연결합니다.
- inside - 차트 내부의 해당 슬라이스에 라벨을 표시합니다.
- insideWithCallout - 기본적으로 차트 내부의 슬라이스에 라벨을 표시하고, 만약 라벨이 겹치면 해당 슬라이스의 라벨은 callout 방법으로 표시합니다.
- Default Value:
- none
-
labelXOffsetNumber
-
labelPosition 속성에 설정된 라벨의 위치에서 가로위치(X축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)
- Default Value:
- 0
-
labelYOffsetNumber
-
labelPosition 속성에 설정된 라벨의 위치에서 세로위치(Y축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)
- Default Value:
- 0
-
nameFieldString
-
차트에서 사용될 데이터 중에서 범례의 라벨로 표시될 데이터 필드명을 설정합니다.
- Default Value:
- null
-
outerRadiusNumber
-
차트 외곽의 크기를 설정합니다.
이 속성은 파이 차트의 전체 반지름 대비 외곽 원 반지름의 퍼센트 값입니다.
도넛 차트를 만들기 위해서 이 속성을 사용할 수 있습니다.유효값은 0 과 1 사이의 값입니다.
- Default Value:
- 1
-
outsideLabelRollOverVisibleNumber
-
LabelPosition이 outside인 라벨을 안보이게 만든 후, 마우스 롤 오버(rollover) 시에만 보이게 하는 속성
- Default Value:
- 8
-
perWedgeExplodeRadiusArray
-
차트가 최초에 생성될 때 팝업될 슬라이스를 설정합니다.
만약 2, 7 번째 슬라이스가 팝업되기를 원한다면 다음과 같이 설정합니다. perWedgeExplodeRadius="[0, 0.1, 0, 0, 0, 0, 0.1]"- Default Value:
- null
-
radialStrokeObject
-
파이의 슬라이스를 구분하는 선(반지름 선)을 설정합니다.
유효값은 Stroke 클래스 인스턴스입니다.
- Default Value:
- null
-
renderDirectionString
-
차트의 각 슬라이스들이 생성되는 방향을 설정합니다.
유효값은 clockwise, counterClockwise 입니다.
- Default Value:
- clockwise
-
reserveExplodeRadiusNumber
-
explodable 속성값이 true 인 경우, 슬라이스가 팝업되는 영역을 미리 확보해 놓을지 여부를 설정합니다.
확보해 놓은 공간을 제외한 크기로 파이 차트가 생성됩니다.
팝업 공간을 확보해 놓음으로써, 차트를 클릭하여 특정 슬라이스가 팝업되더라도 차트의 전체 크기에는 변화가 없도록 하기위한 목적입니다.유효값은 0 또는 0.1 입니다.
- Default Value:
- 0
-
selectableBoolean
-
마우스로 데이터를 선택 가능하도록 할 지 여부를 설정합니다.
- Default Value:
- true
-
showDataEffectObject
-
차트상에 데이터가 표현되는 모습을 보여줄 애니메이션 이펙트를 설정합니다.
유효값은 SeriesInterpolate, SeriesSlide, SeriesZoom 입니다.
- Default Value:
- null
-
sortFieldString
-
사용자가 데이터의 출력 순서를 변경하고자 할 경우 출력 순서에 대한 필드명을 설정합니다.
- Default Value:
- null
-
startAngleNumber
-
첫번째 아이템을 표현하는 시작 각도를 설정합니다.
차트의 중심에서 오른쪽 가로 방향(3시 방향)이 0 이고, 기본값(default)은 180 입니다.- Default Value:
- 180
-
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
-
visibleBoolean
-
시리즈를 차트에 출력할 지 여부를 설정합니다.
- Default Value:
- true
-
zeroValueEnableBoolean
-
라벨(수치값)이 0 인 경우, 차트에 표현할 지 여부를 설정합니다.
- Default Value:
- false
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 labelJsFunction(seriesId, index, data, values)
-
파이 차트에서 labelPosition 속성을 설정한 경우, 사용자 정의 라벨(수치값)을 설정하는 자바스크립트 함수명을 설정합니다.
차트 레이아웃 설정시 Series 클래스 인스턴스의 labelJsFunction 속성값에 자바스크립트 함수명을 설정합니다.<Pie2DSeries field="Profit" nameField="Month" labelPosition="inside" labelJsFunction="pieSeriesLabelFunc"> ... pieSeriesLabelFunc(seriesId, index, data, values) { ... }
Name Type Description seriesId
String 시리즈 식별자(Identifier)
index
Number 데이터 아이템의 인덱스
data
Object 데이터 아이템의 데이터 객체
values
Array 데이터 아이템의 데이터 배열
0 : 값, 1 : 퍼센티지, 2 : nameField -
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 데이터 아이템의 데이터 배열