Die PDF Dateien verfügen über die einzigartige Funktion, die Anzeigeeinstellungen zu speichern, mit denen wir steuern können, wie die Viewer-Anwendung das PDF Dokument anzeigt. Daher können Sie mit dem Viewer-Einstellungswörterbuch eines PDF Dokuments steuern, wie das Dokument auf dem Bildschirm oder im Druck dargestellt werden soll.
Bitte beachten Sie, dass wir die Anzeigeeigenschaften der PDF-Viewer steuern können. Dazu gehört die Steuerung der Anzeige des PDF Dokumenttitels, das Ausblenden oder Anzeigen der Menüleiste, das Ausblenden/Anzeigen der Statusleiste und das Ausblenden/Anzeigen der Fenster-Benutzeroberfläche. Steuern Sie, wie das Seitenlayout, der Seitenmodus und das Seitenlayout eingerichtet werden. Die meisten PDF-Verarbeitungsanwendungen unterstützen diese Vorgänge. Für Massenaktualisierungsvorgänge ist jedoch eine programmgesteuerte Lösung eine effektive Lösung. In diesem Artikel besprechen wir die Details und Schritte zur Steuerung der PDF-Anzeigeeigenschaften mit Python.
- PDF Manipulation SDK
- Lesen Sie die PDF-Anzeigeeigenschaften mit Python
- Aktualisieren Sie die PDF-Anzeigeeigenschaften mit Python
- Lesen Sie die PDF-Anzeigeeigenschaften mit cURL
- Aktualisieren Sie die PFDF-Anzeigeeigenschaften mit cURL
PDF Manipulation SDK
Aspose.PDF Cloud ist eine REST-basierte API, die es Entwicklern ermöglicht, PDF-Erstellungs-, Bearbeitungs und Rendering funktionen in ihre Anwendungen zu implementieren. Mit weniger Codezeilen können Sie beeindruckende PDF-Verarbeitungsanwendungen entwickeln. Es ist keine spezielle Softwareinstallation erforderlich und Sie können alle PDF-Verarbeitungsvorgänge in der Cloud durchführen. Um unseren Entwicklern die Arbeit noch weiter zu erleichtern, haben wir Aspose.PDF Cloud SDK für Python erstellt, das ein Wrapper um Aspose.PDF Cloud ist. Um mit diesem SDK zu beginnen, ist der erste Schritt seine Installation. Das SDK steht zum kostenlosen Download über das PIP und GitHub-Repository zur Verfügung. Jetzt müssen wir den folgenden Befehl im Terminal/Eingabeaufforderung ausführen, um die Installation durchzuführen.
pip install asposepdfcloud
Kostenloses Cloud Dashboard-Konto
Der nächste große Schritt ist ein kostenloses Abonnement unserer Cloud-Dienste über das Aspose.Cloud-Dashboard. Der Zweck dieses Abonnements besteht darin, nur autorisierten Personen den Zugriff auf unsere Dateiverarbeitungsdienste zu ermöglichen. Wenn Sie ein GitHub oder Google-Konto haben, melden Sie sich einfach an oder klicken Sie auf die Schaltfläche Neues Konto erstellen und geben Sie die erforderlichen Informationen ein. Melden Sie sich nun mit Ihren Anmeldeinformationen beim Dashboard an, erweitern Sie den Abschnitt „Anwendungen“ im Dashboard und scrollen Sie nach unten zum Abschnitt „Client-Anmeldeinformationen“, um die Details zu Client-ID und Client-Geheimnis anzuzeigen.
Bild 1: – Client-Anmeldeinformationen auf dem Aspose.Cloud-Dashboard.
Lesen Sie die PDF-Anzeigeeigenschaften mit Python
Bitte verwenden Sie den unten angegebenen Codeausschnitt, um die PDF-Viewer-Einstellungen zu lesen und in der Konsole anzuzeigen.
- Erstellen Sie zunächst eine Instanz der Klasse ApiClient und geben Sie dabei Client ID und Client Secret als Argumente an.
- Zweitens erstellen Sie eine Instanz der PdfApi Klasse, die das ApiClient Objekt als Eingabeargument verwendet
- Rufen Sie abschließend die Methode getdocumentdisplayproperties(…) auf, um die Einstellungen für den PDF-Viewer abzurufen.
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)
# Erstellen Sie eine PdfApi-Instanz und übergeben Sie dabei PdfApiClient als Argument
pdf_api = PdfApi(pdf_api_client)
#source PDF file
input_file = 'PdfWithEmbeddedFiles.pdf'
# Rufen Sie die API auf, um PDF-Anzeigeeigenschaften mit Python zu lesen
response = pdf_api.get_document_display_properties(name = input_file)
# Antwort in der Konsole drucken
print(response)
# Nachricht in der Konsole drucken (optional)
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)
Das im obigen Beispiel verwendete Beispiel-PDF Dokument kann von PdfWithEmbeddedFiles.pdf heruntergeladen werden.
Aktualisieren Sie die PDF-Anzeigeeigenschaften mit Python
In diesem Abschnitt besprechen wir die Schritte und zugehörigen Details zum Festlegen von PDF-Anzeigeeigenschaften mithilfe des Python SDK. Bevor wir jedoch fortfahren, müssen wir zunächst die Eigenschaften und die spezifischen Werte lernen, die ihnen zugewiesen werden können.
Unterstützte Eigenschaften
| Immobilie | Beschreibung |
| —————– | ———————— |
| HideToolbar | Ein Flag, das angibt, ob die Symbolleisten der PDF-Viewer-Anwendung ausgeblendet werden sollen, wenn das Dokument aktiv ist |
| HideMenuBar | Ein Flag, das angibt, ob die Menüleiste der PDF-Viewer-Anwendung ausgeblendet werden soll, wenn das Dokument aktiv ist. |
| HideWindowUI | Ein Flag, das angibt, ob Benutzeroberflächenelemente im Dokumentfenster (wie Bildlaufleisten und Navigationssteuerelemente) ausgeblendet werden sollen, sodass nur der Inhalt des Dokuments angezeigt wird. |
| FitWindow | Ein Flag, das angibt, ob die Größe des Dokumentfensters an die Größe der ersten angezeigten Seite angepasst werden soll. |
| CenterWindow | Ein Flag, das angibt, ob das Fenster des Dokuments in der Bildschirmmitte positioniert werden soll. |
| DisplayDocTitle | Ein Flag, das angibt, ob in der Titelleiste des Fensters der Dokumenttitel angezeigt werden soll. |
| PageMode | Der Dokumentseitenmodus, wenn das PDF Dokument in einem PDF-Viewer geöffnet wird. Mögliche Werte: UseNone – Weder Dokumentgliederung (Lesezeichen) noch Miniaturbilder sind sichtbar. UseOutlines – Dokumentgliederung (Lesezeichen) sind sichtbar. UseThumbs – Miniaturbilder sind sichtbar. FullScreenFull – Bildschirmmodus, ohne sichtbare Menüleiste, Fenstersteuerung oder sonstiges Fenster. UseOC – Optionales Inhaltsgruppenfenster ist sichtbar. UseAttachments – Dokumentanhänge sind sichtbar. |
| PageLayout | Das Seitenlayout, das beim Öffnen des Dokuments verwendet werden soll. Mögliche Werte: SinglePage – Zeigt jeweils eine Seite an. OneColumn – Zeigt die Seiten in einer Spalte an. TwoColumnLeft – Zeigt die Seiten in zwei Spalten an, mit ungeraden Seitenzahlen links. TwoColumnRight – Zeigt die Seiten in zwei Spalten an, mit ungeraden Seitenzahlen rechts. |
| NonFullScreenPageMode | Der Dokumentseitenmodus, wenn die PDF-Viewer-Anwendung den Vollbildmodus verlässt. Mögliche Werte: UseNone – Weder Dokumentgliederung (Lesezeichen) noch Miniaturbilder sind sichtbar. UseOutlines – Dokumentgliederung (Lesezeichen) sind sichtbar. UseThumbs – Miniaturbilder sind sichtbar. UseOC – Optionales Inhaltsgruppenfenster ist sichtbar. |
- Erstellen Sie eine Instanz der ApiClient Klasse und geben Sie als Argumente die Client-ID und das Client-Geheimnis an.
- Erstellen Sie dann eine Instanz der PdfApi Klasse, die das ApiClient Objekt als Eingabeargument verwendet.
- Erstellen Sie nun eine Instanz von DocumentProperties, die neue Anzeigeeigenschaften für die PDF-Anzeige definiert.
- Rufen Sie abschließend die Funktion putdocumentdisplayproperties(…) auf, um neue Anzeigeeigenschaften für die PDF-Datei festzulegen.
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)
# Erstellen Sie eine PdfApi-Instanz und übergeben Sie dabei PdfApiClient als Argument
pdf_api = PdfApi(pdf_api_client)
#source PDF file
input_file = 'PdfWithEmbeddedFiles.pdf'
# Anzeigeeigenschaften von Dokumenten
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 aufrufen um PDF Anzeigeeigenschaften zu aktualisieren
response = pdf_api.put_document_display_properties(name = input_file, display_properties=newDocumentProperties)
# Antwort in der Konsole drucken
print(response)
# Nachricht in der Konsole drucken (optional)
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)
Bild 2: – Vorschau der aktualisierten PDF-Anzeigeeinstellungen.
Lesen Sie die PDF-Anzeigeeigenschaften mit cURL
Auf die REST-APIs kann auch über cURL-Befehle zugegriffen werden. Da Aspose.PDF Cloud gemäß der REST-Architektur entwickelt wurde, können wir auch über den cURL-Befehl auf die API zugreifen. Bevor wir jedoch eine Dokumentbearbeitungsoperation durchführen, müssen wir basierend auf Ihren individuellen Clientanmeldeinformationen, die über das Aspose.Cloud-Dashboard angegeben wurden, ein JSON Web Token (JWT) generieren. Dies ist obligatorisch, da unsere APIs nur für registrierte Benutzer zugänglich sind. Führen Sie bitte den folgenden Befehl aus, um das JWT-Token zu generieren.
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"
Sobald das JWT-Token generiert ist, müssen wir möglicherweise den folgenden cURL-Befehl ausführen, um die PDF-Anzeigeeigenschaften zu lesen.
curl -v -X GET "https://api.aspose.cloud/v3.0/pdf/PdfWithEmbeddedFiles.pdf/displayproperties" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
Aktualisieren Sie die PDF-Anzeigeeigenschaften mit cURL
Mit dem cURL-Befehl können auch die Anzeigeeigenschaften von PDF Dokumenten aktualisiert werden. Die resultierende Datei wird erneut im Cloud-Speicher gespeichert.
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\"}"
Abschluss
In diesem Artikel haben wir die Details und Schritte zum Lesen und Steuern von PDF-Anzeigeeigenschaften untersucht. Diese Anforderungen können mithilfe von Python-Codeausschnitten sowie mithilfe der cURL-Befehle erfüllt werden. Wir empfehlen außerdem, den Entwicklerleitfaden zu lesen, um mehr über andere spannende Funktionen der API zu erfahren. Darüber hinaus wurde der vollständige Quellcode des Aspose.PDF Cloud SDK für Python zum Download über GitHub bereitgestellt. Falls bei der Verwendung der API Probleme auftreten oder Sie weitere Fragen haben, können Sie uns gerne über das Kostenlose Produktsupportforum kontaktieren.
Verwandte Artikel
Wir empfehlen Ihnen außerdem, die folgenden Links zu besuchen, um mehr zu erfahren über: