ویژگی های نمایش PDF را کنترل کنید

فایل‌های PDF دارای ویژگی منحصربه‌فردی برای نگه‌داشتن تنظیمات برگزیده نمایش هستند که به ما امکان می‌دهد نحوه نمایش سند PDF را توسط برنامه بیننده کنترل کنیم. بنابراین، فرهنگ لغت ترجیحات بیننده یک سند PDF به شما امکان می دهد نحوه نمایش سند روی صفحه یا به صورت چاپی را کنترل کنید.

لطفاً توجه داشته باشید که ما می توانیم ویژگی های نمایش نمایشگرهای PDF را کنترل کنیم. این شامل کنترل نمایش عنوان سند PDF، پنهان کردن یا نمایش منوبار، پنهان کردن/نمایش نوار وضعیت، پنهان کردن/نمایش رابط کاربری پنجره است. نحوه تنظیم صفحه‌آرایی، حالت صفحه و صفحه‌آرایی را کنترل کنید. اکثر برنامه های کاربردی پردازش PDF از این عملیات پشتیبانی می کنند. اما، برای عملیات به روز رسانی انبوه، یک راه حل برنامه ای یک راه حل موثر است. در این مقاله قصد داریم به جزئیات و مراحل نحوه کنترل خصوصیات نمایش PDF با استفاده از پایتون بپردازیم.

SDK دستکاری PDF

Aspose.PDF Cloud یک API مبتنی بر REST است که توسعه‌دهندگان را قادر می‌سازد تا ویژگی‌های ایجاد، دستکاری و رندر PDF را در برنامه‌های خود پیاده‌سازی کنند. با خطوط کد کمتر، می توانید برنامه های کاربردی پردازش PDF قابل توجهی را توسعه دهید. نصب نرم افزار خاصی مورد نیاز نیست و می توانید تمام عملیات پردازش PDF را در Cloud انجام دهید. برای تسهیل بیشتر توسعه دهندگان، Aspose.PDF Cloud SDK for Python را ایجاد کرده ایم که پوششی در اطراف Aspose.PDF Cloud است. بنابراین برای شروع کار با این SDK، اولین قدم نصب آن است. SDK برای دانلود رایگان از طریق مخزن PIP و GitHub در دسترس است. حال باید دستور زیر را در خط ترمینال/command prompt برای اجرای نصب اجرا کنیم.

pip install asposepdfcloud

حساب داشبورد ابری رایگان

گام مهم بعدی اشتراک رایگان خدمات ابری ما از طریق Aspose.Cloud dashboard است. هدف از این اشتراک این است که فقط به افراد مجاز اجازه دسترسی به خدمات پردازش فایل ما را بدهد. اگر حساب GitHub یا Google دارید، به سادگی ثبت نام کنید یا روی دکمه Create a new Account کلیک کنید و اطلاعات مورد نیاز را ارائه دهید. اکنون با استفاده از اعتبارنامه وارد داشبورد شوید و بخش Applications را از داشبورد گسترش دهید و به سمت پایین به سمت قسمت Client Credentials حرکت کنید تا Client ID و Client Secret را ببینید.

اعتبار مشتری

تصویر 1: - اعتبار مشتری در Aspose.Cloud Dashboard.

ویژگی های نمایش PDF را با استفاده از پایتون بخوانید

لطفاً از قطعه کد ارائه شده در زیر برای خواندن تنظیمات برگزیده نمایشگر PDF و نمایش آنها در کنسول استفاده کنید.

  • ابتدا یک نمونه از کلاس ApiClient ایجاد کنید و در عین حال Client ID Client Secret را به عنوان آرگومان ارائه دهید
  • در مرحله دوم، یک نمونه از کلاس 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)

        # هنگام ارسال PdfApiClient به عنوان آرگومان، نمونه PdfApi ایجاد کنید
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'

        # برای خواندن خصوصیات نمایش PDF با استفاده از پایتون، API را فراخوانی کنید
        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)

نمونه سند PDF مورد استفاده در مثال بالا را می توان از PdfWithEmbeddedFiles.pdf دانلود کرد.

ویژگی های نمایش PDF را با استفاده از پایتون به روز کنید

در این بخش، ما قصد داریم مراحل و جزئیات مربوط به نحوه تنظیم خصوصیات نمایش PDF با استفاده از Python SDK را مورد بحث قرار دهیم. با این حال، قبل از ادامه، ابتدا باید خصوصیات و مقادیر خاصی را که می توان به آنها نسبت داد، یاد گرفت.

ویژگی های پشتیبانی شده

| اموال | توضیحات |

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

| HideToolbar | پرچمی که مشخص می کند هنگام فعال بودن سند، نوار ابزار برنامه نمایشگر pdf پنهان شود یا خیر |

| HideMenuBar | پرچمی که مشخص می کند وقتی سند فعال است، نوار منوی برنامه نمایشگر pdf پنهان شود یا خیر. |

| HideWindowUI | پرچمی که مشخص می‌کند عناصر رابط کاربری در پنجره سند پنهان شوند (مانند نوارهای پیمایش و کنترل‌های پیمایش)، و تنها محتوای سند نمایش داده شود. |

| FitWindow | پرچمی که تعیین می کند اندازه پنجره سند متناسب با اندازه اولین صفحه نمایش داده شده تغییر کند یا خیر. |

| پنجره مرکزی | پرچمی که مشخص می کند پنجره سند در مرکز صفحه قرار گیرد یا خیر. |

| DisplayDocTitle | پرچمی که مشخص می کند نوار عنوان پنجره باید عنوان سند را نمایش دهد یا خیر. |

| حالت صفحه | حالت صفحه سند هنگامی که سند pdf در یک نمایشگر pdf باز می شود. مقادیر ممکن: UseNone – نه طرح کلی سند (نشانک ها) و نه تصاویر کوچک قابل مشاهده هستند. UseOutlines - طرح کلی سند (نشانک ها) قابل مشاهده است. UseThumbs – تصاویر بند انگشتی قابل مشاهده هستند. FullScreenFull – حالت صفحه، بدون نوار منو، کنترل های پنجره، یا هر پنجره دیگری قابل مشاهده است. UseOC - پانل گروه محتوای اختیاری قابل مشاهده است. UseAttachments - پیوست های سند قابل مشاهده است. |

| صفحه بندی | هنگام باز شدن سند از طرح بندی صفحه استفاده می شود. مقادیر ممکن: SinglePage - یک صفحه را در یک زمان نمایش می دهد. OneColumn - صفحات را در یک ستون نمایش می دهد. TwoColumnLeft - صفحات را در دو ستون با صفحات فرد در سمت چپ نمایش می دهد. TwoColumnRight – صفحات را در دو ستون با صفحات فرد با شماره در سمت راست نمایش می دهد. |

| NonFullScreenPageMode | حالت صفحه سند هنگامی که برنامه نمایش pdf از حالت تمام صفحه خارج می شود. مقادیر ممکن: UseNone – نه طرح کلی سند (نشانک ها) و نه تصاویر کوچک قابل مشاهده هستند. UseOutlines - طرح کلی سند (نشانک ها) قابل مشاهده است. UseThumbs – تصاویر بند انگشتی قابل مشاهده هستند. UseOC - پانل گروه محتوای اختیاری قابل مشاهده است. |

  • همزمان با ارائه Client ID Client Secret به عنوان آرگومان، یک نمونه از کلاس 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)

        # هنگام ارسال PdfApiClient به عنوان آرگومان، نمونه PdfApi ایجاد کنید
        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 با API تماس بگیرید
        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)
تنظیمات برگزیده نمایش پی دی اف به روز شده است

تصویر 2: - پیش نمایش تنظیمات صفحه نمایش PDF به روز شده.

ویژگی های نمایش PDF را با استفاده از cURL بخوانید

APIهای REST همچنین از طریق دستورات cURL قابل دسترسی هستند و از آنجایی که Aspose.PDF Cloud طبق معماری REST توسعه یافته است، بنابراین ما می‌توانیم با استفاده از دستور cURL به API دسترسی پیدا کنیم. با این حال، قبل از انجام هر گونه عملیات دستکاری سند، باید یک رمز وب JSON (JWT) بر اساس اطلاعات کاربری مشتری شخصی شما که روی داشبورد Aspose.Cloud مشخص شده است، ایجاد کنیم. اجباری است زیرا API های ما فقط برای کاربران ثبت نام شده قابل دسترسی است. لطفا دستور زیر را برای تولید توکن 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"

هنگامی که توکن JWT تولید شد، می‌توانیم برای خواندن ویژگی‌های نمایش PDF، دستور cURL زیر را اجرا کنیم.

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

ویژگی های نمایش 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\"}"

نتیجه گیری

در این مقاله، جزئیات و مراحل نحوه خواندن و کنترل ویژگی های نمایش PDF را بررسی کرده ایم. این الزامات را می توان با استفاده از قطعه کد پایتون و همچنین با استفاده از دستورات cURL انجام داد. همچنین توصیه می‌کنیم راهنمای توسعه‌دهنده را بررسی کنید تا در مورد سایر ویژگی‌های هیجان‌انگیز ارائه‌شده توسط API بیاموزید. علاوه بر این، کد منبع کامل Aspose.PDF Cloud SDK برای پایتون برای دانلود از طریق GitHub در دسترس قرار گرفته است. در صورتی که هنگام استفاده از API با مشکلی مواجه شدید یا سؤالات دیگری دارید، لطفاً از طریق [تالار گفتمان پشتیبانی رایگان محصول13 با ما تماس بگیرید.

مقالات مرتبط

همچنین توصیه می کنیم برای کسب اطلاعات بیشتر به لینک های زیر مراجعه کنید: