Анотації PDF Документи Word

Як додати анотації до PDF за допомогою C# .NET

У сучасну цифрову епоху PDF стали популярним форматом для обміну інформацією, документами та звітами. Однак для багатьох користувачів простого перегляду PDF може бути недостатньо. Іноді користувачі можуть виділити або додати примітки до певних частин PDF-файлу, щоб надати додатковий контекст або відгук. На щастя, доступно кілька безкоштовних анотаторів PDF, які дозволяють користувачам легко додавати коментарі, виділяти текст тощо. Однак у цій статті ми розглянемо, як використовувати REST API для підтримки PDF-анотацій, і покажемо, як виділяти, коментувати та додавати примітки до PDF-документів.

REST API для анотації PDF

Aspose.PDF Cloud надає просте у використанні та комплексне рішення для програмного додавання анотацій до документів PDF. За допомогою Aspose.PDF Cloud ви можете додавати різні типи анотацій до PDF-документів, зокрема текст, зображення, штамп і різні анотації розмітки. Ви також можете змінити наявні анотації, наприклад змінити положення, розмір, колір або будь-які інші властивості.

Підтримувані анотації включають текст, коло, багатокутник, ломану лінію, лінію, квадрат, вільний текст, виділення, підкреслення, закреслення, закреслення, вставку, чорнило, посилання, спливаюче вікно, вкладення файлу, звук, фільм, екран, віджет, водяний знак, TrapNet, PrinterMark, Редагування, штамп, RichMedia та PDF3D.

Тепер, щоб додати SDK у свій проект, виконайте пошук Aspose.PDF-Cloud в менеджері пакетів NuGet і натисніть кнопку «Додати пакет». Наступним важливим кроком є реєстрація облікового запису через хмарну інформаційну панель і отримання особистих облікових даних клієнта. Перегляньте посібник Швидкий старт, щоб отримати додаткові відомості.

Додайте коментарі до PDF за допомогою C#

Давайте розглянемо фрагмент коду C# .NET, який використовується для додавання анотації до документа PDF.

// Повні приклади та файли даних див 
https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet

// Отримайте облікові дані клієнта з https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// створити об'єкт PdfApi
PdfApi api = new PdfApi(clientSecret, clientID);

// створити об'єкт List, що містить FreeTextAnnotations
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
{
new FreeTextAnnotation(
    // вкажіть прямокутну область, яка містить примітку 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)
        ))
    {
    // Вміст, який відображатиметься всередині 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);

Тепер давайте розберемося з фрагментом коду більш детально.

PdfApi api = new PdfApi(clientSecret, clientID);

Створіть екземпляр класу PdfApi, який приймає облікові дані клієнта як аргументи у своєму конструкторі.

List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>

Оскільки API підтримує можливість одночасного додавання однієї або кількох анотацій подібного типу, нам потрібно створити об’єкт List типу 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)
        ))

Створіть об’єкт FreeTextAnnotation, де ми визначимо прямокутну область для деталей анотації та форматування тексту.

Contents = "Confidential !"

Тут ми визначаємо вміст для FreeTextAnnotation.

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

Викличте REST API, щоб додати FreeTextAnnotation на першу сторінку документа PDF, який уже доступний у хмарному сховищі.

Нижче наведено можливі значення, які можна призначити властивостям, використаним у фрагменті коду вище.

– AnnotationFlags – підтримуваними значеннями можуть бути [Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents].

  • Rotate - кут повороту тексту. Можливими значеннями можуть бути [None, on90, on180, on270].
  • AnnotationFlags - набір прапорів, що визначають різні характеристики анотації. Можливе значення може бути [Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents].
  • FreeTextIntent - перераховує наміри довільної текстової анотації. Можливими значеннями можуть бути [Undefined, FreeTextCallout, FreeTextTypeWriter].

Додайте вільні текстові анотації до PDF за допомогою команд cURL

Використання команд cURL для виклику Aspose.PDF Cloud API є хорошим підходом для виконання цієї вимоги. Також добре, якщо ви знайомі з інструментами командного рядка або бажаєте ними користуватися. Отже, за допомогою інструмента командного рядка cURL ви можете надсилати HTTP-запити та виконувати різноманітні операції щодо обробки файлів PDF.

Тепер, щоб додати анотації до PDF-документа за допомогою команд cURL, спочатку нам потрібно згенерувати маркер автентифікації, надіславши запит кінцевій точці маркера з вашим SID програми та ключем програми. Виконайте таку команду, щоб створити 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"

Після створення accessToken виконайте наведену нижче команду, яка додасть анотацію FreeTextAnnotation до документа PDF. Анотований PDF-файл потім оновлюється в хмарному сховищі.

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

Замініть {inputPDF} на назву вхідного PDF-файлу, який уже доступний у хмарному сховищі, {accessToken} на маркер доступу JWT, згенерований вище.

Попередній перегляд анотації PDF

Зображення: - Попередній перегляд довільної текстової анотації у файлі PDF.

PDF-документ, використаний у наведеному вище прикладі, можна завантажити за цим посиланням.

Висновок

Підсумовуючи, додавання анотацій до PDF-файлів може значно підвищити їх корисність і функціональність. Незалежно від того, чи хочете ви виділити важливий текст, додати коментарі чи зробити нотатки безпосередньо в документі, Aspose.PDF Cloud стане чудовим вибором для досягнення цієї мети. Ми також дізналися, що Aspose.PDF Cloud SDK для команд .NET і cURL пропонують потужні рішення для анотування PDF-файлів, що дає вам можливість створювати індивідуальні робочі процеси та процеси автоматизації. Тому за допомогою цих інструментів ви можете швидко й легко додавати анотації до PDF-файлів, заощаджуючи час і підвищуючи продуктивність.

корисні посилання

Схожі статті

Ми настійно рекомендуємо переглянути такі блоги: