Docs HotXLS

TXLSXChartAxis class

Unit: lxHandleX
Descripteur typé d'axes de catégories, de valeurs, de dates et de séries pour les axes de graphiques principaux, secondaires et tridimensionnels

Description

Chaque graphique possède des axes principal et secondaire de catégories et de valeurs, ainsi qu'un axe de profondeur de séries. Le type d'axe peut rester automatique ou être défini sur catégorie, valeur, date ou série, tandis que les identifiants d'axes importés et les liens de croisement restent stables au fil des cycles d'enregistrement

Déclaration

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;

Propriétés

KindType d'axe — automatique, catégorie, valeur, date ou série
PositionPosition de l'axe dans la zone de traçage — normale, basse ou haute
AxisIdIdentifiant d'axe stable conservé au fil des cycles d'enregistrement
CrossAxisIdIdentifiant de l'axe que l'axe de croisement intersecte
VisibleIndique si l'axe est affiché
TitleTexte du titre de l'axe
LogBaseBase d'une échelle logarithmique ; zéro sélectionne le linéaire
OrientationDirection de l'axe — normale ou inversée
MajorGridlinesAffiche le quadrillage principal au pas de l'unité principale
MinorGridlinesAffiche le quadrillage secondaire au pas de l'unité secondaire
MinValueValeur minimale fixe ; NaN sélectionne l'automatique
MaxValueValeur maximale fixe ; NaN sélectionne l'automatique
MajorUnitPas du quadrillage principal ; zéro sélectionne l'automatique
MinorUnitPas du quadrillage secondaire ; zéro sélectionne l'automatique
MajorUnitSetIndique si une valeur positive d'unité principale est explicitement présente
MinorUnitSetIndique si une valeur positive d'unité secondaire est explicitement présente
CrossesAtValeur à laquelle l'axe de croisement intersecte ; NaN sélectionne l'automatique
TickLblPosPosition des étiquettes de graduation — 'nextTo', 'low', 'high' ou 'none'
CrossesMode de croisement de l'axe. L'affectation de Crosses émet <c:crosses val="..."/> au lieu du croisement automatique ; un CrossesAt explicite garde la priorité quand il est défini (définir les deux est un OOXML invalide et CrossesAt prime)
CrossesSetIndique si le mode de croisement a été explicitement défini
MajorTickMarkStyle des graduations principales, dessinées aux intersections du quadrillage principal
MinorTickMarkStyle des graduations secondaires, dessinées aux intersections du quadrillage secondaire
DispUnitsFacteur d'échelle en unités d'affichage (10, 100, 1000 ...) ou unité intégrée ; zéro désactive
ShowDispUnitsLabelAffiche l'étiquette d'unités d'affichage ('Thousands', 'Millions', ...) à côté de l'axe
BaseTimeUnitUnité de temps de base d'un axe de dates ; son affectation marque la valeur comme explicite, même s'il s'agit de xlsxChartTimeDays
MajorTimeUnitUnité de temps principale d'un axe de dates ; son affectation marque la valeur comme explicite
MinorTimeUnitUnité de temps secondaire d'un axe de dates ; son affectation marque la valeur comme explicite
BaseTimeUnitSetContrôle l'émission de baseTimeUnit ; False préserve un élément source omis au lieu d'écrire une unité de jours explicite
MajorTimeUnitSetContrôle l'émission de majorTimeUnit indépendamment de MajorUnit
MinorTimeUnitSetContrôle l'émission de minorTimeUnit indépendamment de MinorUnit
AutoDateAxisValeur explicite de détection des catégories automatiques d'un axe de dates
AutoDateAxisSetContrôle l'émission de l'élément auto de l'axe de dates
NumberFormatFormat numérique appliqué aux étiquettes de l'axe ; son affectation marque le format comme explicite
NumberFormatSourceLinkedIndique si le format des étiquettes suit les données source ; son affectation marque le format comme explicite
NumberFormatSetContrôle l'émission de l'élément ChartML numFmt
LabelIntervalIntervalle entre les étiquettes de catégories
TickMarkIntervalIntervalle entre les graduations sur un axe de catégories
NoMultiLevelLabelsTrue n'affiche que le niveau de catégorie feuille et écrit le commutateur noMultiLvlLbl de l'axe de catégories
TextStyleStyle de texte des étiquettes de graduation
TitleTextStyleStyle de texte du titre de l'axe
TitleLayoutPosition et taille du titre de l'axe

Sélection des axes

xlsxAxisAutomatic sélectionne un axe de catégories pour les groupes de graphiques ordinaires et un axe de valeurs pour les groupes nuage de points ou bulles. Utilisez xlsxAxisDate avec les propriétés d'unités de temps pour un calendrier gradué, et xlsxAxisSeries pour un axe de profondeur tridimensionnel
Les valeurs d'unités de l'axe de dates et leurs indicateurs de présence sont indépendants. Les fichiers importés conservent donc les éléments omis, tandis que l'affectation d'une unité écrit cette valeur explicitement. AssignClassicDateAxis mappe les paramètres actifs d'axe de dates Classic et laisse dans le modèle source les champs bruts masqués ou invalides, pour des allers-retours Classic sans perte
Quand les unités ou intervalles sont omis, le rendu inspecte une fois toutes les séries visibles, déduit un pas en jours, mois ou années, et choisit une densité d'étiquettes bornée à partir de la plage visible, de la largeur de l'axe, du texte mesuré, du format numérique et de la rotation. Les étiquettes principales et secondaires, coordonnées, graduations et quadrillages consomment les collections partagées qui en résultent
NumberFormat et NumberFormatSourceLinked conservent l'état du format d'étiquettes ChartML. Les axes de dates utilisent ce format pour les étiquettes de graduation rendues, et Orientation inverse à la fois les coordonnées des graduations et des données, sans fusionner les dates dupliquées ni espacer uniformément les dates clairsemées
Les axes de catégories restituent des caches de séries hiérarchiques du niveau feuille le plus proche de l'axe vers les niveaux parents successifs. NoMultiLevelLabels supprime les niveaux parents et mappe l'indicateur Classic équivalent lors de la conversion des modèles

Mise en page du texte et des titres

TextStyle met en forme les étiquettes de graduation, tandis que TitleTextStyle met en forme le titre de l'axe. Tous deux exposent des paramètres typés de nom, taille, couleur, emphase et rotation. Les valeurs de rotation ChartML positives sont horaires et sont converties vers la convention native de chaque backend de sortie
TitleLayout positionne et dimensionne le titre de l'axe avec des coordonnées ChartML normalisées. Utilisez SetPositionAndSize pour activer et définir les quatre valeurs en un seul groupe compatible Office

Méthodes

procedure Assign

Voir aussi