controlla le proprietà di visualizzazione del PDF

I file PDF hanno una caratteristica unica per contenere le preferenze di visualizzazione che ci consentono di controllare il modo in cui l’applicazione di visualizzazione visualizzerà il documento PDF. Pertanto, il dizionario delle preferenze di visualizzazione di un documento PDF consente di controllare il modo in cui il documento deve essere presentato sullo schermo o in stampa.

Si noti che possiamo controllare le proprietà di visualizzazione dei visualizzatori PDF. Ciò include il controllo della visualizzazione del titolo del documento PDF, nascondere o mostrare la barra dei menu, nascondere/mostrare la barra di stato, nascondere/mostrare l’interfaccia utente della finestra. Controllare come impostare il layout di pagina, la modalità di pagina e il layout di pagina. La maggior parte delle applicazioni di elaborazione PDF supporta queste operazioni. Tuttavia, per le operazioni di aggiornamento in blocco, una soluzione programmatica è una soluzione efficace. In questo articolo, discuteremo i dettagli e i passaggi su come controllare le proprietà di visualizzazione PDF utilizzando Python.

SDK per la manipolazione dei PDF

Aspose.PDF Cloud è un’API basata su REST che consente agli sviluppatori di implementare funzionalità di creazione, manipolazione e rendering di PDF nelle loro applicazioni. Con meno righe di codice, puoi sviluppare impressionanti applicazioni di elaborazione PDF. Non è richiesta alcuna installazione software specifica e puoi eseguire tutte le operazioni di elaborazione PDF nel Cloud. Per facilitare ulteriormente i nostri sviluppatori, abbiamo creato Aspose.PDF Cloud SDK per Python che è un wrapper attorno ad Aspose.PDF Cloud. Quindi, per iniziare con questo SDK, il primo passo è la sua installazione. L’SDK è disponibile per il download gratuito tramite il repository PIP e GitHub. Ora dobbiamo eseguire il seguente comando nel terminale/prompt dei comandi per eseguire l’installazione.

pip install asposepdfcloud

Account gratuito per la dashboard cloud

Il prossimo passo importante è un abbonamento gratuito ai nostri servizi cloud tramite Aspose.Cloud dashboard. Lo scopo di questo abbonamento è consentire solo alle persone autorizzate di accedere ai nostri servizi di elaborazione file. Se hai un account GitHub o Google, registrati semplicemente o fai clic sul pulsante Crea un nuovo account e fornisci le informazioni richieste. Ora accedi alla dashboard utilizzando le credenziali ed espandi la sezione Applicazioni dalla dashboard e scorri verso il basso fino alla sezione Credenziali client per vedere i dettagli ID client e Segreto client.

Credenziali del cliente

Immagine 1: Credenziali del cliente nella dashboard di Aspose.Cloud.

Leggi le proprietà di visualizzazione PDF usando Python

Utilizzare il frammento di codice riportato di seguito per leggere le preferenze del visualizzatore PDF e visualizzarle nella console.

  • Innanzitutto, crea un’istanza della classe ApiClient fornendo l’ID client e il segreto client come argomenti
  • In secondo luogo, creare un’istanza della classe PdfApi che accetta l’oggetto ApiClient come argomento di input
  • Infine, chiama il metodo getdocumentdisplayproperties(…) per recuperare le preferenze del visualizzatore 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)

        # crea un'istanza di PdfApi passando PdfApiClient come argomento
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'

        # chiama l'API per leggere le proprietà di visualizzazione del PDF utilizzando Python
        response = pdf_api.get_document_display_properties(name = input_file)
        
        # stampa la risposta nella console
        print(response)
        
        # stampa messaggio nella console (facoltativo)
        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)

Il documento PDF di esempio utilizzato nell’esempio sopra può essere scaricato da PdfWithEmbeddedFiles.pdf.

Aggiorna le proprietà di visualizzazione PDF utilizzando Python

In questa sezione, discuteremo i passaggi e i dettagli correlati su come impostare le proprietà di visualizzazione PDF tramite Python SDK. Tuttavia, prima di procedere oltre, dobbiamo prima imparare le proprietà e i valori specifici che possono essere assegnati loro.

Proprietà supportate

| Proprietà | Descrizione |

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

| HideToolbar | Flag che specifica se nascondere le barre degli strumenti dell’applicazione di visualizzazione PDF quando il documento è attivo |

| HideMenuBar | Flag che specifica se nascondere la barra dei menu dell’applicazione di visualizzazione PDF quando il documento è attivo. |

| HideWindowUI | Flag che specifica se nascondere gli elementi dell’interfaccia utente nella finestra del documento (ad esempio barre di scorrimento e controlli di navigazione), lasciando visualizzato solo il contenuto del documento. |

| FitWindow | Flag che specifica se ridimensionare la finestra del documento per adattarla alle dimensioni della prima pagina visualizzata. |

| CenterWindow | Flag che specifica se posizionare la finestra del documento al centro dello schermo. |

| DisplayDocTitle | Flag che specifica se la barra del titolo della finestra deve visualizzare il titolo del documento. |

| PageMode | La modalità pagina del documento quando il documento PDF viene aperto in un visualizzatore PDF. Valori possibili: UseNone – Né il contorno del documento (segnalibri) né le immagini in miniatura sono visibili. UseOutlines – Il contorno del documento (segnalibri) è visibile. UseThumbs – Le immagini in miniatura sono visibili. FullScreenFull – Modalità schermo intero, senza barra dei menu, controlli della finestra o altre finestre visibili. UseOC – Il pannello del gruppo di contenuti facoltativo è visibile. UseAttachments – Gli allegati del documento sono visibili. |

| PageLayout | Il layout di pagina deve essere utilizzato quando il documento viene aperto. Valori possibili: SinglePage – Visualizza una pagina alla volta. OneColumn – Visualizza le pagine in una colonna. TwoColumnLeft – Visualizza le pagine in due colonne, con le pagine dispari a sinistra. TwoColumnRight – Visualizza le pagine in due colonne, con le pagine dispari a destra. |

| NonFullScreenPageMode | La modalità della pagina del documento quando l’applicazione di visualizzazione PDF esce dalla modalità a schermo intero. Valori possibili: UseNone – Né il contorno del documento (segnalibri) né le immagini in miniatura sono visibili. UseOutlines – Il contorno del documento (segnalibri) è visibile. UseThumbs – Le immagini in miniatura sono visibili. UseOC – Il pannello del gruppo di contenuti facoltativo è visibile. |

  • Crea un’istanza della classe ApiClient fornendo l’ID client e il segreto client come argomenti.
  • Quindi creare un’istanza della classe PdfApi che accetta l’oggetto ApiClient come argomento di input.
  • Ora crea un’istanza di DocumentProperties che definisce le nuove proprietà di visualizzazione per la visualizzazione PDF.
  • Infine, chiama putdocumentdisplayproperties(…) per impostare le nuove proprietà di visualizzazione per il file 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)

        # crea un'istanza di PdfApi passando PdfApiClient come argomento
        pdf_api = PdfApi(pdf_api_client)

        #source PDF file
        input_file = 'PdfWithEmbeddedFiles.pdf'
        
        # Proprietà di visualizzazione del documento
        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'
        }

        # chiama API per aggiornare le proprietà di visualizzazione PDF
        response = pdf_api.put_document_display_properties(name = input_file, display_properties=newDocumentProperties)
        
        # stampa la risposta nella console
        print(response)
        
        # stampa messaggio nella console (facoltativo)
        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)
preferenze di visualizzazione pdf aggiornate

Immagine 2: Anteprima delle preferenze di visualizzazione PDF aggiornate.

Leggi le proprietà di visualizzazione PDF utilizzando cURL

Le API REST sono accessibili anche tramite comandi cURL e poiché Aspose.PDF Cloud è sviluppato secondo l’architettura REST, possiamo accedere all’API anche tramite il comando cURL. Tuttavia, prima di eseguire qualsiasi operazione di manipolazione del documento, dobbiamo generare un JSON Web Token (JWT) basato sulle credenziali individuali del tuo client specificate sulla dashboard di Aspose.Cloud. È obbligatorio perché le nostre API sono accessibili solo agli utenti registrati. Esegui il seguente comando per generare il token 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"

Una volta generato il token JWT, potremmo dover eseguire il seguente comando cURL per leggere le proprietà di visualizzazione del PDF.

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

Aggiorna le proprietà di visualizzazione PDF utilizzando cURL

Il comando cURL può essere utilizzato anche per aggiornare le proprietà di visualizzazione dei documenti PDF; il file risultante viene nuovamente salvato nell’archivio cloud.

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

Conclusione

In questo articolo, abbiamo esplorato i dettagli e i passaggi su come leggere e controllare le proprietà di visualizzazione PDF. Questi requisiti possono essere soddisfatti utilizzando frammenti di codice Python e anche i comandi cURL. Consigliamo inoltre di esplorare la Guida per sviluppatori per scoprire altre interessanti funzionalità offerte dall’API. Inoltre, il codice sorgente completo di Aspose.PDF Cloud SDK per Python è stato reso disponibile per il download su GitHub. In caso di problemi durante l’utilizzo dell’API o se hai ulteriori domande, non esitare a contattarci tramite il Forum di supporto prodotto gratuito.

Articoli correlati

Ti consigliamo inoltre di visitare i seguenti link per saperne di più: