הגדר מאפייני תצוגת PDF ב-Python

לקבצי PDF יש תכונה ייחודית לשמירה על העדפות התצוגה המאפשרות לנו לשלוט כיצד יישום הצופה יציג את מסמך ה-PDF. לכן, מילון העדפות הצופה של מסמך PDF מאפשר לך לשלוט באופן שבו המסמך יוצג על המסך או בדפוס.

שים לב שאנו יכולים לשלוט במאפייני התצוגה של צופים ב-PDF. זה כולל שליטה בהצגת כותרת מסמך PDF, הסתרה או הצגה של שורת התפריטים, הסתר/הצג שורת מצב, הסתר/הצג ממשק המשתמש של חלון. שליטה כיצד להגדיר את פריסת העמוד, מצב העמוד ופריסת העמוד. רוב יישומי עיבוד 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

חשבון Cloud Dashboard בחינם

הצעד הגדול הבא הוא מנוי חינם לשירותי הענן שלנו דרך מרכז השליטה של Aspose.Cloud. מטרת מנוי זה היא לאפשר רק לאנשים מורשים לגשת לשירותי עיבוד הקבצים שלנו. אם יש לך חשבון GitHub או Google, פשוט הירשם או לחץ על הלחצן צור חשבון חדש וספק את המידע הנדרש. כעת היכנס ללוח המחוונים באמצעות אישורים והרחב את קטע היישומים מלוח המחוונים וגלול מטה לכיוון הקטע אישורי לקוח כדי לראות את פרטי זיהוי הלקוח ופרטי סוד הלקוח.

תמונה 1:- אישורי לקוח ב-Aspose.Cloud Dashboard.

קרא את מאפייני תצוגת PDF באמצעות Python

אנא השתמש בקטע הקוד המופיע למטה כדי לקרוא את העדפות מציג PDF ולהציגן במסוף.

ראשית, צור מופע של מחלקה ApiClient תוך מתן סוד לקוח לקוח כארגומנטים
שנית, צור מופע של מחלקה PdfApi שלוקח אובייקט ApiClient כארגומנט קלט
לבסוף, קרא לשיטה getdocumentdisplayproperties(…) כדי לאחזר העדפות PDF Viewere

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)

ניתן להוריד את מסמך PDF לדוגמה המשמש בדוגמה לעיל מ-PdfWithEmbeddedFiles.pdf.

עדכן את מאפייני תצוגת PDF באמצעות Python

בסעיף זה, אנו הולכים לדון בשלבים ובפרטים הקשורים כיצד להגדיר מאפייני תצוגת PDF באמצעות Python SDK. עם זאת, לפני שנמשיך הלאה, עלינו ללמוד תחילה את המאפיינים ואת הערכים הספציפיים שניתן להקצות להם.

מאפיינים נתמכים

| נכס | תיאור |

| —————— | ———————— |

| הסתר סרגל הכלים | דגל המציין אם להסתיר את סרגלי הכלים של יישום מציג pdf כאשר המסמך פעיל |

| HideMenuBar | דגל המציין אם להסתיר את שורת התפריטים של יישום מציג ה-PDF כאשר המסמך פעיל. |

| HideWindowUI | דגל המציין אם להסתיר רכיבי ממשק משתמש בחלון המסמך (כגון פסי גלילה ופקדי ניווט), ומשאיר רק את תוכן המסמך מוצג. |

| FitWindow | דגל המציין אם לשנות את גודל חלון המסמך כך שיתאים לגודל העמוד הראשון המוצג. |

| CenterWindow | דגל המציין אם למקם את חלון המסמך במרכז המסך. |

| DisplayDocTitle | דגל המציין אם שורת הכותרת של החלון צריכה להציג את כותרת המסמך. |

| PageMode | מצב דף המסמך כאשר מסמך ה-PDF נפתח במציג PDF. ערכים אפשריים: UseNone - לא ניתן לראות מתאר מסמך (סימניות) או תמונות ממוזערות. UseOutlines - מתאר מסמך (סימניות) גלויים. UseThumbs - תמונות ממוזערות גלויות. FullScreenFull - מצב מסך, ללא שורת תפריטים, פקדי חלונות או כל חלון אחר גלוי. UseOC - חלונית קבוצת תוכן אופציונלית גלויה. Use Attachments - קבצים מצורפים למסמכים גלויים. |

| פריסת עמוד | יש להשתמש בפריסת העמוד בעת פתיחת המסמך. ערכים אפשריים: SinglePage - מציג עמוד אחד בכל פעם. OneColumn - מציג את הדפים בעמודה אחת. TwoColumnLeft - מציג את העמודים בשתי עמודות, עם עמודים אי-זוגיים בצד שמאל. TwoColumnRight – מציג את העמודים בשתי עמודות, עם עמודים אי-זוגיים בצד ימין. |

| NonFullScreenPageMode | מצב דף המסמך כאשר יישום מציג ה-PDF יוצא ממצב מסך מלא. ערכים אפשריים: 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)

העדפות תצוגת pdf מעודכנות — תמונה 2:- תצוגה מקדימה של העדפות תצוגת PDF מעודכנות.

קרא את מאפייני תצוגת PDF באמצעות cURL

ניתן לגשת אל REST APIs גם באמצעות פקודות 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"

לאחר יצירת אסימון 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>"

עדכן את מאפייני תצוגת 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\"}"

מַסְקָנָה

במאמר זה, בחנו את הפרטים והשלבים כיצד לקרוא ולשלוט במאפייני תצוגת PDF. ניתן להשיג דרישות אלה באמצעות קטעי קוד של Python וכן באמצעות פקודות cURL. אנו ממליצים גם לעיין במדריך למפתחים כדי ללמוד על תכונות מרגשות אחרות שמציע ה-API. יתר על כן, קוד המקור המלא של Aspose.PDF Cloud SDK עבור Python הפך זמין להורדה דרך GitHub. במקרה שנתקלת בבעיות כלשהן במהלך השימוש בממשק ה-API או שיש לך שאלות נוספות, אל תהסס לפנות אלינו דרך פורום תמיכת מוצרים בחינם.

מאמרים קשורים

אנו ממליצים גם לבקר בקישורים הבאים כדי ללמוד עוד על:

SDK לעיבוד PDF#

חשבון Cloud Dashboard בחינם#

קרא את מאפייני תצוגת PDF באמצעות Python#

עדכן את מאפייני תצוגת PDF באמצעות Python#

מאפיינים נתמכים#

קרא את מאפייני תצוגת PDF באמצעות cURL#

עדכן את מאפייני תצוגת PDF באמצעות cURL#

מַסְקָנָה#

מאמרים קשורים#