Anotácie PDF Dokumenty Word

Ako pridať anotácie do PDF pomocou C# .NET

V dnešnom digitálnom veku sa PDF stali obľúbeným formátom na zdieľanie informácií, dokumentov a správ. Jednoduché zobrazenie PDF však mnohým používateľom nemusí stačiť. Niekedy môžu používatelia chcieť zvýrazniť alebo pridať poznámky do konkrétnych častí PDF, aby poskytli ďalší kontext alebo spätnú väzbu. Našťastie je k dispozícii niekoľko bezplatných anotátorov PDF, ktoré používateľom umožňujú jednoducho pridávať komentáre, zvýrazňovať text a podobne. V tomto článku však preskúmame, ako používať REST API na podporu anotácií PDF, a ukážeme vám, ako zvýrazňovať, komentovať a pridávať poznámky do vašich dokumentov PDF.

REST API pre anotáciu PDF

Aspose.PDF Cloud poskytuje jednoducho použiteľné a komplexné riešenie na programové pridávanie anotácií do dokumentov PDF. Pomocou Aspose.PDF Cloud môžete do dokumentov PDF pridávať rôzne typy anotácií vrátane textu, obrázka, pečiatky a rôznych anotácií. Môžete tiež upraviť existujúce anotácie, napríklad zmeniť polohu, veľkosť, farbu alebo akékoľvek iné vlastnosti.

Podporované anotácie zahŕňajú text, kruh, mnohouholník, lomená čiara, čiara, štvorec, voľný text, zvýraznenie, podčiarknutie, krívanie, prečiarknutie, striebro, atrament, odkaz, kontextové okno, príloha súboru, zvuk, film, obrazovka, miniaplikácia, vodoznak, TrapNet, značka tlačiarne, Redakcia, Pečiatka, RichMedia a PDF3D.

Teraz, ak chcete pridať SDK do svojho projektu, vyhľadajte Aspose.PDF-Cloud v správcovi balíkov NuGet a kliknite na tlačidlo Pridať balík. Ďalším dôležitým krokom je registrácia účtu cez Cloud dashboard a získanie osobných prihlasovacích údajov klienta. Ďalšie podrobnosti nájdete v príručke Rýchly štart.

Pridajte komentáre do PDF pomocou C#

Pozrime sa na útržok kódu C# .NET, ktorý sa používa na pridanie anotácie do dokumentu PDF.

// Úplné príklady a dátové súbory nájdete na 
https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet

// Získajte poverenia klienta z https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

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

// create List objekt obsahuje FreeTextAnnotations
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
{
new FreeTextAnnotation(
    // špecifikujte obdĺžnikovú oblasť obsahujúcu FreeTextAnnotation
    // tiež definujte podrobnosti o formátovaní textu
    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)
        ))
    {
    // Obsah, ktorý sa má zobraziť vo 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);

Teraz pochopme útržok kódu podrobnejšie.

PdfApi api = new PdfApi(clientSecret, clientID);

Vytvorte inštanciu triedy PdfApi, ktorá berie prihlasovacie údaje klienta ako argumenty vo svojom konštruktore.

List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>

Keďže API podporuje možnosť pridať jednu alebo viac anotácií podobného typu súčasne, musíme vytvoriť objekt List typu 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)
        ))

Vytvorte objekt FreeTextAnnotation, kde definujeme obdĺžnikovú oblasť pre anotáciu a podrobnosti o formátovaní textu.

Contents = "Confidential !"

Tu definujeme obsah pre FreeTextAnnotation.

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

Zavolaním REST API pridajte FreeTextAnnotation na prvú stranu dokumentu PDF, ktorý je už dostupný v cloudovom úložisku.

Nižšie sú uvedené možné hodnoty, ktoré možno priradiť vlastnostiam použitým vo vyššie uvedenom útržku kódu.

  • AnnotationFlags - Podporované hodnoty môžu byť [Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents].
  • Rotate - Uhol otočenia pre text. Možné hodnoty môžu byť „[None, on90, on180, on270]“.
  • AnnotationFlags - Sada príznakov špecifikujúcich rôzne charakteristiky anotácie. Možná hodnota môže byť [Predvolené, Neviditeľné, Skryté, Tlačiť, NoZoom, NoRotate, NoView, Iba na čítanie, Uzamknuté, ToggleNoView, LockedContents].
  • FreeTextIntent - Vymenuje zámery anotácie voľného textu. Možné hodnoty môžu byť [ Undefined, FreeTextCallout, FreeTextTypeWriter].

Pridajte anotáciu voľného textu do PDF pomocou príkazov cURL

Použitie príkazov cURL na volanie Aspose.PDF Cloud API je dobrý prístup na splnenie tejto požiadavky. Je tiež dobré, ak poznáte nástroje príkazového riadku alebo ich radšej používate. Takže pomocou nástroja príkazového riadka cURL môžete vytvárať požiadavky HTTP a vykonávať rôzne operácie týkajúce sa spracovania súborov PDF.

Teraz, aby sme mohli pridať anotácie do dokumentu PDF pomocou príkazov cURL, musíme najprv vygenerovať autentifikačný token odoslaním požiadavky do koncového bodu tokenu s vaším SID aplikácie a kľúčom aplikácie. Ak chcete vygenerovať prístupový token, vykonajte nasledujúci príkaz.

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"

Po vygenerovaní accessTokenu spustite nasledujúci príkaz, ktorý pridá FreeTextAnnotation do dokumentu PDF. Súbor PDF s poznámkami sa potom aktualizuje v úložisku Cloud.

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

Nahraďte „{inputPDF}“ názvom vstupného súboru PDF, ktorý je už dostupný v cloudovom úložisku, „{accessToken}“ prístupovým tokenom JWT vygenerovaným vyššie.

Ukážka anotácie PDF

Obrázok:- Ukážka voľnej textovej anotácie v súbore PDF.

Dokument PDF použitý vo vyššie uvedenom príklade si môžete stiahnuť z tento odkaz.

Záver

Záverom možno povedať, že pridávanie anotácií do súborov PDF môže výrazne zvýšiť ich užitočnosť a funkčnosť. Či už chcete zvýrazniť dôležitý text, pridať komentáre alebo si robiť poznámky priamo v dokumente, potom je Aspose.PDF Cloud úžasnou voľbou, ako to dosiahnuť. Tiež sme sa dozvedeli, že príkazy Aspose.PDF Cloud SDK pre .NET a cURL ponúkajú výkonné riešenia na anotovanie súborov PDF, vďaka čomu máte možnosť vytvárať prispôsobené pracovné postupy a procesy automatizácie. Preto pomocou týchto nástrojov môžete rýchlo a jednoducho pridávať anotácie do PDF, pričom ušetríte čas a zvýšite produktivitu.

užitočné odkazy

Súvisiace články

Dôrazne odporúčame prejsť si nasledujúce blogy: