Opombe PDF Wordovi dokumenti

Kako dodati opombe PDF-ju z uporabo C# .NET

V današnji digitalni dobi so PDF-ji postali priljubljena oblika za skupno rabo informacij, dokumentov in poročil. Vendar preprosto ogled PDF-ja za mnoge uporabnike morda ne bo dovolj. Včasih bodo uporabniki želeli označiti ali dodati opombe k določenim delom PDF-ja, da zagotovijo dodaten kontekst ali povratne informacije. Na srečo je na voljo več brezplačnih zapisovalcev PDF, ki uporabnikom omogočajo enostavno dodajanje komentarjev, označevanje besedila in drugo. Vendar bomo v tem članku raziskali, kako uporabiti REST API za podporo opombam PDF, in vam pokazali, kako označiti, komentirati in dodati opombe vašim dokumentom PDF.

REST API za opombe PDF

Aspose.PDF Cloud ponuja preprosto in celovito rešitev za programsko dodajanje opomb dokumentom PDF. Z Aspose.PDF Cloud lahko dokumentom PDF dodate različne vrste opomb, vključno z besedilom, sliko, žigom in različnimi opombami oznak. Prav tako lahko spremenite obstoječe opombe, na primer spremenite položaj, velikost, barvo ali katere koli druge lastnosti.

Podprte opombe vključujejo besedilo, krog, mnogokotnik, poličrt, črto, kvadrat, prosto besedilo, osvetlitev, podčrtano, vijugasto, prečrtano, kazalko, črnilo, povezavo, pojavno okno, priponko datoteke, zvok, film, zaslon, pripomoček, vodni žig, TrapNet, PrinterMark, Redakcija, Žig, RichMedia in PDF3D.

Zdaj, če želite dodati SDK v svoj projekt, poiščite Aspose.PDF-Cloud v upravitelju paketov NuGet in kliknite gumb Dodaj paket. Naslednji pomemben korak je registracija računa prek nadzorne plošče v oblaku in pridobitev osebnih poverilnic stranke. Za dodatne podrobnosti si oglejte vodnik Hitri začetek.

Dodajte komentarje v PDF z uporabo C#

Oglejmo si delček kode C# .NET, ki se uporablja za dodajanje pripisov v dokument PDF.

// Za popolne primere in podatkovne datoteke pojdite na 
https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet

// Pridobite poverilnice odjemalca na https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// ustvarite objekt PdfApi
PdfApi api = new PdfApi(clientSecret, clientID);

// ustvari objekt Seznam, ki vsebuje FreeTextAnnotations
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
{
new FreeTextAnnotation(
    // določite pravokotno območje, ki vsebuje FreeTextAnnotation
    // določite tudi podrobnosti oblikovanja besedila
    Rect: new Rectangle(100, 800, 350, 830),
    TextStyle:new TextStyle(
        FontSize: 26, Font: "Arial",
        ForegroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0, 0xFF, 0),
        BackgroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0xFF, 0, 0)
        ))
    {
    // Vsebina, ki bo prikazana znotraj FreeTextAnnotation
    Contents = "Confidential !",
    Color = new Aspose.Pdf.Cloud.Sdk.Model.Color(0, 0, 0, 0),
    Id = "id1",
    Name = "Test Free Text",                    
    Flags = new List<AnnotationFlags> {AnnotationFlags.Default},
    HorizontalAlignment = HorizontalAlignment.Center,
    Intent = FreeTextIntent.FreeTextTypeWriter,
    RichText = "Rich Text",
    Subject = "Text Box Subj",
    ZIndex = 1,
    Justification = Justification.Center,
    Title = "Title",
    PageIndex = 1                     
    }
};
var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);

Zdaj pa podrobneje razumemo delček kode.

PdfApi api = new PdfApi(clientSecret, clientID);

Ustvarite primerek razreda PdfApi, ki vzame poverilnice odjemalca kot argumente v svojem konstruktorju.

List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>

Ker API podpira zmožnost dodajanja ene ali več opomb podobnega tipa hkrati, moramo ustvariti objekt seznama tipa FreeTextAnnnotation.

new FreeTextAnnotation(
    Rect: new Rectangle(100, 800, 350, 830),
    TextStyle:new TextStyle(
        FontSize: 26, Font: "Arial",
        ForegroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0, 0xFF, 0),
        BackgroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0xFF, 0, 0)
        ))

Ustvarite objekt FreeTextAnnotation, kjer definiramo pravokotno območje za podrobnosti o opombah in oblikovanju besedila.

Contents = "Confidential !"

Tukaj definiramo vsebino za FreeTextAnnotation.

var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);

