Hinzufügen von Bildern zu DOCX in C

Welche Bildformate werden unterstützt?

Unterstützte Dateiformate: .jpg, .png, .bmp, .tiff, und .gif. Jedes Format behält beim Einfügen seine Qualität bei. JPEG eignet sich am besten für Fotos. PNG unterstützt Transparenz für Logos und Grafiken. BMP liefert unkomprimierte Qualität. TIFF eignet sich für hochwertige Druckdokumente. GIF ermöglicht einfache Animationen (in statischen Dokumenten wird nur das erste Bild angezeigt).

Wo wird das Bild im Dokument platziert?

Bilder werden standardmäßig an der aktuellen Cursorposition eingefügt, ohne übergeordneten Knoten. Für eine präzise Stelleierung sollten Sie Bilder als untergeordnete Elemente in Absätze einfügen. Dies ermöglicht eine bessere Kontrolle über den Textfluss und integriert die Bilder in die Struktur Ihres Dokuments.

Warum die ImageContent-Klasse verwenden?

Die Klasse ImageContent verwaltet Bildeigenschaften auf strukturierte Weise. Ändern Sie Abmessungen, Stelleierung und Formatierung vor dem Einfügen. Dieser Ansatz gewährleistet Konsistenz im gesamten Prozess der Dokumentenerstellung und wendet Standardformatierungsregeln in Ihrer gesamten Anwendung an. Die Klasse kapselt alle bildbezogenen Eigenschaften, wodurch der Code leichter zu pflegen ist und Formatierungsfehler reduziert werden.

Wann sollte ich die Stream-Methode verwenden?

Verwenden Sie die Methode Stream, wenn:

• Die Bilder befinden sich hinter sicheren APIs, die eine Authentifizierung erfordern
• Dynamische Verarbeitung von Bildern aus dem Speicher
• Arbeiten mit Bildern, die als Binärdaten in Datenbanken gespeichert sind

Diese Methode eignet sich gut für Unternehmensanwendungen, bei denen Bilder in Dokumentenmanagementsystemen oder in der Cloud gespeichert oder von Bildverarbeitungsdiensten generiert werden.

Was sind die Vorteile von Stream Loading?

Stream Loading integriert Bilder von authentifizierten Endpunkten, ohne temporäre Dateien zu speichern. Dadurch werden Sicherheit und Leistung verbessert. Vorteile umfassen:

• Reduzierte Festplatten-E/A-Vorgänge
• Keine sensible Bildzwischenspeicherung auf der Festplatte
• Bildverarbeitungs-Workflows in Echtzeit
• Bessere Speicherverwaltung für große Bilder
• Flexible Bildquellenoptionen

Wie kann ich Breite und Höhe anpassen?

Implementieren Sie benutzerdefinierte Breite und Höhe durch Ändern des Seitenverhältnisses. Kontrollieren Sie, wie die Bilder in den Dokumenten erscheinen, ob sie die Proportionen einhalten oder in bestimmte Layoutvorgaben passen.

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

using IronWord;

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

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

// modifying the aspect ratio by introducing custom width
image.Width = 800;
image.Height = 200;

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

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

Imports IronWord

' initializing docx file
Dim doc As New IronWord.WordDocument()

' instantiating image file
Dim image As New IronWord.Models.ImageContent("sample-image.tiff")

' modifying the aspect ratio by introducing custom width
image.Width = 800
image.Height = 200

' AddImage function saving the image
doc.AddImage(image)

' Save and export the file
doc.SaveAs("custom-size-image.docx")

Was passiert mit dem Seitenverhältnis?

Benutzerdefinierte Werte für Breite und Höhe setzen das ursprüngliche Seitenverhältnis außer Kraft. Bilder strecken oder komprimieren, um sie an Layout-Anforderungen wie Kopfzeilen, Seitenleisten oder Container mit fester Größe anzupassen. Extreme Verzerrungen können unprofessionell wirken. Um das Seitenverhältnis bei der Größenänderung beizubehalten, berechnen Sie die proportionalen Abmessungen auf der Grundlage Ihrer Zielgröße.

Welche Eigenschaften sollte ich zuerst einstellen?

Legen Sie die Eigenschaften in dieser Reihenfolge fest:

1. Abmessungen (Breite/Höhe) - Grundlage für das Bildlayout
2. Stelleierung (DistanceFrom-Eigenschaften) - Steuerung von Abständen und Rändern
3. Erweiterte Eigenschaften (Skalieren/Übersetzen) - Feinabstimmung

Dieser Ansatz stellt sicher, dass jede Eigenschaft logisch auf der vorherigen aufbaut. Einige Eigenschaften interagieren - der Textumbruch beeinflusst die Funktionsweise von Abstandseigenschaften.