HotXLS-Doku

TXLSXChartAxis-Klasse

Einheit: lxHandleX
Typisierter Deskriptor für Kategorie-, Wert-, Datums- und Reihenachsen für primäre, sekundäre und dreidimensionale Diagrammachsen

Beschreibung

Jedes Diagramm besitzt primäre Kategorie- und Wertachsen, sekundäre Kategorie- und Wertachsen sowie eine Reihen-Tiefenachse. Der Achsentyp kann automatisch bleiben oder auf Kategorie, Wert, Datum oder Reihe gesetzt werden, während importierte Achs-IDs und Schnittverknüpfungen über Save-Zyklen hinweg stabil bleiben

Deklaration

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;

Eigenschaften

KindAchsentyp — automatisch, Kategorie, Wert, Datum oder Reihe
PositionPosition der Achse innerhalb der Zeichenfläche — normal, low oder high
AxisIdStabile Achsen-ID, über Save-Zyklen hinweg erhalten
CrossAxisIdKennung der Achse, die die schneidende Achse schneidet
VisibleGibt an, ob die Achse gerendert wird
TitleText des Achsentitels
LogBaseBasis eines logarithmischen Maßstabs; null wählt linear
OrientationAchsenrichtung — normal oder umgekehrt
MajorGridlinesZeigt Hauptgitterlinien im Abstand der Major-Unit
MinorGridlinesZeigt Hilfsgitterlinien im Abstand der Minor-Unit
MinValueFester Minimalwert; NaN wählt automatisch
MaxValueFester Maximalwert; NaN wählt automatisch
MajorUnitAbstand der Hauptgitterlinien; null wählt automatisch
MinorUnitAbstand der Hilfsgitterlinien; null wählt automatisch
MajorUnitSetGibt an, ob ein positiver Major-Unit-Wert explizit vorhanden ist
MinorUnitSetGibt an, ob ein positiver Minor-Unit-Wert explizit vorhanden ist
CrossesAtWert, an dem die schneidende Achse schneidet; NaN wählt automatisch
TickLblPosPosition der Teilstrich-Beschriftung — 'nextTo', 'low', 'high' oder 'none'
CrossesAchsen-Schnittmodus. Die Zuweisung von Crosses schreibt <c:crosses val="..."/> statt des automatischen Schnittpunkts; ein explizit gesetztes CrossesAt behält weiterhin Vorrang (beide zu setzen ist ungültiges OOXML, CrossesAt gewinnt)
CrossesSetGibt an, ob der Schnittmodus explizit gesetzt wurde
MajorTickMarkStil der Hauptteilstriche, gezeichnet an den Schnittpunkten der Hauptgitterlinien
MinorTickMarkStil der Hilfsteilstriche, gezeichnet an den Schnittpunkten der Hilfsgitterlinien
DispUnitsSkalierungsfaktor der Anzeigeeinheit (10, 100, 1000 ...) oder eine eingebaute Einheit; null deaktiviert
ShowDispUnitsLabelZeigt das Anzeigeeinheiten-Label ('Thousands', 'Millions', ...) neben der Achse
BaseTimeUnitBasiseinheit einer Datumsachse; die Zuweisung markiert den Wert als explizit, auch wenn er xlsxChartTimeDays ist
MajorTimeUnitHaupt-Zeiteinheit einer Datumsachse; die Zuweisung markiert den Wert als explizit
MinorTimeUnitHilfs-Zeiteinheit einer Datumsachse; die Zuweisung markiert den Wert als explizit
BaseTimeUnitSetSteuert, ob baseTimeUnit geschrieben wird; False erhält ein in der Quelle ausgelassenes Element, statt eine explizite Tageseinheit zu schreiben
MajorTimeUnitSetSteuert, ob majorTimeUnit unabhängig von MajorUnit geschrieben wird
MinorTimeUnitSetSteuert, ob minorTimeUnit unabhängig von MinorUnit geschrieben wird
AutoDateAxisExpliziter Wert der automatischen Kategorieerkennung einer Datumsachse
AutoDateAxisSetSteuert, ob das auto-Element der Datumsachse geschrieben wird
NumberFormatZahlenformat für Achsenbeschriftungen; die Zuweisung markiert das Format als explizit
NumberFormatSourceLinkedGibt an, ob das Achsenbeschriftungsformat den Quelldaten folgt; die Zuweisung markiert das Format als explizit
NumberFormatSetSteuert, ob das ChartML-Element numFmt geschrieben wird
LabelIntervalAbstand zwischen Kategoriebeschriftungen
TickMarkIntervalAbstand zwischen Teilstrichen auf einer Kategorieachse
NoMultiLevelLabelsTrue zeigt nur die unterste Kategorieebene und schreibt den Schalter noMultiLvlLbl der Kategorieachse
TextStyleTextstil der Teilstrich-Beschriftungen
TitleTextStyleTextstil des Achsentitels
TitleLayoutPosition und Größe des Achsentitels

