Funktionen und Fähigkeiten

Aspose.Slides FOSS for .NET bietet ein breites Spektrum an Funktionen zum programmgesteuerten Arbeiten mit PowerPoint .pptx-Dateien. Diese Seite listet alle unterstützten Funktionsbereiche mit repräsentativen Codebeispielen auf.

Präsentation I/O

Öffnen Sie eine vorhandene .pptx‑Datei oder erstellen Sie eine neue und speichern Sie sie anschließend im PPTX‑Format.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

// Open an existing presentation
using (var prs = new Presentation("input.pptx"))
{
    Console.WriteLine($"Slide count: {prs.Slides.Count}");
    prs.Save("output.pptx", SaveFormat.Pptx);
}

// Create a new presentation (starts with one blank slide)
using (var prs = new Presentation())
{
    prs.Save("new.pptx", SaveFormat.Pptx);
}

Hinweis: PPTX ist das einzige unterstützte Speicherformat. Der Export nach PDF, HTML, SVG oder Bildern ist nicht verfügbar.

Unbekannte XML‑Teile in der Quelldatei werden beim Speichern unverändert beibehalten, sodass das Öffnen und erneute Speichern eines .pptx niemals Inhalte entfernt werden, die die Bibliothek noch nicht versteht.

Folienverwaltung

Folien hinzufügen, entfernen, klonen und neu anordnen.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
// Access the first slide
var slide = prs.Slides[0];

// Add an additional blank slide at the end
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);

Console.WriteLine($"Total slides: {prs.Slides.Count}");
prs.Save("multi-slide.pptx", SaveFormat.Pptx);

Formen

Fügen Sie AutoShapes, PictureFrames, Tabellen und Verbinder zu einer Folie hinzu.

AutoShapes

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
// Add a rectangle at (x=50, y=50) with width=300, height=100
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 300, 100);
shape.AddTextFrame("Aspose.Slides FOSS");
prs.Save("shapes.pptx", SaveFormat.Pptx);

Tabellen

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
// Column widths and row heights in points
double[] colWidths = { 120.0, 120.0, 120.0 };
double[] rowHeights = { 40.0, 40.0, 40.0 };
var table = slide.Shapes.AddTable(50, 50, colWidths, rowHeights);
table.Rows[0][0].TextFrame.Text = "Product";
table.Rows[0][1].TextFrame.Text = "Quantity";
table.Rows[0][2].TextFrame.Text = "Price";
prs.Save("table.pptx", SaveFormat.Pptx);

Connectoren

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
var box1 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 100, 150, 60);
var box2 = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 350, 100, 150, 60);
var conn = slide.Shapes.AddConnector(ShapeType.BentConnector3, 0, 0, 10, 10);
conn.StartShapeConnectedTo = box1;
conn.StartShapeConnectionSiteIndex = 3;  // right side
conn.EndShapeConnectedTo = box2;
conn.EndShapeConnectionSiteIndex = 1;    // left side
prs.Save("connector.pptx", SaveFormat.Pptx);

Textformatierung

Formatieren Sie Text auf Absatz‑ und Zeichenebene mit PortionFormat.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 500, 150);
var tf = shape.AddTextFrame("Bold blue heading");

var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 28;
fmt.FontBold = NullableBool.True;
fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 0, 70, 127);

prs.Save("text.pptx", SaveFormat.Pptx);

NullableBool.True setzt die Eigenschaft explizit; NullableBool.NotDefined erbt vom Folienmaster.

Fülltypen

Wenden Sie einfarbige, Farbverlauf-, Muster- oder Bildfüllungen auf Formen an.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 300, 150);

// Solid fill
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 30, 120, 200);

prs.Save("fill.pptx", SaveFormat.Pptx);

Visuelle Effekte

Wenden Sie äußeren Schatten, Leuchten, weiche Kante, Unschärfe, Spiegelung und inneren Schatten auf Formen an.

Die Effekt‑Eigenschaften sind über shape.EffectFormat zugänglich. Rufen Sie EnableOuterShadowEffect(), EnableGlowEffect(), EnableSoftEdgeEffect(), SetBlurEffect(), EnableReflectionEffect() oder EnableInnerShadowEffect() auf, um jede einzeln zu konfigurieren.

3D Formatierung

Wenden Sie 3D‑Fase, Kamera, Lichtanlage, Material und Extrusionstiefe über shape.ThreeDFormat an. Dies steuert die visuelle Tiefe und das Beleuchtungsmodell für die Formdarstellung in PPTX‑Betrachtern, die 3D‑Effekte unterstützen.

Sprecher-Notizen

Fügen Sie Notizen zu einer beliebigen Folie hinzu, indem Sie NotesSlideManager verwenden.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var notes = prs.Slides[0].NotesSlideManager.AddNotesSlide();
notes.NotesTextFrame.Text = "Key talking point: emphasize the ROI benefit.";
prs.Save("notes.pptx", SaveFormat.Pptx);

Kommentare

Fügen Sie verschachtelte Kommentare mit Autoreninformationen und Folienposition hinzu.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var author = prs.CommentAuthors.AddAuthor("Jane Smith", "JS");
var slide = prs.Slides[0];
author.Comments.AddComment(
    "Please verify this data before the presentation.",
    slide,
    new PointF(2.0f, 2.0f),
    DateTime.Now
);
prs.Save("comments.pptx", SaveFormat.Pptx);

Eingebettete Bilder

Betten Sie ein Bild aus einer Datei in die Präsentation ein und fügen Sie es einer Folie als PictureFrame hinzu.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var imageData = File.ReadAllBytes("logo.png");
var image = prs.Images.AddImage(imageData);
var slide = prs.Slides[0];
slide.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 50, 200, 150, image);
prs.Save("with-image.pptx", SaveFormat.Pptx);

Dokumenteigenschaften

Kern-, App- und benutzerdefinierte Dokumenteigenschaften lesen und schreiben.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var props = prs.DocumentProperties;

// Core properties
props.Title = "Q1 Results";
props.Author = "Finance Team";
props.Subject = "Quarterly Review";
props.Keywords = "Q1, finance, results";

// Custom property
props.SetCustomPropertyValue("ReviewedBy", "Legal Team");

prs.Save("deck.pptx", SaveFormat.Pptx);

Bekannte Einschränkungen

Die folgenden Bereiche lösen NotImplementedException aus und sind in dieser Ausgabe nicht verfügbar:

Bereich	Status
Diagramme	Nicht implementiert
SmartArt	Nicht implementiert
Animationen und Übergänge	Nicht implementiert
PDF / HTML / SVG / Bildexport	Nicht implementiert (nur PPTX)
VBA-Makros	Nicht implementiert
Digitale Signaturen	Nicht implementiert
Hyperlinks und Aktions‑Einstellungen	Nicht implementiert
OLE-Objekte	Nicht implementiert
Mathematischer Text	Nicht implementiert

Siehe auch

Erste Schritte: Installation und erstes Programm
API-Referenz: Klassen- und Methodenreferenz
Anleitungen: Aufgabenorientierte Artikel