Aspose.Slides FOSS
.NET
Guia de Desenvolvedores
Características e capacidades

Características e capacidades

Características e capacidades

Aspose.Slides FOSS for .NET provides a broad set of capabilities for working with PowerPoint .pptx Esta página lista todas as áreas de recursos suportadas com exemplos de código representativos.

Apresentação de I/O

Abrir um sistema existente . .pptx arquivo ou criar um novo, em seguida, salvar de volta para o 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: O formato de armazenamento é o único suportado nesta edição do FOSS. A chamada de salva serializa a gráfica completa da apresentação para o contêiner OOXML.

Partes XML desconhecidas no arquivo de origem são preservadas literalmente em salvar, então abrir e re-salvar um .pptx Nunca vai tirar conteúdo que a biblioteca ainda não entende.

Gestão de diapositivas

Utilização: prs.Slides para adicionar diapositivas vazias com: AddEmptySlide(), remova os já existentes ou verifique a contagem total de slides:

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

Formas de papel

Adicionar AutoShapes, PictureFrames e Connectors a um slide.

AutoShapes

Chama-me . slide.Shapes.AddAutoShape() com um ShapeType, posição, e tamanho, então ligue para o telefone. AddTextFrame() para definir o conteúdo do texto:

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

Tabelas de dados

Utilização: slide.Shapes.AddTable() com largura de coluna e altura das linhas para criar uma grade, em seguida acessar células via table.Rows[row][col]:

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

Conectores

Chama-me . slide.Shapes.AddConnector() e definido StartShapeConnectedTo e a) EndShapeConnectedTo Para cablar duas formas com uma linha de ligação:

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

Formato de texto

Acessos PortionFormat em cada um dos seguintes: TextPortion para definir a altura da fonte, negrito, itálico e cor de preenchimento no nível do caractere:

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 define explicitamente a propriedade; NullableBool.NotDefined herda do mestre de slides.

Tipos de preenchimento

Set (s) shape.FillFormat.FillType a) para o FillType.Solid e configurar a cor de preenchimento via SolidFillColor.Color Utilizando um valor ARGB:

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

Efeitos visuais

Aplique sombra externa, brilho, borda macia, desfoque, reflexão e sombra interna às formas.

As propriedades do efeito são acessíveis através de: shape.EffectFormat.- Ligue. EnableOuterShadowEffect(), EnableGlowEffect(), EnableSoftEdgeEffect(), SetBlurEffect(), EnableReflectionEffect(), ou EnableInnerShadowEffect() para configurar cada um de forma independente.

3D Formatting

Aplicar 3D bevel, câmera, equipamento de iluminação, material e profundidade extrusão via shape.ThreeDFormat.Este controla a profundidade visual e o modelo de iluminação para a reprodução de formas em visualizadores PPTX que suportam efeitos 3D.

Notas do orador

Acessos NotesSlideManager em qualquer diapositiva e chamada AddNotesSlide() para criar uma página de notas, em seguida, definir o texto das notas diretamente:

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

Comentários

Criar um autor de comentários com: prs.CommentAuthors.AddAuthor(),Então , liga-me . author.Comments.AddComment() com as coordenadas de deslizamento e posição:

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

Imagens incorporadas

Incorporar uma imagem de um arquivo na apresentação e adicioná-lo a um slide como um 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);

Propriedades do documento

Acessos prs.DocumentProperties para ler ou escrever propriedades padrão, tais como título, autor e assunto, mais pares de valores personalizados:

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

Limitações conhecidas

As seguintes áreas não são implementadas na edição FOSS:

Área de exploraçãoEstatuto da União Europeia
GráficosNão aplicada
SmartArtNão aplicada
Animações e transiçõesNão aplicada
Exportação de PDF / HTML / SVG / imagemNão implementado (apenas PPTX)
Macros VBANão aplicada
Assinaturas digitaisNão aplicada
Hiperligações e configurações de açãoNão aplicada
Objetos OLENão aplicada
Texto matemáticoNão aplicada

Ver também:

 Português