Pokličite REST API, da dodate FreeTextAnnotation na prvo stran dokumenta PDF, ki je že na voljo v shrambi v oblaku.

Spodaj so možne vrednosti, ki jih je mogoče dodeliti lastnostim, uporabljenim v zgornjem delčku kode.

  • AnnotationFlags - Podprte vrednosti so lahko [Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents].
  • Zasukaj - Kot vrtenja za besedilo. Možne vrednosti so lahko [None, on90, on180, on270].
  • AnnotationFlags - niz zastavic, ki določajo različne značilnosti opombe. Možna vrednost je lahko [Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents]. – FreeTextIntent – našteje namene opombe za prosto besedilo. Možne vrednosti so lahko [Undefined, FreeTextCallout, FreeTextTypeWriter].

Dodajte opombo s prostim besedilom v PDF z ukazi cURL

Uporaba ukazov cURL za klic Aspose.PDF Cloud API je dober pristop za izpolnitev te zahteve. Dobro je tudi, če poznate orodja ukazne vrstice ali jih raje uporabljate. Torej, z orodjem ukazne vrstice cURL lahko postavljate zahteve HTTP in izvajate različne operacije v zvezi z obdelavo datoteke PDF.

Zdaj, če želimo dokumentu PDF dodati opombe z ukazi cURL, moramo najprej ustvariti žeton za preverjanje pristnosti, tako da končni točki žetona pošljemo zahtevo s SID-jem vaše aplikacije in ključem aplikacije. Izvedite naslednji ukaz, da ustvarite accessToken.

curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=ee170169-ca49-49a4-87b7-0e2ff815ea6e&client_secret=7f098199230fc5f2175d494d48f2077c" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

Ko je accessToken ustvarjen, izvedite naslednji ukaz, ki doda opombo FreeTextAnnotation v dokument PDF. Datoteka PDF z opombami se nato posodobi v shrambi v oblaku.

curl -v "https://api.aspose.cloud/v3.0/pdf/{inputPDF}/pages/1/annotations/freetext" \
-X POST \
-H  "accept: application/json" \
-H  "authorization: Bearer {accessToken}" \
-H  "Content-Type: application/json" \
-d "[  {        \"Color\": {      \"A\": 0,      \"R\": 0,      \"G\": 0,      \"B\": 0    },    \"Contents\": \"Confidential !\",    \"Modified\": \"01/05/2023 12:00:00.000 PM\",    \"Id\": \"id0\",    \"Flags\": [      \"Default\"    ],    \"Name\": \"comment\",    \"Rect\": {      \"LLX\": 100,      \"LLY\": 800,      \"URX\": 350,      \"URY\": 830    },    \"PageIndex\": 0,    \"ZIndex\": 1,    \"HorizontalAlignment\": \"Center\",    \"VerticalAlignment\": \"Center\",    \"CreationDate\": \"03/05/2023 16:00:00.000 PM\",    \"Subject\": \"Subj.\",    \"Title\": \"Main Heading\",    \"RichText\": \"Hello world...\",    \"Justification\": \"Left\",    \"Intent\": \"FreeTextTypeWriter\",    \"Rotate\": \"None\",    \"TextStyle\": {      \"FontSize\": 26,      \"Font\": \"Arial\",      \"ForegroundColor\": {        \"A\": 10,        \"R\": 10,        \"G\": 100,        \"B\": 120      },      \"BackgroundColor\": {        \"A\": 0,        \"R\": 0,        \"G\": 50,        \"B\": 80      }    }  }]"

Zamenjajte {inputPDF} z imenom vhodne datoteke PDF, ki je že na voljo v shrambi v oblaku, {accessToken} z zgoraj ustvarjenim žetonom dostopa JWT.

Predogled pripisov PDF

Slika: - Predogled pripisov s prostim besedilom v datoteki PDF.

Dokument PDF, uporabljen v zgornjem primeru, lahko prenesete s te povezave.

Zaključek

Skratka, dodajanje opomb dokumentom PDF lahko močno poveča njihovo uporabnost in funkcionalnost. Ne glede na to, ali želite poudariti pomembno besedilo, dodati komentarje ali delati zapiske neposredno v dokumentu, je Aspose.PDF Cloud odlična izbira za dosego tega. Izvedeli smo tudi, da Aspose.PDF Cloud SDK za .NET in ukaze cURL ponuja zmogljive rešitve za označevanje PDF-jev, kar vam daje možnost ustvarjanja prilagojenih delovnih tokov in procesov avtomatizacije. Zato lahko s temi orodji hitro in enostavno dodajate opombe PDF-jem, hkrati pa prihranite čas in povečate produktivnost.

Uporabne povezave

povezani članki

Zelo priporočamo, da si ogledate naslednje bloge: