Comment ajouter une image à un DOCX en C

Comment ajouter une image à DOCX?

Référencez une image à l'aide de son chemin d'accès. Tout d'abord, instanciez la classe ImageContent avec le chemin d'accès au fichier sous la forme d'une chaîne. Utilisez la variable image dans tout le fichier pour modifier des propriétés telles que la largeur et la hauteur. Ajoutez l'image au fichier .docx à l'aide de la fonction AddImage(). Exportez et enregistrez le document localement.

L'exemple ci-dessous ajoute une image au document sans nœud parent. Les formats de fichiers pris en charge sont les suivants : .jpg, .png, .bmp, .tiff et .gif. Cette flexibilité vous permet de travailler avec n'importe quel format d'image courant.

:path=/static-assets/word/content-code-examples/how-to/add-image-insert-image.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// initializing docx file
WordDocument doc = new IronWord.WordDocument();

// instantiating image file
IronWord.Models.ImageContent image = new IronWord.Models.ImageContent("sample-image.jpg");

// modifying image properties
image.Width = 200;
image.Height = 200;

// AddImage function saving the image
doc.AddImage(image);

// Save and export the file
doc.SaveAs("inserted-image.docx");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Quels sont les formats d'image pris en charge ? Formats de fichiers pris en charge : .jpg, .png, .bmp, .tiff et .gif. Chaque format conserve sa qualité lorsqu'il est inséré. Le format JPEG est le plus adapté aux photographies. PNG prend en charge la transparence pour les logos et les graphiques. Le format BMP offre une qualité non compressée. Le format TIFF convient aux documents imprimés de haute qualité. Le format GIF permet des animations simples (seule la première image s'affiche dans les documents statiques).

Où l'image est-elle placée dans le document ? Les images sont ajoutées par défaut à la position actuelle du curseur, sans nœud parent. Pour un positionnement précis, insérez les images en tant qu'éléments enfants dans les paragraphes. Cela permet de mieux contrôler le flux de texte et d'intégrer les images dans la structure de votre document. ### Pourquoi utiliser la classe ImageContent? La classe ImageContent gère les propriétés des images de manière structurée. Modifiez les dimensions, le positionnement et le formatage avant l'insertion. Cette approche garantit la cohérence de votre processus de génération de documents et applique des règles de formatage standard à l'ensemble de votre application. La classe encapsule toutes les propriétés liées à l'image, ce qui rend le code plus facile à maintenir et réduit les erreurs de formatage. ## Comment ajouter des images via un flux de données ? Les images d'URL locales ou statiques sont faciles à ajouter à l'aide de la méthode précédente. Toutefois, les applications utilisent souvent des images provenant de bases de données, de services web ou de contenu généré dynamiquement. Utilisez la méthode `Stream` pour ajouter des images derrière des API sécurisées nécessitant une authentification. L'exemple ci-dessous montre un client HTTP qui envoie des jetons d'autorisation pour récupérer un flux d'images authentifié. Le flux s'intègre directement dans le document avant l'exportation. Cette approche permet d'éliminer le stockage temporaire des fichiers et d'améliorer la sécurité des données d'image sensibles. ```csharp :path=/static-assets/word/content-code-examples/how-to/add-image-insert-image-via-http-stream.cs ``` ### Quand dois-je utiliser la méthode Stream ? Utilisez la méthode `Stream` lorsque : - Les images sont protégées par des API sécurisées nécessitant une authentification - Traitement dynamique d'images à partir de la mémoire - Travailler avec des images stockées sous forme de données binaires dans des bases de données Cette méthode fonctionne bien dans les applications d'entreprise où les images sont stockées dans des systèmes de gestion de documents, de stockage en nuage ou générées par des services de traitement d'images.

Quels sont les avantages du chargement par flux ? Le chargement en flux intègre des images provenant de points d'extrémité authentifiés sans enregistrer de fichiers temporaires. Cela permet d'améliorer la sécurité et les performances. Les avantages comprennent : - Réduction des opérations d'E/S sur disque - Pas de mise en cache d'images sensibles sur le disque - Flux de traitement d'images en temps réel - Meilleure gestion de la mémoire pour les images de grande taille - Options de sources d'images flexibles ## Comment modifier les propriétés d'une image? IronWord propose des méthodes complètes pour personnaliser les propriétés des images. Ajustez ces propriétés avant ou après avoir ajouté l'image au document.

Paramètres	Description du projet	Exemple d'application
Largeur	Dimension horizontale de l'image en pixels	image.Largeur = 500;
Hauteur	Dimension verticale de l'image en pixels	image.Hauteur = 300;
WrapText	Comportement de l'habillage du texte autour de l'image	image.WrapText = WrapText.Square;
Distance par rapport à la gauche	Mesure de l'espacement à partir du bord gauche en pixels	image.Distance par rapport à la gauche = 10;
DistanceFromRight	Mesure de l'espacement à partir du bord droit en pixels	image.DistanceFromRight = 10;
DistanceFromTop	Mesure de l'espacement à partir du bord supérieur en pixels	image.DistanceFromTop = 15;
DistanceFromBottom	Mesure de l'espacement à partir du bord inférieur en pixels	image.DistanceFromBottom = 15;
Poste à pourvoir	Informations sur le positionnement spatial (coordonnées X et Y)	image.Poste à pourvoir = new ElementPoste à pourvoir(50, 100);
Échelle	Facteurs de dimensionnement proportionnels pour les axes X et Y	image.Échelle = new PointF(1.5f, 1.5f);
Traduire	Coordonnées de déplacement pour le repositionnement	image.Traduire = new PointF(20, 30);

Comment personnaliser la largeur et la hauteur ? Mettre en œuvre une largeur et une hauteur personnalisées en modifiant le rapport d'aspect. Contrôler la façon dont les images apparaissent dans les documents, que ce soit en respectant les proportions ou en s'adaptant à des contraintes de mise en page spécifiques. ```csharp :path=/static-assets/word/content-code-examples/how-to/add-image-custom-size.cs ```

### Qu'advient-il du rapport d'aspect? Les valeurs de largeur et de hauteur personnalisées remplacent le rapport d'aspect d'origine. Étirer ou compresser des images pour les adapter à des exigences de mise en page telles que des en-têtes, des barres latérales ou des conteneurs de taille fixe. Une déformation extrême peut donner une impression de manque de professionnalisme. Pour maintenir le rapport hauteur/largeur lors du redimensionnement, calculez les dimensions proportionnelles en fonction de la taille cible.

Quelles sont les propriétés à définir en premier ? Définissez les propriétés dans cet ordre : 1. Dimensions (largeur/hauteur) - base de la mise en page de l'image 2. Poste à pourvoirnement (propriétés DistanceFrom) - contrôle de l'espacement et des marges 3. Propriétés avancées (mise à l'échelle/traduction) - réglage fin Cette approche permet de s'assurer que chaque propriété s'appuie logiquement sur les précédentes. Certaines propriétés interagissent - l'habillage du texte affecte le fonctionnement des propriétés de distance.