Documentação do HotXLS

Classe TXLSXChartAxis

Unidade: lxHandleX
Descritor tipado de eixos de categoria, valor, data e série para eixos de gráfico primários, secundários e tridimensionais

Descrição

Cada gráfico tem eixos primários de categoria e valor, eixos secundários de categoria e valor e um eixo de profundidade de série O tipo de eixo pode permanecer automático ou ser definido como categoria, valor, data ou série, enquanto os identificadores de eixo importados e os vínculos de cruzamento permanecem estáveis entre ciclos de salvamento

Declaração

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;

Propriedades

KindTipo de eixo — automático, categoria, valor, data ou série
PositionPosição do eixo dentro da área de plotagem — normal, baixa ou alta
AxisIdIdentificador estável de eixo preservado entre ciclos de salvamento
CrossAxisIdIdentificador do eixo que o eixo de cruzamento intersecta
VisibleSe o eixo é renderizado
TitleTexto do título do eixo
LogBaseBase da escala logarítmica; zero seleciona linear
OrientationDireção do eixo — normal ou invertida
MajorGridlinesExibe linhas de grade principais no espaçamento da unidade principal
MinorGridlinesExibe linhas de grade secundárias no espaçamento da unidade secundária
MinValueValor mínimo fixo; NaN seleciona automático
MaxValueValor máximo fixo; NaN seleciona automático
MajorUnitEspaçamento das linhas de grade principais; zero seleciona automático
MinorUnitEspaçamento das linhas de grade secundárias; zero seleciona automático
MajorUnitSetSe um valor positivo de unidade principal está explicitamente presente
MinorUnitSetSe um valor positivo de unidade secundária está explicitamente presente
CrossesAtValor no qual o eixo de cruzamento intersecta; NaN seleciona automático
TickLblPosPosição dos rótulos de marca — 'nextTo', 'low', 'high' ou 'none'
CrossesModo de cruzamento do eixo. Atribuir Crosses emite <c:crosses val="..."/> em vez do cruzamento automático; um CrossesAt explícito ainda prevalece quando definido (definir os dois é um OOXML inválido e CrossesAt tem precedência)
CrossesSetSe o modo de cruzamento foi definido explicitamente
MajorTickMarkEstilo da marca de escala principal, desenhada nas interseções das linhas de grade principais
MinorTickMarkEstilo da marca de escala secundária, desenhada nas interseções das linhas de grade secundárias
DispUnitsFator de escala em unidades de exibição (10, 100, 1000 ...) ou uma unidade interna; zero desabilita
ShowDispUnitsLabelExibe o rótulo de unidade de exibição ('Thousands', 'Millions', ...) ao lado do eixo
BaseTimeUnitUnidade de tempo base de um eixo de data; atribuir um valor marca o valor como explícito, mesmo quando ele é xlsxChartTimeDays
MajorTimeUnitUnidade de tempo principal de um eixo de data; atribuir um valor marca o valor como explícito
MinorTimeUnitUnidade de tempo secundária de um eixo de data; atribuir um valor marca o valor como explícito
BaseTimeUnitSetControla se baseTimeUnit é emitido; False preserva o elemento de origem omitido em vez de gravar uma unidade de dia explícita
MajorTimeUnitSetControla se majorTimeUnit é emitido de forma independente de MajorUnit
MinorTimeUnitSetControla se minorTimeUnit é emitido de forma independente de MinorUnit
AutoDateAxisValor explícito de detecção de categoria automática do eixo de data
AutoDateAxisSetControla se o elemento auto do eixo de data é emitido
NumberFormatFormato numérico aplicado aos rótulos do eixo; atribuir um valor marca o formato como explícito
NumberFormatSourceLinkedSe o formato dos rótulos do eixo segue os dados de origem; atribuir um valor marca o formato como explícito
NumberFormatSetControla se o elemento numFmt do ChartML é emitido
LabelIntervalIntervalo entre rótulos de categoria
TickMarkIntervalIntervalo entre marcas de escala em um eixo de categoria
NoMultiLevelLabelsTrue exibe apenas o nível de categoria folha e grava a chave noMultiLvlLbl do eixo de categoria
TextStyleEstilo de texto dos rótulos de marca
TitleTextStyleEstilo de texto do título do eixo
TitleLayoutPosição e tamanho do título do eixo

Seleção de eixo

xlsxAxisAutomatic seleciona um eixo de categoria para grupos de gráfico comuns e um eixo de valor para grupos de dispersão ou bolhas Use xlsxAxisDate junto com as propriedades de unidade de tempo para escala de calendário e xlsxAxisSeries para um eixo de profundidade tridimensional
Os valores de unidade do eixo de data e suas flags de presença são independentes Arquivos importados portanto preservam elementos omitidos, enquanto atribuir uma unidade grava esse valor explicitamente AssignClassicDateAxis mapeia as configurações ativas de eixo de data do XLS clássico e deixa os campos brutos mascarados ou inválidos no modelo de origem para Round trips do clássico sem perdas
Quando unidades ou intervalos são omitidos, a renderização inspeciona todas as séries visíveis uma vez, infere a escala em dias, meses ou anos e escolhe uma densidade de rótulos limitada a partir do intervalo visível, da largura do eixo, do texto medido, do formato numérico e da rotação Rótulos principais e secundários, coordenadas, marcas de escala e linhas de grade consomem as coleções compartilhadas resultantes
NumberFormat e NumberFormatSourceLinked preservam o estado do formato de rótulos do ChartML Eixos de data usam esse formato nos rótulos de marca renderizados, e Orientation inverte as coordenadas de marca e de dados sem colapsar datas duplicadas ou espaçar uniformemente datas esparsas
Eixos de categoria renderizam caches hierárquicos de séries do nível folha mais próximo do eixo até os níveis pai sucessivos NoMultiLevelLabels suprime os níveis pai e mapeia a flag equivalente de gráfico do XLS clássico quando os modelos são convertidos

Layout de texto e título

TextStyle formata os rótulos de marca, enquanto TitleTextStyle formata o título do eixo Ambos expõem configurações tipadas de nome, tamanho, cor, ênfase e rotação Valores positivos de rotação no ChartML são no sentido horário e são convertidos para a convenção nativa de cada backend de saída
TitleLayout posiciona e dimensiona o título do eixo com coordenadas normalizadas do ChartML Use SetPositionAndSize para habilitar e definir os quatro valores como um único grupo compatível com Office

Métodos

procedure Assign

Veja também