إدارة تعليقات العروض التقديمية في بايثون

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

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

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

للسماح لك باستخدام التعليقات في عروض PowerPoint التقديمية، توفر Aspose.Slides for Python عبر .NET

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

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

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

import aspose.slides as slides
import aspose.pydrawing as draw
import datetime

# ينشئ كائن فئة Presentation
with slides.Presentation() as presentation:
    # يضيف شريحة فارغة
    presentation.slides.add_empty_slide(presentation.layout_slides[0])

    # يضيف مؤلفًا
    author = presentation.comment_authors.add_author("Jawad", "MF")

    # يضبط الموضع للتعليقات
    point = draw.PointF(0.2, 0.2)

    # يضيف تعليق شريحة لمؤلف على الشريحة 1
    author.comments.add_comment("Hello Jawad, this is slide comment", presentation.slides[0], point, datetime.date.today())

    # يضيف تعليق شريحة لمؤلف على الشريحة 2
    author.comments.add_comment("Hello Jawad, this is second slide comment", presentation.slides[1], point, datetime.date.today())

    # الوصول إلى ISlide 1
    slide = presentation.slides[0]

    # عند تمرير قيمة null كمعامل، يتم جلب التعليقات من جميع المؤلفين إلى الشريحة المحددة
    comments = slide.get_slide_comments(author)

    # يصل إلى التعليق في الفهرس 0 للشريحة 1
    str = comments[0].text

    presentation.save("Comments_out.pptx", slides.export.SaveFormat.PPTX)

    if comments.length > 0:
        # يختار مجموعة تعليقات المؤلف في الفهرس 0
        commentCollection = comments[0].author.comments
        print(commentCollection[0].text)

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

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

import aspose.slides as slides

# يُنشئ كائن فئة Presentation
with slides.Presentation("Comments1.pptx") as presentation:
    for author in presentation.comment_authors:
        for comment in author.comments:
            print("ISlide :" + str(comment.slide.slide_number) + 
            " has comment: " + comment.text + 
            " with Author: " + comment.author.name + 
            " posted on time :" + str(comment.created_time) + "\n")

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

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

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

import aspose.slides as slides
import aspose.pydrawing as draw
import datetime

with slides.Presentation() as pres:
    # يضيف تعليقًا
    author1 = pres.comment_authors.add_author("Author_1", "A.A.")
    comment1 = author1.comments.add_comment("comment1", pres.slides[0], draw.PointF(10, 10), datetime.date.today())

    # يضيف ردًا على التعليق 1
    author2 = pres.comment_authors.add_author("Autror_2", "B.B.")
    reply1 = author2.comments.add_comment("reply 1 for comment 1", pres.slides[0], draw.PointF(10, 10), datetime.date.today())
    reply1.parent_comment = comment1

    # يضيف ردًا آخر على التعليق 1
    reply2 = author2.comments.add_comment("reply 2 for comment 1", pres.slides[0], draw.PointF(10, 10), datetime.date.today())
    reply2.parent_comment = comment1

    # يضيف ردًا على الرد الموجود
    subReply = author1.comments.add_comment("subreply 3 for reply 2", pres.slides[0], draw.PointF(10, 10), datetime.date.today())
    subReply.parent_comment = reply2

    comment2 = author2.comments.add_comment("comment 2", pres.slides[0], draw.PointF(10, 10), datetime.date.today())
    comment3 = author2.comments.add_comment("comment 3", pres.slides[0], draw.PointF(10, 10), datetime.date.today())

    reply3 = author1.comments.add_comment("reply 4 for comment 3", pres.slides[0], draw.PointF(10, 10), datetime.date.today())
    reply3.parent_comment = comment3

    # يعرض تسلسل التعليقات على وحدة التحكم
    slide = pres.slides[0]
    comments = slide.get_slide_comments(None)
    for i in range(comments.length):
        comment = comments[i]
        while comment.parent_comment is not None:
            print("\t")
            comment = comment.parent_comment

        print(comments[i].author.name + " : " + comments[i].text)
        print("\r\n")

    pres.save("parent_comment.pptx", slides.export.SaveFormat.PPTX)

    # يزيل التعليق 1 وجميع الردود عليه
    comment1.remove()

    pres.save("remove_comment.pptx", slides.export.SaveFormat.PPTX)

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

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

قمنا بتنفيذ دعم التعليقات الحديثة بإضافة الفئة [ModernComment]. تم إضافة الطريقتين add_modern_comment و insert_modern_comment إلى الفئة [CommentCollection].

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

import aspose.pydrawing as draw
import aspose.slides as slides
from datetime import date

with slides.Presentation() as pres:
    newAuthor = pres.comment_authors.add_author("Some Author", "SA")
    modernComment = newAuthor.comments.add_modern_comment("This is a modern comment", pres.slides[0], None, draw.PointF(100, 100), date.today())

    pres.save("example.pptx", slides.export.SaveFormat.PPTX)

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

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

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

import aspose.slides as slides

with slides.Presentation("example.pptx") as presentation:
    # حذف جميع التعليقات من العرض التقديمي
    for author in presentation.comment_authors:
        author.comments.clear()

    # حذف جميع المؤلفين
    presentation.comment_authors.clear()

    presentation.save("example_out.pptx", slides.export.SaveFormat.PPTX)

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

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

import aspose.pydrawing as draw
import aspose.slides as slides
from datetime import date

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    
    # إضافة تعليقات...
    author = presentation.comment_authors.add_author("Author", "A")
    author.comments.add_comment("comment 1", slide, draw.PointF(0.2, 0.2), date.today())
    author.comments.add_comment("comment 2", slide, draw.PointF(0.3, 0.2), date.today())
    
    # إزالة جميع التعليقات التي تحتوي على النص "comment 1"
    for commentAuthor in presentation.comment_authors:
        toRemove = []
        for comment in slide.get_slide_comments(commentAuthor):
            if comment.text == "comment 1":
                toRemove.append(comment)
        
        for comment in toRemove:
            commentAuthor.comments.remove(comment)
    
    presentation.save("pres.pptx", slides.export.SaveFormat.PPTX)

الأسئلة المتداولة

هل يدعم Aspose.Slides حالة مثل “تم الحل” للتعليقات الحديثة؟

نعم. تُظهر [Modern comments] خاصية [status]؛ يمكنك قراءة وضبط [comment’s state] (على سبيل المثال، وضع علامة تم الحل)، ويتم حفظ هذه الحالة في الملف وتُعترف بها من قبل PowerPoint.

هل يتم دعم المناقشات المتسلسلة (سلاسل الردود)، وهل هناك حد للتعشيق؟

نعم. يمكن لكل تعليق الإشارة إلى [parent comment] الخاص به، مما يتيح سلاسل ردود غير محدودة. لا تُعلن الـ API عن حد معين لعمق التعشيق.

في أي نظام إحداثي يُعرف موقع علامة التعليق على الشريحة؟

يُخزن الموقع كنقطة ذات قيمة عائمة في نظام إحداثيات الشريحة. يتيح لك ذلك وضع علامة التعليق بدقة في المكان الذي تحتاجه.

استرجاع وتحديث خصائص عرض العرض التقديمي في بايثون إدارة ملاحظات العرض التقديمي في Python