HotXLS-Doku

TXLSXChartSeries class

Unit: lxHandleX
Diagrammreihe mit Formelbereichen, zwischengespeicherten Werten, Datenbeschriftungen, Trendlinien-Sammlung und X-/Y-Fehlerbalken

Description

Eine Reihe behält ihren Anzeigenamen, die optionale Namensformel, die Kategorie- bzw. X-Formel, die Wert- bzw. Y-Formel, die Blasengrößenformel sowie den String- bzw. numerischen Cache, der neben jeder Formel abgelegt ist. Zwischengespeicherte Punkte verbessern die Offline-Darstellung und überstehen Diagrammbearbeitungen, Arbeitsblattkopien und Öffnen-Speichern-Zyklen

Reihenmarker und Glättung

property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
MarkerFillColorFüllfarbe des Reihenmarkers für Linien-/Punktdiagramme als RGB- LongWord; 0 belässt die automatische Designfarbe von Excel
MarkerBorderColorRahmenfarbe des Reihenmarkers als RGB- LongWord
Smoothzeichnet die Reihe als geglättete Kurve statt als gerade Liniensegmente; zusammen mit MarkerSymbol/MarkerSize/MarkerSet
SmoothSetGibt an, ob das Glättungs-Flag explizit gesetzt wurde, und steuert damit, ob das OOXML-Glättungs-Flag geschrieben wird
LegendDeletedentfernt diese Reihe aus der Legende, ohne sie aus der Zeichnung zu nehmen, und schreibt für ihren Reihenindex einen c:legendEntry -Löscheintrag

Mehrstufige Kategorien

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;
Kategorieebenen sind mit den Blattelementen zuerst geordnet, passend zur physischen ChartML-Cache-Reihenfolge. Jede Ebene ist ein sparsamer indizierter String-Cache. Fehlende Punkte erben die vorherige Beschriftung derselben Ebene, während ein explizit gespeicherter leerer String einen leeren Span beginnt und das Zusammenführen über benachbarte Gruppen hinweg verhindert
ResolveCategoryLevels materialisiert einen zugreifbaren zweidimensionalen Kategoriebereich genau einmal und behält ansonsten den importierten Cache bei. BuildCategorySpans liefert in O(levels × points) Spans, die die Parent-Ebene einbeziehen, sodass identischer Untertext nur innerhalb desselben Parent-Span zusammengeführt wird

Datenbeschriftungen aus Zellen

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 ist eine A1-Formel je Reihe, und DataLabelsCache bewahrt den beim Diagramm gespeicherten indizierten Text. Interne Arbeitsblattbereiche werden einmal pro Arbeitsmappengeneration aktualisiert, während nicht zugreifbare oder externe Formeln ihren importierten Cache behalten und niemals impliziten Datei- oder Netzwerkzugriff auslösen
ShowDataLabelsRangeSet bewahrt, ob die gemeinsame Sichtbarkeit explizit vorhanden war, und die Punkt-Methoden verwalten sparsame nullbasierte Sichtbarkeits-Overrides. Benutzerdefinierter Zelltext wird vor den Komponenten Reihenname, Kategorie, Wert, Prozent und Blasengröße zusammengesetzt, wobei das Trennzeichen nur zwischen nichtleeren Komponenten eingefügt wird
TXLSXChart.DataLabelsRange bleibt eine Kompatibilitäts-Fassade. Der Setter verteilt den Wert an vorhandene Reihen und legt ihn für spätere Reihen als Startwert ab, während der Getter nur dann einen Wert liefert, wenn alle Reihen dieselbe Formel verwenden

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

Zwischengespeicherte Punkte

Setzen Sie einen Cache-Typ auf xlsxChartCacheString oder xlsxChartCacheNumber, legen Sie für numerische Daten optional FormatCode fest und fügen Sie anschließend indizierte Punkte hinzu. Numerische Caches ohne expliziten Formatcode verwenden beim Schreiben General when written

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