Legend classe

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 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 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 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.
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 de graphique spécifiée.
La définition des entrées de légende du graphique en surface n’est pas prise en charge.
Il renverra donc null si le type de graphique est de type graphique en surface.
legend_entries_labels Obtient les étiquettes des entrées de légende après avoir appelé la méthode Chart.Calculate().
is_over_lay Obtient ou définit si d’autres éléments de graphique doivent être autorisés à chevaucher cet élément de graphique.

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 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