PDF-aantekeninge Word-dokumente

Hoe om aantekeninge by ’n PDF te voeg met C# .NET

In vandag se digitale era het PDF’s ’n gewilde formaat geword om inligting, dokumente en verslae te deel. Dit sal egter vir baie gebruikers dalk nie genoeg wees om bloot ’n PDF te bekyk nie. Soms wil gebruikers dalk spesifieke dele van die PDF uitlig of notas byvoeg om bykomende konteks of terugvoer te verskaf. Gelukkig is daar verskeie gratis PDF-annoteerders beskikbaar wat gebruikers toelaat om maklik opmerkings by te voeg, teks uit te lig, en meer. In hierdie artikel sal ons egter ondersoek hoe om die REST API te gebruik om PDF-aantekeninge te ondersteun, en jou wys hoe om uit te lig, kommentaar te lewer en notas by jou PDF-dokumente te voeg.

REST API vir PDF-aantekening

Aspose.PDF Cloud bied ’n maklik-om-te-gebruik en omvattende oplossing om aantekeninge programmaties by PDF-dokumente te voeg. Met Aspose.PDF Cloud kan jy verskeie soorte aantekeninge by PDF-dokumente voeg, insluitend teks, prent, stempel en verskeie opmaakaantekeninge. Jy kan ook bestaande aantekeninge verander, soos om die posisie, grootte, kleur of enige ander eienskappe te verander.

Ondersteunde aantekeninge sluit in teks, sirkel, veelhoek, polylyn, lyn, vierkant, vryteks, hoogtepunt, onderstreep, kronkelend, deurtrek, karet, ink, skakel, opspringer, lêeraanhangsel, klank, fliek, skerm, legstuk, watermerk, TrapNet, PrinterMark, Redaksie, Stamp, RichMedia en PDF3D.

Nou, om die SDK by jou projek by te voeg, soek asseblief Aspose.PDF-Cloud in NuGet-pakketbestuurder en klik die Voeg pakket by-knoppie. Die volgende belangrike stap is om ’n rekening oor Cloud-dashboard te registreer en jou persoonlike kliëntbewyse te kry. Kyk asseblief na die Vinnige begin gids vir verdere besonderhede.

Voeg opmerkings by PDF met C#

Kom ons kyk na die C# .NET-kodebrokkie wat gebruik word om annotasie by ’n PDF-dokument te voeg.

// Vir volledige voorbeelde en datalêers, gaan asseblief na 
https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet

// Kry kliëntbewyse van https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// skep 'n voorwerp van PdfApi
PdfApi api = new PdfApi(clientSecret, clientID);

// skep Lys voorwerp bevat FreeTextAnnotations
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
{
new FreeTextAnnotation(
    // spesifiseer die reghoekige streek wat FreeTextAnnotation bevat
    // definieer ook teksformatering besonderhede
    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)
        ))
    {
    // Inhoud wat binne FreeTextAnnotation vertoon moet word
    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);

Kom ons verstaan nou die kodebrokkie in meer besonderhede.

PdfApi api = new PdfApi(clientSecret, clientID);

Skep ’n instansie van PdfApi-klas wat kliëntbewyse as argumente in sy konstruktor neem.

List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>

Aangesien die API die vermoë ondersteun om een of meer aantekeninge van soortgelyke tipe op dieselfde tyd by te voeg, moet ons ’n Lys-objek van FreeTextAnnnotation-tipe skep.

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)
        ))

Skep ’n voorwerp van FreeTextAnnotation waar ons die reghoekige gebied vir annotasie en teksformatering besonderhede definieer.

Contents = "Confidential !"

Hier definieer ons die inhoud vir FreeTextAnnotation.

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

Bel die REST API om FreeTextAnnotation by te voeg op die eerste bladsy van PDF-dokument wat reeds in Wolkberging beskikbaar is.

Hieronder word die moontlike waardes gegee wat aan die eienskappe wat in bogenoemde kodebrokkie gebruik word, toegeken kan word.

  • AnnotationFlags - Ondersteunde waardes kan [Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents] wees.
  • Roteer - Rotasiehoek vir teks. Moontlike waardes kan [Geen, op90, op180, op270] wees.
  • AnnotationFlags - ’n Stel vlae wat verskeie kenmerke van die annotasie spesifiseer. Moontlike waarde kan [Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents] wees.
  • FreeTextIntent - Noem die bedoelings van die vryteks-aantekening op. Moontlike waardes kan [ Undefined, FreeTextCallout, FreeTextTypeWriter] wees.

Voeg gratis teksaantekening by PDF deur gebruik te maak van cURL-opdragte

Die gebruik van cURL-opdragte om Aspose.PDF Wolk-API te noem, is ’n goeie benadering om hierdie vereiste te bereik. Dit is ook goed as jy vertroud is met opdragreëlnutsgoed of verkies om dit te gebruik. Dus, met die cURL-opdragreëlinstrument, kan u HTTP-versoeke maak en verskeie bewerkings uitvoer rakende PDF-lêerverwerking.

Nou, om aantekeninge by ’n PDF-dokument by te voeg deur gebruik te maak van cURL-opdragte, moet ons eers ’n verifikasietoken genereer deur ’n versoek na die token-eindpunt te stuur met jou App-SID en App-sleutel. Voer asseblief die volgende opdrag uit om die accessToken te genereer.

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"

Sodra die accessToken gegenereer is, voer asseblief die volgende opdrag uit wat die FreeTextAnnotation by die PDF-dokument voeg. Die geannoteerde PDF-lêer word dan op Wolkberging opgedateer.

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

Vervang {inputPDF} met die naam van invoer-PDF-lêer wat reeds beskikbaar is op Wolkberging, {accessToken} met JWT-toegangtoken wat hierbo gegenereer is.

PDF-aantekeningvoorskou

Beeld: - Voorskou van gratis teksaantekeninge in PDF-lêer.

Die PDF-dokument wat in die voorbeeld hierbo gebruik word, kan afgelaai word vanaf hierdie skakel.

Afsluiting

Ten slotte, die byvoeging van aantekeninge by PDF’s kan hul bruikbaarheid en funksionaliteit aansienlik verbeter. Of jy nou belangrike teks wil uitlig, opmerkings byvoeg of notas direk binne die dokument wil maak, dan is Aspose.PDF Cloud ’n wonderlike keuse om dit te bereik. Ons het ook geleer dat Aspose.PDF Wolk SDK vir .NET- en cURL-opdragte kragtige oplossings bied vir die annotering van PDF’s, wat jou die vermoë gee om pasgemaakte werkvloeie en outomatiseringsprosesse te skep. Daarom kan u met hierdie nutsmiddels vinnig en maklik aantekeninge by PDF’s voeg, terwyl u tyd bespaar en produktiwiteit verhoog.

nuttige skakels

verwante artikels

Ons beveel sterk aan om deur die volgende blogs te gaan: