Legend classe

Encapsule l’objet qui représente la légende du graphique.

Héritage: Legend → ChartTextFrame → ChartFrame

Le type Legend 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 `ChartFrame.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 un objet `ChartFrame.font` de l’objet ChartFrame spécifié.
auto_scale_font	Cette 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_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 du graphique.
y	Obtient ou définit la coordonnée y du coin supérieur gauche en unités de 1/4000 de la zone du graphique.
height	Obtient ou définit la hauteur du cadre en unités de 1/4000 de la zone du graphique.
width	Obtient ou définit la largeur du cadre en unités de 1/4000 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 en unités de 1/4000 de la zone du graphique.
default_y	Représente y de la position par défaut en unités de 1/4000 de la zone du graphique.
default_width	Représente la largeur de la position par défaut en unités de 1/4000 de la zone du graphique.
default_height	Représente la hauteur de la position par défaut en unités de 1/4000 de la zone du graphique.
default_x_ratio_to_chart	Représente x de la position par défaut en unités de fraction de la zone du graphique.
default_y_ratio_to_chart	Représente y de la position par défaut en unités de fraction de la zone du graphique.
default_width_ratio_to_chart	Représente la largeur de la position par défaut en unités de fraction de la zone du graphique.
default_height_ratio_to_chart	Représente la hauteur de la position par défaut en unités de fraction de la zone du graphique.
x_ratio_to_chart	Obtient 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_chart	Obtient 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_chart	Obtient ou définit la largeur du cadre en unités de rapport de la zone du graphique.
height_ratio_to_chart	Obtient ou définit la hauteur du cadre en unités de rapport de la zone du graphique.
x_pixel	Obtient ou définit la coordonnée x du coin supérieur gauche en unités de pixels.
y_pixel	Obtient ou définit la coordonnée y du coin supérieur gauche en unités de pixels.
width_pixel	Obtient ou définit la largeur du cadre en unités de pixels.
height_pixel	Obtient ou définit la hauteur du cadre en unités de pixels.
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 du titre d’un cadre.
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 enveloppé.
is_resize_shape_to_fit_text	Obtient 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.
position	Obtient ou définit le type de position de la légende.
legend_entries	Obtient une collection de tous les objets LegendEntry dans la légende du graphique spécifiée. La définition des entrées de légende du graphique de surface n’est pas prise en charge. Il renverra donc null si le type de graphique est un type de graphique de surface.
legend_entries_labels	Obtient les étiquettes des entrées de légende après l’appel de la méthode Chart.Calculate().
is_over_lay	Obtient ou définit si la légende doit être affichée sans chevaucher le graphique.

Méthodes

Méthode	Description
`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.
`get_legend_labels(self)`	Obtient les étiquettes des entrées de légende après l’appel de la méthode Chart.Calculate().

Exemple

from aspose.cells import Workbook
from aspose.cells.charts import ChartType, LegendPositionType

workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
# Set Legend's width and height
legend = chart.legend
# Legend is at right side of chart by default.
# If the legend is at left or right side of the chart, setting Legend.X property will not take effect.
# If the legend is at top or bottom side of the chart, setting Legend.Y property will not take effect.
legend.y = 1500
legend.width = 50
legend.height = 50
# Set legend's position
legend.position = LegendPositionType.LEFT

Voir également

Floor classe LegendEntry classe