DataLabels classe

DataLabels classe

Encapsule une collection de tous les objets DataLabel pour la série spécifiée.

Héritage: DataLabelsChartTextFrameChartFrame

Le type DataLabels expose les membres suivants :

Propriétés

PropriétéDescription
is_inner_modeIndique si la taille de la zone de tracé inclut les graduations et les étiquettes des axes.
False spécifie que la taille doit déterminer la taille de la zone de tracé, les graduations et les étiquettes des axes.
borderObtient le Line.
areaObtient le DataLabels.area.
text_fontObtient un objet ChartFrame.font de l’objet ChartFrame spécifié.
text_optionsObtient et définit les options du texte.
fontObtient la police des DataLabels ;
auto_scale_fontCette valeur est « Vrai » si la taille de police du texte de l’objet change en fonction de la taille de l’objet. La valeur par défaut est « Vrai ».
background_modeObtient et définit le mode d’affichage de l’arrière-plan
backgroundObtient et définit le mode d’affichage de l’arrière-plan
is_automatic_sizeIndique si le cadre du graphique est dimensionné automatiquement.
xObtient ou définit la coordonnée x du coin supérieur gauche en unités de 1/4000 de la zone du graphique.
yObtient ou définit la coordonnée y du coin supérieur gauche en unités de 1/4000 de la zone du graphique.
heightObtient ou définit la hauteur du cadre en unités de 1/4000 de la zone du graphique.
widthObtient ou définit la largeur du cadre en unités de 1/4000 de la zone du graphique.
shadowVrai si le cadre a une ombre.
shape_propertiesObtient l’objet ChartFrame.shape_properties.
is_default_pos_be_setIndique si la position par défaut (DefaultX, DefaultY, DefaultWidth et DefaultHeight) est définie.
default_xReprésente x de la position par défaut en unités de 1/4000 de la zone du graphique.
default_yReprésente y de la position par défaut en unités de 1/4000 de la zone du graphique.
default_widthReprésente la largeur de la position par défaut en unités de 1/4000 de la zone du graphique.
default_heightReprésente la hauteur de la position par défaut en unités de 1/4000 de la zone du graphique.
default_x_ratio_to_chartReprésente x de la position par défaut en unités de fraction de la zone du graphique.
default_y_ratio_to_chartReprésente y de la position par défaut en unités de fraction de la zone du graphique.
default_width_ratio_to_chartReprésente la largeur de la position par défaut en unités de fraction de la zone du graphique.
default_height_ratio_to_chartReprésente la hauteur de la position par défaut en unités de fraction de la zone du graphique.
x_ratio_to_chartObtient ou définit la coordonnée x du coin supérieur gauche en unités de rapport de la zone du graphique.
y_ratio_to_chartObtient ou définit la coordonnée y du coin supérieur gauche en unités de rapport de la zone du graphique.
width_ratio_to_chartObtient ou définit la largeur du cadre en unités de rapport de la zone du graphique.
height_ratio_to_chartObtient ou définit la hauteur du cadre en unités de rapport de la zone du graphique.
x_pixelObtient ou définit la coordonnée x du coin supérieur gauche en unités de pixels.
y_pixelObtient ou définit la coordonnée y du coin supérieur gauche en unités de pixels.
width_pixelObtient ou définit la largeur du cadre en unités de pixels.
height_pixelObtient ou définit la hauteur du cadre en unités de pixels.
is_auto_textIndique que le texte est généré automatiquement.
is_deletedIndique si ces étiquettes de données sont supprimées.
text_horizontal_alignmentObtient et définit l’alignement horizontal du texte.
text_vertical_alignmentObtient ou définit l’alignement vertical du texte.
rotation_angleReprésente l’angle de rotation du texte.
is_automatic_rotationIndique si le texte du graphique est automatiquement pivoté.
textObtient ou définit le texte de l’étiquette de données.
linked_sourceObtient et définit une référence à la feuille de calcul.
text_directionReprésente l’ordre de lecture du texte.
reading_orderReprésente l’ordre de lecture du texte.
direction_typeObtient et définit la direction du texte.
is_text_wrappedObtient ou définit une valeur indiquant si le texte est enveloppé.
is_resize_shape_to_fit_textObtient ou définit si une forme doit être ajustée automatiquement pour contenir entièrement le texte qu’elle décrit. L’ajustement automatique est
lorsque le texte dans une forme est mis à l’échelle afin de contenir tout le texte à l’intérieur.
show_valueReprésente le comportement d’affichage des valeurs des étiquettes de données d’un graphique spécifié. La valeur « True » affiche les valeurs. La valeur « False » masque les valeurs.
show_cell_rangeIndique si la plage de cellules doit être affichée comme étiquettes de données.
show_percentageReprésente le comportement d’affichage du pourcentage des étiquettes de données d’un graphique spécifié. La valeur « True » affiche le pourcentage. La valeur « False » masque le pourcentage.
show_bubble_sizeReprésente le comportement d’affichage du pourcentage des étiquettes de données d’un graphique spécifié. La valeur « True » affiche le pourcentage. La valeur « False » masque le pourcentage.
show_category_nameReprésente le comportement d’affichage du nom de catégorie des étiquettes de données d’un graphique spécifié. La valeur « True » affiche le nom de catégorie des étiquettes de données d’un graphique. La valeur « False » le masque.
show_series_nameIndique si le nom de la série s’affiche pour les étiquettes de données sur un graphique.
Vrai pour afficher le nom de la série. Faux pour le masquer.
show_legend_keyReprésente le comportement d’affichage de la clé de légende de l’étiquette de données d’un graphique spécifié.
Vrai si la clé de légende de l’étiquette de données est visible.
number_formatReprésente la chaîne de format pour l’objet DataLabels.
numberObtient et définit le format numérique intégré.
number_format_linkedVrai si le format numérique est lié aux cellules
(afin que le format des nombres change dans les étiquettes lorsqu’il change dans les cellules).
separator_typeObtient ou définit le type de séparateur utilisé pour les étiquettes de données sur un graphique.
separator_valueObtient ou définit la valeur du séparateur utilisée pour les étiquettes de données sur un graphique.
positionReprésente la position de l’étiquette de données.
is_never_overlapIndique si les étiquettes de données affichées ne se chevauchent jamais. (Pour les graphiques à secteurs)
shape_typeObtient ou définit le type de forme de l’étiquette de données.

Méthodes

MéthodeDescription
set_position_auto(self)Définir la position du cadre sur automatique
characters(self, start_index, length)Renvoie un objet Characters qui représente une plage de caractères dans le texte.
apply_font(self)Appliquez la police des étiquettes de données à tous les nœuds enfants.

Exemple

from aspose.cells import Workbook
from aspose.cells.charts import LabelPositionType

# Set the DataLabels in the chart
wb = Workbook("chart.xlsx")
chart = wb.worksheets[0].charts[0]
for i in range(len(chart.n_series)):
    datalabels = chart.n_series[i].data_labels
    # Set the position of DataLabels
    datalabels.position = LabelPositionType.INSIDE_BASE
    # Show the category name in the DataLabels
    datalabels.show_category_name = True
    # Show the value in the DataLabels
    datalabels.show_value = True
    # Not show the percentage in the DataLabels
    datalabels.show_percentage = False
    # Not show the legend key.
    datalabels.show_legend_key = False

Voir également