Como adicionar comentários ao PowerPoint no .NET

Este guia mostra como adicionar comentários e notas do orador aos slides do PowerPoint usando Aspose.Slides FOSS para .NET. Use prs.CommentAuthors.AddAuthor() para criar um autor de comentário, em seguida, chamar author.Comments.AddComment() Para anexar comentários com thread a um slide numa posição específica. slide.NotesSlideManager.AddNotesSlide() Para adicionar notas de alto-falante visíveis na Visualização do apresentador.

Precondições

Adicione a seguinte referência de pacote ao seu projeto executando o comando dotnet CLI install:

aspose-slides-foss/slides is not yet published — build from source until it ships. See the project README for build instructions.

Adicionar um Comentário

As observações pertencem a um Autor: Objeto. Crie um autor primeiro, em seguida adicione comentários através de author.Comments:

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

using var prs = new Presentation();

// Create a comment author with name and initials
var author = prs.CommentAuthors.AddAuthor("Jane Smith", "JS");

var slide = prs.Slides[0];

// Add a comment at (2.0, 2.0) inches from the slide top-left corner
author.Comments.AddComment(
    "Please review the figures on this slide",
    slide,
    new PointF(2.0f, 2.0f),
    DateTime.Now
);

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

A Comissão PointF Coordenadas estão em: centímetros Vários chamadas para o “Slide” e a chamada de “Call to Slide”. AddComment() criar uma cadeia de comentários com o mesmo autor.

Vários autores e comentários

Criar vários autores chamando prs.CommentAuthors.AddAuthor() uma vez por autor, em seguida, postar comentários de cada autor independentemente:

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

using var prs = new Presentation();
var author1 = prs.CommentAuthors.AddAuthor("Alice Brown", "AB");
var author2 = prs.CommentAuthors.AddAuthor("Bob Davis", "BD");

var slide = prs.Slides[0];

author1.Comments.AddComment(
    "Initial draft: needs revision",
    slide, new PointF(1.0f, 1.0f), DateTime.Now
);
author2.Comments.AddComment(
    "Approved after changes",
    slide, new PointF(3.0f, 1.0f), DateTime.Now
);

prs.Save("multi-author.pptx", SaveFormat.Pptx);

Leia comentários de um arquivo existente

Carregar um ficheiro existente com: new Presentation(path) e iterar sobre prs.CommentAuthors para ler os comentários de cada autor:

using Aspose.Slides.Foss;

using var prs = new Presentation("commented.pptx");
foreach (var author in prs.CommentAuthors)
{
    Console.WriteLine($"Author: {author.Name} ({author.Initials})");
    foreach (var comment in author.Comments)
    {
        Console.WriteLine($"  Slide: {comment.Text}");
    }
}

Adicionar notas de orador a um slide

Criar um slide de notas chamando slide.NotesSlideManager.AddNotesSlide() e escrever o texto do apresentador para: notes.NotesTextFrame.Text:

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

using var prs = new Presentation();
var slide = prs.Slides[0];
slide.Shapes.AddAutoShape(
    ShapeType.Rectangle, 50, 50, 600, 300
).AddTextFrame("Main slide content");

// Create the notes slide and write text
var notes = slide.NotesSlideManager.AddNotesSlide();
notes.NotesTextFrame.Text =
    "Mention the Q3 revenue increase. Emphasize the 24% YoY growth.";

prs.Save("with-notes.pptx", SaveFormat.Pptx);

Adicionar notas a vários slides

Para adicionar notas do orador a cada slide em um lote, iterar sobre prs.Slides E chama-me. NotesSlideManager.AddNotesSlide() em cada diapositiva:

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

string[] noteTexts = {
    "Opening: introduce the agenda and set expectations.",
    "Key metrics: emphasize Q4 results and growth trajectory.",
    "Closing: summarize and call to action.",
};

using var prs = new Presentation();
var layout = prs.Slides[0].LayoutSlide;
prs.Slides.AddEmptySlide(layout);
prs.Slides.AddEmptySlide(layout);

for (int i = 0; i < prs.Slides.Count; i++)
{
    var slide = prs.Slides[i];
    slide.Shapes.AddAutoShape(
        ShapeType.Rectangle, 50, 50, 600, 300
    ).AddTextFrame($"Slide {i + 1}");

    var n = slide.NotesSlideManager.AddNotesSlide();
    n.NotesTextFrame.Text = noteTexts[i];
}

prs.Save("all-notes.pptx", SaveFormat.Pptx);

Verifique se as notas já existem

NotesSlideManager.NotesSlide Renda de rendimentos null se não tiver sido criado nenhum diapositivo de notas:

using Aspose.Slides.Foss;

using var prs = new Presentation("existing.pptx");
for (int i = 0; i < prs.Slides.Count; i++)
{
    var existing = prs.Slides[i].NotesSlideManager.NotesSlide;
    if (existing != null)
        Console.WriteLine($"Slide {i + 1}: {existing.NotesTextFrame.Text[..60]}");
    else
        Console.WriteLine($"Slide {i + 1}: no notes");
}