Unit: lxHandleX
数式範囲、キャッシュされた値、データラベル、近似曲線コレクション、X/Y 誤差範囲を備えたグラフの系列
Description
各系列は、表示名、オプションの名前数式、カテゴリまたは X 数式、値または Y 数式、バブル サイズ数式、そして各数式の横に格納される文字列または数値のキャッシュを保持します。キャッシュされたポイントはオフライン描画を改善し、グラフの編集、ワークシートのコピー、開いて保存するサイクルを経ても保持されます
Series markers and smoothing
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | 折れ線/散布図チャートの系列マーカーの塗りつぶし色。RGB の LongWordで指定し、 0 は Excel の自動テーマ カラーのままになります |
| MarkerBorderColor | 系列マーカーの枠線の色。RGB の LongWord |
| Smooth | にすると、直線セグメントの代わりに平滑化された曲線として系列を描画します。 MarkerSymbol/MarkerSize/MarkerSet |
| SmoothSet | 平滑化フラグが明示的に設定されたかどうか。OOXML の smooth フラグを出力するかどうかの判定に使われます |
| LegendDeleted | にすると、系列をプロットしたまま凡例から取り除きます。系列インデックスに対する c:legendEntry の削除を出力します |
Multi-level categories
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 次元のカテゴリ範囲を 1 度だけ実体化し、それ以外の場合はインポートされたキャッシュを保持します。 BuildCategorySpans は親を考慮したスパンを O(levels × points) の計算量で返すため、同じ子テキストは同じ親スパン内でのみ結合されます
Cell-sourced data labels
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 はグラフと一緒に格納されたインデックス付きテキストを保持します。内部のワークシート範囲はワークブックの世代ごとに 1 回更新され、アクセスできない範囲や外部の数式はインポートされたキャッシュを保持し、暗黙的なファイル アクセスやネットワーク アクセスは一切発生しません
ShowDataLabelsRangeSet は共有の表示設定が明示的に存在していたかどうかを保持し、ポイント単位のメソッドはスパースな 0 始まりの表示オーバーライドを管理します。セルのカスタム テキストは、系列名、カテゴリ、値、パーセント、バブル サイズの各要素より先に構成され、区切り記号は空でない要素の間にのみ挿入されます
TXLSXChart.DataLabelsRange は互換性ファサードとして残されています。セッターは既存の系列へ値を配信し、後から作成される系列の初期値としても使われます。ゲッターは、すべての系列が同じ数式を使っている場合にのみ値を返します
Properties
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
Cached points
キャッシュの種類を xlsxChartCacheString または xlsxChartCacheNumberに設定し、数値データには必要に応じて FormatCode を設定してから、インデックス付きのポイントを追加します。明示的な書式コードのない数値キャッシュは、書き込み時に General が使用されます
Methods
procedure Assign
function AddTrendline
function AddErrorBar
function AddCategoryLevel
procedure ClearCategoryLevels
procedure ResolveCategoryLevels
function BuildCategorySpans
procedure ResolveDataLabelsRange
procedure SetPointShowDataLabelsRange
procedure ClearPointShowDataLabelsRangeOverrides
function TryGetPointShowDataLabelsRange
See also