Wie man Bilder in PowerPoint verwaltet

Bild hinzufügen

Um mit IronPPT ein Bild in ein PowerPoint-Dokument einzufügen, erstellen Sie ein neues Dokumentobjekt (oder laden Sie es aus einer vorhandenen Datei). Erstellen Sie anschließend ein Bildobjekt aus der Klasse Image, das auf eine Datei verweist. Sobald das Bild geladen ist, fügen Sie es dem Dokument hinzu und geben Sie die Foliennummer an, auf der es erscheinen soll. Von dort aus können Bildattribute mithilfe von Eigenschaften wie Height, Width und Angle geändert werden. Abschließend exportieren Sie das Dokument mit dem neu hinzugefügten Bild.

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

using IronPPT;
using IronPPT.Models;

// Create a new presentation document
var document = new PresentationDocument();

// Create and load an image from file
Image image = new Image();
image.LoadFromFile("image.jpg");

// Add image to the first slide (index 0)
var newImage = document.AddImage(image, 0);

// Rotate the image 180 degrees
newImage.Angle = 180;

// Save the presentation as a PPTX file
document.Save("adding-image.pptx");

Bildeigenschaften

Erkunden Sie die Optionen für die Bildeigenschaften in der Tabelle unten.

Ändern von hinzugefügten Bildeigenschaften

Nachdem Sie ein Bild zu einer Folie hinzugefügt haben, können Sie seine Eigenschaften ändern, um Aussehen und Positionierung anzupassen. Zum Beispiel durch die Verwendung von Eigenschaften wie Height, Width und Angle, um die Bildabmessungen und die Drehung anzupassen. Mit diesen Einstellungen können Sie das Erscheinungsbild des Bildes in Ihrer Präsentation feinabstimmen.

:path=/static-assets/ppt/content-code-examples/how-to/manage-image-add-image-modify-properties.cs

using IronPPT;
using IronPPT.Models;
using IronPPT.Enums;

// Load an existing presentation document
var document = new PresentationDocument("existing-presentation.pptx");

// Create and load an image from file
Image image = new Image();
image.LoadFromFile("image.jpg");

// Add image to the second slide (index 1)
var newImage = document.AddImage(image, 1);

// Modify image properties
newImage.Angle = 45; // Rotate the image 45 degrees
newImage.FrameShape = ShapeType.RoundRectangle; // Set the frame shape to Rounded Rectangle
newImage.Position = (180, 180); // Set the position to coordinates (180, 180)
newImage.Width = 300; // Set the width to 300 points
newImage.Height = 300; // Set the height to 300 points

// Save the modified presentation as a new PPTX file
document.Save("modifying-image-properties.pptx");

Bild austauschen

Das Ersetzen eines Bildes ist mit IronPPT eine intuitive Aufgabe. Laden Sie zunächst das Präsentationsdokument und Ihr neues Bild in ein neues Image-Objekt. Wählen Sie anschließend das Bild aus, das Sie aktualisieren möchten, indem Sie dessen Folie und Index auswählen, z. B. Slides[0].Images[0] (für das erste Bild auf der ersten Folie). Nach Abschluss der Arbeiten rufen Sie die Methode Replace mit dem neuen Bildobjekt auf und exportieren die Datei.

:path=/static-assets/ppt/content-code-examples/how-to/manage-image-replace-image-replace-image.cs

using IronPPT;
using IronPPT.Models;

// Load an existing presentation
var document = new PresentationDocument("sample.pptx");

// Load the replacement image
Image replaceImage = new Image();
replaceImage.LoadFromFile("sample.png");

// Replace the first image found in the first slide
document.Slides[0].Images[0].Replace(replaceImage);

// Save changes (overwriting the original file)
document.Save("sample.pptx");

Original

Ergebnis

---

Bild aus dem Index entfernen

Der einfachste Weg, ein Bild zu entfernen, ist seine Indexposition. Greifen Sie auf die Bildersammlung der Folie zu und verwenden Sie die Methode Remove mit dem nullbasierten Index des Bildes, das Sie löschen möchten. Dieser Ansatz funktioniert gut, wenn Sie die genaue Position des Bildes in der Sammlung kennen.

:path=/static-assets/ppt/content-code-examples/how-to/manage-image-remove-image-remove-by-index.cs

using IronPPT;

// Create a new presentation
var document = new PresentationDocument("real_sample.pptx");

// Remove the first image found in the first slide
document.Slides[1].Images[0].Remove();

// Save the updated presentation
document.Save("removed-image.pptx");

Vor der Bildentfernung

Nach dem Entfernen von Bildern

---

Entfernen aller Bilder

Für Szenarien, in denen alle Image Dateien in einem Dokument massenhaft gelöscht werden müssen, können wir zwei for Schleifen verwenden: eine, um alle Dokumentseiten zu durchlaufen, und eine zweite, um alle identifizierten Bilder pro Seite zu entfernen. Ein Beispiel ist unten gezeigt.

:path=/static-assets/ppt/content-code-examples/how-to/manage-image-remove-all-images.cs

using IronPPT;
using IronPPT.Models;

// Load an existing presentation
var document = new PresentationDocument("real_sample.pptx");

// Remove all images from every slide
for (int s = 0; s < document.Slides.Count; s++)       // Loop through all slides
{
    var slide = document.Slides[s];                   // Get the current slide

    for (int i = slide.Images.Count - 1; i >= 0; i--) // Loop backward through images on this slide
    {
        slide.Images[i].Remove();                     // Remove each image
    }
}

// Save the updated presentation
document.Save("removed-images.pptx");

Vor der Massenlöschung

Nach Massenlöschung

Wie Sie sehen können, wurden alle Bilder aus den Folien 2 und 4 entfernt.