Travailler avec des images

Aspose.Words permet aux utilisateurs de travailler avec des images de manière très flexible. Dans cet article, vous ne pouvez explorer que certaines des possibilités de travail avec des images.

Comment insérer une image

DocumentBuilder fournit plusieurs surcharges de la méthode InsertImage qui vous permettent d’insérer une image en ligne ou flottante. Si l’image est un métafichier EMF ou WMF, elle sera insérée dans le document au format métafichier. Toutes les autres images seront stockées au format PNG. La méthode InsertImage peut utiliser des images provenant de différentes sources:

  • Depuis un fichier ou URL en passant un paramètre InsertImage String
  • Depuis un flux en passant un paramètre Stream InsertImage
  • Depuis un objet Image en passant un paramètre Image InsertImage
  • Depuis un tableau d’octets en passant un paramètre de tableau d’octets InsertImage

Pour chacune des méthodes InsertImage, il existe d’autres surcharges qui vous permettent d’insérer une image avec les options suivantes:

  • En ligne ou flottant à une position spécifique, par exemple, InsertImage
  • Échelle de pourcentage ou taille personnalisée, par exemple, InsertImage ; de plus, la méthode InsertImage renvoie un objet Shape qui vient d’être créé et inséré afin que vous puissiez modifier davantage les propriétés de la forme

Comment insérer une image {#insert-an-inline-image} en ligne

Transmettez une seule chaîne représentant un fichier contenant l’image à InsertImage pour insérer l’image dans le document en tant que graphique en ligne

L’exemple de code suivant montre comment insérer une image en ligne à la position du curseur dans un document:

Comment insérer une image flottante

L’exemple de code suivant montre comment insérer une image flottante à partir d’un fichier ou d’un URL à une position et une taille spécifiées:

Comment extraire des images d’un document

Toutes les images sont stockées dans les nœuds Shape dans un Document. Pour extraire toutes les images ou images d’un type spécifique du document, procédez comme suit:

  • Utilisez la méthode GetChildNodes pour sélectionner tous les nœuds Shape.
  • Parcourez les collections de nœuds résultantes.
  • Vérifiez la propriété booléenne HasImage.
  • Extrayez les données d’image à l’aide de la propriété ImageData.
  • Enregistrez les données d’image dans un fichier.

L’exemple de code suivant montre comment extraire des images d’un document et les enregistrer sous forme de fichiers:

Comment insérer un code-barres sur chaque page de document

Cet exemple vous montre comment ajouter des codes-barres identiques ou différents sur toutes les pages ou des pages spécifiques d’un document Word. Il n’existe pas de moyen direct d’ajouter des codes-barres sur toutes les pages d’un document, mais vous pouvez utiliser les méthodes MoveToSection, MoveToHeaderFooter et InsertImage pour vous déplacer vers n’importe quelle section ou en-têtes/pieds de page et insérer les images de codes-barres comme vous pouvez le voir dans le code suivant.

L’exemple de code suivant montre comment insérer une image de code-barres sur chaque page d’un document:

Verrouiller le rapport hauteur/largeur de l’image

Le rapport hauteur/largeur d’une forme géométrique est le rapport de ses tailles dans différentes dimensions. Vous pouvez verrouiller le rapport hauteur/largeur de l’image à l’aide de AspectRatioLocked. La valeur par défaut du rapport hauteur/largeur de la forme dépend du ShapeType. Il s’agit de true pour ShapeType.Image et false pour les autres types de formes.

L’exemple de code suivant montre comment utiliser les proportions:

Comment obtenir les limites réelles de la forme en points

Si vous souhaitez que le cadre de délimitation réel de la forme soit rendu sur la page, vous pouvez y parvenir en utilisant la propriété BoundsInPoints.

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

Recadrer les images

Le recadrage d’une image fait généralement référence à la suppression des parties extérieures indésirables d’une image pour aider à améliorer le cadrage. Il est également utilisé pour supprimer certaines parties d’une image afin d’augmenter la mise au point sur une zone particulière.

L’exemple de code suivant montre comment y parvenir à l’aide de Aspose.Words API:

Enregistrer les images au format WMF

Aspose.Words fournit des fonctionnalités pour enregistrer toutes les images disponibles dans un document au format WMF lors de la conversion de DOCX en RTF.

L’exemple de code suivant montre comment enregistrer des images au format WMF avec les options d’enregistrement RTF:

Comment ajouter une forme Group dans un document Word Travailler avec des graphiques dans C#