PNG JPG BMP TIFF PDF
Aspose.PDF  for Python

إضافة تعليقات نصية مشطوبة إلى PDF عبر Python SDK

API لإضافة التعليقات إلى مستندات PDF باستخدام Cloud Python SDK.

Get Started

كيفية إضافة تعليقات الشطب إلى PDF عبر Cloud Python SDK

لإضافة تعليقات توضيحية إلى PDF، سنستخدم Aspose.PDF Cloud Python SDK. يساعد هذا SDK السحابي مبرمجي Python في تطوير تطبيقات إنشاء وتوضيح وتحرير وتحويل PDF المستندة إلى السحابة باستخدام لغة برمجة Python عبر Aspose.PDF REST API. ما عليك سوى إنشاء حساب في Aspose for Cloud والحصول على معلومات التطبيق الخاصة بك. بمجرد أن يكون لديك App SID والمفتاح، أنت جاهز لاستخدام Aspose.PDF Cloud Python SDK. إذا كان حزمة Python مستضافة على Github، يمكنك التثبيت مباشرة من Github:

التثبيت من Github


     
    pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git

أمر وحدة تحكم إدارة الحزم

     
    pip install asposepdfcloud

خطوات إضافة تعليقات الشطب إلى PDF عبر Python

يمكن لمطوري Aspose.PDF Cloud تحميل وإضافة التعليقات إلى PDF بسهولة في بضعة أسطر من الشفرة.

  1. تثبيت Python SDK.
  2. تحميل ملف PDF المدخل.
  3. إنشاء تعليق شطب جديد بخصائص مثل الموضع، اللون والنص.
  4. إرسال التعليق إلى PDF.
  5. التحقق من صحة الاستجابة.
  6. تحميل المستند المعلق.
 

إضافة تعليقات الشطب إلى PDF باستخدام Python


    from annotations_helper import Config, PdfAnnotationsHelper, logging
    from asposepdfcloud import PdfApi, StrikeOutAnnotation, Rectangle, Color, Point, AnnotationFlags, HorizontalAlignment, VerticalAlignment

    class PdfAddStrikeoutAnnotations:
        """Class for managing PDF annotations using Aspose PDF Cloud API."""
        def __init__(self, pdf_api: PdfApi, helper: PdfAnnotationsHelper):
            self.pdfApi = pdf_api
            self.helper = helper

        def append_strikeout_annotation(self):
            """Append a new strikeout text annotation to the PDF document."""
            if self.pdfApi:
                self.helper.uploadFile(Config.PDF_DOCUMENT_NAME, Config.LOCAL_FOLDER, Config.REMOTE_FOLDER)
                
                args = {
                    "folder": Config.REMOTE_FOLDER
                }
                
                new_annotation = StrikeOutAnnotation(
                    rect = Rectangle(llx=100, lly=100, urx=200, ury=200),
                    name = 'Strikeout_Text_Annotation',
                    flags = [AnnotationFlags.DEFAULT],
                    horizontal_alignment = HorizontalAlignment.LEFT,
                    vertical_alignment = VerticalAlignment.TOP,
                    rich_text = Config.NEW_SO_ANNOTATION_TEXT,
                    subject = Config.NEW_SO_ANNOTATION_SUBJECT,
                    title = Config.NEW_SO_ANNOTATION_DESCRIPTION,
                    contents= Config.NEW_SO_ANNOTATION_CONTENTS,
                    z_index = 1,
                    color= Color(a=0xFF, r=0, g=0xFF, b=0),
                    quad_points = [
                        Point(10, 10),
                        Point(20, 10),
                        Point(10, 20),
                        Point(10, 10)
                    ],
                    modified = '03/27/2025 00:00:00.000 AM',
                )
                try:
                    response = self.pdfApi.post_page_strike_out_annotations(Config.PDF_DOCUMENT_NAME, Config.PAGE_NUMBER, [new_annotation], **args)
                    if response.code == 200:
                        logging.info(f"append_strikeout_annotation(): annotation '{Config.NEW_SO_ANNOTATION_TEXT}' added to the document '{Config.PDF_DOCUMENT_NAME}'.")
                        self.helper.downloadFile(Config.PDF_DOCUMENT_NAME, Config.LOCAL_RESULT_DOCUMENT_NAME, Config.LOCAL_FOLDER, Config.REMOTE_FOLDER, "add_strikeout_")
                    else:
                        logging.error(f"append_strikeout_annotation(): Failed to add annotation to the document. Response code: {response.code}")
                except Exception as e:
                    logging.error(f"append_strikeout_annotation(): Error while adding annotation: {e}")