ChartShape classe

ChartShape classe

Représente la forme du graphique. Les propriétés et les méthodes de l’objet ChartObject contrôlent l’apparence et la taille du graphique incorporé dans la feuille de calcul.

Héritage: ChartShape → Shape

Le type ChartShape expose les membres suivants :

Propriétés

Propriété Description
macro_name Obtient et définit le nom de la macro.
is_equation Indique si la forme contient uniquement une équation.
is_smart_art Indique si la forme est de l’art intelligent.
z_order_position Renvoie la position d’une forme dans l’ordre z.
name Obtient et définit le nom de la forme.
alternative_text Renvoie ou définit la chaîne de texte descriptive (alternative) de l’objet Shape.
title Spécifie le titre (légende) de l’objet forme courant.
line_format Renvoie un objet MsoLineFormat qui contient les propriétés de mise en forme des lignes pour la forme spécifiée.
fill_format Renvoie un objet MsoFillFormat qui contient les propriétés de mise en forme de remplissage pour la forme spécifiée.
format Représente le paramètre de mise en forme de la forme.
line Obtient le style de ligne
fill Renvoie un objet Shape.fill_format qui contient les propriétés de formatage de remplissage pour la forme spécifiée.
shadow_effect Représente un objet ShadowEffect qui spécifie l’effet d’ombre pour l’élément ou la forme du graphique.
reflection Représente un objet ReflectionEffect qui spécifie l’effet de réflexion pour l’élément ou la forme du graphique.
glow Représente un objet GlowEffect qui spécifie l’effet de lueur pour l’élément ou la forme du graphique.
soft_edges Obtient et définit le rayon de flou à appliquer aux bords, en unités de points.
three_d_format Obtient et définit le format 3D de la forme.
text_frame Renvoie un objet TextFrame qui contient les propriétés d’alignement et d’ancrage de la forme spécifiée.
format_picture Obtient et définit les options du format d’image.
is_hidden Indique si l’objet est visible.
is_lock_aspect_ratio True signifie qu’il n’est pas possible de modifier les proportions.
rotation_angle Obtient et définit la rotation de la forme.
hyperlink Obtient le lien hypertexte de la forme.
id Obtient l’identifiant de cette forme.
spid Spécifie une chaîne facultative qu’une application peut utiliser pour identifier la forme particulière.
spt Spécifie un nombre facultatif qu’une application peut utiliser pour associer la forme particulière à un type de forme défini.
worksheet Obtient l’objet Shape.worksheet qui contient cette forme.
is_group Indique si la forme est un groupe.
is_in_group Indique si la forme est groupée.
is_word_art Indique si cette forme est un mot art.
text_effect Renvoie un objet TextEffectFormat qui contient des propriétés de mise en forme d’effet de texte pour la forme spécifiée.
S’applique aux objets Shape qui représentent WordArt.
is_locked Vrai si l’objet est verrouillé, Faux si l’objet peut être modifié lorsque la feuille est protégée.
is_printable Vrai si l’objet est imprimable
mso_drawing_type Obtient le type de dessin mso.
auto_shape_type Obtient et définit le type de forme automatique.
anchor_type Obtient et définit l’espace réservé d’ancrage de la forme.
placement Représente la manière dont l’objet dessin est attaché aux cellules situées en dessous.
La propriété contrôle le placement d’un objet sur une feuille de calcul.
upper_left_row Représente l’index de ligne du coin supérieur gauche.
upper_delta_y Obtient ou définit le décalage vertical de la forme par rapport à sa ligne dans le coin supérieur gauche.
upper_left_column Représente l’index de la colonne du coin supérieur gauche.
upper_delta_x Obtient ou définit le décalage horizontal de la forme par rapport à sa colonne d’angle supérieur gauche.
lower_right_row Représente l’index de ligne du coin inférieur droit.
lower_delta_y Obtient ou définit le décalage vertical de la forme par rapport à sa rangée du coin inférieur droit.
lower_right_column Représente l’index de la colonne du coin inférieur droit.
lower_delta_x Obtient ou définit le décalage horizontal de la forme par rapport à sa colonne d’angle inférieur droit.
right Représente la largeur du décalage horizontal de la forme par rapport à sa colonne d’angle inférieur droit, en pixels.
bottom Représente la largeur du décalage vertical de la forme par rapport à sa ligne d’angle inférieure inférieure, en pixels.
width Représente la largeur de la forme, en pixels.
width_inch Représente la largeur de la forme, en pouces.
width_pt Représente la largeur de la forme, en unité de point.
width_cm Représente la largeur de la forme, en centimètres.
height Représente la hauteur de la forme, en unité de pixel.
height_inch Représente la hauteur de la forme, en pouces.
height_pt Représente la hauteur de la forme, en unité de points.
height_cm Représente la hauteur de la forme, en centimètres.
left Représente le décalage horizontal de la forme par rapport à sa colonne de gauche, en pixels.
left_inch Représente le décalage horizontal de la forme par rapport à sa colonne de gauche, en pouces.
left_cm Représente le décalage horizontal de la forme par rapport à sa colonne de gauche, en centimètres.
top Représente le décalage vertical de la forme par rapport à sa rangée supérieure, en pixels.
top_inch Représente le décalage vertical de la forme par rapport à sa rangée supérieure, en pouces.
top_cm Représente le décalage vertical de la forme par rapport à sa rangée supérieure, en centimètres.
top_to_corner Obtient et définit le décalage vertical de la forme par rapport à la bordure supérieure de la feuille de calcul, en pixels.
left_to_corner Obtient et définit le décalage horizontal de la forme par rapport à la bordure gauche de la feuille de calcul.
x Obtient et définit le décalage horizontal de la forme par rapport à la bordure gauche de la feuille de calcul, en pixels.
y Obtient et définit le décalage vertical de la forme par rapport à la bordure supérieure de la feuille de calcul, en pixels.
width_scale Obtient et définit l’échelle de largeur, en pourcentage de la largeur de l’image d’origine.
Si la forme n’est pas picture , la propriété WidthScale ne renvoie que 100 ;
height_scale Obtient et définit l’échelle de hauteur, en pourcentage de la hauteur de l’image d’origine.
Si la forme n’est pas picture , la propriété HeightScale ne renvoie que 100 ;
top_in_shape Représente le décalage vertical de la forme par rapport à la bordure supérieure de la forme parent,
en unité de 1/4000 de hauteur de la forme parent.
left_in_shape Représente le décalage horizontal de la forme par rapport à la bordure gauche de la forme parent,
en unité de 1/4000 de largeur de la forme parent.
width_in_shape Représente la largeur de la forme, en unité de 1/4000 de la forme parent.
height_in_shape Représente le décalage vertical de la forme par rapport à la bordure supérieure de la forme parent, en unité de 1/4000 de hauteur de la forme parent.
group Obtient la forme de groupe qui contient cette forme.
type Obtient le type de forme automatique.
has_line Obtient et définit la bordure de ligne de la forme visible.
is_filled Indique si le format de remplissage est visible.
is_flipped_horizontally Obtient et définit si la forme est retournée horizontalement.
is_flipped_vertically Obtient et définit si la forme est retournée verticalement.
actual_lower_right_row Obtenez la rangée du bas réelle.
connection_points Obtenir les points de connexion
relative_to_original_picture_size Indique si la forme est relative à la taille de l’image d’origine.
linked_cell Obtient ou définit la plage de feuille de calcul liée à la valeur du contrôle.
input_range Obtient ou définit la plage de feuille de calcul utilisée pour remplir la zone de liste déroulante spécifiée.
text_shape_type Obtient et définit le type de forme de texte prédéfini.
text_body Obtient et définit le paramètre du texte de la forme.
font Représente la police de la forme.
text_options Représente les options de texte de la forme.
text Représente la chaîne dans cet objet TextBox.
is_rich_text Indique si le texte est un texte enrichi ou non.
html_text Obtient et définit la chaîne html qui contient des données et certains formats dans cette zone de texte.
text_vertical_overflow Obtient et définit le type de débordement vertical du texte de la forme qui contient du texte.
text_horizontal_overflow Obtient et définit le type de débordement horizontal du texte de la forme qui contient du texte.
is_text_wrapped Obtient et définit le type de texte enveloppé de la forme qui contient du texte.
text_orientation_type Obtient et définit le type d’orientation du texte de la forme.
text_horizontal_alignment Obtient et définit le type d’alignement horizontal du texte de la forme.
text_vertical_alignment Obtient et définit le type d’alignement vertical du texte de la forme.
text_direction Obtient/Définit la direction du flux de texte pour cet objet.
control_data Obtient les données de contrôle.
active_x_control Obtient le contrôle ActiveX.
paths Obtient les chemins d’une forme géométrique personnalisée.
geometry Obtient la géométrie
create_id Obtient et définit l’identifiant de création pour cette forme.
chart Renvoie un objet Chart qui représente le graphique contenu dans l’objet.

