Документація HotXLS

TXLSXChartAxis class

Unit: lxHandleX
Типізований дескриптор осей категорій, значень, дат і серій для первинних, вторинних і тривимірних осей діаграм

Description

Кожна діаграма володіє первинними осями категорій і значень, вторинними осями категорій і значень та віссю глибини серій. Тип осі може лишатися автоматичним або задаватися як категорії, значення, дата чи серії, тоді як імпортовані ідентифікатори осей і зв'язки перетину залишаються стабільними крізь цикли збереження

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

KindAxis type — automatic, category, value, date or series
PositionAxis position within the plot area — normal, low or high
AxisIdStable axis identifier retained across save cycles
CrossAxisIdIdentifier of the axis the crossing axis intersects
VisibleWhether the axis is rendered
TitleAxis title text
LogBaseBase of a logarithmic scale; zero selects linear
OrientationAxis direction — normal or reversed
MajorGridlinesShow major gridlines at the major unit spacing
MinorGridlinesShow minor gridlines at the minor unit spacing
MinValueFixed minimum value; NaN selects automatic
MaxValueFixed maximum value; NaN selects automatic
MajorUnitSpacing of the major gridlines; zero selects automatic
MinorUnitSpacing of the minor gridlines; zero selects automatic
MajorUnitSetWhether a positive major-unit value is explicitly present
MinorUnitSetWhether a positive minor-unit value is explicitly present
CrossesAtValue at which the crossing axis intersects; NaN selects automatic
TickLblPosTick-label position — 'nextTo', 'low', 'high' or 'none'
CrossesAxis crossing mode. Assigning Crosses emits <c:crosses val="..."/> instead of the automatic crossing; an explicit CrossesAt still wins when set (setting both is invalid OOXML and CrossesAt takes precedence)
CrossesSetWhether the crossing mode has been explicitly set
MajorTickMarkStyle of the major tick mark, drawn at the major gridline intersections
MinorTickMarkStyle of the minor tick mark, drawn at the minor gridline intersections
DispUnitsМножник масштабу одиниць відображення (10, 100, 1000 ...) або вбудована одиниця; нуль вимикає
ShowDispUnitsLabelShow the display-unit label ('Thousands', 'Millions', ...) beside the axis
BaseTimeUnitБазова одиниця часу осі дат; присвоєння робить значення явним, навіть коли воно xlsxChartTimeDays
MajorTimeUnitMajor time unit of a date axis; assigning it marks the value explicit
MinorTimeUnitMinor time unit of a date axis; assigning it marks the value explicit
BaseTimeUnitSetControls whether baseTimeUnit записується; False зберігає пропущений вихідний елемент замість запису явної одиниці днів
MajorTimeUnitSetControls whether majorTimeUnit is emitted independently of MajorUnit
MinorTimeUnitSetControls whether minorTimeUnit is emitted independently of MinorUnit
AutoDateAxisExplicit date-axis automatic-category detection value
AutoDateAxisSetControls whether the date-axis auto element is emitted
NumberFormatNumber format applied to axis labels; assigning it marks the format explicit
NumberFormatSourceLinkedЧи слідує формат підписів осі за своїми вихідними даними; присвоєння значення робить формат явним
NumberFormatSetControls whether the ChartML numFmt element is emitted
LabelIntervalInterval between category labels
TickMarkIntervalInterval between tick marks on a category axis
NoMultiLevelLabelsTrue displays only the leaf category level and writes the category-axis noMultiLvlLbl switch
TextStyleText style of the tick labels
TitleTextStyleText style of the axis title
TitleLayoutPosition and size of the axis title

Axis selection

xlsxAxisAutomatic обирає вісь категорій для звичайних груп діаграм і вісь значень для груп scatter або bubble. Використовуйте xlsxAxisDate together with the time-unit properties for calendar scaling and xlsxAxisSeries for a three-dimensional depth axis
Значення одиниць осі дат і прапори їхньої наявності незалежні. Тому імпортовані файли зберігають пропущені елементи, а присвоєння одиниці записує це значення явно AssignClassicDateAxis відображає активні параметри класичної осі дат і лишає замасковані чи некоректні сирі поля у вихідній моделі для класичних round-trip-ів без втрат
Коли одиниці чи інтервали не задані, рендеринг один раз оглядає всі видимі серії, виводить масштабування день/місяць/рік і обирає обмежену щільність підписів на основі видимого діапазону, ширини осі, виміряного тексту, числового формату та повороту. Основні та проміжні підписи, координати, поділки й сітки споживають отримані спільні колекції
NumberFormat and NumberFormatSourceLinked зберігають стан формату підписів ChartML. Вісь дат використовує цей формат для відрендерених підписів поділок, а Orientation обертає координати як поділок, так і даних, не склеюючи повторювані дати й не розставляючи рідкі дати рівномірно
Осі категорій рендерять ієрархічні кеші серій від найближчого до осі листового рівня до послідовних батьківських рівнів NoMultiLevelLabels пригнічує батьківські рівні та відображає еквівалентний прапор класичної діаграми при конвертації моделей

Text and title layout

TextStyle formats tick labels, while TitleTextStyle форматують заголовок осі. Обидва відкривають типізовані параметри імені, розміру, кольору, акцентування та повороту. Додатні значення повороту ChartML — за годинниковою стрілкою — конвертуються у власну конвенцію кожного бекенду виводу
TitleLayout positions and sizes the axis title with normalized ChartML coordinates Use SetPositionAndSize to enable and set all four values as one Office-compatible group

Methods

procedure Assign

See also