TXLSXChartAxis class - HotXLS Developer Reference

Unit: lxHandleX

Typovaný popisovač kategoriové, hodnotové, datové a řadové osy pro primární, sekundární i trojrozměrné osy grafu

Popis

Každý graf vlastní primární kategoriovou a hodnotovou osu, sekundární kategoriovou a hodnotovou osu a osu hloubky řad. Druh osy může zůstat automatický, nebo se nastaví na category, value, date či series, přičemž importované identifikátory os a zkřížené vazby zůstávají při ukládání stabilní

Deklarace

type
  TXLSXChartAxis = class
    property Kind: TXLSXChartAxisKind;
    property Position: TXLSXChartAxisPosition;
    property AxisId: Integer;
    property CrossAxisId: Integer;
    property Visible: Boolean;
    property Title: WideString;
    property LogBase: Double;
    property Orientation: TXLSXChartAxisOrientation;
    property MajorGridlines: Boolean;
    property MinorGridlines: Boolean;
    property MinValue: Double;
    property MaxValue: Double;
    property MajorUnit: Double;
    property MinorUnit: Double;
    property MajorUnitSet: Boolean;
    property MinorUnitSet: Boolean;
    property CrossesAt: Double;
    property TickLblPos: WideString;
    property Crosses: TXLSXChartCrosses;
    property CrossesSet: Boolean;
    property MajorTickMark: TXLSXChartTickMark;
    property MinorTickMark: TXLSXChartTickMark;
    property DispUnits: Double;
    property ShowDispUnitsLabel: Boolean;
    property BaseTimeUnit: TXLSXChartTimeUnit;
    property MajorTimeUnit: TXLSXChartTimeUnit;
    property MinorTimeUnit: TXLSXChartTimeUnit;
    property BaseTimeUnitSet: Boolean;
    property MajorTimeUnitSet: Boolean;
    property MinorTimeUnitSet: Boolean;
    property AutoDateAxis: Boolean;
    property AutoDateAxisSet: Boolean;
    property NumberFormat: WideString;
    property NumberFormatSourceLinked: Boolean;
    property NumberFormatSet: Boolean;
    property LabelInterval: Integer;
    property TickMarkInterval: Integer;
    property NoMultiLevelLabels: Boolean;
    property TextStyle: TXLSXChartTextStyle;
    property TitleTextStyle: TXLSXChartTextStyle;
    property TitleLayout: TXLSXChartLayout;
    procedure Assign(Source: TXLSXChartAxis);
    procedure AssignClassicDateAxis(Source: TXLSChartAxis);
  end;

Vlastnosti

Kind	Typ osy — automatic, category, value, date nebo series
Position	Pozice osy v rámci oblasti vykreslení — normal, low nebo high
AxisId	Stabilní identifikátor osy zachovaný napříč cykly ukládání
CrossAxisId	Identifikátor osy, kterou protínající osa protíná
Visible	Zda se osa vykresluje
Title	Text názvu osy
LogBase	Základ logaritmického měřítka; nula znamená lineární
Orientation	Směr osy — normal nebo reversed
MajorGridlines	Zobrazit hlavní mřížku v rozestupech hlavní jednotky
MinorGridlines	Zobrazit vedlejší mřížku v rozestupech vedlejší jednotky
MinValue	Pevná minimální hodnota; NaN znamená automaticky
MaxValue	Pevná maximální hodnota; NaN znamená automaticky
MajorUnit	Rozestup hlavní mřížky; nula znamená automaticky
MinorUnit	Rozestup vedlejší mřížky; nula znamená automaticky
MajorUnitSet	Zda je kladná hodnota hlavní jednotky přítomna explicitně
MinorUnitSet	Zda je kladná hodnota vedlejší jednotky přítomna explicitně
CrossesAt	Hodnota, v níž protínající osa protíná; NaN znamená automaticky
TickLblPos	Pozice popisků — 'nextTo', 'low', 'high' nebo 'none'
Crosses	Režim protnutí os. Přiřazení `Crosses` emituje `<c:crosses val="..."/>` místo automatického protnutí; explicitní `CrossesAt` má při nastavení stále přednost (nastavení obou je neplatné OOXML a `CrossesAt` zvítězí)
CrossesSet	Zda byl režim protnutí explicitně nastaven
MajorTickMark	Styl hlavních značek, kreslených v průsečících hlavní mřížky
MinorTickMark	Styl vedlejších značek, kreslených v průsečících vedlejší mřížky
DispUnits	Faktor škálování zobrazovacích jednotek (10, 100, 1000 ...) nebo vestavěná jednotka; nula vypne
ShowDispUnitsLabel	Zobrazit u osy popisek zobrazovací jednotky ('Thousands', 'Millions', ...)
BaseTimeUnit	Základní časová jednotka datové osy; přiřazení označí hodnotu za explicitní, i když jde o `xlsxChartTimeDays`
MajorTimeUnit	Hlavní časová jednotka datové osy; přiřazení označí hodnotu za explicitní
MinorTimeUnit	Vedlejší časová jednotka datové osy; přiřazení označí hodnotu za explicitní
BaseTimeUnitSet	Řídí, zda se emituje `baseTimeUnit`; False zachová vynechaný zdrojový element místo zápisu explicitní denní jednotky
MajorTimeUnitSet	Řídí, zda se `majorTimeUnit` emituje nezávisle na `MajorUnit`
MinorTimeUnitSet	Řídí, zda se `minorTimeUnit` emituje nezávisle na `MinorUnit`
AutoDateAxis	Explicitní hodnota automatické detekce kategorií datové osy
AutoDateAxisSet	Řídí, zda se emituje element `auto` datové osy
NumberFormat	Formát čísel aplikovaný na popisky osy; přiřazení označí formát za explicitní
NumberFormatSourceLinked	Zda formát popisků osy následuje zdrojová data; přiřazení označí formát za explicitní
NumberFormatSet	Řídí, zda se emituje element ChartML `numFmt`
LabelInterval	Interval mezi popisky kategorií
TickMarkInterval	Interval mezi značkami na kategoriové ose
NoMultiLevelLabels	True zobrazí pouze nejnižší úroveň kategorií a zapíše přepínač `noMultiLvlLbl` kategoriové osy
TextStyle	Textový styl popisků
TitleTextStyle	Textový styl názvu osy
TitleLayout	Pozice a velikost názvu osy

Výběr osy

xlsxAxisAutomatic vybere kategoriovou osu pro běžné skupiny grafu a hodnotovou osu pro skupiny scatter či bubble. xlsxAxisDate použijte spolu s vlastnostmi časových jednotek pro kalendářní škálování a xlsxAxisSeries pro trojrozměrnou osu hloubky

Hodnoty časových jednotek datové osy a jejich příznaky přítomnosti jsou nezávislé. Importované soubory si proto zachovají vynechané elementy, zatímco přiřazení jednotky hodnotu zapíše explicitně. AssignClassicDateAxis přenese aktivní nastavení Classic datové osy a maskovaná či neplatná surová pole nechá ve zdrojovém modelu, aby Classic Roundtrip zůstal bezztrátový

Když jsou jednotky či intervaly vynechány, vykreslení jednorázově projde všechny viditelné řady, odvodí škálování na dny, měsíce či roky a zvolí rozumnou hustotu popisků podle viditelného rozsahu, šířky osy, změřeného textu, formátu čísel a rotace. Hlavní i vedlejší popisky, souřadnice, značky a mřížka pak sdílejí výsledné kolekce

NumberFormat a NumberFormatSourceLinked zachovávají stav formátu popisků ChartML. Datové osy tento formát používají pro vykreslené popisky a Orientation obrací souřadnice popisků i dat, aniž by sbalila duplicitní data nebo rovnoměrně rozestoupila řídká data

Kategoriové osy vykreslují hierarchické cache řad od nejnižší úrovně u osy k postupně nadřazeným úrovním. NoMultiLevelLabels potlačí nadřazené úrovně a při převodu modelů namapuje ekvivalentní příznak Classic grafu

Rozvržení textu a názvu

TextStyle formátuje popisky, TitleTextStyle pak název osy. Oba vystavují typovaná nastavení názvu, velikosti, barvy, zvýraznění a rotace. Kladné hodnoty rotace v ChartML jsou po směru hodinových ručiček a konvertují se do nativní konvence každého výstupního backendu

TitleLayout pozicuje a rozměřuje název osy pomocí normalizovaných souřadnic ChartML. SetPositionAndSize zapne a nastaví všech čtyři hodnoty najednou jako jednu skupinu kompatibilní s Office

Metody

procedure Assign

Viz také

XLSX Facade Overview

Třída TXLSXWorksheet

Třída TXLSXWorkbook

Třída TXLSXChartTextStyle

Třída TXLSXChartLayout

Třída TXLSXChartAxis