Méthodes

Méthode Description
to_image(stream, image_type) Crée l’image de la forme et l’enregistre dans un flux au format spécifié.
to_image(image_file, options) Enregistre la forme dans un fichier.
to_image(stream, options) Enregistre la forme dans un flux.
format_characters(start_index, length, font, flag) Formate certains caractères avec le paramètre de police.
format_characters(start_index, length, font) Formate certains caractères avec le paramètre de police.
get_result_of_smart_art() Conversion d’art intelligent en formes groupées.
to_front_or_back(orders) Amène la forme à l’avant ou envoie la forme à l’arrière.
get_locked_property(type) Obtient la valeur de la propriété verrouillée.
set_locked_property(type, value) Définissez la propriété verrouillée.
add_hyperlink(address) Ajoute un lien hypertexte à la forme.
remove_hyperlink() Supprimez le lien hypertexte de la forme.
move_to_range(upper_left_row, upper_left_column, lower_right_row, lower_right_column) Déplace la forme vers une plage spécifiée.
align_top_right_corner(top_row, right_column) Déplace l’image vers le coin supérieur droit.
get_connection_points() Obtenir les points de connexion
get_linked_cell(is_r1c1, is_local) Obtient la plage liée à la valeur du contrôle.
set_linked_cell(formula, is_r1c1, is_local) Définit la plage liée à la valeur du contrôle.
get_input_range(is_r1c1, is_local) Obtient la plage utilisée pour remplir le contrôle.
set_input_range(formula, is_r1c1, is_local) Définit la plage utilisée pour remplir le contrôle.
update_selected_value() Mettre à jour la valeur sélectionnée par la valeur de la cellule liée.
calculate_text_size() Recalculer la zone de texte
characters(start_index, length) Renvoie un objet Characters qui représente une plage de caractères dans le texte.
get_characters() Renvoie tous les objets Characters
qui représente une plage de caractères dans le texte .
remove_active_x_control() Supprimez le contrôle ActiveX.
is_same_setting(obj) Renvoie si la forme est identique.

Exemple

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

# Instantiating a Workbook object
workbook = Workbook()
# Obtaining the reference of the first worksheet
worksheet = workbook.worksheets[0]
# Adding a sample value to "A1" cell
worksheet.cells.get("A1").put_value(50)
# Adding a sample value to "A2" cell
worksheet.cells.get("A2").put_value(100)
# Adding a sample value to "A3" cell
worksheet.cells.get("A3").put_value(150)
# Adding a sample value to "B1" cell
worksheet.cells.get("B1").put_value(60)
# Adding a sample value to "B2" cell
worksheet.cells.get("B2").put_value(32)
# Adding a sample value to "B3" cell
worksheet.cells.get("B3").put_value(50)
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.PIE_EXPLODED, 5, 0, 25, 10)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B3"
chart.n_series.add("A1:B3", True)
# Show Data Labels
chart.n_series[0].data_labels.show_value = True
# Getting Chart Shape
chartShape = chart.chart_object
# Set Lower Right Column
chartShape.lower_right_column = 10
# Set LowerDeltaX
chartShape.lower_delta_x = 1024
# Saving the Excel file
workbook.save("book1.xls")

Voir également

CellsDrawing classe CheckBox classe