Vezérelje a PDF megjelenítési tulajdonságait Python segítségével

A PDF fájlok egyedülálló funkcióval rendelkeznek a nézetbeállítások tárolására, amelyek lehetővé teszik számunkra annak vezérlését, hogy a megjelenítő alkalmazás hogyan jelenítse meg a PDF-dokumentumot. Ezért a PDF-dokumentum nézői preferenciáinak szótára lehetővé teszi a dokumentum képernyőn vagy nyomtatásban való megjelenítésének módját.

Felhívjuk figyelmét, hogy a PDF-megtekintők megjelenítési tulajdonságait szabályozhatjuk. Ez magában foglalja a PDF dokumentum címének megjelenítésének vezérlését, a menüsor elrejtését vagy megjelenítését, az állapotsor elrejtését/megjelenítését, az ablak elrejtésének/megjelenítésének kezelőfelületét. Szabályozza az oldalelrendezés, az oldalmód és az oldalelrendezés beállítását. A PDF-feldolgozó alkalmazások többsége támogatja ezeket a műveleteket. A tömeges frissítési műveleteknél azonban a programozott megoldás hatékony megoldás. Ebben a cikkben a PDF-megjelenítési tulajdonságok Python használatával történő szabályozásának részleteiről és lépéseiről fogunk beszélni.

• PDF Manipulation SDK
• Olvassa el a PDF megjelenítési tulajdonságait a Python használatával
• Frissítse a PDF megjelenítési tulajdonságait Python segítségével
• Olvassa el a PDF megjelenítési tulajdonságait a cURL használatával
• Frissítse a PFDF megjelenítési tulajdonságait a cURL használatával

PDF Manipulation SDK

Az Aspose.PDF Cloud egy REST-alapú API, amely lehetővé teszi a fejlesztők számára, hogy PDF-készítési, -manipulációs és -megjelenítési funkciókat implementáljanak alkalmazásaikba. Kevesebb kódsorral lenyűgöző PDF-feldolgozó alkalmazásokat fejleszthet. Nincs szükség speciális szoftver telepítésére, és az összes PDF-feldolgozási műveletet elvégezheti a felhőben. Fejlesztőink további megkönnyítése érdekében létrehoztuk Aspose.PDF Cloud SDK for Python, amely az Aspose.PDF Cloud köré épül. Tehát az SDK használatának megkezdéséhez az első lépés a telepítés. Az SDK ingyenesen letölthető PIP és GitHub tárhelyen keresztül. Most végre kell hajtanunk a következő parancsot a terminálban/parancssorban a telepítés végrehajtásához.

pip install asposepdfcloud
copy

Ingyenes Cloud Dashboard-fiók

A következő nagy lépés egy ingyenes előfizetés felhőszolgáltatásainkra az Aspose.Cloud dashboard oldalon. Ennek az előfizetésnek az a célja, hogy csak arra jogosult személyek férhessenek hozzá fájlfeldolgozó szolgáltatásainkhoz. Ha rendelkezik GitHub- vagy Google-fiókkal, egyszerűen regisztráljon, vagy kattintson az Új fiók létrehozása gombra, és adja meg a szükséges információkat. Most jelentkezzen be az irányítópultra a hitelesítési adatokkal, és bontsa ki az Alkalmazások részt az irányítópulton, és görgessen lefelé az Ügyfél hitelesítő adatai szakasz felé, hogy megtekinthesse az ügyfél-azonosítót és az ügyféltitkot.

Olvassa el a PDF megjelenítési tulajdonságait a Python használatával

Kérjük, használja az alábbi kódrészletet a PDF-megjelenítő beállításainak elolvasásához és a konzolon való megjelenítéséhez.

• Először is hozzon létre egy példányt az ApiClient osztályból, miközben argumentumként adja meg a Client ID Client Secretet
• Másodszor, hozzon létre egy példányt a PdfApi osztályból, amely az ApiClient objektumot veszi be bemeneti argumentumként
• Végül hívja meg a getdocumentdisplayproperties(…) metódust a PDF-megtekintő beállításainak lekéréséhez

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)

        # hozzon létre PdfApi példányt, miközben a PdfApiClient argumentumként adja át
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'

        # hívja meg az API-t a PDF megjelenítési tulajdonságainak Python használatával történő olvasásához
        response = pdf_api.get_document_display_properties(name = input_file)
        
        # válasz kinyomtatása a konzolon
        print(response)
        
        # üzenet nyomtatása a konzolon (opcionális)
        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

A fenti példában használt minta PDF dokumentum letölthető a PdfWithEmbeddedFiles.pdf webhelyről.

Frissítse a PDF megjelenítési tulajdonságait Python segítségével

Ebben a részben a PDF-megjelenítési tulajdonságok Python SDK használatával történő beállításának lépéseit és kapcsolódó részleteit tárgyaljuk. Mielőtt azonban továbblépnénk, először meg kell tanulnunk a tulajdonságokat és a hozzájuk rendelhető konkrét értékeket.

Támogatott tulajdonságok

| Ingatlan | Leírás |

| —————— | ————————- |

| Eszköztár elrejtése | Jelző, amely megadja, hogy el kell-e rejteni a PDF-nézegető alkalmazás eszköztárait, amikor a dokumentum aktív |

| HideMenuBar | Jelző, amely megadja, hogy el kell-e rejteni a PDF-nézegető alkalmazás menüsorát, amikor a dokumentum aktív. |

| HideWindowUI | Jelző, amely megadja, hogy el kell-e rejteni a felhasználói felület elemeit a dokumentum ablakában (például görgetősávok és navigációs vezérlők), és csak a dokumentum tartalma marad látható. |

