HotXLS-dokumentation

TXLSXChartSeries class

Unit: lxHandleX
Diagramserie med formelområden, cachade värden, dataetiketter, en samling trendlinjer och X/Y-error bars

Description

En serie bevarar sitt visningsnamn, valfri namnformel, kategori- eller X-formel, värde- eller Y-formel, bubbelstorleksformel samt den sträng- eller numeriska cache som lagras bredvid varje formel Cachade punkter förbättrar rendering offline och överlever diagramändringar, kalkylbladskopior och öppnings-/sparcykler

Seriemarkörer och utjämning

property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
MarkerFillColorFyllnadsfärg för seriens markör i linje-/punktdiagram som ett RGB-LongWord; 0 behåller Excels automatiska temafärg
MarkerBorderColorKantfärg för seriens markör som ett RGB-LongWord
SmoothSant renderar serien som en utjämnad kurva i stället för raka linjesegment; kombinera med MarkerSymbol/MarkerSize/MarkerSet
SmoothSetHuruvida utjämningsflaggan har satts explicit, vilket styr om OOXML-smooth-flaggan skrivs ut
LegendDeletedSant tar bort serien från legenden men ritar den kvar, och skriver en c:legendEntry-borttagning för seriens index

Flernivåkategorier

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;
Kategorinivåer ordnas med lövnivån först, i samma ordning som ChartML fysiska cache Varje nivå är en gles, indexerad strängcache Punkter som saknas ärver föregående etikett i sin nivå, medan en explicit lagrad tom sträng startar ett tomt span och förhindrar sammanfogning över intilliggande grupper
ResolveCategoryLevels materialiserar ett åtkomligt tvådimensionellt kategoriområde en gång och behåller i övrigt den importerade cachen BuildCategorySpans returnerar spans som beaktar föräldernivån, i O(levels × points) tid, så att identisk barnetext bara slås samman inom samma förälderspan

Dataetiketter från 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 är en A1-formel per serie och DataLabelsCache bevarar den indexerade text som lagras tillsammans med diagramet Interna kalkylbladsområden uppdateras en gång per arbetsboksgeneration, medan otillgängliga eller externa formler behåller sin importerade cache och aldrig utlöser implicit fil- eller nätverksåtkomst
ShowDataLabelsRangeSet bevarar om den gemensamma synligheten fanns explicit, och punktmetoderna underhåller glesa, nollbaserade åsidosättningar av synligheten Anpassad celltext sätts samman före komponenterna serienamn, kategori, värde, procent och bubbelstorlek, med avgränsaren insatt endast mellan icke-tomma komponenter
TXLSXChart.DataLabelsRange är fortfarande en kompatibilitetsfacade Dess setter sprider värdet till befintliga serier och förser senare serier med startvärde, medan dess getter bara returnerar ett värde när alla serier använder samma 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

Cachade punkter

Sätt cachetypen till xlsxChartCacheString eller xlsxChartCacheNumber, sätt valfritt FormatCode för numeriska data och lägg sedan till indexerade punkter Numeriska cachar utan explicit formatkod skrivs med 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