აკონტროლეთ PDF ჩვენების თვისებები

PDF ფაილებს აქვთ უნიკალური ფუნქცია ხედვის პრეფერენციების შესანარჩუნებლად, რაც საშუალებას გვაძლევს ვაკონტროლოთ, თუ როგორ აჩვენებს მაყურებლის აპლიკაციას PDF დოკუმენტი. მაშასადამე, PDF დოკუმენტის მაყურებლის პრეფერენციების ლექსიკონი საშუალებას გაძლევთ აკონტროლოთ დოკუმენტის ეკრანზე ან ბეჭდვით წარდგენა.

გთხოვთ გაითვალისწინოთ, რომ ჩვენ შეგვიძლია გავაკონტროლოთ PDF მაყურებლების ჩვენების თვისებები. მასში შედის PDF დოკუმენტის სათაურის ჩვენების კონტროლი, მენიუს ზოლის დამალვა ან ჩვენება, სტატუსის ზოლის დამალვა/ჩვენება, ფანჯრის ინტერფეისის დამალვა/ჩვენება. აკონტროლეთ, როგორ დააყენოთ გვერდის განლაგება, გვერდის რეჟიმი და გვერდის განლაგება. PDF დამუშავების აპლიკაციების უმრავლესობა მხარს უჭერს ამ ოპერაციებს. მაგრამ ნაყარი განახლების ოპერაციებისთვის პროგრამული გადაწყვეტა ეფექტური გამოსავალია. ამ სტატიაში ჩვენ განვიხილავთ დეტალებს და ნაბიჯებს, თუ როგორ გავაკონტროლოთ PDF ჩვენების თვისებები Python-ის გამოყენებით.

PDF მანიპულირების SDK

Aspose.PDF Cloud არის REST-ზე დაფუძნებული API, რომელიც დეველოპერებს საშუალებას აძლევს განახორციელონ PDF-ის შექმნა, მანიპულირება და ფუნქციების რენდერი თავიანთ აპლიკაციებში. ნაკლები კოდის ხაზებით, შეგიძლიათ განავითაროთ შთამბეჭდავი PDF დამუშავების აპლიკაციები. არ არის საჭირო კონკრეტული პროგრამული უზრუნველყოფის ინსტალაცია და შეგიძლიათ შეასრულოთ ყველა PDF დამუშავების ოპერაცია Cloud-ში. ჩვენი დეველოპერების შემდგომი გასაადვილებლად, ჩვენ შევქმენით Aspose.PDF Cloud SDK for Python, რომელიც არის შეფუთვა Aspose.PDF Cloud-ის გარშემო. ასე რომ, ამ SDK-ით დასაწყებად, პირველი ნაბიჯი არის მისი ინსტალაცია. SDK ხელმისაწვდომია უფასო ჩამოტვირთვისთვის PIP და GitHub საცავიდან. ახლა ჩვენ უნდა შევასრულოთ შემდეგი ბრძანება ტერმინალში/ბრძანების სტრიქონში ინსტალაციის შესასრულებლად.

pip install asposepdfcloud

უფასო Cloud Dashboard ანგარიში

შემდეგი მნიშვნელოვანი ნაბიჯი არის ჩვენი ღრუბლოვანი სერვისების უფასო გამოწერა Aspose.Cloud dashboard-ის მეშვეობით. ამ გამოწერის მიზანია მხოლოდ უფლებამოსილ პირებს მისცეს წვდომა ფაილების დამუშავების სერვისებზე. თუ გაქვთ GitHub ან Google ანგარიში, უბრალოდ დარეგისტრირდით ან დააწკაპუნეთ ღილაკზე Create a new Account და მიაწოდეთ საჭირო ინფორმაცია. ახლა შედით საინფორმაციო დაფაზე რწმუნებათა სიგელების გამოყენებით და გააფართოვეთ აპლიკაციების განყოფილება დაფიდან და გადადით ქვემოთ კლიენტის სერთიფიკატების განყოფილებისკენ, რომ ნახოთ კლიენტის ID და კლიენტის საიდუმლო დეტალები.

კლიენტის რწმუნებათა სიგელები

სურათი 1: - კლიენტის სერთიფიკატები Aspose.Cloud Dashboard-ზე.

წაიკითხეთ PDF ეკრანის თვისებები პითონის გამოყენებით

გთხოვთ, გამოიყენოთ ქვემოთ მოცემული კოდის ფრაგმენტი, რათა წაიკითხოთ PDF მნახველის პრეფერენციები და აჩვენოთ ისინი კონსოლში.

  • უპირველეს ყოვლისა, შექმენით ApiClient კლასის ინსტანცია არგუმენტებად Client ID Client Secret-ის მიწოდებისას
  • მეორეც, შექმენით PdfApi კლასის მაგალითი, რომელიც იღებს ApiClient ობიექტს შეყვანის არგუმენტად
  • დაბოლოს, გამოიძახეთ getdocumentdisplayproperties(…) მეთოდი 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)

        # შექმენით 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 ეკრანის თვისებები პითონის გამოყენებით

ამ განყოფილებაში ჩვენ განვიხილავთ ნაბიჯებს და დაკავშირებულ დეტალებს, თუ როგორ უნდა დააყენოთ PDF ეკრანის თვისებები Python SDK-ის გამოყენებით. თუმცა, სანამ შემდგომ გავაგრძელებთ, ჯერ უნდა ვისწავლოთ თვისებები და კონკრეტული მნიშვნელობები, რომლებიც შეიძლება მიენიჭოს მათ.

მხარდაჭერილი თვისებები

| ქონება | აღწერა |

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

| HideToolbar | დროშა, რომელშიც მითითებულია, დაიმალოს თუ არა pdf მაყურებლის აპლიკაციის ხელსაწყოთა ზოლები, როდესაც დოკუმენტი აქტიურია |

| HideMenuBar | დროშა, რომელშიც მითითებულია, დაიმალოს თუ არა pdf მაყურებლის აპლიკაციის მენიუს ზოლი, როდესაც დოკუმენტი აქტიურია. |

| დამალვაWindowUI | დროშა, რომელიც აზუსტებს, უნდა დაიმალოს თუ არა მომხმარებლის ინტერფეისის ელემენტები დოკუმენტის ფანჯარაში (როგორიცაა გადახვევის ზოლები და ნავიგაციის კონტროლი), ტოვებს მხოლოდ დოკუმენტის შიგთავსს. |

| FitWindow | დროშა, რომელიც აზუსტებს, უნდა შეცვალოს თუ არა დოკუმენტის ფანჯრის ზომა პირველი ნაჩვენები გვერდის ზომაზე. |

| ცენტრის ფანჯარა | დროშა, რომელიც აზუსტებს, განთავსდეს თუ არა დოკუმენტის ფანჯარა ეკრანის ცენტრში. |

| DisplayDocTitle | დროშა, რომელშიც მითითებულია, უნდა იყოს თუ არა ფანჯრის სათაურის ზოლში დოკუმენტის სათაური. |

| PageMode | დოკუმენტის გვერდის რეჟიმი, როდესაც pdf დოკუმენტი იხსნება pdf მაყურებელში. შესაძლო მნიშვნელობები: UseNone – არც დოკუმენტის მონახაზი (სანიშნეები) და არც მინიატურების სურათები არ ჩანს. UseOutlines – ჩანს დოკუმენტის მონახაზი (სანიშნეები).UseThumbs – მინიატურების სურათები ჩანს. FullScreenFull – ეკრანის რეჟიმი, მენიუს ზოლის, ფანჯრის კონტროლის ან ნებისმიერი სხვა ფანჯრის გარეშე. UseOC - არჩევითი შინაარსის ჯგუფის პანელი ჩანს. UseAttachments – ჩანს დოკუმენტის დანართები. |

| გვერდის განლაგება | გვერდის განლაგება გამოიყენება დოკუმენტის გახსნისას. შესაძლო მნიშვნელობები: SinglePage – აჩვენებს ერთ გვერდს ერთდროულად. OneColumn – აჩვენებს გვერდებს ერთ სვეტში. TwoColumnLeft – აჩვენებს გვერდებს ორ სვეტად, კენტი ნომრით მარცხნივ. TwoColumnRight – აჩვენებს გვერდებს ორ სვეტად, კენტი რიცხვით მარჯვნივ. |

| NonFullScreenPageMode | დოკუმენტის გვერდის რეჟიმი, როდესაც pdf მაყურებლის აპლიკაცია გამოდის სრული ეკრანის რეჟიმიდან. შესაძლო მნიშვნელობები: UseNone – არც დოკუმენტის მონახაზი (სანიშნეები) და არც მინიატურების სურათები არ ჩანს. UseOutlines – ჩანს დოკუმენტის მონახაზი (სანიშნეები).UseThumbs – მინიატურების სურათები ჩანს. UseOC - არჩევითი შინაარსის ჯგუფის პანელი ჩანს. |

  • შექმენით ApiClient კლასის ეგზემპლარი არგუმენტებად Client ID Client Secret-ის მიწოდებისას.
  • შემდეგ შექმენით 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 API-ებზე წვდომა ასევე შესაძლებელია 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 ეკრანის თვისებები. ეს მოთხოვნები შეიძლება შესრულდეს პითონის კოდის ფრაგმენტების გამოყენებით, ასევე cURL ბრძანებების გამოყენებით. ჩვენ ასევე გირჩევთ გაეცნოთ დეველოპერთა სახელმძღვანელოს, რათა გაეცნოთ API-ს მიერ შემოთავაზებულ სხვა საინტერესო ფუნქციებს. გარდა ამისა, Python-ისთვის Aspose.PDF Cloud SDK-ის სრული წყაროს კოდი ხელმისაწვდომი გახდა GitHub-ით ჩამოსატვირთად. თუ API-ს გამოყენებისას რაიმე პრობლემას წააწყდებით ან გაქვთ რაიმე დამატებითი შეკითხვა, გთხოვთ, მოგერიდებათ დაგვიკავშირდეთ [პროდუქტის მხარდაჭერის უფასო ფორუმის] მეშვეობით 13.

დაკავშირებული სტატიები

ჩვენ ასევე გირჩევთ ეწვიოთ შემდეგ ბმულებს მეტის გასაგებად: