Unit: lxHandleX
Grafiekserie met formulebereiken, gecachte waarden, gegevenslabels, een verzameling trendlijnen en X/Y-foutbalken
Description
Een serie behoudt de weergavenaam, een optionele naamformule, de categorie- of X-formule, de waarde- of Y-formule, de bubble-size-formule en de tekenreeks- of numerieke cache die naast elke formule wordt opgeslagen. Gecachte punten verbeteren offline rendering en overleven grafiekbewerkingen, kopieën van werkbladen en open-savecycli
Seriemarkers en afvlakking
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | Vulkleur van de seriemarkers voor lijn-/spreidingsdiagrammen als RGB-LongWord; 0 houdt de automatische themakleur van Excel aan |
| MarkerBorderColor | Randkleur van de seriemarkers als RGB-LongWord |
| Smooth | True tekent de serie als afgevlakte curve in plaats van rechte lijnsegmenten; combineer met MarkerSymbol/MarkerSize/MarkerSet |
| SmoothSet | Of de afvlakkingsvlag expliciet is ingesteld; dit bepaalt of de OOXML-smooth-vlag wordt uitgeschreven |
| LegendDeleted | True haalt deze serie uit de legenda terwijl hij getekend blijft, met een c:legendEntry-delete voor de serie-index tot gevolg |
Categorieën op meerdere niveaus
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;
Categorieniveaus staan in blad-eerst-volgorde, gelijk aan de fysieke ChartML-cachevolgorde. Elk niveau is een schaarse geïndexeerde tekenreeks-cache. Ontbrekende punten erven het voorafgaande label in dat niveau, terwijl een expliciet opgeslagen lege tekenreeks een leeg span start en voorkomt dat er over aangrenzende groepen heen wordt samengevoegd
ResolveCategoryLevels materialiseert een bereikbaar tweedimensionaal categoriebereik eenmalig en laat in alle andere gevallen de geïmporteerde cache staan. BuildCategorySpans levert in O(levels × points) spans die de ouderstructuur volgen, zodat identieke kindtekst alleen binnen dezelfde ouderspan wordt samengevoegd
Gegevenslabels uit cellen
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 is een A1-formule per serie en DataLabelsCache bewaart de geïndexeerde tekst die bij de grafiek is opgeslagen. Interne werkbladbereiken worden een keer per werkmapgeneratie ververst, terwijl onbereikbare of externe formules hun geïmporteerde cache houden en nooit impliciete bestands- of netwerktoegang veroorzaken
ShowDataLabelsRangeSet bewaart of de gedeelde zichtbaarheid expliciet aanwezig was, en de puntmethoden beheren schaarse, op nul gebaseerde zichtbaarheidsoverrides. Aangepaste celtekst wordt vóór de onderdelen serienaam, categorie, waarde, percentage en bubble-size samengesteld, waarbij het scheidingsteken alleen tussen niet-lege onderdelen komt
TXLSXChart.DataLabelsRange blijft een compatibiliteitsfacade. De setter werkt bestaande series bij en geeft latere series hun beginwaarde, terwijl de getter alleen een waarde teruggeeft als elke serie dezelfde formule gebruikt
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
Gecachte punten
Zet een cachetype op xlsxChartCacheString of xlsxChartCacheNumber, stel optioneel FormatCode in voor numerieke gegevens en voeg daarna geïndexeerde punten toe. Numerieke caches zonder expliciete indelingscode worden met General weggeschreven
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