Documentación HotXLS

Clase TXLSXChartAxis

Unidad: lxHandleX
Descriptor tipado de ejes de categoría, valor, fecha y series para ejes de gráfico primarios, secundarios y tridimensionales

Descripción

Cada gráfico posee ejes de categoría y valor primarios, ejes de categoría y valor secundarios, y un eje de profundidad de series. El tipo de eje puede permanecer automático o establecerse como categoría, valor, fecha o series, mientras que los identificadores de eje importados y los enlaces de cruce se mantienen 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ía, valor, fecha 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 representa
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 positivo de unidad principal presente explícitamente
MinorUnitSetSi hay un valor positivo de unidad secundaria presente explícitamente
CrossesAtValor en el que se cruza 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 prevaleciendo cuando está establecido (establecer ambos es OOXML no válido y CrossesAt tiene prioridad)
CrossesSetSi el modo de cruce se ha establecido explícitamente
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 en unidades de visualización (10, 100, 1000...) o una unidad integrada; cero deshabilita
ShowDispUnitsLabelMuestra la etiqueta de unidades de visualización ('Thousands', 'Millions',...) junto al eje
BaseTimeUnitUnidad de tiempo base de un eje de fecha; asignarla marca el valor como explícito incluso cuando es xlsxChartTimeDays
MajorTimeUnitUnidad de tiempo principal de un eje de fecha; asignarla marca el valor como explícito
MinorTimeUnitUnidad de tiempo secundaria de un eje de fecha; 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ía explícita
MajorTimeUnitSetControla si majorTimeUnit se emite de forma independiente de MajorUnit
MinorTimeUnitSetControla si minorTimeUnit se emite de forma independiente de MinorUnit
AutoDateAxisValor explícito de detección de categorías automáticas del eje de fecha
AutoDateAxisSetControla si se emite el elemento auto del eje de fecha
NumberFormatFormato de número 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ía
TickMarkIntervalIntervalo entre marcas de 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 eje

xlsxAxisAutomatic selecciona un eje de categorías para los grupos de gráficos ordinarios y un eje de valor para los grupos de dispersión o burbujas. Use xlsxAxisDate junto con las propiedades de unidad de tiempo para el escalado de calendario, y xlsxAxisSeries para un eje de profundidad tridimensional
Los valores de unidad del eje de fecha y sus indicadores de presencia son independientes. Por ello, los archivos importados conservan los elementos omitidos, mientras que asignar una unidad escribe ese valor explícitamente. AssignClassicDateAxis mapea la configuración activa del eje de fecha Classic y deja en el modelo de origen los campos en bruto enmascarados o no válidos, para round-trips Classic sin pérdidas
Cuando se omiten unidades o intervalos, la representación inspecciona todas las series visibles una vez, deduce el escalado de día, mes o año, y elige una densidad de etiquetas acotada a partir del rango visible, el ancho del eje, el texto medido, el formato de número y 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 fecha usan ese formato para las etiquetas de marcas representadas, y Orientation invierte tanto las coordenadas de marcas como de datos sin colapsar fechas duplicadas ni espaciar uniformemente fechas dispersas
Los ejes de categorías representan 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 indicador 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 tipados 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 ChartML normalizadas. Use SetPositionAndSize para habilitar y establecer los cuatro valores como un grupo compatible con Office

Métodos

procedure Assign

Véase también