Achsenauswahl

xlsxAxisAutomatic wählt für gewöhnliche Diagrammgruppen eine Kategorieachse und für Punkt- (XY-) oder Blasendiagrammgruppen eine Wertachse. xlsxAxisDate verwenden Sie zusammen mit den Zeiteinheits-Eigenschaften für die Kalenderskalierung, xlsxAxisSeries für eine dreidimensionale Tiefenachse
Die Zeiteinheits-Werte einer Datumsachse und ihre Vorhanden-Flags sind unabhängig voneinander. Importierte Dateien behalten daher ausgelassene Elemente bei, während die Zuweisung einer Einheit diesen Wert explizit schreibt. AssignClassicDateAxis übernimmt die aktiven Classic-Einstellungen der Datumsachse und lässt maskierte oder ungültige Rohfelder im Quellmodell, damit Classic-Roundtrips verlustfrei bleiben
Wenn Einheiten oder Intervalle ausgelassen werden, untersucht das Rendering alle sichtbaren Datenreihen einmal, leitet eine Skalierung nach Tag, Monat oder Jahr her und wählt aus sichtbarem Bereich, Achsenbreite, gemessenem Text, Zahlenformat und Rotation eine begrenzte Beschriftungsdichte. Haupt- und Hilfsbeschriftungen, Koordinaten, Teilstriche und Gitterlinien greifen auf die resultierenden gemeinsamen Sammlungen zu
NumberFormat und NumberFormatSourceLinked bewahren den ChartML-Zustand des Beschriftungsformats. Datumsachsen verwenden dieses Format für gerenderte Teilstrich-Beschriftungen, und Orientation kehrt sowohl Teilstrich- als auch Datenkoordinaten um, ohne doppelte Datumswerte zusammenzulegen oder dünn gestreute Datumswerte gleichmäßig zu verteilen
Kategorieachsen rendern hierarchische Reihen-Caches von der der Achse nächstgelegenen Blattebene aufwärts über die übergeordneten Ebenen. NoMultiLevelLabels unterdrückt übergeordnete Ebenen und bildet bei der Modellkonvertierung das entsprechende Classic-Diagrammflag ab

Text- und Titellayout

TextStyle formatiert die Teilstrich-Beschriftungen, TitleTextStyle den Achsentitel. Beide bieten typisierte Einstellungen für Name, Größe, Farbe, Hervorhebung und Rotation. Positive ChartML-Rotationswerte laufen im Uhrzeigersinn und werden in die native Konvention des jeweiligen Ausgabe-Backends konvertiert
TitleLayout positioniert und skaliert den Achsentitel mit normalisierten ChartML-Koordinaten. Verwenden Sie SetPositionAndSize, um das Layout zu aktivieren und alle vier Werte als eine Office-kompatible Gruppe zu setzen

Methoden

procedure Assign

Siehe auch