керування властивостями відображення PDF

Файли PDF мають унікальну функцію збереження параметрів перегляду, які дозволяють нам контролювати, як програма перегляду відображатиме PDF-документ. Таким чином, словник налаштувань переглядача PDF-документа дає змогу контролювати спосіб представлення документа на екрані чи в друкованому вигляді.

Зверніть увагу, що ми можемо керувати властивостями відображення програм перегляду PDF. Він включає керування відображенням заголовка PDF-документа, приховування або відображення рядка меню, приховування/показу рядка стану, приховування/відображення інтерфейсу користувача вікна. Контролюйте, як налаштувати макет сторінки, режим сторінки та макет сторінки. Більшість програм для обробки PDF підтримують ці операції. Але для операцій масового оновлення ефективним рішенням є програмне рішення. У цій статті ми збираємося обговорити деталі та кроки щодо керування властивостями відображення PDF за допомогою Python.

PDF Manipulation SDK

Aspose.PDF Cloud — це API на основі REST, який дозволяє розробникам запроваджувати функції створення PDF-файлів, обробки та відтворення у своїх програмах. З меншою кількістю рядків коду ви можете розробляти вражаючі програми обробки PDF. Встановлювати спеціальне програмне забезпечення не потрібно, і ви можете виконувати всі операції обробки PDF-файлів у хмарі. Щоб ще більше полегшити роботу наших розробників, ми створили Aspose.PDF Cloud SDK для Python, який є оболонкою для Aspose.PDF Cloud. Отже, щоб розпочати роботу з цим SDK, першим кроком є його встановлення. SDK доступний для безкоштовного завантаження в репозиторії PIP і GitHub. Тепер нам потрібно виконати наступну команду в терміналі/командному рядку, щоб виконати інсталяцію.

pip install asposepdfcloud

Безкоштовний обліковий запис Cloud Dashboard

Наступним важливим кроком є безкоштовна підписка на наші хмарні сервіси через інформаційну панель Aspose.Cloud. Метою цієї підписки є надання лише авторизованим особам доступу до наших служб обробки файлів. Якщо у вас є обліковий запис GitHub або Google, просто зареєструйтеся або натисніть кнопку Створити новий обліковий запис і надайте необхідну інформацію. Тепер увійдіть на інформаційну панель, використовуючи облікові дані, розгорніть розділ «Програми» на інформаційній панелі та прокрутіть униз до розділу «Облікові дані клієнта», щоб переглянути дані про ідентифікатор клієнта та секрет клієнта.

Облікові дані клієнта

Зображення 1: облікові дані клієнта на інформаційній панелі Aspose.Cloud.

Читайте властивості відображення PDF за допомогою Python

Скористайтеся наведеним нижче фрагментом коду, щоб прочитати параметри програми перегляду 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)

        # створити екземпляр 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)

Зразок PDF-документа, використаного у наведеному вище прикладі, можна завантажити з PdfWithEmbeddedFiles.pdf.

Оновіть властивості відображення PDF за допомогою Python

У цьому розділі ми збираємося обговорити кроки та відповідні деталі щодо встановлення властивостей відображення PDF за допомогою Python SDK. Однак перш ніж продовжувати, нам потрібно спочатку вивчити властивості та конкретні значення, які їм можна присвоїти.

Підтримувані властивості

| Власність | Опис |

| —————— | ———————— |

| Приховати панель інструментів | Прапорець, який визначає, чи приховувати панелі інструментів програми перегляду 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'
        }

        # виклик API для оновлення властивостей відображення 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)
оновлені параметри відображення pdf

Зображення 2: - Попередній перегляд оновлених параметрів відображення PDF.

Читайте властивості відображення PDF за допомогою cURL

Доступ до API REST також можна отримати за допомогою команд cURL, а оскільки Aspose.PDF Cloud розроблено відповідно до архітектури REST, ми також можемо отримати доступ до API за допомогою команди cURL. Однак, перш ніж виконувати будь-яку операцію з маніпулюванням документом, нам потрібно створити веб-токен 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 нам може знадобитися виконати наступну команду 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>"

Оновіть властивості відображення 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. Ці вимоги можна виконати за допомогою фрагментів коду Python, а також за допомогою команд cURL. Ми також рекомендуємо ознайомитися з Посібником розробника, щоб дізнатися про інші цікаві функції, які пропонує API. Крім того, повний вихідний код Aspose.PDF Cloud SDK для Python доступний для завантаження на GitHub. Якщо у вас виникнуть проблеми під час використання API або у вас виникнуть додаткові запитання, будь ласка, зв’яжіться з нами через безкоштовний форум підтримки продуктів.

Схожі статті

Ми також рекомендуємо відвідати такі посилання, щоб дізнатися більше про: