Styr PDF-skærmegenskaber ved hjælp af Python

PDF-filerne har en unik funktion til at holde visningspræferencerne, der gør det muligt for os at kontrollere, hvordan fremviserapplikationen vil vise PDF-dokumentet. Derfor giver seerpræferenceordbogen for et PDF-dokument dig mulighed for at kontrollere, hvordan dokumentet skal præsenteres på skærmen eller på tryk.

Bemærk venligst, at vi kan kontrollere visningsegenskaberne for PDF-fremviserne. Det omfatter styring af visningen af PDF-dokumentets titel, skjul eller visning af menulinje, skjul/vis statuslinje, skjul/vis vindues-UI. Styr, hvordan du opsætter sidelayout, sidetilstand og sidelayout. De fleste PDF-behandlingsapplikationer understøtter disse operationer. Men til masseopdateringsoperationer er en programmatisk løsning en effektiv løsning. I denne artikel vil vi diskutere detaljerne og trinene til, hvordan man kontrollerer PDF-visningsegenskaber ved hjælp af Python.

• PDF-manipulation SDK
• Læs PDF-skærmegenskaber ved hjælp af Python
• Opdater PDF-skærmegenskaber ved hjælp af Python
• Læs PDF-skærmegenskaber ved hjælp af cURL
• Opdater PFDF-skærmegenskaber ved hjælp af cURL

PDF-manipulation SDK

Aspose.PDF Cloud er en REST-baseret API, der gør det muligt for udviklere at implementere PDF-oprettelse, manipulation og gengivelsesfunktioner i deres applikationer. Med færre kodelinjer kan du udvikle imponerende PDF-behandlingsapplikationer. Der kræves ingen specifik softwareinstallation, og du kan udføre alle PDF-behandlingshandlinger i skyen. For yderligere at lette vores udviklere har vi skabt Aspose.PDF Cloud SDK til Python, som er en indpakning omkring Aspose.PDF Cloud. Så for at komme i gang med denne SDK, er det første trin dens installation. SDK’et er tilgængeligt til gratis download over PIP og GitHub repository. Nu skal vi udføre følgende kommando i terminal/kommandoprompten for at udføre installationen.

pip install asposepdfcloud
kopier

Gratis Cloud Dashboard-konto

Det næste store skridt er et gratis abonnement på vores cloud-tjenester via Aspose.Cloud dashboard. Formålet med dette abonnement er kun at give autoriserede personer adgang til vores filbehandlingstjenester. Hvis du har en GitHub- eller Google-konto, skal du blot tilmelde dig eller klikke på knappen Opret en ny konto og angive de nødvendige oplysninger. Log nu ind på dashboardet ved hjælp af legitimationsoplysninger og udvid applikationssektionen fra dashboardet, og rul ned mod sektionen Klientlegitimationsoplysninger for at se klient-id og klienthemmelighedsoplysninger.

Læs PDF-skærmegenskaber ved hjælp af Python

Brug venligst kodestykket nedenfor til at læse PDF-fremviserpræferencer og vise dem i konsollen.

• For det første skal du oprette en forekomst af ApiClient-klassen, mens du angiver Client ID Client Secret som argumenter
• For det andet skal du oprette en forekomst af PdfApi-klassen, som tager ApiClient-objektet som input-argument
• Til sidst skal du kalde getdocumentdisplayproperties(…)-metoden for at hente PDF-viewere-præferencer

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)

        # opret PdfApi-instans, mens du sender PdfApiClient som argument
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'

        # kalde API for at læse PDF-visningsegenskaber ved hjælp af Python
        response = pdf_api.get_document_display_properties(name = input_file)
        
        # udskriv svar i konsollen
        print(response)
        
        # udskriv besked i konsollen (valgfrit)
        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)
kopier

Eksempel PDF-dokumentet brugt i ovenstående eksempel kan downloades fra PdfWithEmbeddedFiles.pdf.

Opdater PDF-skærmegenskaber ved hjælp af Python

I dette afsnit skal vi diskutere trinene og relaterede detaljer om, hvordan du indstiller PDF-visningsegenskaber ved hjælp af Python SDK. Men før vi går videre, skal vi først lære egenskaberne og de specifikke værdier, der kan tildeles dem.

Understøttede egenskaber

| Ejendom | Beskrivelse |

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

| SkjulToolbar | Et flag, der angiver, om pdf-fremviserens værktøjslinjer skal skjules, når dokumentet er aktivt |

| HideMenuBar | Et flag, der angiver, om pdf-fremviserens menulinje skal skjules, når dokumentet er aktivt. |

| HideWindowUI | Et flag, der angiver, om brugergrænsefladeelementer skal skjules i dokumentets vindue (såsom rullepaneler og navigationskontroller), så kun dokumentets indhold vises. |

| FitWindow | Et flag, der angiver, om dokumentets vindue skal ændres, så det passer til størrelsen på den først viste side. |

| CenterWindow | Et flag, der angiver, om dokumentets vindue skal placeres i midten af skærmen. |

| DisplayDocTitle | Et flag, der angiver, om vinduets titellinje skal vise dokumentets titel. |

| Sidetilstand | Dokumentsidetilstanden, når pdf-dokumentet åbnes i en pdf-fremviser. Mulige værdier: UseNone – Hverken dokumentkontur (bogmærker) eller miniaturebilleder er synlige. UseOutlines – Dokumentomrids (bogmærker) er synlige. UseThumbs – Miniaturebilleder er synlige. FullScreenFull – skærmtilstand, uden menulinje, vindueskontroller eller andet synligt vindue. UseOC – Valgfrit indholdsgruppepanel er synligt. Brug vedhæftede filer – Dokumentvedhæftede filer er synlige. |

| Sidelayout | Sidelayoutet skal bruges, når dokumentet åbnes. Mulige værdier: SinglePage – Viser én side ad gangen. OneColumn – Viser siderne i én kolonne. TwoColumnLeft – Viser siderne i to kolonner med sider med ulige numre til venstre. TwoColumnRight – Viser siderne i to kolonner med ulige sider til højre. |

| NonFullScreenPageMode | Dokumentsidetilstanden, når pdf-fremviseren afslutter fuldskærmstilstanden. Mulige værdier: UseNone – Hverken dokumentkontur (bogmærker) eller miniaturebilleder er synlige. UseOutlines – Dokumentomrids (bogmærker) er synlige. UseThumbs – Miniaturebilleder er synlige. UseOC – Valgfrit indholdsgruppepanel er synligt. |

• Opret en forekomst af ApiClient-klassen, mens du leverer Client ID Client Secret som argumenter.
• Opret derefter en instans af PdfApi-klassen, som tager ApiClient-objektet som input-argument.
• Opret nu en forekomst af DocumentProperties, som definerer nye visningsegenskaber for PDF-visning.
• Til sidst skal du kalde putdocumentdisplayproperties(…) for at indstille nye visningsegenskaber for PDF-filen.

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)

        # opret PdfApi-instans, mens du sender PdfApiClient som argument
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'
        
        # Dokumentvisningsegenskaber
        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'
        }

        # kald API for at opdatere PDF-visningsegenskaber
        response = pdf_api.put_document_display_properties(name = input_file, display_properties=newDocumentProperties)
        
        # udskriv svar i konsollen
        print(response)
        
        # udskriv besked i konsollen (valgfrit)
        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)
kopier

Læs PDF-skærmegenskaber ved hjælp af cURL

REST API’erne kan også tilgås via cURL-kommandoer, og da Aspose.PDF Cloud er udviklet i henhold til REST-arkitekturen, så kan vi også få adgang til API’et ved hjælp af cURL-kommandoen. Før vi udfører nogen dokumentmanipulationsoperation, skal vi dog generere et JSON Web Token (JWT) baseret på dine individuelle klientoplysninger angivet over Aspose.Cloud-dashboard. Det er obligatorisk, fordi vores API’er kun er tilgængelige for registrerede brugere. Udfør venligst følgende kommando for at generere JWT-tokenet.

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"
kopier

Når først JWT-tokenet er genereret, kan vi være nødt til at udføre følgende cURL-kommando for at læse PDF-visningsegenskaber.

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

Opdater PDF-skærmegenskaber ved hjælp af cURL

cURL-kommandoen kan også bruges til at opdatere visningsegenskaberne for PDF-dokumenter, og den resulterende fil gemmes igen i skylageret.

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\"}"
kopier

Konklusion

I denne artikel har vi udforsket detaljerne og trinene til, hvordan man læser og kontrollerer PDF-visningsegenskaber. Disse krav kan opnås ved hjælp af Python-kodestykker såvel som ved hjælp af cURL-kommandoer. Vi anbefaler også, at du udforsker udviklervejledningen for at lære om andre spændende funktioner, der tilbydes af API. Ydermere er den komplette kildekode til Aspose.PDF Cloud SDK til Python blevet gjort tilgængelig til download over GitHub. I tilfælde af at du støder på problemer, mens du bruger API’et, eller du har yderligere spørgsmål, er du velkommen til at kontakte os via Free product support forum.

Relaterede artikler

Vi anbefaler også, at du besøger følgende links for at lære mere om:

• PDF til billede - Konverter PDF til JPEG i Python
• Download vedhæftet fil fra PDF ved hjælp af Python
• Tilføj eller fjern PDF-sider ved hjælp af Python
• Find og erstat tekst i PDF ved hjælp af Python
• Uddrag billeder fra PDF i Python
• Uddrag tekst fra PDF i Python