Unit: lxHandleX
수식 범위, 캐시된 값, 데이터 레이블, 추세선 컬렉션 및 X/Y 오차 막대를 갖춘 차트 계열
설명
계열은 표시 이름, 선택적 이름 수식, 범주 또는 X 수식, 값 또는 Y 수식, 거품 크기 수식, 그리고 각 수식 옆에 저장된 문자열 또는 숫자 캐시를 유지합니다. 캐시된 포인트는 오프라인 렌더링을 개선하며 차트 편집, 워크시트 복사, 열기-저장 주기에서도 유지됩니다
계열 마커와 스무딩
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | 선형/분산형 차트 계열 마커의 채우기 색(RGB LongWord). 0이면 Excel의 자동 테마 색을 유지합니다 |
| MarkerBorderColor | 계열 마커의 테두리 색(RGB LongWord) |
| Smooth | True이면 계열을 직선 세그먼트 대신 부드러운 곡선으로 렌더링합니다. MarkerSymbol/MarkerSize/MarkerSet과 함께 사용합니다 |
| SmoothSet | 스무딩 플래그가 명시적으로 설정되었는지 여부로, OOXML smooth 플래그 내보내기를 제어합니다 |
| LegendDeleted | True이면 계열은 그대로 그리되 범례에서는 제거하며, 해당 계열 인덱스에 대한 c:legendEntry 삭제 항목을 내보냅니다 |
다단계 범주
property CategoriesMultiLevel: Boolean;
property CategoryLevelCount: Integer;
property CategoryLevels[Index: Integer]: TXLSXChartDataCache;
function AddCategoryLevel: TXLSXChartDataCache;
procedure ClearCategoryLevels;
procedure ResolveCategoryLevels;
function BuildCategorySpans(APointCount: Integer;
out ASpans: TXLSXChartCategorySpans): Integer;
범주 수준은 ChartML 물리적 캐시 순서에 맞춰 리프가 먼저 오는 순서로 배치됩니다. 각 수준은 스파스 인덱스 문자열 캐시이며, 누락된 포인트는 해당 수준에서 바로 앞의 레이블을 상속합니다. 명시적으로 저장된 빈 문자열은 빈 스팬을 시작하여 인접 그룹 간 병합을 방지합니다
ResolveCategoryLevels는 접근 가능한 2차원 범주 범위를 한 번 구체화하고, 그 외의 경우 가져온 캐시를 그대로 유지합니다. BuildCategorySpans는 O(levels × points) 시간에 부모를 인식하는 스팬을 반환하므로 동일한 자식 텍스트는 같은 부모 스팬 안에서만 병합됩니다
셀 기반 데이터 레이블
property DataLabelsRange: WideString;
property DataLabelsCache: TXLSXChartDataCache;
property ShowDataLabelsRange: Boolean;
property ShowDataLabelsRangeSet: Boolean;
property SeparatorSet: Boolean;
property DataLabelRangeOverrideCount: Integer;
property DataLabelRangeOverrideIndexes[Index: Integer]: Integer;
property DataLabelRangeOverrideValues[Index: Integer]: Boolean;
procedure ResolveDataLabelsRange;
procedure SetPointShowDataLabelsRange(APointIndex: Integer;
AVisible: Boolean);
procedure ClearPointShowDataLabelsRangeOverrides;
function TryGetPointShowDataLabelsRange(APointIndex: Integer;
out AVisible: Boolean): Boolean;
DataLabelsRange는 계열별 A1 수식이고 DataLabelsCache는 차트와 함께 저장된 인덱스 텍스트를 유지합니다. 통합 문서 내부의 워크시트 범위는 통합 문서 세대당 한 번 새로 고쳐지며, 접근할 수 없는 수식이나 외부 수식은 가져온 캐시를 유지하고 암시적인 파일 또는 네트워크 접근을 절대 유발하지 않습니다
ShowDataLabelsRangeSet은 공유 가시성 설정이 명시적으로 존재했는지를 보존하고, 포인트 메서드는 희소한 0 기반 가시성 오버라이드를 관리합니다. 사용자 지정 셀 텍스트는 계열 이름, 범주, 값, 백분율, 거품 크기 구성 요소보다 먼저 배치되며, 구분 기호는 비어 있지 않은 구성 요소 사이에만 삽입됩니다
TXLSXChart.DataLabelsRange는 호환성 파사드로 남아 있습니다. setter는 기존 계열에 브로드캐스트하고 이후 추가되는 계열을 시드하며, getter는 모든 계열이 같은 수식을 사용할 때만 값을 반환합니다
속성
Name
NameRange
CategoriesRange
ValuesRange
BubbleSizeRange
DataLabelsRange
NameCache
CategoryCache
CategoriesMultiLevel
CategoryLevelCount
CategoryLevels
ValueCache
BubbleSizeCache
DataLabelsCache
DataLabelRangeOverrideCount
DataLabelRangeOverrideIndexes
DataLabelRangeOverrideValues
TrendlineCount
Trendlines
ErrBarX
ErrBarY
ShowValue
ShowCategoryName
ShowSeriesName
ShowLegendKey
ShowPercent
ShowBubbleSize
ShowDataLabelsRange
ShowDataLabelsRangeSet
Separator
SeparatorSet
MarkerFillColor
MarkerBorderColor
Smooth
SmoothSet
LegendDeleted
캐시된 포인트
캐시 종류를 xlsxChartCacheString 또는 xlsxChartCacheNumber로 설정하고, 숫자 데이터라면 필요에 따라 FormatCode를 설정한 다음 인덱스 포인트를 추가합니다. 명시적인 형식 코드가 없는 숫자 캐시는 쓰기 시 General을 사용합니다
메서드
procedure Assign
function AddTrendline
function AddErrorBar
function AddCategoryLevel
procedure ClearCategoryLevels
procedure ResolveCategoryLevels
function BuildCategorySpans
procedure ResolveDataLabelsRange
procedure SetPointShowDataLabelsRange
procedure ClearPointShowDataLabelsRangeOverrides
function TryGetPointShowDataLabelsRange
참고 항목