Documentação do HotXLS

Classe TXLSXChartAxis

Unidade: lxHandleX
Descritor tipado de eixos de categoria, valores, datas e séries para eixos de gráficos primários, secundários e tridimensionais

Descrição

Cada gráfico tem eixos primários de categoria e valores, eixos secundários de categoria e valores e um eixo de profundidade de séries. O tipo de eixo pode manter-se automático ou ser definido como categoria, valores, data ou séries, enquanto os identificadores de eixos importados e as ligações de cruzamento se mantêm estáveis ao longo dos ciclos de gravação

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, valores, data ou séries
PositionPosição do eixo na área de plotagem — normal, baixa ou alta
AxisIdIdentificador estável do eixo, mantido entre ciclos de gravação
CrossAxisIdIdentificador do eixo com que o eixo de cruzamento se cruza
VisibleSe o eixo é renderizado
TitleTexto do título do eixo
LogBaseBase de uma escala logarítmica; zero seleciona escala linear
OrientationDireção do eixo — normal ou invertida
MajorGridlinesMostra linhas de grelha principais com o espaçamento da unidade principal
MinorGridlinesMostra linhas de grelha secundárias com o 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 grelha principais; zero seleciona automático
MinorUnitEspaçamento das linhas de grelha secundárias; zero seleciona automático
MajorUnitSetSe existe explicitamente um valor positivo de unidade principal
MinorUnitSetSe existe explicitamente um valor positivo de unidade secundária
CrossesAtValor em que o eixo de cruzamento se cruza; NaN seleciona automático
TickLblPosPosição dos rótulos dos marcadores — '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 está definido (definir ambos é OOXML inválido e CrossesAt tem precedência)
CrossesSetSe o modo de cruzamento foi explicitamente definido
MajorTickMarkEstilo do marcador principal, desenhado nas interseções das linhas de grelha principais
MinorTickMarkEstilo do marcador secundário, desenhado nas interseções das linhas de grelha secundárias
DispUnitsFator de escala em unidades de apresentação (10, 100, 1000 ...) ou uma unidade incorporada; zero desativa
ShowDispUnitsLabelMostra o rótulo da unidade de apresentação ('Thousands', 'Millions', ...) junto ao eixo
BaseTimeUnitUnidade de tempo base de um eixo de datas; atribuí-la marca o valor como explícito, mesmo quando é xlsxChartTimeDays
MajorTimeUnitUnidade de tempo principal de um eixo de datas; atribuí-la marca o valor como explícito
MinorTimeUnitUnidade de tempo secundária de um eixo de datas; atribuí-la marca o valor como explícito
BaseTimeUnitSetControla se baseTimeUnit é emitido; False preserva um elemento de origem omitido em vez de escrever uma unidade de dias explícita
MajorTimeUnitSetControla se majorTimeUnit é emitido independentemente de MajorUnit
MinorTimeUnitSetControla se minorTimeUnit é emitido independentemente de MinorUnit
AutoDateAxisValor explícito da deteção de categorias automáticas do eixo de datas
AutoDateAxisSetControla se o elemento auto do eixo de datas é emitido
NumberFormatFormato de número aplicado aos rótulos do eixo; atribuí-lo marca o formato como explícito
NumberFormatSourceLinkedSe o formato dos rótulos do eixo segue os dados de origem; atribuí-lo marca o formato como explícito
NumberFormatSetControla se o elemento numFmt do ChartML é emitido
LabelIntervalIntervalo entre rótulos de categoria
TickMarkIntervalIntervalo entre marcadores num eixo de categoria
NoMultiLevelLabelsTrue apresenta apenas o nível de categoria folha e escreve o interruptor noMultiLvlLbl do eixo de categoria
TextStyleEstilo de texto dos rótulos dos marcadores
TitleTextStyleEstilo de texto do título do eixo
TitleLayoutPosição e tamanho do título do eixo

Seleção de eixos

xlsxAxisAutomatic seleciona um eixo de categoria para grupos de gráficos comuns e um eixo de valores para grupos de dispersão ou bolhas. Use xlsxAxisDate em conjunto com as propriedades de unidade de tempo para escala de calendário e xlsxAxisSeries para um eixo de profundidade tridimensional
Os valores de unidade de um eixo de datas e os sinalizadores de presença são independentes. Por isso, os ficheiros importados mantêm os elementos omitidos, enquanto atribuir uma unidade escreve esse valor explicitamente. AssignClassicDateAxis mapeia as definições ativas de eixo de datas Classic e deixa os campos brutos mascarados ou inválidos no modelo de origem, para round trips Classic sem perdas
Quando as unidades ou os 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 de número e da rotação. Rótulos principais e secundários, coordenadas, marcadores e linhas de grelha consomem as coleções partilhadas resultantes
NumberFormat e NumberFormatSourceLinked mantêm o estado do formato de rótulos do ChartML. Os eixos de datas usam esse formato nos rótulos renderizados, e Orientation inverte as coordenadas dos marcadores e dos dados sem colapsar datas duplicadas nem espaçar uniformemente datas esparsas
Os eixos de categoria renderizam caches de séries hierárquicas do nível folha mais próximo do eixo até aos níveis pai sucessivos. NoMultiLevelLabels suprime os níveis pai e mapeia o sinalizador equivalente de gráficos Classic quando os modelos são convertidos

Texto e disposição do título

TextStyle formata os rótulos dos marcadores, enquanto TitleTextStyle formata o título do eixo. Ambos expõem definições tipadas de nome, tamanho, cor, ênfase e rotação. Os valores de rotação positivos do ChartML são no sentido dos ponteiros do relógio 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 ChartML normalizadas. Use SetPositionAndSize para ativar e definir os quatro valores como um grupo compatível com o Office

Métodos

procedure Assign

Ver também