Unit: lxHandleX
Séries de graphique avec plages de formules, valeurs en cache, étiquettes de données, collection de courbes de tendance et barres d'erreur X/Y
Description
Une série conserve son nom d'affichage, sa formule de nom facultative, sa formule de catégories ou X, sa formule de valeurs ou Y, sa formule de taille de bulles ainsi que le cache de chaînes ou de nombres stocké à côté de chaque formule. Les points en cache améliorent le rendu hors ligne et survivent aux modifications du graphique, aux copies de feuilles de calcul et aux cycles ouverture-enregistrement
Marqueurs de série et lissage
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | Couleur de remplissage du marqueur de la série pour les graphiques en courbes/nuage de points, sous forme de LongWordRGB ; 0 conserve la couleur de thème automatique d'Excel |
| MarkerBorderColor | Couleur de bordure du marqueur de la série, sous forme de LongWord |
| Smooth | restitue la série sous forme de courbe lissée au lieu de segments de droite ; à combiner avec MarkerSymbol/MarkerSize/MarkerSet |
| SmoothSet | Indique si le flag de lissage a été défini explicitement, ce qui conditionne l'émission du flag smooth OOXML |
| LegendDeleted | retire cette série de la légende tout en la gardant tracée, en émettant une suppression c:legendEntry pour son index de série |
Catégories à plusieurs niveaux
property CategoriesMultiLevel: Boolean;
property CategoryLevelCount: Integer;
property CategoryLevels[Index: Integer]: TXLSXChartDataCache;
function AddCategoryLevel: TXLSXChartDataCache;
procedure ClearCategoryLevels;
procedure ResolveCategoryLevels;
function BuildCategorySpans(APointCount: Integer;
out ASpans: TXLSXChartCategorySpans): Integer;
Les niveaux de catégories sont ordonnés de la feuille vers la racine, conformément à l'ordre physique du cache ChartML. Chaque niveau est un cache de chaînes indexé épars. Les points manquants héritent du libellé précédent dans ce niveau, tandis qu'une chaîne vide explicitement stockée démarre une étendue vide et empêche la fusion entre groupes adjacents
ResolveCategoryLevels matérialise une plage de catégories bidimensionnelle accessible une seule fois et, sinon, conserve le cache importé BuildCategorySpans matérialise une seule fois une plage de catégories bidimensionnelle accessible et conserve sinon le cache importé. O(levels × points) renvoie des étendues tenant compte des parents en temps O(levels × points), de sorte que le texte enfant identique n'est fusionné qu'au sein d'une même étendue parent
Étiquettes de données issues de cellules
property DataLabelsRange: WideString;
property DataLabelsCache: TXLSXChartDataCache;
property ShowDataLabelsRange: Boolean;
property ShowDataLabelsRangeSet: Boolean;
property SeparatorSet: Boolean;
property DataLabelRangeOverrideCount: Integer;
property DataLabelRangeOverrideIndexes[Index: Integer]: Integer;
property DataLabelRangeOverrideValues[Index: Integer]: Boolean;
procedure ResolveDataLabelsRange;
procedure SetPointShowDataLabelsRange(APointIndex: Integer;
AVisible: Boolean);
procedure ClearPointShowDataLabelsRangeOverrides;
function TryGetPointShowDataLabelsRange(APointIndex: Integer;
out AVisible: Boolean): Boolean;
DataLabelsRange est une formule A1 par série et DataLabelsCache conserve le texte indexé stocké avec le graphique. Les plages internes de la feuille de calcul s'actualisent une fois par génération du classeur, tandis que les formules inaccessibles ou externes conservent leur cache importé et ne déclenchent jamais d'accès implicite aux fichiers ou au réseau
ShowDataLabelsRangeSet préserve le fait que la visibilité partagée était explicitement présente, et les méthodes par point gèrent des substitutions de visibilité éparses en base zéro. Le texte de cellule personnalisé est composé avant les composants nom de série, catégorie, valeur, pourcentage et taille de bulles, le séparateur n'étant inséré qu'entre les composants non vides
TXLSXChart.DataLabelsRange reste une façade de compatibilité. Son setter diffuse la valeur aux séries existantes et l'amorce pour les séries créées ensuite, tandis que son getter ne renvoie une valeur que si toutes les séries utilisent la même formule
Properties
Name
NameRange
CategoriesRange
ValuesRange
BubbleSizeRange
DataLabelsRange
NameCache
CategoryCache
CategoriesMultiLevel
CategoryLevelCount
CategoryLevels
ValueCache
BubbleSizeCache
DataLabelsCache
DataLabelRangeOverrideCount
DataLabelRangeOverrideIndexes
DataLabelRangeOverrideValues
TrendlineCount
Trendlines
ErrBarX
ErrBarY
ShowValue
ShowCategoryName
ShowSeriesName
ShowLegendKey
ShowPercent
ShowBubbleSize
ShowDataLabelsRange
ShowDataLabelsRangeSet
Separator
SeparatorSet
MarkerFillColor
MarkerBorderColor
Smooth
SmoothSet
LegendDeleted
Points en cache
Définissez un type de cache sur xlsxChartCacheString ou xlsxChartCacheNumber, définissez éventuellement FormatCode pour les données numériques, puis ajoutez des points indexés. Les caches numériques sans code de format explicite utilisent General lors de l'écriture
Methods
procedure Assign
function AddTrendline
function AddErrorBar
function AddCategoryLevel
procedure ClearCategoryLevels
procedure ResolveCategoryLevels
function BuildCategorySpans
procedure ResolveDataLabelsRange
procedure SetPointShowDataLabelsRange
procedure ClearPointShowDataLabelsRangeOverrides
function TryGetPointShowDataLabelsRange
See also