تعليقات العرض

في PowerPoint، تظهر التعليقات كملحوظة أو تعليق على الشريحة. عند النقر على تعليق، يتم الكشف عن محتوياته أو رسائله.

لماذا تضيف تعليقات إلى العروض؟

قد ترغب في استخدام التعليقات لتقديم تعليقات أو التواصل مع زملائك عند مراجعة العروض.

لتمكينك من استخدام التعليقات في عروض PowerPoint، توفر Aspose.Slides لـ Java

• فئة Presentation التي تحتوي على مجموعات من المؤلفين (من واجهة ICommentAuthorCollection). يضيف المؤلفون التعليقات إلى الشرائح.
• واجهة ICommentCollection التي تحتوي على مجموعة من التعليقات لمؤلفين فرديين.
• فئة IComment التي تحتوي على معلومات حول المؤلفين وتعليقاتهم: من أضاف التعليق، الوقت الذي تم إضافة التعليق فيه، موقع التعليق، إلخ.
• فئة CommentAuthor التي تحتوي على معلومات حول المؤلفين الفرديين: اسم المؤلف، الأحرف الأولى، التعليقات المرتبطة باسم المؤلف، إلخ.

إضافة تعليق على الشريحة

يوضح هذا الكود بلغة Java كيفية إضافة تعليق إلى شريحة في عرض PowerPoint:

// ينشئ كائن Presentation
Presentation pres = new Presentation();
try {
    // يضيف شريحة فارغة
    pres.getSlides().addEmptySlide(pres.getLayoutSlides().get_Item(0));

    // يضيف مؤلفًا
    ICommentAuthor author = pres.getCommentAuthors().addAuthor("Jawad", "MF");

    // يحدد الموقع للتعليقات
    Point2D.Float point = new Point2D.Float(0.2f, 0.2f);

    // يضيف تعليق الشريحة لمؤلف على الشريحة 1
    author.getComments().addComment("مرحبًا Jawad، هذا هو تعليق الشريحة", pres.getSlides().get_Item(0), point, new Date());

    // يضيف تعليق الشريحة لمؤلف على الشريحة 2
    author.getComments().addComment("مرحبًا Jawad، هذا هو التعليق الثاني على الشريحة", pres.getSlides().get_Item(1), point, new Date());

    // يصل إلى الشريحة ISlide 1
    ISlide slide = pres.getSlides().get_Item(0);

    // عند تمرير null كمعامل، يتم جلب التعليقات من جميع المؤلفين إلى الشريحة المحددة
    IComment[] Comments = slide.getSlideComments(author);

    // يصل إلى التعليق في الفهرس 0 للشريحة 1
    String str = Comments[0].getText();

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

    if (Comments.length > 0)
    {
        // يختار مجموعة تعليقات المؤلف في الفهرس 0
        ICommentCollection commentCollection = Comments[0].getAuthor().getComments();
        String Comment = commentCollection.get_Item(0).getText();
    }
} finally {
    if (pres != null) pres.dispose();
}

الوصول إلى تعليقات الشريحة

يوضح هذا الكود بلغة Java كيفية الوصول إلى تعليق موجود على شريحة في عرض PowerPoint:

// ينشئ كائن 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() + " لديه تعليق: " + comment.getText() +
                    " مع المؤلف: " + comment.getAuthor().getName() + " نشر في الوقت: " + comment.getCreatedTime() + "\n");
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

الرد على التعليقات

التعليق الأب هو التعليق الأعلى أو الأصلي في تسلسل التعليقات أو الردود. باستخدام طريقة getParentComment أو setParentComment (من واجهة IComment)، يمكنك تعيين أو الحصول على تعليق أب.

يوضح هذا الكود بلغة Java كيفية إضافة تعليقات والحصول على ردود عليها:

Presentation pres = new Presentation();
try {
    // يضيف تعليقًا
    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
    ICommentAuthor author2 = pres.getCommentAuthors().addAuthor("Autror_2", "B.B.");
    IComment reply1 = author2.getComments().addComment("رد 1 على التعليق 1", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());
    reply1.setParentComment(comment1);

    // يضيف ردًا آخر على comment1
    IComment reply2 = author2.getComments().addComment("رد 2 على التعليق 1", pres.getSlides().get_Item(0),  new Point2D.Float(10, 10), new Date());
    reply2.setParentComment(comment1);

    // يضيف ردًا على رد موجود
    IComment subReply = author1.getComments().addComment("رد فرعي 3 على الرد 2", pres.getSlides().get_Item(0),  new Point2D.Float(10, 10), new Date());
    subReply.setParentComment(reply2);

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

    IComment reply3 = author1.getComments().addComment("رد 4 على التعليق 3", pres.getSlides().get_Item(0), new Point2D.Float(10, 10), new Date());
    reply3.setParentComment(comment3);

    // يعرض هيكل التعليقات على وحدة التحكم
    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 وجميع الردود عليه
    comment1.remove();

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

تنبيه

• عند استخدام طريقة Remove (من واجهة IComment) لحذف تعليق، سيتم أيضًا حذف الردود على التعليق.
• إذا كانت إعدادات setParentComment تسبب إشارة دائرية، سيتم طرح استثناء PptxEditException.

إضافة تعليق حديث

في عام 2021، قدمت Microsoft تعليقات حديثة في PowerPoint. تعمل ميزة التعليقات الحديثة على تحسين التعاون بشكل كبير في PowerPoint. من خلال التعليقات الحديثة، يمكن لمستخدمي PowerPoint حل التعليقات، وتثبيت التعليقات على الكائنات والنصوص، والانخراط في التفاعلات بسهولة أكبر مما كان عليه الحال من قبل.

في Aspose Slides for Java 21.11، قمنا بتنفيذ دعم التعليقات الحديثة عن طريق إضافة فئة ModernComment. تمت إضافة طرق addModernComment و insertModernComment إلى فئة CommentCollection.

يوضح هذا الكود بلغة Java كيفية إضافة تعليق حديث إلى شريحة في عرض PowerPoint:

Presentation pres = new Presentation();
try {
    ICommentAuthor newAuthor = pres.getCommentAuthors().addAuthor("بعض المؤلفين", "SA");
    IModernComment modernComment = newAuthor.getComments().addModernComment("هذا تعليق حديث", 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();
}

إزالة التعليق

حذف جميع التعليقات والمؤلفين

يوضح هذا الكود بلغة Java كيفية إزالة جميع التعليقات والمؤلفين في عرض تقديمي:

Presentation presentation = new Presentation("example.pptx");
try {
    // يحذف جميع التعليقات من العرض التقديمي
    for (ICommentAuthor author : presentation.getCommentAuthors())
    {
        author.getComments().clear();
    }

    // يحذف جميع المؤلفين
    presentation.getCommentAuthors().clear();

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

حذف تعليقات محددة

يوضح هذا الكود بلغة Java كيفية حذف تعليقات محددة على شريحة:

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

    // إضافة تعليقات...
    ICommentAuthor author = presentation.getCommentAuthors().addAuthor("Author", "A");
    author.getComments().addComment("تعليق 1", slide, new Point2D.Float(0.2f, 0.2f), new Date());
    author.getComments().addComment("تعليق 2", slide, new Point2D.Float(0.3f, 0.2f), new Date());

    // إزالة جميع التعليقات التي تحتوي على نص "تعليق 1"
    for (ICommentAuthor commentAuthor : presentation.getCommentAuthors())
    {
        ArrayList<IComment> toRemove = new ArrayList<IComment>();
        for (IComment comment : slide.getSlideComments(commentAuthor))
        {
            if (comment.getText().equals("تعليق 1"))
            {
                toRemove.add(comment);
            }
        }

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

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