Comment ajouter une image dans un document Word en utilisant C#

Comment ajouter une image dans un document Word en utilisant C#

Ce tutoriel vous guidera étape par étape sur la façon d’ajouter des images à un document Word en utilisant C#. Nous allons utiliser une application en ligne de commande pour démontrer l’ajout d’une image à un document Word.

Avantages de l’ajout d’images aux documents Word

  1. Attrait visuel amélioré :
    • Les images peuvent rendre les documents plus engageants.
  2. Communication améliorée :
    • Les visuels peuvent aider à transmettre des informations complexes plus clairement.
  3. Présentation professionnelle :
    • Inclure des images peut améliorer le professionnalisme de vos documents.

Prérequis : Préparer l’environnement

  1. Avoir Visual Studio ou tout IDE .NET installé.
  2. Assurez-vous que la bibliothèque Aspose.Words est disponible via NuGet.
  3. Avoir accès à un fichier image à des fins de démonstration.

Guide étape par étape pour ajouter une image dans un document Word

Étape 1 : Ajouter une référence à System.Drawing

Assurez-vous que l’assemblage System.Drawing est référencé dans votre solution.

Étape 2 : Ajouter le package NuGet Aspose.Words

Installez la bibliothèque Aspose.Words en utilisant le gestionnaire de packages NuGet.

Install-Package Aspose.Words

Étape 3 : Inclure les directives using

Ajoutez les directives using nécessaires en haut de votre fichier.

using Aspose.Words;
using Aspose.Words.Drawing;

Étape 4 : Créer un objet Document

Chargez le fichier DOC Word dans un objet Document.

Document addImagesToWordDOC = new Document("input.doc");

Étape 5 : Créer un objet DocumentBuilder

Instanciez la classe DocumentBuilder pour faciliter l’écriture dans le document.

DocumentBuilder imageWriter = new DocumentBuilder(addImagesToWordDOC);

Étape 6 : Déplacer le curseur vers l’en-tête

Positionnez le curseur sur l’en-tête principal du document Word.

imageWriter.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);

Étape 7 : Insérer une image dans l’en-tête

Insérez une image dans l’en-tête du document Word.

Shape headerImage = imageWriter.InsertImage("C:\\Add Image in Word Header.jpg");

Étape 8 : Définir les propriétés de l’image

Ajustez la taille et la position de l’image insérée.

headerImage.Width = 1 * 72; // équivaut à un pouce
headerImage.Height = 1 * 72;

Étape 9 : Ajouter une image en tant que fichier lié

Déplacez le curseur vers le dernier paragraphe et ajoutez une image en tant que lien vers un fichier.

imageWriter.MoveTo(addImagesToWordDOC.LastSection.Body.LastParagraph);
Shape imageAsLinkToFile = imageWriter.InsertImage("C:\\Add Image as Link to File.jpg");
imageAsLinkToFile.ImageData.SourceFullName = "C:\\Add Image as Link to File.jpg";

Étape 10 : Enregistrer le document

Enfin, enregistrez le document Word modifié sur le disque.

addImagesToWordDOC.Save("C:\\Word with Embedded and Linked Images.docx");

Exemple de code pour ajouter des images dans un document Word

Voici un exemple complet qui inclut toutes les étapes mentionnées :

// Chargez le document Word DOC auquel vous souhaitez ajouter des images
Document addImagesToWordDOC = new Document("input.doc");

// Instanciez un objet de la classe DocumentBuilder pour écrire du texte, des images, des tableaux, etc.
DocumentBuilder imageWriter = new DocumentBuilder(addImagesToWordDOC);

// Déplacez le curseur vers l'en-tête principal dans le document Word
imageWriter.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);

// Insérez une image dans l'en-tête du document Word
Shape headerImage = imageWriter.InsertImage("path-to-header-image.jpeg");

// Définissez la taille de l'image dans l'en-tête
headerImage.Width = 1 * 72; // équivaut à un pouce
headerImage.Height = 1 * 72;

// Déplacez le curseur vers le dernier paragraphe dans le document Word
imageWriter.MoveTo(addImagesToWordDOC.LastSection.Body.LastParagraph);

// Ajoutez une image au document Word et liez-la à un fichier
Shape imageAsLinkToFile = imageWriter.InsertImage("path-to-image.jpeg");
imageAsLinkToFile.ImageData.SourceFullName = "path-to-image.jpeg"
// Enregistrez sous DOCX
addImagesToWordDOC.Save("images.docx");

Conclusion

Ce tutoriel vous a montré comment ajouter des images à un document Word en utilisant C#. En suivant ces étapes, vous pouvez inclure à la fois des images intégrées et des images liées, améliorant ainsi la qualité esthétique et informative de vos documents Word. Pour une exploration plus approfondie, envisagez de créer des documents Word par programmation au lieu de vous fier à des fichiers existants.

 Français