التحكم في خصائص عرض PDF باستخدام Python

تتمتع ملفات PDF بميزة فريدة تتمثل في الاحتفاظ بتفضيلات العرض التي تمكننا من التحكم في كيفية عرض تطبيق العارض لمستند PDF. وبالتالي، فإن قاموس تفضيلات العارض لمستند PDF يسمح لك بالتحكم في الطريقة التي سيتم بها عرض المستند على الشاشة أو في الطباعة.

يرجى ملاحظة أنه يمكننا التحكم في خصائص عرض عارضات PDF. ويشمل ذلك التحكم في عرض عنوان مستند PDF، وإخفاء شريط القوائم أو إظهاره، وإخفاء/إظهار شريط الحالة، وإخفاء/إظهار واجهة المستخدم الخاصة بالنافذة. والتحكم في كيفية إعداد تخطيط الصفحة، ووضع الصفحة، وتخطيط الصفحة. تدعم غالبية تطبيقات معالجة PDF هذه العمليات. ولكن بالنسبة لعمليات التحديث المجمعة، فإن الحل البرمجي هو الحل الفعال. في هذه المقالة، سنناقش التفاصيل والخطوات حول كيفية التحكم في خصائص عرض PDF باستخدام Python.

• مجموعة أدوات معالجة ملفات PDF
• قراءة خصائص العرض في PDF باستخدام Python
• تحديث خصائص عرض PDF باستخدام Python
• قراءة خصائص عرض PDF باستخدام cURL
• تحديث خصائص عرض PFDF باستخدام cURL

مجموعة أدوات معالجة ملفات PDF

Aspose.PDF Cloud عبارة عن واجهة برمجة تطبيقات تعتمد على REST تتيح للمطورين تنفيذ ميزات إنشاء ملفات PDF ومعالجتها وعرضها في تطبيقاتهم. باستخدام عدد أقل من أسطر التعليمات البرمجية، يمكنك تطوير تطبيقات معالجة PDF رائعة. لا يلزم تثبيت برنامج معين ويمكنك إجراء جميع عمليات معالجة PDF في السحابة. لتسهيل الأمر على مطورينا بشكل أكبر، قمنا بإنشاء Aspose.PDF Cloud SDK for Python وهو عبارة عن غلاف حول Aspose.PDF Cloud. لذا، للبدء في استخدام SDK هذه، فإن الخطوة الأولى هي تثبيتها. SDK متاحة للتنزيل مجانًا عبر مستودع PIP وGitHub. نحتاج الآن إلى تنفيذ الأمر التالي في المحطة الطرفية/موجه الأوامر لإجراء التثبيت.

pip install asposepdfcloud
copy

حساب لوحة معلومات السحابة المجاني

الخطوة الرئيسية التالية هي الاشتراك المجاني في خدماتنا السحابية عبر لوحة تحكم Aspose.Cloud. الغرض من هذا الاشتراك هو السماح فقط للأشخاص المصرح لهم بالوصول إلى خدمات معالجة الملفات الخاصة بنا. إذا كان لديك حساب GitHub أو Google، فما عليك سوى التسجيل أو النقر فوق الزر إنشاء حساب جديد وتقديم المعلومات المطلوبة. الآن قم بتسجيل الدخول إلى لوحة التحكم باستخدام بيانات الاعتماد وقم بتوسيع قسم التطبيقات من لوحة التحكم وانتقل لأسفل نحو قسم بيانات اعتماد العميل لرؤية تفاصيل معرف العميل والسر الخاص بالعميل.

قراءة خصائص العرض في PDF باستخدام Python

يرجى استخدام مقتطف التعليمات البرمجية الموضح أدناه لقراءة تفضيلات عارض PDF وعرضها في وحدة التحكم.

• أولاً، قم بإنشاء مثيل لفئة ApiClient مع توفير معرف العميل وسر العميل كوسائط
• ثانيًا، قم بإنشاء مثيل لفئة PdfApi التي تأخذ كائن ApiClient كحجة إدخال
• أخيرًا، اتصل بطريقة getdocumentdisplayproperties(…) لاسترداد تفضيلات عارض PDF

