Documentación de HotXLS

Clase TXLSXChartAxis

Unidad: lxHandleX
Descriptor con tipos de ejes de categorías, valores, fechas y series para ejes de gráficos principales, secundarios y tridimensionales

Descripción

Cada gráfico posee ejes de categorías y valores principales, ejes de categorías y valores secundarios, y un eje de profundidad de series. El tipo de eje puede permanecer automático o fijarse en categorías, valores, fechas o series, mientras que los identificadores de eje importados y los vínculos de cruce permanecen estables a través de los ciclos de guardado

Declaración

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;

Propiedades

KindTipo de eje — automático, categorías, valores, fechas o series
PositionPosición del eje dentro del área de trazado — normal, baja o alta
AxisIdIdentificador de eje estable que se conserva entre ciclos de guardado
CrossAxisIdIdentificador del eje que el eje de cruce interseca
VisibleSi el eje se renderiza
TitleTexto del título del eje
LogBaseBase de una escala logarítmica; cero selecciona lineal
OrientationDirección del eje — normal o invertida
MajorGridlinesMuestra las líneas de cuadrícula principales con el espaciado de la unidad principal
MinorGridlinesMuestra las líneas de cuadrícula secundarias con el espaciado de la unidad secundaria
MinValueValor mínimo fijo; NaN selecciona automático
MaxValueValor máximo fijo; NaN selecciona automático
MajorUnitEspaciado de las líneas de cuadrícula principales; cero selecciona automático
MinorUnitEspaciado de las líneas de cuadrícula secundarias; cero selecciona automático
MajorUnitSetSi hay un valor de unidad principal positivo presente de forma explícita
MinorUnitSetSi hay un valor de unidad secundaria positivo presente de forma explícita
CrossesAtValor en el que interseca el eje de cruce; NaN selecciona automático
TickLblPosPosición de las etiquetas de marcas — 'nextTo', 'low', 'high' o 'none'
CrossesModo de cruce del eje. Asignar Crosses emite <c:crosses val="..."/> en lugar del cruce automático; un CrossesAt explícito sigue teniendo prioridad cuando está asignado (asignar ambos es un OOXML no válido y CrossesAt prevalece)
CrossesSetSi el modo de cruce se ha establecido de forma explícita
MajorTickMarkEstilo de la marca principal, dibujada en las intersecciones de las líneas de cuadrícula principales
MinorTickMarkEstilo de la marca secundaria, dibujada en las intersecciones de las líneas de cuadrícula secundarias
DispUnitsFactor de escala de unidades de visualización (10, 100, 1000...) o una unidad integrada; cero deshabilita
ShowDispUnitsLabelMuestra la etiqueta de unidad de visualización ('Thousands', 'Millions'...) junto al eje
BaseTimeUnitUnidad de tiempo base de un eje de fechas; asignarla marca el valor como explícito incluso cuando es xlsxChartTimeDays
MajorTimeUnitUnidad de tiempo principal de un eje de fechas; asignarla marca el valor como explícito
MinorTimeUnitUnidad de tiempo secundaria de un eje de fechas; asignarla marca el valor como explícito
BaseTimeUnitSetControla si se emite baseTimeUnit; False preserva un elemento de origen omitido en lugar de escribir una unidad de días explícita
MajorTimeUnitSetControla si se emite majorTimeUnit de forma independiente de MajorUnit
MinorTimeUnitSetControla si se emite minorTimeUnit de forma independiente de MinorUnit
AutoDateAxisValor explícito de detección de categorías automáticas del eje de fechas
AutoDateAxisSetControla si se emite el elemento auto del eje de fechas
NumberFormatFormato numérico aplicado a las etiquetas del eje; asignarlo marca el formato como explícito
NumberFormatSourceLinkedSi el formato de las etiquetas del eje sigue sus datos de origen; asignarlo marca el formato como explícito
NumberFormatSetControla si se emite el elemento numFmt de ChartML
LabelIntervalIntervalo entre etiquetas de categorías
TickMarkIntervalIntervalo entre marcas en un eje de categorías
NoMultiLevelLabelsTrue muestra solo el nivel de categoría hoja y escribe el interruptor noMultiLvlLbl del eje de categorías
TextStyleEstilo de texto de las etiquetas de marcas
TitleTextStyleEstilo de texto del título del eje
TitleLayoutPosición y tamaño del título del eje

Selección de ejes

xlsxAxisAutomatic selecciona un eje de categorías para los grupos de gráficos ordinarios y un eje de valores para los grupos de dispersión o burbujas. Use xlsxAxisDate junto con las propiedades de unidades de tiempo para el escalado de calendario, y xlsxAxisSeries para un eje de profundidad tridimensional
Los valores de unidades del eje de fechas y sus flags de presencia son independientes. Por ello, los archivos importados conservan los elementos omitidos, mientras que asignar una unidad escribe ese valor de forma explícita. AssignClassicDateAxis mapea la configuración activa del eje de fechas Classic y deja en el modelo de origen los campos crudos enmascarados o no válidos, para lograr round-trips de Classic sin pérdidas
Cuando se omiten las unidades o los intervalos, el renderizado inspecciona todas las series visibles una vez, infiere el escalado por días, meses o años, y elige una densidad de etiquetas acotada a partir del rango visible, del ancho del eje, del texto medido, del formato numérico y de la rotación. Las etiquetas principales y secundarias, las coordenadas, las marcas y las líneas de cuadrícula consumen las colecciones compartidas resultantes
NumberFormat y NumberFormatSourceLinked conservan el estado de formato de etiquetas de ChartML. Los ejes de fechas usan ese formato para las etiquetas de marcas renderizadas, y Orientation invierte tanto las coordenadas de las marcas como las de los datos, sin colapsar fechas duplicadas ni espaciar de forma uniforme las fechas dispersas
Los ejes de categorías renderizan las cachés de series jerárquicas desde el nivel hoja más cercano al eje hasta los niveles padre sucesivos. NoMultiLevelLabels suprime los niveles padre y mapea el flag equivalente del gráfico Classic cuando se convierten los modelos

Texto y diseño del título

TextStyle da formato a las etiquetas de marcas, mientras que TitleTextStyle da formato al título del eje. Ambos exponen ajustes con tipos de nombre, tamaño, color, énfasis y rotación. Los valores de rotación positivos de ChartML son en sentido horario y se convierten a la convención nativa de cada backend de salida
TitleLayout posiciona y dimensiona el título del eje con coordenadas normalizadas de ChartML. Use SetPositionAndSize para habilitar y asignar los cuatro valores como un solo grupo compatible con Office

Métodos

procedure Assign

Ver también