HotXLS-dokumentation

TXLSXChartSeries class

Unit: lxHandleX
Diagramserie med formelområder, cachede værdier, dataetiketter, en trendline-samling og X/Y-error bars

Description

En serie bevarer sit visningsnavn, sin valgfrie navneformel, sin kategori- eller X-formel, sin værdi- eller Y-formel, sin bubble-size-formel og den streng- eller numeriske cache, der gemmes ved siden af hver formel. Cachede punkter forbedrer offline-rendering og overlever diagramredigeringer, regnearkskopier og gem-/åbn-cyklusser

Seriemarkører og udjævning

property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
MarkerFillColorFyldefarven på seriens markør i linje-/punktdiagrammer som en RGB-LongWord; 0 bevarer Excels automatiske temafarve
MarkerBorderColorKantfarven på seriens markør som en RGB-LongWord
SmoothTrue renderer serien som en udjævnet kurve i stedet for lige linjesegmenter; kombiner med MarkerSymbol/MarkerSize/MarkerSet
SmoothSetOm udjævningsflaget er blevet sat eksplicit, hvilket styrer, om OOXML'ens smooth-flag skrives
LegendDeletedTrue fjerner serien fra legenden, mens den stadig plottes, ved at der udsendes en c:legendEntry-sletning for seriens indeks

Kategorier med flere niveauer

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;
Kategoriniveauerne ordnes med bladene først, svarende til ChartML'ens fysiske cache-rækkefølge. Hvert niveau er en sparse, indekseret streng-cache. Manglende punkter arver den foregående etiket på deres niveau, mens en eksplicit gemt tom streng starter et tomt span og forhindrer, at tilstødende grupper lægges sammen
ResolveCategoryLevels materialiserer et tilgængeligt todimensionelt kategoriområde én gang og beholder ellers den importerede cache. BuildCategorySpans returnerer parent-opdelte spans i O(levels × points)-tid, så identisk børnetekst kun flettes inden for det samme parent-span

Dataetiketter fra celler

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 er en A1-formel pr. serie, og DataLabelsCache bevarer den indekserede tekst, der er gemt sammen med diagrammet. Interne regnearksområder opdateres én gang pr. projektmappegeneration, mens utilgængelige eller eksterne formler beholder deres importerede cache og aldrig udløser implicit fil- eller netværksadgang
ShowDataLabelsRangeSet bevarer, om den fælles synlighed var eksplicit til stede, og punktmetoderne vedligeholder sparse, nulbaserede synligheds-overrides. Brugerdefineret celletekst sammensættes foran seriens navn og kategori-, værdi-, procent- og bubble-size-komponenterne, og separatoren indsættes kun mellem ikke-tomme komponenter
TXLSXChart.DataLabelsRange forbliver en kompatibilitetsfacade. Setteren sætter værdien på alle eksisterende serier og forudfylder senere serier, mens getteren kun returnerer en værdi, når alle serier bruger samme formel

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

Cachede punkter

Sæt cachetypen til xlsxChartCacheString eller xlsxChartCacheNumber, sæt evt. FormatCode for numeriske data, og tilføj derefter indekserede punkter. Numeriske cacher uden eksplicit formatkode bruger General, når de skrives

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