How to Add Image to DOCX in C

Jakie formaty obrazów są obsługiwane?

Obsługiwane formaty plików: .jpg, .png, .bmp, .tiff oraz .gif. Każdy format utrzymuje swoją jakość po wstawieniu. JPEG najlepiej sprawdza się dla fotografii. PNG obsługuje przezroczystość dla logo i grafik. BMP zapewnia jakość bez kompresji. TIFF nadaje się do dokumentów drukowanych wysokiej jakości. GIF pozwala na proste animacje (tylko pierwsza klatka jest wyświetlana w statycznych dokumentach).

Gdzie umieszcza się obraz w dokumencie?

Obrazy są domyślnie dodawane w aktualnej pozycji kursora, bez żadnego węzła nadrzędnego. Dla precyzyjnego pozycjonowania, wstaw obrazy jako elementy podrzędne w akapitach. To zapewnia lepszą kontrolę nad przepływem tekstu i integruje obrazy ze strukturą dokumentu.

Dlaczego używać klasy ImageContent?

Klasa ImageContent zarządza właściwościami obrazów w uporządkowany sposób. Zmodyfikuj wymiary, pozycjonowanie i formatowanie przed wstawieniem. To podejście zapewnia spójność w procesie generowania dokumentów i stosuje standardowe zasady formatowania w całej aplikacji. Klasa kapsułkuje wszystkie właściwości związane z obrazem, co sprawia, że kod jest łatwiejszy do utrzymania i redukuje błędy formatowania.

Kiedy używać metody Stream?

Użyj metody Stream, gdy:

• Obrazy są chronione za zabezpieczonymi API wymagającymi uwierzytelnienia
• Przetwarzanie obrazów dynamicznie z pamięci
• Praca z obrazami przechowywanymi jako dane binarne w bazach danych

Ta metoda dobrze działa w aplikacjach Enterprise, gdzie obrazy są przechowywane w systemach zarządzania dokumentami, pamięci w chmurze lub generowane przez usługi przetwarzania obrazów.

Jakie są korzyści z ładowania przez Stream?

Ładowanie przez Stream integruje obrazy z uwierzytelnionych punktów końcowych bez zapisywania tymczasowych plików. Poprawia to bezpieczeństwo i wydajność. Zalety obejmują:

• Zmniejszona liczba operacji we/wy na dysku
• Brak przechowywania w pamięci cache na dysku wizerunków
• Workflow przetwarzania obrazu w czasie rzeczywistym
• Lepsze zarządzanie pamięcią dla dużych obrazów
• Elastyczne opcje źródła obrazów

Jak można dostosować szerokość i wysokość?

Zaimplementuj niestandardowe szerokość i wysokość, zmieniając proporcje. Kontroluj, jak obrazy pojawiają się w dokumentach, czy to zachowując proporcje, czy dopasowując się do określonych ograniczeń układu.

: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")

Co dzieje się z proporcjami?

Niestandardowe wartości szerokości i wysokości nadpisują oryginalne proporcje. Rozciągaj lub kompresuj obrazy, aby dopasować się do wymagań układu, takich jak nagłówki, paski boczne lub elementy o stałej wielkości. Skrajne zniekształcenia mogą wyglądać nieprofesjonalnie. Aby zachować proporcje podczas zmiany rozmiaru, oblicz wymiary proporcjonalne w oparciu o docelowy rozmiar.

Jakie właściwości ustawić najpierw?

Ustaw właściwości w tej kolejności:

1. Wymiary (szerokość/wysokość) - fundament układu obrazu
2. Pozycjonowanie (właściwości Odległości) - kontrola nad odstępami i marginesami
3. Zaawansowane właściwości (skala/przesunięcie) - dostrojenie

To podejście zapewnia, że każda właściwość opiera się logicznie na poprzednich. Niektóre właściwości współdziałają - zawijanie tekstu wpływa na działanie właściwości odległości.