DataLabels classe

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

Héritage: DataLabels → ChartTextFrame → ChartFrame

Le type DataLabels expose les membres suivants :

Propriétés

Propriété	Description
is_inner_mode	Indique 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.
border	Obtient le `Line`.
area	Obtient le `DataLabels.area`.
text_font	Obtient un objet `ChartFrame.font` de l’objet ChartFrame spécifié.
text_options	Obtient et définit les options du texte.
font	Obtient la police des DataLabels ;
auto_scale_font	True si le texte de l’objet change de taille de police lorsque la taille de l’objet change. La valeur par défaut est True.
background_mode	Obtient et définit le mode d’affichage de l’arrière-plan
background	Obtient et définit le mode d’affichage de l’arrière-plan
is_automatic_size	Indique si le cadre du graphique est dimensionné automatiquement.
x	Obtient ou définit la coordonnée x du coin supérieur gauche en unités de 1/4 000 de la zone du graphique.
y	Obtient ou définit la coordonnée y du coin supérieur gauche en unités de 1/4 000 de la zone du graphique.
height	Obtient ou définit la hauteur du cadre en unités de 1/4 000 de la zone du graphique.
width	Obtient ou définit la largeur du cadre en unités de 1/4 000 de la zone du graphique.
shadow	Vrai si le cadre a une ombre.
shape_properties	Obtient l’objet `ChartFrame.shape_properties`.
is_default_pos_be_set	Indique si la position par défaut (DefaultX, DefaultY, DefaultWidth et DefaultHeight) est définie.
default_x	Représente x de la position par défaut
default_y	Représente y de la position par défaut
default_width	Représente la largeur de la position par défaut
default_height	Représente la hauteur de la position par défaut
is_auto_text	Indique que le texte est généré automatiquement.
is_deleted	Indique si ces étiquettes de données sont supprimées.
text_horizontal_alignment	Obtient et définit l’alignement horizontal du texte.
text_vertical_alignment	Obtient ou définit l’alignement vertical du texte.
rotation_angle	Représente l’angle de rotation du texte.
is_automatic_rotation	Indique si le texte du graphique est automatiquement pivoté.
text	Obtient ou définit le texte de l’étiquette de données.
linked_source	Obtient et définit une référence à la feuille de calcul.
text_direction	Représente l’ordre de lecture du texte.
reading_order	Représente l’ordre de lecture du texte.
direction_type	Obtient et définit la direction du texte.
is_text_wrapped	Obtient ou définit une valeur indiquant si le texte est renvoyé à la ligne.
is_resize_shape_to_fit_text	Obtient ou définit si une forme doit être automatiquement ajustée pour contenir entièrement le texte qui y est décrit. L’ajustement automatique est lorsque le texte d’une forme est mis à l’échelle afin de contenir tout le texte à l’intérieur.
show_value	Représente le comportement d’affichage des valeurs d’étiquette de données d’un graphique spécifié. True affiche les valeurs. Faux pour se cacher.
show_cell_range	Indique si la plage de cellules est affichée comme étiquettes de données.
show_percentage	Représente le comportement d’affichage de la valeur en pourcentage de l’étiquette de données d’un graphique spécifié. True affiche la valeur en pourcentage. Faux pour se cacher.
show_bubble_size	Représente le comportement d’affichage de la valeur en pourcentage de l’étiquette de données d’un graphique spécifié. True affiche la valeur en pourcentage. Faux pour se cacher.
show_category_name	Représente le comportement d’affichage du nom de catégorie d’étiquette de données d’un graphique spécifié. True pour afficher le nom de catégorie pour les étiquettes de données sur un graphique. Faux pour se cacher.
show_series_name	Renvoie ou définit un booléen pour indiquer le comportement d’affichage du nom de série pour les étiquettes de données sur un graphique. True pour afficher le nom de la série. Faux pour se cacher.
show_legend_key	Représente le comportement d’affichage de la clé de légende de l’étiquette de données d’un graphique spécifié. True si la clé de légende de l’étiquette de données est visible.
number_format	Représente la chaîne de format pour l’objet DataLabels.
number	Obtient et définit le format numérique intégré.
number_format_linked	Vrai si le format des nombres est lié aux cellules (pour que le format des nombres change dans les étiquettes lorsqu’il change dans les cellules).
separator_type	Obtient ou définit le type de séparateur utilisé pour les étiquettes de données sur un graphique.
separator_value	Obtient ou définit la valeur de séparateur utilisée pour les étiquettes de données sur un graphique.
position	Représente la position de l’étiquette de données.
is_never_overlap	Indique si l’affichage des étiquettes de données ne se chevauche jamais. (Pour le diagramme circulaire)
shape_type	Obtient ou définit le type de forme de l’étiquette de données.

Méthodes

Méthode	Description
set_position_auto	Régler la position du cadre sur automatique
characters	Renvoie un objet Characters qui représente une plage de caractères dans le texte.

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

ChartTextFrame classe DisplayUnitLabel classe