| FitWindow | Jelző, amely megadja, hogy át kell-e méretezni a dokumentum ablakát, hogy az illeszkedjen az első megjelenített oldal méretéhez. |

| CenterWindow | Jelző, amely megadja, hogy a dokumentum ablakát a képernyő közepére kell-e helyezni. |

| DisplayDocTitle | Jelző, amely megadja, hogy az ablak címsorában megjelenjen-e a dokumentum címe. |

| PageMode | A dokumentumoldal mód, amikor a pdf dokumentumot pdf-nézegetőben nyitják meg. Lehetséges értékek: UseNone – Sem a dokumentum körvonala (könyvjelzők), sem a miniatűrök nem láthatók. UseOutlines – A dokumentum vázlata (könyvjelzők) látható. UseThumbs – Az indexképek láthatók. FullScreenFull – képernyő mód, nem látható menüsor, ablakvezérlők vagy bármely más ablak. UseOC – Az opcionális tartalomcsoport panel látható. UseAttachments – A dokumentummellékletek láthatók. |

| Oldalelrendezés | Az oldalelrendezést a dokumentum megnyitásakor kell használni. Lehetséges értékek: SinglePage – Egyszerre egy oldalt jelenít meg. OneColumn – Egy oszlopban jeleníti meg az oldalakat. TwoColumnLeft – Az oldalakat két oszlopban jeleníti meg, páratlan számú oldalakkal a bal oldalon. TwoColumnRight – Két oszlopban jeleníti meg az oldalakat, a jobb oldalon páratlan számú oldalakkal. |

| NonFullScreenPageMode | A dokumentumoldal mód, amikor a PDF-nézegető alkalmazás kilép a teljes képernyős módból. Lehetséges értékek: UseNone – Sem a dokumentum körvonala (könyvjelzők), sem a miniatűrök nem láthatók. UseOutlines – A dokumentum vázlata (könyvjelzők) látható. UseThumbs – Az indexképek láthatók. UseOC – Az opcionális tartalomcsoport panel látható. |

• Hozzon létre egy példányt az ApiClient osztályból, miközben argumentumként adja meg a Client ID Client Secretet.
• Ezután hozzon létre egy példányt a PdfApi osztályból, amely az ApiClient objektumot veszi be bemeneti argumentumként.
• Most hozza létre a DocumentProperties egy példányát, amely új megjelenítési tulajdonságokat határoz meg a PDF megjelenítéshez.
• Végül hívja meg a putdocumentdisplayproperties(…) parancsot a PDF-fájl új megjelenítési tulajdonságainak beállításához.

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)

        # hozzon létre PdfApi példányt, miközben a PdfApiClient argumentumként adja át
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'
        
        # A dokumentum megjelenítési tulajdonságai
        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'
        }

        # hívja meg az API-t a PDF megjelenítési tulajdonságainak frissítéséhez
        response = pdf_api.put_document_display_properties(name = input_file, display_properties=newDocumentProperties)
        
        # válasz kinyomtatása a konzolon
        print(response)
        
        # üzenet nyomtatása a konzolon (opcionális)
        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

Olvassa el a PDF megjelenítési tulajdonságait a cURL használatával

A REST API-k a cURL parancsokkal is elérhetők, és mivel az Aspose.PDF Cloud a REST architektúrának megfelelően lett kifejlesztve, így a cURL paranccsal is elérhetjük az API-t. Mielőtt azonban bármilyen dokumentumkezelési műveletet végrehajtanánk, létre kell hoznunk egy JSON Web Tokent (JWT) az Aspose.Cloud irányítópulton megadott egyéni kliens hitelesítő adatai alapján. Kötelező, mert API-jaink csak regisztrált felhasználók számára érhetők el. Kérjük, hajtsa végre a következő parancsot a JWT token generálásához.

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

A JWT token létrehozása után a következő cURL parancsot kell végrehajtanunk a PDF megjelenítési tulajdonságainak olvasásához.

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

Frissítse a PDF megjelenítési tulajdonságait a cURL használatával

A cURL parancs a PDF-dokumentumok megjelenítési tulajdonságainak frissítésére is használható, és az eredményül kapott fájl ismét felhőtárhelyre kerül.

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

Következtetés

Ebben a cikkben megvizsgáltuk a PDF-megjelenítési tulajdonságok olvasásának és vezérlésének részleteit és lépéseit. Ezek a követelmények teljesíthetők Python kódrészletekkel, valamint a cURL parancsokkal. Azt is javasoljuk, hogy tekintse át a Fejlesztői útmutatót, hogy megismerje az API által kínált egyéb izgalmas funkciókat. Ezenkívül a Pythonhoz készült Aspose.PDF Cloud SDK teljes forráskódja letölthető GitHub-on keresztül. Ha bármilyen problémába ütközik az API használata során, vagy további kérdései vannak, forduljon hozzánk bizalommal az Ingyenes terméktámogatási fórumon.

Kapcsolódó cikkek

Javasoljuk továbbá, hogy látogassa meg az alábbi linkeket, ha többet szeretne megtudni erről:

• PDF-ből kép – PDF konvertálása JPEG-be a Pythonban
• Töltse le a mellékletet PDF-ből Python segítségével
• PDF-oldalak hozzáadása vagy eltávolítása a Python használatával
• Szöveg keresése és cseréje PDF-ben Python segítségével
• Képek kibontása PDF-ből Pythonban
• Szöveg kibontása a PDF-ből Pythonban