Dokumentacja HotXLS

TXLSXChartAxis class

Unit: lxHandleX
Typowany deskerator osi kategorii, wartości, dat i serii dla osi wykresów podstawowych, pomocniczych i trójwymiarowych

Description

Każdy wykres posiada podstawową i pomocniczą oś kategorii oraz wartości i osią głębokości serii. Rodzaj osi może pozostać automatyczny albo być ustawiony na kategorię, wartość, datę lub serię, przy czym zaimportowane identyfikatory osi i powiązania przecięć pozostają stabilne przez cykle zapisu

Declaration

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;

Properties

KindRodzaj osi — automatyczny, kategoria, wartość, data albo seria
PositionPozycja osi w obszarze wykresu — normalna, niska albo wysoka
AxisIdStabilny identyfikator osi zachowywany przez cykle zapisu
CrossAxisIdIdentyfikator osi, którą przecina oś przecinająca
VisibleCzy oś jest rysowana
TitleTekst tytułu osi
LogBasePodstawa skali logarytmicznej; zero wybiera skalę liniową
OrientationKierunek osi — normalny albo odwrócony
MajorGridlinesPokazuje główne linie siatki w odstępie jednostki głównej
MinorGridlinesPokazuje pomocnicze linie siatki w odstępie jednostki pomocniczej
MinValueStała wartość minimalna; NaN wybiera wartość automatyczną
MaxValueStała wartość maksymalna; NaN wybiera wartość automatyczną
MajorUnitOdstęp głównych linii siatki; zero wybiera wartość automatyczną
MinorUnitOdstęp pomocniczych linii siatki; zero wybiera wartość automatyczną
MajorUnitSetCzy dodatnia wartość jednostki głównej jest obecna jawnie
MinorUnitSetCzy dodatnia wartość jednostki pomocniczej jest obecna jawnie
CrossesAtWartość, w której oś przecinająca się przecina; NaN wybiera wartość automatyczną
TickLblPosPozycja etykiet podziałek — 'nextTo', 'low', 'high' albo 'none'
CrossesTryb przecinania osi. Przypisanie Crosses emituje <c:crosses val="..."/> zamiast automatycznego przecięcia; jawne CrossesAt wciąż wygrywa, gdy jest ustawione (ustawienie obu jest niepoprawnym OOXML i pierwszeństwo ma CrossesAt)
CrossesSetCzy tryb przecinania został ustawiony jawnie
MajorTickMarkStyl głównej podziałki rysowanej na przecięciach głównych linii siatki
MinorTickMarkStyl pomocniczej podziałki rysowanej na przecięciach pomocniczych linii siatki
DispUnitsWspółczynnik skalowania jednostek wyświetlania (10, 100, 1000 ...) albo wbudowana jednostka; zero wyłącza
ShowDispUnitsLabelPokazuje etykietę jednostek wyświetlania ('Thousands', 'Millions', ...) obok osi
BaseTimeUnitJednostka czasu bazowego osi daty; przypisanie oznacza wartość jako jawną, nawet gdy to xlsxChartTimeDays
MajorTimeUnitGłówna jednostka czasu osi daty; przypisanie oznacza wartość jako jawną
MinorTimeUnitPomocnicza jednostka czasu osi daty; przypisanie oznacza wartość jako jawną
BaseTimeUnitSetSteruje tym, czy baseTimeUnit jest emitowany; False zachowuje pominięty element źródłowy zamiast zapisywać jawną jednostkę dni
MajorTimeUnitSetSteruje tym, czy majorTimeUnit jest emitowany niezależnie od MajorUnit
MinorTimeUnitSetSteruje tym, czy minorTimeUnit jest emitowany niezależnie od MinorUnit
AutoDateAxisJawna wartość automatycznego wykrywania kategorii dla osi daty
AutoDateAxisSetSteruje tym, czy element auto osi daty jest emitowany
NumberFormatFormat liczb stosowany do etykiet osi; przypisanie oznacza format jako jawny
NumberFormatSourceLinkedCzy format etykiet osi podąża za danymi źródłowymi; przypisanie oznacza format jako jawny
NumberFormatSetSteruje tym, czy element ChartML numFmt jest emitowany
LabelIntervalInterwał między etykietami kategorii
TickMarkIntervalInterwał między podziałkami na osi kategorii
NoMultiLevelLabelsTrue wyświetla tylko najniższy poziom kategorii i zapisuje przełącznik noMultiLvlLbl osi kategorii
TextStyleStyl tekstu etykiet podziałek
TitleTextStyleStyl tekstu tytułu osi
TitleLayoutPozycja i rozmiar tytułu osi

Wybór osi

xlsxAxisAutomatic wybiera oś kategorii dla zwykłych grup wykresów i oś wartości dla grup rozrzutu lub bąbelkowych. Użyj xlsxAxisDate razem z właściwościami jednostek czasu dla skalowania kalendarzowego oraz xlsxAxisSeries dla osi głębokości wykresu trójwymiarowego
Wartości jednostek czasu osi daty i ich flagi obecności są niezależne. Dzięki temu importowane pliki zachowują pominięte elementy, a przypisanie jednostki zapisuje tę wartość jawnie. AssignClassicDateAxis mapuje aktywne ustawienia klasycznej osi daty i pozostawia zamaskowane lub nieprawidłowe surowe pola w modelu źródłowym, co daje bezstratne round-tripy Classic
Gdy jednostki albo interwały są pominięte, renderowanie bada wszystkie widoczne serie jeden raz, wnioskuje skalowanie dziennie, miesięczne albo roczne i wybiera ograniczoną gęstość etykiet na podstawie widocznego zakresu, szerokości osi, zmierzonego tekstu, formatu liczb i obrotu. Główne i pomocnicze etykiety, współrzędne, podziałki i linie siatki korzystają z wynikowych współdzielonych kolekcji
NumberFormat i NumberFormatSourceLinked zachowują stan formatu etykiet ChartML. Osie dat używają tego formatu dla rysowanych etykiet podziałek, a Orientation odwraca współrzędne podziałek i danych bez zwijania zduplikowanych dat ani równomiernego rozstawiania rzadkich dat
Osie kategorii renderują hierarchiczne cache serii od poziomu liścia najbliższego osi do kolejnych poziomów nadrzędnych. NoMultiLevelLabels tłumi poziomy nadrzędne i mapuje równoważną flagę wykresu klasycznego podczas konwersji modeli

Układ tekstu i tytułu

TextStyle formatuje etykiety podziałek, a TitleTextStyle formatuje tytuł osi. Oba udostępniają typowane ustawienia nazwy, rozmiaru, koloru, wyróżnienia i obrotu. Dodatnie wartości obrotu w ChartML są zgodne z ruchem wskazówek zegara i są konwertowane do natywnej konwencji każdego zaplecza wyjścia
TitleLayout pozycjonuje i wymiaruje tytuł osi znormalizowanymi współrzędnymi ChartML. Użyj SetPositionAndSize, aby włączyć i ustawić wszystkie cztery wartości jako jedną grupę zgodną z Office

Methods

procedure Assign

See also