ควบคุมคุณสมบัติการแสดง PDF โดยใช้ Python

ไฟล์ PDF มีคุณสมบัติพิเศษในการกำหนดลักษณะมุมมองที่ช่วยให้เราควบคุมได้ว่าแอปพลิเคชันสำหรับดูจะแสดงเอกสาร PDF อย่างไร ดังนั้นพจนานุกรมการกำหนดลักษณะสำหรับดูของเอกสาร PDF จะช่วยให้คุณควบคุมวิธีการนำเสนอเอกสารบนหน้าจอหรือในการพิมพ์ได้

โปรดทราบว่าเราสามารถควบคุมคุณสมบัติการแสดงผลของโปรแกรมอ่าน PDF ได้ ซึ่งรวมถึงการควบคุมการแสดงชื่อเอกสาร PDF การซ่อนหรือแสดงแถบเมนู การซ่อน/แสดงแถบสถานะ การซ่อน/แสดง UI ของหน้าต่าง ควบคุมวิธีการตั้งค่าเค้าโครงหน้า โหมดหน้า และเค้าโครงหน้า แอปพลิเคชันประมวลผล PDF ส่วนใหญ่รองรับการทำงานเหล่านี้ แต่สำหรับการดำเนินการอัปเดตจำนวนมาก โซลูชันเชิงโปรแกรมเป็นโซลูชันที่มีประสิทธิภาพ ในบทความนี้ เราจะหารือเกี่ยวกับรายละเอียดและขั้นตอนต่างๆ เกี่ยวกับวิธีการควบคุมคุณสมบัติการแสดงผล PDF โดยใช้ Python

• SDK การจัดการ PDF
• อ่านคุณสมบัติการแสดงผล PDF โดยใช้ Python
• อัปเดตคุณสมบัติการแสดง PDF โดยใช้ Python
• อ่านคุณสมบัติการแสดงผล PDF โดยใช้ cURL
• อัปเดตคุณสมบัติการแสดงผล PFDF โดยใช้ cURL

SDK การจัดการ PDF

Aspose.PDF Cloud เป็น API ที่ใช้ REST ช่วยให้นักพัฒนาสามารถนำคุณลักษณะการสร้าง การจัดการ และการเรนเดอร์ PDF ไปใช้กับแอปพลิเคชันของตนได้ ด้วยโค้ดเพียงไม่กี่บรรทัด คุณก็สามารถพัฒนาแอปพลิเคชันประมวลผล PDF ที่น่าประทับใจได้ ไม่จำเป็นต้องติดตั้งซอฟต์แวร์เฉพาะใดๆ และคุณสามารถดำเนินการประมวลผล PDF ทั้งหมดบนคลาวด์ได้ เพื่ออำนวยความสะดวกแก่นักพัฒนาของเราเพิ่มเติม เราจึงได้สร้าง Aspose.PDF Cloud SDK สำหรับ Python ซึ่งเป็นตัวห่อหุ้ม Aspose.PDF Cloud ดังนั้นเพื่อเริ่มต้นใช้งาน SDK นี้ ขั้นตอนแรกคือการติดตั้ง SDK พร้อมให้ดาวน์โหลดฟรีที่ PIP และที่เก็บ GitHub ตอนนี้ เราต้องดำเนินการคำสั่งต่อไปนี้ในเทอร์มินัล/พรอมต์คำสั่งเพื่อดำเนินการติดตั้ง

pip install asposepdfcloud
copy

บัญชีแดชบอร์ดคลาวด์ฟรี

ขั้นตอนสำคัญต่อไปคือการสมัครใช้บริการคลาวด์ของเราฟรีผ่าน แดชบอร์ด Aspose.Cloud วัตถุประสงค์ของการสมัครใช้งานนี้คือเพื่อให้เฉพาะบุคคลที่ได้รับอนุญาตเท่านั้นที่สามารถเข้าถึงบริการประมวลผลไฟล์ของเราได้ หากคุณมีบัญชี GitHub หรือ Google เพียงลงทะเบียนหรือคลิกปุ่ม สร้างบัญชีใหม่ แล้วระบุข้อมูลที่จำเป็น จากนั้นเข้าสู่ระบบแดชบอร์ดโดยใช้ข้อมูลรับรอง แล้วขยายส่วนแอปพลิเคชันจากแดชบอร์ด จากนั้นเลื่อนลงไปที่ส่วนข้อมูลรับรองไคลเอนต์เพื่อดูรายละเอียดรหัสไคลเอนต์และความลับไคลเอนต์

อ่านคุณสมบัติการแสดงผล PDF โดยใช้ Python

โปรดใช้ชิ้นส่วนโค้ดที่ระบุไว้ด้านล่างเพื่ออ่านค่ากำหนดของโปรแกรมดู PDF และแสดงค่าเหล่านี้ในคอนโซล

• ขั้นแรก ให้สร้างอินสแตนซ์ของคลาส ApiClient โดยระบุรหัสไคลเอนต์และรหัสลับไคลเอนต์เป็นอาร์กิวเมนต์
• ประการที่สอง สร้างอินสแตนซ์ของคลาส PdfApi ซึ่งรับ ApiClient object เป็นอาร์กิวเมนต์อินพุต
• ในที่สุด เรียกใช้เมธอด 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 viewer ออกจากโหมดเต็มหน้าจอ ค่าที่เป็นไปได้: 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)
copy

อ่านคุณสมบัติการแสดงผล PDF โดยใช้ cURL

นอกจากนี้ยังสามารถเข้าถึง REST API ได้โดยใช้คำสั่ง cURL และเนื่องจาก Aspose.PDF Cloud ได้รับการพัฒนาตามสถาปัตยกรรม REST เราจึงสามารถเข้าถึง API ได้โดยใช้คำสั่ง cURL อย่างไรก็ตาม ก่อนที่จะดำเนินการจัดการเอกสารใดๆ เราจำเป็นต้องสร้าง JSON Web Token (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"
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 นอกจากนี้ เราขอแนะนำให้คุณอ่าน คู่มือสำหรับนักพัฒนา เพื่อเรียนรู้เกี่ยวกับคุณสมบัติที่น่าสนใจอื่นๆ ที่นำเสนอโดย API นอกจากนี้ ซอร์สโค้ดทั้งหมดของ Aspose.PDF Cloud SDK สำหรับ Python ยังพร้อมให้ดาวน์โหลดผ่าน GitHub หากคุณพบปัญหาใดๆ ในขณะใช้ API หรือมีคำถามเพิ่มเติม โปรดติดต่อเราผ่าน ฟอรัมสนับสนุนผลิตภัณฑ์ฟรี

บทความที่เกี่ยวข้อง

เราขอแนะนำให้เยี่ยมชมลิงค์ต่อไปนี้เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับ:

• PDF เป็นรูปภาพ – แปลง PDF เป็น JPEG ใน Python
• ดาวน์โหลดเอกสารแนบจาก PDF โดยใช้ Python
• เพิ่มหรือลบหน้า PDF โดยใช้ Python
• ค้นหาและแทนที่ข้อความใน PDF โดยใช้ Python
• ดึงภาพจาก PDF ใน Python
• การแยกข้อความจาก PDF ใน Python