def readPDFDisplayProperties():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # إنشاء مثيل PdfApi أثناء تمرير PdfApiClient كحجة
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'

        # استدعاء API لقراءة خصائص عرض PDF باستخدام Python
        response = pdf_api.get_document_display_properties(name = input_file)
        
        # طباعة الاستجابة في وحدة التحكم
        print(response)
        
        # طباعة الرسالة في وحدة التحكم (اختياري)
        print('PDF Display preferences successfully retrieved !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)
copy

يمكن تنزيل مستند PDF النموذجي المستخدم في المثال أعلاه من PdfWithEmbeddedFiles.pdf.

تحديث خصائص عرض PDF باستخدام Python

في هذا القسم، سنناقش الخطوات والتفاصيل ذات الصلة بكيفية تعيين خصائص عرض PDF باستخدام Python SDK. ومع ذلك، قبل المتابعة، نحتاج أولاً إلى معرفة الخصائص والقيم المحددة التي يمكن تعيينها لها.

الخصائص المدعومة

| العقار | الوصف |

| —————– | ———————— |

| HideToolbar | علم يحدد ما إذا كان سيتم إخفاء أشرطة أدوات تطبيق عارض PDF عندما يكون المستند نشطًا |

|HideMenuBar | علم يحدد ما إذا كان سيتم إخفاء شريط القائمة الخاص بتطبيق عارض PDF عندما يكون المستند نشطًا. |

|HideWindowUI | علم يحدد ما إذا كان سيتم إخفاء عناصر واجهة المستخدم في نافذة المستند (مثل أشرطة التمرير وعناصر التحكم في التنقل)، وترك محتويات المستند فقط معروضة. |

| FitWindow | علم يحدد ما إذا كان سيتم تغيير حجم نافذة المستند لتناسب حجم الصفحة المعروضة الأولى. |

| CenterWindow | علم يحدد ما إذا كان سيتم وضع نافذة المستند في منتصف الشاشة. |

| DisplayDocTitle | علم يحدد ما إذا كان شريط عنوان النافذة يجب أن يعرض عنوان المستند. |

| PageMode | وضع صفحة المستند عند فتح مستند pdf في عارض pdf. القيم الممكنة: UseNone – لا يمكن رؤية مخطط المستند (الإشارات المرجعية) ولا الصور المصغرة. UseOutlines – يمكن رؤية مخطط المستند (الإشارات المرجعية).UseThumbs – يمكن رؤية الصور المصغرة. FullScreenFull – وضع الشاشة، بدون شريط القائمة أو عناصر التحكم في النافذة أو أي نافذة أخرى مرئية. UseOC – يمكن رؤية لوحة مجموعة المحتوى الاختيارية. UseAttachments – يمكن رؤية مرفقات المستند. |

| PageLayout | يجب استخدام تخطيط الصفحة عند فتح المستند. القيم الممكنة: SinglePage – يعرض صفحة واحدة في كل مرة. OneColumn – يعرض الصفحات في عمود واحد. TwoColumnLeft – يعرض الصفحات في عمودين، مع وضع الصفحات ذات الأرقام الفردية على اليسار. TwoColumnRight – يعرض الصفحات في عمودين، مع وضع الصفحات ذات الأرقام الفردية على اليمين. |

| NonFullScreenPageMode | وضع صفحة المستند عندما يخرج تطبيق عارض pdf من وضع ملء الشاشة. القيم الممكنة: UseNone – لا يمكن رؤية مخطط المستند (الإشارات المرجعية) ولا الصور المصغرة. UseOutlines – يمكن رؤية مخطط المستند (الإشارات المرجعية).UseThumbs – يمكن رؤية الصور المصغرة. UseOC – يمكن رؤية لوحة مجموعة المحتوى الاختيارية. |

• قم بإنشاء مثيل لفئة ApiClient مع توفير معرف العميل وسر العميل كوسائط.
• ثم قم بإنشاء مثيل لفئة PdfApi والتي تأخذ كائن ApiClient كحجة إدخال.
• قم الآن بإنشاء مثيل لـ DocumentProperties الذي يحدد خصائص عرض جديدة لعرض PDF.
• أخيرًا، قم باستدعاء putdocumentdisplayproperties(…) لتعيين خصائص العرض الجديدة لملف PDF.

def updatePDFDisplayProperties():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # إنشاء مثيل PdfApi أثناء تمرير PdfApiClient كحجة
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'
        
        # خصائص عرض المستند
        newDocumentProperties = asposepdfcloud.DocumentProperties
        {
          "Links": [
            {
               "Href": '/PdfWithEmbeddedFiles.pdf/displayproperties',
                "Rel": 'self',
                "Type": None,
                "Title": None    }
          ],
          "CenterWindow": True,
          "Direction": 'L2R',
          "DisplayDocTitle": True,
          "HideMenuBar": True,
          "HideToolBar": False,
          "HideWindowUI": True,
          "NonFullScreenPageMode": 'UseOutlines',
          "PageLayout":'TwoColumnRight',
          "PageMode": 'UseThumbs'
        }

        # استدعاء واجهة برمجة التطبيقات لتحديث خصائص عرض PDF
        response = pdf_api.put_document_display_properties(name = input_file, display_properties=newDocumentProperties)
        
        # طباعة الاستجابة في وحدة التحكم
        print(response)
        
        # طباعة الرسالة في وحدة التحكم (اختياري)
        print('PDF Display preferences successfully updated !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)
copy

قراءة خصائص عرض PDF باستخدام cURL

يمكن أيضًا الوصول إلى واجهات برمجة التطبيقات REST عبر أوامر cURL وبما أن Aspose.PDF Cloud تم تطويره وفقًا لهندسة REST، فيمكننا أيضًا الوصول إلى واجهة برمجة التطبيقات باستخدام أمر cURL. ومع ذلك، قبل إجراء أي عملية معالجة للمستندات، نحتاج إلى إنشاء رمز ويب JSON (JWT) استنادًا إلى بيانات اعتماد العميل الفردية المحددة عبر لوحة معلومات Aspose.Cloud. هذا أمر إلزامي لأن واجهات برمجة التطبيقات الخاصة بنا لا يمكن الوصول إليها إلا من قبل المستخدمين المسجلين. يرجى تنفيذ الأمر التالي لإنشاء رمز JWT.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
copy

بمجرد إنشاء رمز JWT، قد نحتاج إلى تنفيذ أمر cURL التالي لقراءة خصائص عرض PDF.

curl -v -X GET "https://api.aspose.cloud/v3.0/pdf/PdfWithEmbeddedFiles.pdf/displayproperties" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"
copy

تحديث خصائص عرض PDF باستخدام cURL

يمكن أيضًا استخدام الأمر cURL لتحديث خصائص العرض لمستندات PDF ويتم حفظ الملف الناتج مرة أخرى في التخزين السحابي.

curl -v -X PUT "https://api.aspose.cloud/v3.0/pdf/PdfWithEmbeddedFiles.pdf/displayproperties" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Links\": [    {       \"Href\": \"/PdfWithEmbeddedFiles.pdf/displayproperties\",        \"Rel\": \"self\",        \"Type\": null,        \"Title\": null    }  ],  \"CenterWindow\": true,  \"Direction\": \"L2R\",  \"DisplayDocTitle\": true,  \"HideMenuBar\": true,  \"HideToolBar\": false,  \"HideWindowUI\": true,  \"NonFullScreenPageMode\": \"UseOutlines\",  \"PageLayout\": \"TwoColumnRight\",  \"PageMode\": \"UseThumbs\"}"
copy

خاتمة

في هذه المقالة، استكشفنا التفاصيل والخطوات المتعلقة بكيفية قراءة خصائص عرض PDF والتحكم فيها. يمكن إنجاز هذه المتطلبات باستخدام مقتطفات التعليمات البرمجية بلغة Python بالإضافة إلى استخدام أوامر cURL. نوصي أيضًا باستكشاف دليل المطور لمعرفة المزيد عن الميزات المثيرة الأخرى التي تقدمها واجهة برمجة التطبيقات. علاوة على ذلك، أصبح الكود المصدر الكامل لمجموعة أدوات تطوير البرامج السحابية Aspose.PDF for Python متاحًا للتنزيل عبر GitHub. في حالة مواجهة أي مشكلات أثناء استخدام واجهة برمجة التطبيقات أو إذا كان لديك أي استفسارات أخرى، فلا تتردد في الاتصال بنا عبر منتدى دعم المنتج المجاني.

مقالات ذات صلة

وننصحك أيضًا بزيارة الروابط التالية لمعرفة المزيد عن:

• تحويل PDF إلى صورة – تحويل PDF إلى JPEG في Python
• تنزيل المرفق من ملف PDF باستخدام Python
• إضافة أو إزالة صفحات PDF باستخدام Python
• البحث عن نص واستبداله في PDF باستخدام Python
• استخراج الصور من PDF في بايثون
• استخراج النص من PDF في بايثون