Java'da Sunum Yorumlarını Yönetme

Genel Bakış

Bu makale, Aspose.Slides’te sunum yorumlarını nasıl yöneteceğinizi açıklar. Ana yorumla ilgili tipleri gösterir ve slaytlara yorum ekleme, mevcut yorumlara erişme, yanıtlarla çalışma, modern yorumları kullanma ve bir sunumdan yorumları kaldırma konularını örneklerle sunar.

Örnekler, PowerPoint’te yaygın inceleme ve iş birliği senaryolarına odaklanır; yazarlar arasında yorum atama, yorum içeriği ve meta verilerini okuma, yanıt zincirleri oluşturma ve tüm yorumları temizleme veya seçilenleri silme gibi.

PowerPoint’te bir yorum, bir slaytta not veya açıklama olarak görülür. Bir yorum tıklandığında içeriği veya mesajları ortaya çıkar.

Sunumlara Neden Yorum Eklenir?

Sunumları incelerken geri bildirim sağlamak veya ekip arkadaşlarınızla iletişim kurmak için yorumları kullanmak isteyebilirsiniz.

PowerPoint sunumlarında yorumları kullanmanıza olanak tanımak için Aspose.Slides for Java şunları sağlar:

Presentation sınıfı, yazar koleksiyonlarını ( ICommentAuthorCollection arayüzünden) içerir. Yazarlar slaytlara yorum ekler.
ICommentCollection arayüzü, bireysel yazarlar için yorum koleksiyonunu tutar.
IComment sınıfı, yazarlar ve yorumları hakkında bilgi içerir: yorumu kim eklemiş, eklenme zamanı, yorumun konumu vb.
CommentAuthor sınıfı, bireysel yazarlar hakkında bilgi içerir: yazarın adı, baş harfleri, yazar adına bağlı yorumlar vb.

Slayt Yorumları Ekle

Bu Java kodu, bir PowerPoint sunumundaki bir slayta nasıl yorum ekleyeceğinizi gösterir:

// Presentation sınıfını örnekleyerek oluşturur
Presentation pres = new Presentation();
try {
    // Boş bir slayt ekler
    pres.getSlides().addEmptySlide(pres.getLayoutSlides().get_Item(0));

    // Bir yazar ekler
    ICommentAuthor author = pres.getCommentAuthors().addAuthor("Jawad", "MF");

    // Yorumların konumunu ayarlar
    Point2D.Float point = new Point2D.Float(0.2f, 0.2f);

    // Yazar için slayt 1'de slayt yorumu ekler
    author.getComments().addComment("Hello Jawad, this is slide comment", pres.getSlides().get_Item(0), point, new Date());

    // Yazar için slayt 2'de slayt yorumu ekler
    author.getComments().addComment("Hello Jawad, this is second slide comment", pres.getSlides().get_Item(1), point, new Date());

    // ISlide 1'e erişir
    ISlide slide = pres.getSlides().get_Item(0);

    // Argüman olarak null gönderildiğinde, tüm yazarların yorumları seçili slayta getirilir
    IComment[] Comments = slide.getSlideComments(author);

    // Slayt 1 için indeks 0'daki yoruma erişir
    String str = Comments[0].getText();

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

    if (Comments.length > 0)
    {
        // Yazarın yorum koleksiyonunu indeks 0'da seçer
        ICommentCollection commentCollection = Comments[0].getAuthor().getComments();
        String Comment = commentCollection.get_Item(0).getText();
    }
} finally {
    if (pres != null) pres.dispose();
}

Slayt Yorumlarına Erişme

Bu Java kodu, bir PowerPoint sunumundaki bir slaytta mevcut bir yoruma nasıl erişileceğini gösterir:

// Presentation sınıfını örnekleyerek oluşturur
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();
}

Yorumlara Yanıt Verme

Üst yorum, bir yorum hiyerarşisinin ya da yanıtların en üst ya da orijinal yorumudur. IComment arayüzündeki getParentComment veya setParentComment yöntemlerini kullanarak bir üst yorum ayarlayabilir veya alabilirsiniz.

Bu Java kodu, yorum ekleme ve onlara yanıt alma süreçlerini gösterir:

Presentation pres = new Presentation();
try {
    // Bir yorum ekler
    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());

    // comment1'e bir yanıt ekler
    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);

    // comment1'e başka bir yanıt ekler
    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);

    // Mevcut bir yanıta yanıt ekle
    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);

    // Yorum hiyerarşisini konsolda gösterir
    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);

    // comment1'i ve ona ait tüm yanıtları kaldırır
    comment1.remove();

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

Attention

IComment arayüzündeki Remove yöntemi bir yorumu silmek için kullanıldığında, o yoruma ait yanıtlar da silinir.
setParentComment ayarı bir döngüsel referans oluşturursa, PptxEditException istisnası fırlatılır.

Modern Yorumlar Ekle

2021 yılında Microsoft, PowerPoint’te modern yorumlar özelliğini tanıttı. Modern yorumlar, PowerPoint’te iş birliğini büyük ölçüde geliştirir. Modern yorumlar sayesinde PowerPoint kullanıcıları yorumları çözebilir, yorumları nesnelere ve metinlere sabitleyebilir ve etkileşimleri çok daha kolay yürütür.

Aspose Slides for Java 21.11 sürümünde, ModernComment sınıfını ekleyerek modern yorum desteği sağladık. CommentCollection sınıfına addModernComment ve insertModernComment yöntemleri eklendi.

Bu Java kodu, bir PowerPoint sunumundaki bir slayta modern yorum nasıl eklenir gösterir:

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

Yorumları Kaldır

Tüm Yorumları ve Yazarları Sil

Bu Java kodu, bir sunumdaki tüm yorumları ve yazarları nasıl kaldıracağınızı gösterir:

Presentation presentation = new Presentation("example.pptx");
try {
    // Sunumdaki tüm yorumları siler
    for (ICommentAuthor author : presentation.getCommentAuthors())
    {
        author.getComments().clear();
    }

    // Tüm yazarları siler
    presentation.getCommentAuthors().clear();

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

Belirli Yorumları Sil

Bu Java kodu, bir slayttaki belirli yorumları nasıl sileceğinizi gösterir:

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

    // yorum ekle...
    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());

    // "comment 1" metnini içeren tüm yorumları kaldır
    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();
}

Sık Sorulan Sorular

Aspose.Slides, modern yorumlar için ‘çözülmüş’ gibi bir durum desteği sunuyor mu?

Evet. Modern yorumlar bir setStatus yöntemi sunar; bir yorumun durumunu (örneğin, çözülmüş olarak işaretleme) yazabilir ve bu durum dosyada kaydedilir, PowerPoint tarafından tanınır.

Dallanmış tartışmalar (yanıt zincirleri) destekleniyor mu ve bir iç içe geçme sınırı var mı?

Evet. Her yorum, kendi parent comment referansını tutabilir, böylece isteğe bağlı yanıt zincirleri oluşturulabilir. API, belirli bir iç içe geçme derinliği sınırı bildirmez.

Bir slayttaki yorum işaretçisinin konumu hangi koordinat sisteminde tanımlanır?

Konum, slaytın koordinat sisteminde kayan noktalı bir nokta olarak saklanır. Bu, yorum işaretçisini ihtiyacınız olan yere tam olarak yerleştirmenizi sağlar.

Java'da Sunum Görünüm Özelliklerini Alıp Güncelleme Java'da Sunum Notlarını Yönetme