PDF megjegyzések Word dokumentumok

Megjegyzések hozzáadása PDF-hez C# .NET használatával

A mai digitális korban a PDF-ek az információk, dokumentumok és jelentések megosztásának népszerű formátumává váltak. Előfordulhat azonban, hogy sok felhasználó számára nem elegendő a PDF egyszerű megtekintése. Előfordulhat, hogy a felhasználók kiemelik vagy megjegyzéseket fűznek a PDF egyes részeihez, hogy további kontextust vagy visszajelzést adjanak. Szerencsére számos ingyenes PDF-annotátor áll rendelkezésre, amelyek segítségével a felhasználók egyszerűen megjegyzéseket fűzhetnek hozzá, szöveget emelhetnek ki stb. Ebben a cikkben azonban megvizsgáljuk, hogyan használhatjuk a REST API-t a PDF-annotációk támogatására, és megmutatjuk, hogyan lehet kiemelni, megjegyzéseket fűzni a PDF-dokumentumokhoz és megjegyzéseket fűzni hozzájuk.

REST API PDF-annotációhoz

Az Aspose.PDF Cloud könnyen használható és átfogó megoldást kínál a PDF-dokumentumok programozott megjegyzéseinek hozzáadására. Az Aspose.PDF Cloud segítségével különféle típusú megjegyzéseket adhat hozzá a PDF-dokumentumokhoz, beleértve a szöveget, képet, bélyegzőt és különféle jelölőannotációkat. Módosíthatja a meglévő megjegyzéseket is, például megváltoztathatja a pozíciót, méretet, színt vagy bármilyen más tulajdonságot.

A támogatott megjegyzések közé tartozik a szöveg, kör, sokszög, vonalvonal, vonal, négyzet, szabad szöveg, kiemelés, aláhúzás, szaggatott, áthúzott, tinta, tinta, hivatkozás, előugró ablak, fájlmelléklet, hang, film, képernyő, widget, vízjel, trapNet, nyomtatójel, Redakció, bélyegző, RichMedia és PDF3D.

Most, hogy hozzáadhassa az SDK-t a projekthez, keressen az “Aspose.PDF-Cloud” kifejezésre a NuGet csomagkezelőben, és kattintson a Csomag hozzáadása gombra. A következő fontos lépés az, hogy regisztráljon egy fiókot a Cloud irányítópulton keresztül, és szerezze be személyes ügyfél hitelesítő adatait. További részletekért tekintse át a Quick Start útmutatót.

Megjegyzések hozzáadása a PDF-hez a C# használatával

Vessünk egy pillantást a C# .NET kódrészletre, amelyet arra használnak, hogy megjegyzést adjunk egy PDF dokumentumhoz.

// A teljes példákért és adatfájlokért látogasson el ide 
https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet

// Szerezze be az ügyfél hitelesítő adatait a https://dashboard.aspose.cloud/ webhelyről
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// hozzon létre egy PdfApi objektumot
PdfApi api = new PdfApi(clientSecret, clientID);

// Create List objektum FreeTextAnnotations tartalmaz
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
{
new FreeTextAnnotation(
    // adja meg a FreeTextAnnotation-t tartalmazó téglalap alakú régiót
    // szövegformázási részleteket is megadhat
    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)
        ))
    {
    // A FreeTextAnnotationben megjelenítendő tartalom
    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);

Most ismerjük meg részletesebben a kódrészletet.

PdfApi api = new PdfApi(clientSecret, clientID);

Hozzon létre egy példányt a PdfApi osztályból, amely az ügyfél hitelesítő adatait veszi argumentumként a konstruktorában.

List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>

Mivel az API támogatja egy vagy több hasonló típusú megjegyzés hozzáadását egy időben, létre kell hoznunk egy FreeTextAnnotation típusú List objektumot.

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

Hozzon létre egy FreeTextAnnotation objektumot, ahol meghatározzuk a téglalap alakú régiót a megjegyzés és a szöveg formázási részletei számára.

Contents = "Confidential !"

Itt határozzuk meg a FreeTextAnnotation tartalmát.

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

Hívja a REST API-t a FreeTextAnnotation hozzáadásához a felhőtárhelyen már elérhető PDF-dokumentum első oldalán.

Az alábbiakban láthatók azok a lehetséges értékek, amelyek a fenti kódrészletben használt tulajdonságokhoz rendelhetők.

  • AnnotationFlags - A támogatott értékek a következők lehetnek: [Alapértelmezett, Láthatatlan, Rejtett, Nyomtatás, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents].
  • Forgatás - Szöveg elforgatási szöge. A lehetséges értékek a következők lehetnek: `[Nincs, on90, on180, on270].
  • AnnotationFlags - A megjegyzés különféle jellemzőit meghatározó jelzők halmaza. A lehetséges érték a következő lehet: `[Alapértelmezett, Láthatatlan, Rejtett, Nyomtatás, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents].
  • FreeTextIntent - Felsorolja a szabad szöveges megjegyzés szándékait. A lehetséges értékek a következők lehetnek: [ Undefined, FreeTextCallout, FreeTextTypeWriter].

Szabad szöveges megjegyzés hozzáadása a PDF-hez a cURL parancsokkal

A cURL-parancsok használata az Aspose.PDF Cloud API meghívására jó módszer ennek a követelménynek a teljesítésére. Az is jó, ha ismeri a parancssori eszközöket, vagy szívesebben használja azokat. Tehát a cURL parancssori eszközzel HTTP-kéréseket küldhet, és különféle műveleteket hajthat végre a PDF-fájlok feldolgozásával kapcsolatban.

Most, hogy megjegyzéseket adhassunk egy PDF-dokumentumhoz cURL-parancsok segítségével, először hitelesítési tokent kell létrehoznunk oly módon, hogy kérést küldünk a token-végpontnak az alkalmazás-SID-vel és az alkalmazáskulccsal. Kérjük, hajtsa végre a következő parancsot az accessToken generálásához.

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"

Az accessToken létrehozása után hajtsa végre a következő parancsot, amely hozzáadja a FreeTextAnnotation-t a PDF dokumentumhoz. A megjegyzésekkel ellátott PDF-fájl ezután frissül a felhőtárhelyen.

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

Cserélje ki az {inputPDF} értéket a felhőtárhelyen már elérhető bemeneti PDF-fájl nevére, {accessToken} a fent generált JWT hozzáférési tokenre.

PDF-jegyzet előnézete

Kép: - Ingyenes szöveges megjegyzés előnézete PDF-fájlban.

A fenti példában használt PDF-dokumentum letölthető [erről a linkről] (https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet/blob/master/testData/Binder1.pdf).

Következtetés

Összefoglalva, megjegyzések hozzáadása a PDF-ekhez nagymértékben növelheti azok hasznosságát és funkcionalitását. Akár fontos szöveget szeretne kiemelni, akár megjegyzéseket szeretne írni, akár közvetlenül a dokumentumon belül jegyzeteket szeretne készíteni, az Aspose.PDF Cloud nagyszerű választás ennek eléréséhez. Azt is megtudtuk, hogy az Aspose.PDF Cloud SDK for .NET és a cURL parancsok hatékony megoldásokat kínálnak a PDF-fájlok annotálására, így személyre szabott munkafolyamatokat és automatizálási folyamatokat hozhat létre. Ezért ezekkel az eszközökkel gyorsan és egyszerűen fűzhet megjegyzéseket a PDF-ekhez, miközben időt takarít meg és növeli a termelékenységet.

Hasznos Linkek

kapcsolódó cikkek

Javasoljuk, hogy olvassa el az alábbi blogokat: