Funzionalità e capacità

Aspose.Slides FOSS for .NET provides a broad set of capabilities for working with PowerPoint .pptx file programmaticamente. Questa pagina elenca tutte le aree funzionali supportate con esempi di codice rappresentativi.

I/O della presentazione

Apri un file esistente .pptx o creane uno nuovo, quindi salva nuovamente in formato PPTX.

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);
}

Nota: PPTX è l’unico formato di salvataggio supportato. L’esportazione in PDF, HTML, SVG o immagini non è disponibile.

Le parti XML sconosciute nel file di origine vengono preservate alla lettera al salvataggio, quindi aprire e risalvare un .pptx non rimuoverà mai contenuti che la libreria non comprende ancora.

Gestione delle diapositive

Aggiungi, rimuovi, clona e riordina le diapositive.

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);

Forme

Aggiungi AutoShapes, PictureFrames, Tabelle e Connettori a una diapositiva.

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);

Tabelle

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);

Connettori

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);

Formattazione del testo

Formattta il testo a livello di paragrafo e di carattere usando 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 imposta la proprietà esplicitamente; NullableBool.NotDefined eredita dal master della diapositiva.

Tipi di riempimento

Applica riempimenti solidi, sfumati, a motivo o immagine alle forme.

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);

Effetti visivi

Applica ombra esterna, bagliore, bordo morbido, sfocatura, riflessione e ombra interna alle forme.

Le proprietà dell’effetto sono accessibili tramite shape.EffectFormat. Chiama EnableOuterShadowEffect(), EnableGlowEffect(), EnableSoftEdgeEffect(), SetBlurEffect(), EnableReflectionEffect(), o EnableInnerShadowEffect() per configurare ciascuna in modo indipendente.

3D Formatting

Applica smusso 3D, telecamera, impianto di luce, materiale e profondità di estrusione tramite shape.ThreeDFormat. Questo controlla la profondità visiva e il modello di illuminazione per il rendering delle forme nei visualizzatori PPTX che supportano gli effetti 3D.

Note del relatore

Allega note a qualsiasi diapositiva usando NotesSlideManager.

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);

Commenti

Aggiungi commenti in thread con informazioni sull’autore e posizione della diapositiva.

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);

Immagini incorporate

Incorpora un’immagine da un file nella presentazione e aggiungila a una diapositiva come PictureFrame.

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);

Proprietà del documento

Leggi e scrivi le proprietà core, app e personalizzate del documento.

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);

Limitazioni note

Le seguenti aree generano NotImplementedException e non sono disponibili in questa edizione:

Area	Stato
Grafici	Non implementato
SmartArt	Non implementato
Animazioni e transizioni	Non implementato
Esportazione PDF / HTML / SVG / immagine	Non implementato (solo PPTX)
Macro VBA	Non implementato
Firme digitali	Non implementato
Collegamenti ipertestuali e impostazioni di azione	Non implementato
Oggetti OLE	Non implementato
Testo matematico	Non implementato

Vedi anche

Iniziare: Installazione e primo programma
Riferimento API: Riferimento a classi e metodi
Guide pratiche: Articoli orientati ai compiti