Kiểm soát Thuộc tính Hiển thị PDF bằng Python

Các tệp PDF có một tính năng độc đáo để lưu trữ các tùy chọn chế độ xem cho phép chúng ta kiểm soát cách ứng dụng trình xem sẽ hiển thị tài liệu PDF. Do đó, từ điển tùy chọn trình xem của tài liệu PDF cho phép bạn kiểm soát cách tài liệu sẽ được trình bày trên màn hình hoặc khi in.

Xin lưu ý rằng chúng ta có thể kiểm soát các thuộc tính hiển thị của trình xem PDF. Bao gồm kiểm soát việc hiển thị tiêu đề tài liệu PDF, ẩn hoặc hiển thị Thanh menu, ẩn/hiện Thanh trạng thái, ẩn/hiển thị Giao diện người dùng cửa sổ. Kiểm soát cách thiết lập bố cục trang, chế độ trang và bố cục trang. Phần lớn các ứng dụng xử lý PDF đều hỗ trợ các thao tác này. Nhưng đối với các thao tác cập nhật hàng loạt, giải pháp theo chương trình là giải pháp hiệu quả. Trong bài viết này, chúng ta sẽ thảo luận về các chi tiết và các bước về cách kiểm soát các thuộc tính hiển thị PDF bằng Python.

• SDK thao tác PDF
• Đọc Thuộc tính Hiển thị PDF bằng Python
• Cập nhật Thuộc tính Hiển thị PDF bằng Python
• Đọc Thuộc tính Hiển thị PDF bằng cURL
• Cập nhật Thuộc tính Hiển thị PFDF bằng cURL

SDK thao tác PDF

Aspose.PDF Cloud là một API dựa trên REST cho phép các nhà phát triển triển khai các tính năng tạo, thao tác và hiển thị PDF trong các ứng dụng của họ. Với ít dòng mã hơn, bạn có thể phát triển các ứng dụng xử lý PDF ấn tượng. Không cần cài đặt phần mềm cụ thể nào và bạn có thể thực hiện tất cả các hoạt động xử lý PDF trên Cloud. Để tạo điều kiện thuận lợi hơn cho các nhà phát triển của mình, chúng tôi đã tạo Aspose.PDF Cloud SDK cho Python, đây là một trình bao bọc xung quanh Aspose.PDF Cloud. Vì vậy, để bắt đầu với SDK này, bước đầu tiên là cài đặt nó. SDK có sẵn để tải xuống miễn phí qua kho lưu trữ PIP và GitHub. Bây giờ chúng ta cần thực hiện lệnh sau trong terminal/dấu nhắc lệnh để thực hiện cài đặt.

pip install asposepdfcloud
Sao chép

Tài khoản Cloud Dashboard miễn phí

Bước quan trọng tiếp theo là đăng ký miễn phí dịch vụ đám mây của chúng tôi thông qua bảng điều khiển Aspose.Cloud. Mục đích của đăng ký này là chỉ cho phép những người được ủy quyền truy cập vào dịch vụ xử lý tệp của chúng tôi. Nếu bạn có tài khoản GitHub hoặc Google, chỉ cần Đăng ký hoặc nhấp vào nút Tạo tài khoản mới và cung cấp thông tin bắt buộc. Bây giờ hãy đăng nhập vào bảng điều khiển bằng thông tin xác thực và mở rộng phần Ứng dụng từ bảng điều khiển và cuộn xuống phần Thông tin xác thực của khách hàng để xem thông tin chi tiết về ID khách hàng và Bí mật khách hàng.

Đọc Thuộc tính Hiển thị PDF bằng Python

Vui lòng sử dụng đoạn mã dưới đây để đọc tùy chọn trình xem PDF và hiển thị chúng trong bảng điều khiển.

• Đầu tiên, tạo một thể hiện của lớp ApiClient trong khi cung cấp Client ID Client Secret làm đối số
• Thứ hai, tạo một thể hiện của lớp PdfApi lấy đối tượng ApiClient làm đối số đầu vào
• Cuối cùng, gọi phương thức getdocumentdisplayproperties(…) để lấy các tùy chọn của người xem 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)

        # tạo phiên bản PdfApi trong khi truyền PdfApiClient làm đối số
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'

        # gọi API để đọc các thuộc tính hiển thị PDF bằng Python
        response = pdf_api.get_document_display_properties(name = input_file)
        
        # in phản hồi trong bảng điều khiển
        print(response)
        
        # in tin nhắn trong bảng điều khiển (tùy chọn)
        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)
Sao chép

Tài liệu PDF mẫu được sử dụng trong ví dụ trên có thể được tải xuống từ PdfWithEmbeddedFiles.pdf.

Cập nhật Thuộc tính Hiển thị PDF bằng Python

Trong phần này, chúng ta sẽ thảo luận về các bước và chi tiết liên quan về cách thiết lập thuộc tính hiển thị PDF bằng Python SDK. Tuy nhiên, trước khi tiếp tục, trước tiên chúng ta cần tìm hiểu các thuộc tính và các giá trị cụ thể có thể được gán cho chúng.

Thuộc tính được hỗ trợ

| Bất động sản | Mô tả |

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

| HideToolbar | Một cờ chỉ định xem có nên ẩn thanh công cụ của ứng dụng xem pdf khi tài liệu đang hoạt động hay không |

| HideMenuBar | Một cờ chỉ định xem có nên ẩn thanh menu của ứng dụng xem pdf khi tài liệu đang hoạt động hay không. |

| HideWindowUI | Một cờ chỉ định xem có ẩn các thành phần giao diện người dùng trong cửa sổ tài liệu hay không (chẳng hạn như thanh cuộn và điều khiển điều hướng), chỉ để lại nội dung của tài liệu được hiển thị. |

| FitWindow | Một cờ chỉ định xem có nên thay đổi kích thước cửa sổ tài liệu để vừa với kích thước của trang đầu tiên được hiển thị hay không. |

| CenterWindow | Một cờ chỉ định xem có nên đặt cửa sổ tài liệu ở giữa màn hình hay không. |

| DisplayDocTitle | Một cờ chỉ định xem thanh tiêu đề của cửa sổ có hiển thị tiêu đề tài liệu hay không. |

| PageMode | Chế độ trang tài liệu khi tài liệu pdf được mở trong trình xem pdf. Các giá trị có thể: UseNone – Không hiển thị cả phác thảo tài liệu (dấu trang) lẫn hình ảnh thu nhỏ. UseOutlines – Hiển thị phác thảo tài liệu (dấu trang).UseThumbs – Hiển thị hình ảnh thu nhỏ. FullScreenFull – chế độ màn hình, không hiển thị thanh menu, điều khiển cửa sổ hoặc bất kỳ cửa sổ nào khác. UseOC – Hiển thị bảng nhóm nội dung tùy chọn. UseAttachments – Hiển thị tệp đính kèm tài liệu. |

| PageLayout | Bố cục trang sẽ được sử dụng khi tài liệu được mở. Các giá trị có thể: SinglePage – Hiển thị một trang tại một thời điểm. OneColumn – Hiển thị các trang trong một cột. TwoColumnLeft – Hiển thị các trang trong hai cột, với các trang có số lẻ ở bên trái. TwoColumnRight – Hiển thị các trang trong hai cột, với các trang có số lẻ ở bên phải. |

| NonFullScreenPageMode | Chế độ trang tài liệu khi ứng dụng xem pdf thoát khỏi chế độ toàn màn hình. Các giá trị có thể: UseNone – Không hiển thị phác thảo tài liệu (dấu trang) hoặc hình ảnh thu nhỏ. UseOutlines – Hiển thị phác thảo tài liệu (dấu trang).UseThumbs – Hiển thị hình ảnh thu nhỏ. UseOC – Hiển thị bảng nhóm nội dung tùy chọn. |

• Tạo một thể hiện của lớp ApiClient trong khi cung cấp Client ID và Client Secret làm đối số.
• Sau đó tạo một thể hiện của lớp PdfApi lấy đối tượng ApiClient làm đối số đầu vào.
• Bây giờ hãy tạo một phiên bản của DocumentProperties để xác định các thuộc tính hiển thị mới cho PDF.
• Cuối cùng, gọi putdocumentdisplayproperties(…) để thiết lập thuộc tính hiển thị mới cho tệp 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)

        # tạo phiên bản PdfApi trong khi truyền PdfApiClient làm đối số
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'
        
        # Thuộc tính hiển thị tài liệu
        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'
        }

        # gọi API để cập nhật thuộc tính hiển thị PDF
        response = pdf_api.put_document_display_properties(name = input_file, display_properties=newDocumentProperties)
        
        # in phản hồi trong bảng điều khiển
        print(response)
        
        # in tin nhắn trong bảng điều khiển (tùy chọn)
        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)
Sao chép

Đọc Thuộc tính Hiển thị PDF bằng cURL

REST API cũng có thể được truy cập thông qua lệnh cURL và vì Aspose.PDF Cloud được phát triển theo kiến trúc REST, nên chúng ta cũng có thể truy cập API bằng lệnh cURL. Tuy nhiên, trước khi thực hiện bất kỳ thao tác xử lý tài liệu nào, chúng ta cần tạo JSON Web Token (JWT) dựa trên thông tin xác thực của từng khách hàng được chỉ định trên bảng điều khiển Aspose.Cloud. Điều này là bắt buộc vì API của chúng tôi chỉ có thể truy cập được đối với người dùng đã đăng ký. Vui lòng thực hiện lệnh sau để tạo mã thông báo 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"
Sao chép

Sau khi mã thông báo JWT được tạo, chúng ta có thể cần thực thi lệnh cURL sau để đọc thuộc tính hiển thị PDF.

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

Cập nhật Thuộc tính Hiển thị PDF bằng cURL

Lệnh cURL cũng có thể được sử dụng để cập nhật thuộc tính hiển thị của tài liệu PDF và tệp kết quả sẽ được lưu lại trên bộ nhớ đám mây.

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\"}"
Sao chép

Phần kết luận

Trong bài viết này, chúng tôi đã khám phá các chi tiết và các bước về cách đọc và kiểm soát các thuộc tính hiển thị PDF. Những yêu cầu này có thể được thực hiện bằng cách sử dụng các đoạn mã Python cũng như sử dụng các lệnh cURL. Chúng tôi cũng khuyên bạn nên khám phá Hướng dẫn dành cho nhà phát triển để tìm hiểu về các tính năng thú vị khác do API cung cấp. Hơn nữa, mã nguồn đầy đủ của Aspose.PDF Cloud SDK dành cho Python đã có sẵn để tải xuống qua GitHub. Trong trường hợp bạn gặp bất kỳ sự cố nào khi sử dụng API hoặc có bất kỳ thắc mắc nào khác, vui lòng liên hệ với chúng tôi qua Diễn đàn hỗ trợ sản phẩm miễn phí.

Bài viết liên quan

Chúng tôi cũng khuyên bạn nên truy cập vào các liên kết sau để tìm hiểu thêm về:

• PDF sang hình ảnh – Chuyển đổi PDF sang JPEG trong Python
• Tải xuống tệp đính kèm từ PDF bằng Python
• Thêm hoặc xóa trang PDF bằng Python
• Tìm và thay thế văn bản trong PDF bằng Python
• Trích xuất hình ảnh từ PDF trong Python
• Trích xuất văn bản từ PDF bằng Python