Travailler avec des formes

Cette rubrique explique comment travailler par programmation avec des formes à l’aide de Aspose.Words.

Les formes dans Aspose.Words représentent un objet dans le calque de dessin, tel qu’une forme automatique, une zone de texte, une forme libre, un objet OLE, un contrôle ActiveX ou une image. Un document Word peut contenir une ou plusieurs formes différentes. Les formes du document sont représentées par la classe Shape.

Insertion de formes à l’aide de Document Builder

Vous pouvez insérer une forme en ligne avec un type et une taille spécifiés et une forme flottante avec la position, la taille et le type d’habillage de texte spécifiés dans un document à l’aide de la méthode insert_shape. La méthode insert_shape permet d’insérer une forme DML dans le modèle de document. Le document doit être enregistré dans un format prenant en charge les formes DML, sinon ces nœuds seront convertis en forme VML lors de l’enregistrement du document.

L’exemple de code suivant montre comment insérer ces types de formes dans le document:

Définir le format d’image verrouillé

À l’aide de Aspose.Words, vous pouvez spécifier si les proportions de la forme sont verrouillées via la propriété aspect_ratio_locked.

L’exemple de code suivant montre comment utiliser la propriété AspectRatioLocked:

Définir la disposition de la forme dans la cellule

Vous pouvez également spécifier si la forme est affichée à l’intérieur ou à l’extérieur d’un tableau à l’aide de la propriété is_layout_in_cell.

L’exemple de code suivant montre comment utiliser la propriété IsLayoutInCell:

Créer un rectangle de coin de coupe

Vous pouvez créer un rectangle de coin coupé à l’aide de Aspose.Words. Les types de formes sont SINGLE_CORNER_SNIPPED, TOP_CORNERS_SNIPPED, DIAGONAL_CORNERS_SNIPPED, TOP_CORNERS_ONE_ROUNDED_ONE_SNIPPED, SINGLE_CORNER_ROUNDED, TOP_CORNERS_ROUNDED et DIAGONAL_CORNERS_ROUNDED.

La forme DML est créée à l’aide de la méthode insert_shape avec ces types de forme. Ces types ne peuvent pas être utilisés pour créer des formes VML. Toute tentative de création de forme à l’aide du constructeur public de la classe Shape déclenche l’exception “NotSupportedException”.

L’exemple de code suivant montre comment insérer ce type de formes dans le document:

Obtenir les points de limites de forme réels

À l’aide de Aspose.Words API, vous pouvez obtenir l’emplacement et la taille de la forme contenant le bloc en points, par rapport à l’ancre de la forme la plus haute. Pour ce faire, utilisez la propriété bounds_in_points.

L’exemple de code suivant montre comment utiliser la propriété BoundsInPoints:

Spécifier l’ancrage vertical

Vous pouvez spécifier l’alignement vertical du texte dans une forme à l’aide de la propriété vertical_anchor.

L’exemple de code suivant montre comment utiliser la propriété VerticalAnchor:

Détecter la forme SmartArt

Aspose.Words permet également de détecter si la Shape possède un objet SmartArt. Pour ce faire, utilisez la propriété Propriété has_smart_art.

L’exemple de code suivant montre comment utiliser la propriété HasSmartArt:

Insérer une règle horizontale dans le document

Vous pouvez insérer une forme de règle horizontale dans un document à l’aide de la méthode insert_horizontal_rule.

L’exemple de code suivant montre comment procéder:

Aspose.Words API fournit la propriété horizontal_rule_format pour accéder aux propriétés de la forme de la règle horizontale. La classe HorizontalRuleFormat expose des propriétés de base comme height, color, no_shade etc. pour le formatage d’une règle horizontale.

L’exemple de code suivant montre comment définir HorizontalRuleFormat:

Insérer un objet OLE en tant qu’icône

Aspose.Words API fournit une fonction Shape.insert_ole_object_as_icon pour insérer un objet OLE incorporé ou lié sous forme d’icône dans le document. Cette fonction permet de spécifier le fichier icône et la légende. Le type d’objet OLE doit être détecté à l’aide de l’extension de fichier.

L’exemple de code suivant montre comment définir l’insertion d’un objet OLE en tant qu’icône dans le document:

La taille maximale de l’icône doit être de 32x32 pour un affichage correct.

Importer des formes avec Math XML en tant que formes dans DOM

Vous pouvez utiliser la propriété convert_shape_to_office_math pour convertir les formes avec EquationXML en objets Office Math. La valeur par défaut de cette propriété correspond au comportement de MS Word, c’est-à-dire que les formes avec une équation XML ne sont pas converties en objets mathématiques Office.

L’exemple de code suivant montre comment convertir des formes en objets Office Math: