Gerenciar Comentários de Apresentação no Android

Visão geral

Este artigo explica como gerenciar comentários de apresentação no Aspose.Slides. Ele mostra os principais tipos relacionados a comentários e demonstra como adicionar comentários aos slides, acessar comentários existentes, trabalhar com respostas, usar comentários modernos e remover comentários de uma apresentação.

Os exemplos se concentram em cenários comuns de revisão e colaboração no PowerPoint, como atribuir comentários a autores, ler o conteúdo e os metadados dos comentários, construir cadeias de respostas e limpar todos os comentários ou excluir os selecionados.

No PowerPoint, um comentário aparece como uma nota ou anotação em um slide. Quando um comentário é clicado, seu conteúdo ou mensagens são revelados.

Por que adicionar comentários às apresentações?

Você pode querer usar comentários para fornecer feedback ou se comunicar com seus colegas ao revisar apresentações.

Para permitir que você use comentários em apresentações do PowerPoint, o Aspose.Slides for Android via Java fornece

A classe Presentation que contém as coleções de autores (da interface ICommentAuthorCollection). Os autores adicionam comentários aos slides.
A interface ICommentCollection que contém a coleção de comentários para autores individuais.
A classe IComment que contém informações sobre os autores e seus comentários: quem adicionou o comentário, a hora em que o comentário foi adicionado, a posição do comentário, etc.
A classe CommentAuthor que contém informações sobre autores individuais: o nome do autor, suas iniciais, comentários associados ao nome do autor, etc.

Adicionar um comentário ao slide

Este código Java mostra como adicionar um comentário a um slide em uma apresentação do PowerPoint:

// Instancia a classe Presentation
Presentation pres = new Presentation();
try {
    // Adiciona um slide vazio
    pres.getSlides().addEmptySlide(pres.getLayoutSlides().get_Item(0));

    // Adiciona um autor
    ICommentAuthor author = pres.getCommentAuthors().addAuthor("Jawad", "MF");

    // Define a posição dos comentários
    Point2D.Float point = new Point2D.Float(0.2f, 0.2f);

    // Adiciona comentário de slide para um autor no slide 1
    author.getComments().addComment("Hello Jawad, this is slide comment", pres.getSlides().get_Item(0), point, new Date());

    // Adiciona comentário de slide para um autor no slide 2
    author.getComments().addComment("Hello Jawad, this is second slide comment", pres.getSlides().get_Item(1), point, new Date());

    // Acessa ISlide 1
    ISlide slide = pres.getSlides().get_Item(0);

    // Quando null é passado como argumento, comentários de todos os autores são trazidos para o slide selecionado
    IComment[] Comments = slide.getSlideComments(author);

    // Acessa o comentário no índice 0 para o slide 1
    String str = Comments[0].getText();

    pres.save("Comments_out.pptx", SaveFormat.Pptx);

    if (Comments.length > 0)
    {
        // Seleciona a coleção de comentários do autor no índice 0
        ICommentCollection commentCollection = Comments[0].getAuthor().getComments();
        String Comment = commentCollection.get_Item(0).getText();
    }
} finally {
    if (pres != null) pres.dispose();
}

Acessar comentários do slide

Este código Java mostra como acessar um comentário existente em um slide em uma apresentação do PowerPoint:

// Instancia a classe Presentation
Presentation pres = new Presentation("Comments1.pptx");
try {
    for (ICommentAuthor commentAuthor : pres.getCommentAuthors())
    {
        CommentAuthor author = (CommentAuthor) commentAuthor;
        for (IComment comment1 : author.getComments())
        {
            Comment comment = (Comment) comment1;
            System.out.println("ISlide :" + comment.getSlide().getSlideNumber() + " has comment: " + comment.getText() +
                    " with Author: " + comment.getAuthor().getName() + " posted on time :" + comment.getCreatedTime() + "\n");
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

Responder Comentários

Um comentário pai é o comentário superior ou original em uma hierarquia de comentários ou respostas. Usando os métodos getParentComment ou setParentComment (da interface IComment), você pode definir ou obter um comentário pai.

Este código Java mostra como adicionar comentários e obter respostas a eles:

Presentation pres = new Presentation();
try {
    // Adiciona um comentário
    ICommentAuthor author1 = pres.getCommentAuthors().addAuthor("Author_1", "A.A.");
    IComment comment1 = author1.getComments().addComment("comment1", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());

    // Adiciona uma resposta ao comment1
    ICommentAuthor author2 = pres.getCommentAuthors().addAuthor("Autror_2", "B.B.");
    IComment reply1 = author2.getComments().addComment("reply 1 for comment 1", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());
    reply1.setParentComment(comment1);

    // Adiciona outra resposta ao comment1
    IComment reply2 = author2.getComments().addComment("reply 2 for comment 1", pres.getSlides().get_Item(0),  new Point2D.Float(10, 10), new Date());
    reply2.setParentComment(comment1);

    // Adiciona uma resposta a uma resposta existente
    IComment subReply = author1.getComments().addComment("subreply 3 for reply 2", pres.getSlides().get_Item(0),  new Point2D.Float(10, 10), new Date());
    subReply.setParentComment(reply2);

    IComment comment2 = author2.getComments().addComment("comment 2", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());
    IComment comment3 = author2.getComments().addComment("comment 3", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());

    IComment reply3 = author1.getComments().addComment("reply 4 for comment 3", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());
    reply3.setParentComment(comment3);

    // Exibe a hierarquia de comentários no console
    ISlide slide = pres.getSlides().get_Item(0);
    IComment[] comments = slide.getSlideComments(null);
    for (int i = 0; i < comments.length; i++)
    {
        IComment comment = comments[i];
        while (comment.getParentComment() != null)
        {
            System.out.print("\t");
            comment = comment.getParentComment();
        }

        System.out.println(comments[i].getAuthor().getName() +  " : " + comments[i].getText());
        System.out.println();
    }
    pres.save("parent_comment.pptx",SaveFormat.Pptx);

    // Remove o comment1 e todas as respostas a ele
    comment1.remove();

    pres.save("remove_comment.pptx",SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Attention

Quando o método Remove (da interface IComment) é usado para excluir um comentário, as respostas ao comentário também são excluídas.
Se a configuração setParentComment resultar em uma referência circular, será lançada a exceção PptxEditException.

Adicionar um comentário moderno

Em 2021, a Microsoft introduziu modern comments no PowerPoint. O recurso de comentários modernos melhora significativamente a colaboração no PowerPoint. Por meio dos comentários modernos, os usuários do PowerPoint podem resolver comentários, ancorar comentários a objetos e textos e interagir de forma muito mais fácil do que antes.

Aspose.Slides oferece suporte a comentários modernos por meio da classe ModernComment. Os métodos addModernComment e insertModernComment foram adicionados à classe CommentCollection.

Este código Java mostra como adicionar um comentário moderno a um slide em uma apresentação do PowerPoint:

Presentation pres = new Presentation();
try {
    ICommentAuthor newAuthor = pres.getCommentAuthors().addAuthor("Some Author", "SA");
    IModernComment modernComment = newAuthor.getComments().addModernComment("This is a modern comment", pres.getSlides().get_Item(0), null, new Point2D.Float(100, 100), new Date());

    pres.save("pres.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Remover um comentário

Excluir todos os comentários e autores

Este código Java mostra como remover todos os comentários e autores de uma apresentação:

Presentation presentation = new Presentation("example.pptx");
try {
    // Exclui todos os comentários da apresentação
    for (ICommentAuthor author : presentation.getCommentAuthors())
    {
        author.getComments().clear();
    }

    // Exclui todos os autores
    presentation.getCommentAuthors().clear();

    presentation.save("example_out.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

Excluir comentários específicos

Este código Java mostra como excluir comentários específicos em um slide:

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // adicionar comentários...
    ICommentAuthor author = presentation.getCommentAuthors().addAuthor("Author", "A");
    author.getComments().addComment("comment 1", slide, new Point2D.Float(0.2f, 0.2f), new Date());
    author.getComments().addComment("comment 2", slide, new Point2D.Float(0.3f, 0.2f), new Date());

    // remover todos os comentários que contêm o texto "comment 1"
    for (ICommentAuthor commentAuthor : presentation.getCommentAuthors())
    {
        ArrayList<IComment> toRemove = new ArrayList<IComment>();
        for (IComment comment : slide.getSlideComments(commentAuthor))
        {
            if (comment.getText().equals("comment 1"))
            {
                toRemove.add(comment);
            }
        }

        for (IComment comment : toRemove)
        {
            commentAuthor.getComments().remove(comment);
        }
    }

    presentation.save("pres.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

FAQ

O Aspose.Slides oferece suporte a um status como ‘resolvido’ para comentários modernos?

Sim. Os Modern comments expõem o método setStatus; você pode definir o estado do comentário (por exemplo, marcá-lo como resolvido), e esse estado é salvo no arquivo e reconhecido pelo PowerPoint.

Discussões em thread (cadeias de respostas) são suportadas e há um limite de aninhamento?

Sim. Cada comentário pode referenciar seu parent comment, permitindo cadeias de respostas arbitrárias. A API não declara um limite específico de profundidade de aninhamento.

Em qual sistema de coordenadas a posição do marcador de comentário é definida em um slide?

A posição é armazenada como um ponto de ponto flutuante no sistema de coordenadas do slide. Isso permite posicionar o marcador de comentário exatamente onde você precisar.

Recuperar e Atualizar Propriedades de Visualização da Apresentação no Android Gerenciar notas de apresentação no Android