DataLabels classe

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 Vrai.
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/4000 de la zone de graphique.
y Obtient ou définit la coordonnée y du coin supérieur gauche en unités de 1/4000 de la zone de graphique.
height Obtient ou définit la hauteur du cadre en unités de 1/4000 de la zone de graphique.
width Obtient ou définit la largeur du cadre en unités de 1/4000 de la zone de 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 encapsulé.
is_resize_shape_to_fit_text Obtient ou définit si une forme doit être ajustée automatiquement 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 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 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 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 des étiquettes de données d’un graphique. Faux pour cacher.
show_series_name Renvoie ou définit un booléen pour indiquer le comportement d’affichage du nom de la série pour les étiquettes de données sur un graphique.
True pour afficher le nom de la série. Faux pour 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 de l’objet DataLabels.
number Obtient et définit le format numérique intégré.
number_format_linked Vrai 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 Obtient ou définit le type de séparateur utilisé pour les étiquettes de données sur un graphique.
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 les étiquettes de données ne se chevauchent jamais. (Pour le graphique à secteurs)
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(start_index, length) 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.NSeries)):
    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