Shape classe

Shape classe

Représente l’objet msodrawing.

Le type Shape expose les membres suivants :

Propriétés

PropriétéDescription
macro_nameObtient et définit le nom de la macro.
is_equationIndique si la forme contient uniquement une équation.
is_smart_artIndique si la forme est un art intelligent.
z_order_positionRenvoie la position d’une forme dans l’ordre z.
nameObtient et définit le nom de la forme.
alternative_textRenvoie ou définit la chaîne de texte descriptive (alternative) de l’objet Shape.
titleSpécifie le titre (légende) de l’objet de forme actuel.
line_formatRenvoie un objet MsoLineFormat qui contient les propriétés de mise en forme de ligne pour la forme spécifiée.
fill_formatRenvoie un objet MsoFillFormat qui contient les propriétés de mise en forme de remplissage pour la forme spécifiée.
lineObtient le style de ligne
fillRenvoie un objet Shape.fill_format qui contient les propriétés de formatage de remplissage pour la forme spécifiée.
shadow_effectReprésente un objet ShadowEffect qui spécifie l’effet d’ombre pour l’élément ou la forme du graphique.
reflectionReprésente un objet ReflectionEffect qui spécifie l’effet de réflexion pour l’élément ou la forme du graphique.
glowReprésente un objet GlowEffect qui spécifie l’effet de lueur pour l’élément ou la forme du graphique.
soft_edgesObtient et définit le rayon de flou à appliquer aux bords, en unités de points.
three_d_formatObtient et définit le format 3D de la forme.
text_frameRenvoie un objet TextFrame qui contient les propriétés d’alignement et d’ancrage de la forme spécifiée.
format_pictureObtient et définit les options du format d’image.
is_hiddenIndique si l’objet est visible.
is_lock_aspect_ratioVrai signifie que cela n’autorise pas les changements de rapport hauteur/largeur.
rotation_angleObtient et définit la rotation de la forme.
hyperlinkObtient le lien hypertexte de la forme.
idObtient l’identifiant de cette forme.
spidSpécifie une chaîne facultative qu’une application peut utiliser pour identifier la forme particulière.
sptSpécifie un numéro facultatif qu’une application peut utiliser pour associer la forme particulière à un type de forme défini.
worksheetObtient l’objet Shape.worksheet qui contient cette forme.
is_groupIndique si la forme est un groupe.
is_in_groupIndique si la forme est groupée.
is_word_artIndique si cette forme est un word art.
text_effectRenvoie un objet TextEffectFormat qui contient les propriétés de mise en forme des effets de texte pour la forme spécifiée.
S’applique aux objets Shape qui représentent WordArt.
is_lockedTrue si l’objet est verrouillé, False si l’objet peut être modifié lorsque la feuille est protégée.
is_printableVrai si l’objet est imprimable
mso_drawing_typeObtient le type de dessin mso.
auto_shape_typeObtient et définit le type de forme automatique.
anchor_typeObtient et définit l’espace réservé de l’ancre de forme.
placementReprésente la manière dont l’objet de 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_rowReprésente l’index de la ligne du coin supérieur gauche.
upper_delta_yObtient ou définit le décalage vertical de la forme par rapport à sa ligne du coin supérieur gauche.
upper_left_columnReprésente l’index de la colonne du coin supérieur gauche.
upper_delta_xObtient ou définit le décalage horizontal de la forme par rapport à sa colonne du coin supérieur gauche.
lower_right_rowReprésente l’index de la ligne du coin inférieur droit.
lower_delta_yObtient ou définit le décalage vertical de la forme par rapport à sa ligne du coin inférieur droit.
lower_right_columnReprésente l’index de la colonne du coin inférieur droit.
lower_delta_xObtient ou définit le décalage horizontal de la forme par rapport à sa colonne du coin inférieur droit.
rightReprésente la largeur du décalage horizontal de la forme par rapport à sa colonne du coin inférieur droit, en unités de pixels.
bottomReprésente la largeur du décalage vertical de la forme par rapport à sa rangée du coin inférieur inférieur, en unités de pixels.
widthReprésente la largeur de la forme, en unités de pixels.
width_inchReprésente la largeur de la forme, en unité de pouce.
width_ptReprésente la largeur de la forme, en unité de point.
width_cmReprésente la largeur de la forme, en unités de centimètres.
heightReprésente la hauteur de la forme, en unité de pixel.
height_inchReprésente la hauteur de la forme, en unités de pouces.
height_ptReprésente la hauteur de la forme, en unités de points.
height_cmReprésente la hauteur de la forme, en unités de centimètres.
leftReprésente le décalage horizontal de la forme par rapport à sa colonne de gauche, en unités de pixels.
left_inchReprésente le décalage horizontal de la forme par rapport à sa colonne de gauche, en unités de pouces.
left_cmReprésente le décalage horizontal de la forme par rapport à sa colonne de gauche, en unités de centimètres.
topReprésente le décalage vertical de la forme par rapport à sa rangée supérieure, en unités de pixels.
top_inchReprésente le décalage vertical de la forme par rapport à sa rangée supérieure, en unités de pouces.
top_cmReprésente le décalage vertical de la forme par rapport à sa rangée supérieure, en unités de centimètres.
top_to_cornerObtient et définit le décalage vertical de la forme par rapport à la bordure supérieure de la feuille de calcul, en unités de pixels.
left_to_cornerObtient et définit le décalage horizontal de la forme par rapport à la bordure gauche de la feuille de calcul.
xObtient et définit le décalage horizontal de la forme par rapport à la bordure gauche de la feuille de calcul, en unités de pixels.
yObtient et définit le décalage vertical de la forme par rapport à la bordure supérieure de la feuille de calcul, en unités de pixels.
width_scaleObtient et définit l’échelle de largeur, en unité de pourcentage de la largeur de l’image d’origine.
Si la forme n’est pas une image, la propriété widthScale renvoie uniquement 100 ;
height_scaleObtient et définit l’échelle de hauteur, en unité de pourcentage de la hauteur de l’image d’origine.
Si la forme n’est pas une image, la propriété HeightScale renvoie uniquement 100 ;
top_in_shapeRepré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_shapeRepré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_shapeReprésente la largeur de la forme, en unité de 1/4 000 de la forme parent.
height_in_shapeReprésente le décalage vertical de la forme par rapport à la bordure supérieure de la forme parent, en unité de 1/4 000 de la hauteur de la forme parent.
groupObtient la forme de groupe qui contient cette forme.
typeObtient le type de forme automatique.
has_lineObtient et définit la bordure de ligne de la forme qui est visible.
is_filledIndique si le format de remplissage est visible.
is_flipped_horizontallyObtient et définit si la forme est inversée horizontalement.
is_flipped_verticallyObtient et définit si la forme est inversée verticalement.
actual_lower_right_rowObtenez la ligne du bas réelle.
connection_pointsObtenez les points de connexion
relative_to_original_picture_sizeIndique si la forme est relative à la taille d’origine de l’image.
linked_cellObtient ou définit la plage de feuille de calcul liée à la valeur du contrôle.
input_rangeObtient ou définit la plage de feuille de calcul utilisée pour remplir la zone de liste déroulante spécifiée.
text_shape_typeObtient et définit le type de forme de texte prédéfini.
text_bodyObtient et définit le paramètre du texte de la forme.
fontReprésente la police de la forme.
text_optionsReprésente les options de texte de la forme.
textReprésente la chaîne dans cet objet TextBox.
is_rich_textSi le texte est ou non un texte enrichi.
html_textObtient et définit la chaîne HTML qui contient des données et certains formats dans cette zone de texte.
text_vertical_overflowObtient et définit le type de débordement vertical de texte de la forme qui contient du texte.
text_horizontal_overflowObtient et définit le type de débordement horizontal de texte de la forme qui contient du texte.
is_text_wrappedObtient et définit le type de texte renvoyé à la ligne de la forme qui contient le texte.
text_orientation_typeObtient et définit le type d’orientation du texte de la forme.
text_horizontal_alignmentObtient et définit le type d’alignement horizontal du texte de la forme.
text_vertical_alignmentObtient et définit le type d’alignement vertical du texte de la forme.
text_directionObtient/Définit la direction du flux de texte pour cet objet.
control_dataObtient les données de contrôle.
active_x_controlObtient le contrôle ActiveX.
pathsObtient les chemins d’une forme géométrique personnalisée.
geometryObtient la géométrie
create_idObtient et définit l’identifiant de création pour cette forme.

Méthodes

MéthodeDescription
to_imageCrée l’image de forme et l’enregistre dans un flux au format spécifié.
to_imageEnregistre la forme dans un fichier.
to_imageEnregistre la forme dans un flux.
format_charactersFormate certains caractères avec le paramètre de police.
format_charactersFormate certains caractères avec le paramètre de police.
get_result_of_smart_artConversion d’art intelligent en formes groupées.
to_front_or_backPlace la forme au premier plan ou la renvoie à l’arrière-plan.
get_locked_propertyObtient la valeur de la propriété verrouillée.
set_locked_propertyDéfinissez la propriété verrouillée.
add_hyperlinkAjoute un lien hypertexte à la forme.
remove_hyperlinkSupprimez le lien hypertexte de la forme.
move_to_rangeDéplace la forme vers une plage spécifiée.
align_top_right_cornerDéplace l’image vers le coin supérieur droit.
get_connection_pointsObtenez les points de connexion
get_linked_cellObtient la plage liée à la valeur du contrôle.
set_linked_cellDéfinit la plage liée à la valeur du contrôle.
get_input_rangeObtient la plage utilisée pour remplir le contrôle.
set_input_rangeDéfinit la plage utilisée pour remplir le contrôle.
update_selected_valueMettez à jour la valeur sélectionnée par la valeur de la cellule liée.
calculate_text_sizeRecalculer la zone de texte
charactersRenvoie un objet Characters qui représente une plage de caractères dans le texte.
get_charactersRenvoie tous les objets Personnages
qui représente une plage de caractères dans le texte.
get_rich_formattingsRenvoie tous les objets Personnages
qui représente une plage de caractères dans le texte.
remove_active_x_controlSupprimez le contrôle ActiveX.
is_same_settingRenvoie si la forme est la même.
get_actual_boxObtenez la position et la taille réelles de la forme (après avoir appliqué une rotation, un retournement, etc.)

Exemple

from aspose.cells import Workbook

# Initialize a new workbook.
book = Workbook()
# Add a shape.(e.g rectangle)
shape = book.worksheets[0].shapes.add_rectangle(2, 0, 2, 0, 130, 130)
# do your business
# Save the excel file.
book.save("exmaple.xlsx")

Voir également