Про GroupDocs.Annotation для Net API

GroupDocs.Annotation for Net API — це бібліотека, яка дозволяє додавати анотації до PDF, Word та інших документів на Mac, Windows або Ubuntu. GroupDocs.Annotation for Net — це власний API Net для керування анотаціями з повною підтримкою створення, додавання, редагування, видалення, вилучення й експорту анотацій із зображень та різних інших документів. Повний список підтримуваних форматів документів можна переглянути на цій сторінці. Ця бібліотека дозволяє вам працювати не лише з документом DOT, а й з багатьма іншими типами документів, такими як Word, Excel, PowerPoint, електронні листи Outlook, Visio, Adobe, OpenDocument, OpenOffice, Photoshop, AutoCad та багато інших. GroupDocs.Annotation for Net API дозволяє створювати та додавати нові нотатки, редагувати анотації, отримувати коментарі, анотації та видаляти їх із документів. Бібліотека підтримує 13 різних типів анотацій, зокрема текст, ламана лінія, область, підкреслення, точка, водяний знак, стрілка, еліпс, заміна тексту, відстань, текстове поле, редакція ресурсу в документах PDF, HTML, Microsoft Word, електронних таблицях, діаграмах, презентаціях, малюнки, зображення та багато інших форматів файлів. Приклад (див. нижче) демонструє роботу з документом DOT, у цьому прикладі ви можете побачити основні кроки роботи з GroupDocs. Анотація: налаштуйте ліцензію, відкрийте документ, з яким хочете працювати, створіть анотація, додавання об’єктів даних для встановлення властивостей анотації відповідно до ваших вимог і збереження результату в потрібному місці. Також ви можете детальніше ознайомитися з підтримуваними функціями на нашій сторінці github або в документації нашого продукту.

Кроки для додавання анотацій до DOT у мережі

GroupDocs.Annotation дозволяє розробникам Net легко додавати різні типи анотацій до файлів DOT у будь-якій програмі на основі Net, реалізувавши кілька простих кроків.

  • Створення об’єктів відповіді з коментарем і датою.
  • Створіть об’єкт AreaAnnotation, установіть параметри області та додайте відповіді.
  • Створіть об’єкт Annotator і додайте анотацію області.
  • Зберегти вихідний файл.

Системні вимоги

GroupDocs.Annotation for Net API підтримуються на всіх основних платформах і операційних системах. Перш ніж виконувати наведений нижче код, переконайтеся, що у вашій системі встановлено такі передумови.

  • Операційні системи: Microsoft Windows, Linux, MacOS
  • Середовища розробки: Visual Studio, Xamarin, MonoDevelop
  • Фреймворки: .NET Framework, .NET Standard, .NET Core, Mono
  • Завантажте останню версію GroupDocs.Annotation для .NET із NuGet

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

//Add text field annotation to the document from local disk
using (Annotator annotator = new Annotator("input.bmp"))
{
    TextFieldAnnotation textField = new TextFieldAnnotation
    {
        BackgroundColor = 65535,
        Box = new Rectangle(100, 100, 100, 100),
        CreatedOn = DateTime.Now,
        Text = "Some text",
        FontColor = 65535,
        FontSize = 12,
        Message = "This is text field annotation",
        Opacity = 0.7,
        PageNumber = 0,
        PenStyle = PenStyle.Dot,
        PenWidth = 3,
        FontFamily = "Arial",
        TextHorizontalAlignment = HorizontalAlignment.Center,
        Replies = new List
        {
            new Reply
            {
                Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(textField);
    annotator.Save("result.bmp");
}

Annotation preview image

Кроки для видалення анотацій із DOT у мережі

GroupDocs.Annotation спрощує розробникам Net видаляти деталі анотації з файлів DOT у будь-якій програмі на базі Net, виконавши кілька простих кроків.

  • Створення об’єктів відповіді з коментарем і датою.
  • Створіть об’єкт SaveOptions і встановіть AnnotationTypes = AnnotationType.None.
  • Виклик методу збереження з кінцевим шляхом або потоком документа та об’єктом SaveOptions.

// 1- How to remove annotation from document using annotation index

using (Annotator annotator = new Annotator("result.bmp"))
{
    annotator.Remove(0);
    annotator.Save("removed.bmp");
}

// 2- How to remove annotation from document using annotation object

using (Annotator annotator = new Annotator("result.bmp"))
{
    var tmp = annotator.Get();
    annotator.Remove(tmp[0]);
    annotator.Save("removed.bmp");
}

// 3- How to remove some annotations from document using list of ID’s

using (Annotator annotator = new Annotator("result.bmp"))
{
    var idList = new List{1, 2, 3};
    annotator.Remove(idList);
    annotator.Save("removed.bmp");
}

// 4- How to remove some annotations from document using list of annotations

using (Annotator annotator = new Annotator("result.bmp"))
{
    var tmp = annotator.Get();
    annotator.Remove(tmp);
    annotator.Save("removed.bmp");
}

Кроки для редагування анотацій із DOT у мережі

GroupDocs.Annotation полегшує розробникам Net оновлення різноманітних властивостей анотацій із файлів DOT у будь-якій програмі на основі Net, реалізувавши кілька простих кроків.

  • Створення екземпляра об’єкта Annotator із вхідним шляхом документа або потоку з екземпляром LoadOptions із ImportAnnotations = true.
  • Створіть деяку реалізацію AnnotationBase та встановіть ідентифікатор наявної анотації (якщо анотація з таким ідентифікатором не знайдена, нічого не буде змінено) або список шляхів анотацій (усі існуючі анотації буде видалено).
  • Виклик методу оновлення об’єкта Annotator із переданими анотаціями.
  • Виклик методу збереження з кінцевим шляхом або потоком документа та об’єктом SaveOptions.

// open annotated document
using (Annotator annotator = new Annotator("result.bmp"))
{
    //assuming we are going to change some properties of existing annotation
        AreaAnnotation updated = new AreaAnnotation
            {
                    // It's important to set existed annotation Id
                    Id = 1,
                    BackgroundColor = 255,
                    Box = new Rectangle(0, 0, 50, 200),
                    CreatedOn = DateTime.Now,
                    Message = "This is updated annotation",
                    Replies = new List
                    {
                        new Reply
                        {
                            Comment = "Updated first comment",
                            RepliedOn = DateTime.Now
                        },
                        new Reply
                        {
                            Comment = "Updated second comment",
                            RepliedOn = DateTime.Now
                        }
                    }
                };
        // update annotation
        annotator.Update(updated);
        annotator.Save("result.bmp");
}

Кроки для вилучення анотацій із DOT у мережі

GroupDocs.Annotation полегшує розробникам Net коментувати документи та видобувати анотаційну інформацію з файлів DOT у будь-якій програмі на базі Net, виконавши кілька простих кроків.

  • Створення об’єктів відповіді з коментарем і датою.
  • Створення екземпляра об’єкта LoadOptions і виклику SetImportAnnotations з аргументом true.
  • Визначте змінну з типом List.
  • Виклик методу get і повернення результату до змінної вище.

// for using this example input file ("annotated.bmp") must be with annotations
using (Annotator annotator = new Annotator("annotated.bmp"))
{
    List annotations = annotator.Get();
    XmlSerializer formatter = new XmlSerializer(typeof(List));
    using (FileStream fs = new FileStream("annotations.xml", FileMode.Create))
    {
        fs.SetLength(0);
        formatter.Serialize(fs, annotations);
    }
}

Живі демонстрації для додавання, видалення, редагування та вилучення анотацій до документів і зображень

Додавайте, видаляйте, редагуйте та витягуйте анотації до файлу DOT прямо зараз, відвідавши веб-сайт GroupDocs.Annotation Live Demos. Жива демонстрація має такі переваги

Немає необхідності завантажувати API

Немає необхідності писати код

Просто завантажте вихідний файл

Закачати результуючий файл

Про формат файлу DOT

Файли з розширенням .DOT — це шаблонні файли, створені Microsoft Word із попередньо відформатованими налаштуваннями для створення подальших файлів DOC або DOCX. Файл шаблону створюється для того, щоб мати спеціальні параметри користувача, які слід застосовувати до наступних файлів, створених із них. Ці параметри включають поля сторінки, рамки, верхні та нижні колонтитули та інші параметри сторінки. Такі шаблони використовуються в офіційних документах, таких як фірмові бланки та стандартизовані форми. Формат файлу DOT є специфічним для Microsoft Word 2003 і попередніх версій, але підтримується й вищими версіями. Microsoft Word за замовчуванням відкриває кожен новий документ на основі файлу normal.dot. У разі змінення всі нові створені файли матимуть ті самі налаштування, що й у файлі шаблону. У Microsoft Word 2007 формат файлу DOT було замінено на формат файлу DOTX на основі Office OpenXML.

Детальніше Про формат файлу DOT

Робота з іншими популярними форматами документів

Оновіть властивості анотації з деяких популярних форматів файлів, як зазначено нижче.

Annotate PDF document

(Adobe Portable Document Format)

Annotate DOC document

(Microsoft Word Document)

Annotate DOCM document

(Microsoft Word Macro-Enabled Document)

Annotate DOCX document

(Microsoft Word Open XML Document)

Annotate DOT document

(Microsoft Word Document Template)

Annotate DOTX document

(Word Open XML Document Template)

Annotate RTF document

(Rich Text Document)

Annotate ODT document

(Open Document Text)

Annotate XLS document

(Microsoft Excel Binary File Format)

Annotate XLSX document

(Microsoft Excel Open XML Spreadsheet)

Annotate XLSM document

(Microsoft Excel Macro-Enabled Spreadsheet)

Annotate XLSB document

(Microsoft Excel Binary Worksheet)

Annotate ODS document

(Open Document Spreadsheet)

Annotate PPT document

(PowerPoint Presentation)

Annotate PPTX document

(PowerPoint Open XML Presentation)

Annotate PPSX document

(PowerPoint Open XML Slide Show)

Annotate POTM document

(Microsoft PowerPoint Template)

Annotate PPTM document

(Microsoft PowerPoint Presentation)

Annotate PPS document

(Microsoft PowerPoint 97-2003 Slide Show)

Annotate ODP document

(OpenDocument Presentation)

Annotate HTML document

(HyperText Markup Language)

Annotate TIFF document

(Tagged Image File Format)

Annotate PNG document

(Portable Network Graphic)

Annotate EML document

(E-mail Message)

Annotate MSG document

(Microsoft Outlook E-mail Message)

Annotate VSD document

(Microsoft Visio 2003-2010 Drawing)

Annotate VSDX document

(Microsoft Visio Drawing)

Annotate VSS document

(Microsoft Visio 2003-2010 Stencil)

Annotate VST document

(Microsoft Visio 2013 Stencil)

Annotate DWG document

(Autodesk Design Data Formats)

Annotate DXF document

(AutoCAD Drawing Interchange)

Annotate DCM document

(Digital Imaging and Communications in Medicine)

Annotate WMF document

(Windows Metafile)

Annotate EMF document

(Enhanced Metafile Format)

Back to top
 Українська