Zapomeňte na diskusi o obsahu dokumentů a zpětné vazbě v dlouhých e-mailových vláknech. Jednoduše použijte anotace k označení dokumentů zprávami a odpověďmi. V tomto článku se dozvíte, jak programově přidávat a odebírat anotace pro označování dokumentů Wordu v C# pomocí aplikací .NET.

Níže jsou stručně diskutována následující témata:

.NET API pro anotování a označování souborů Word

GroupDocs.Annotation poskytuje rozhraní .NET API pro práci s anotacemi pro vaše dokumenty a obrázky v aplikacích .NET. Rozhraní API umožňuje přidávat, odebírat a extrahovat anotace z dokumentů aplikace Word. Dále podporuje tabulky, prezentace, obrázky, soubory PDF, webové stránky, e-mailové zprávy, kresby Visio. Na seznamu jsou také některé výkresy AutoCAD a formáty digitálního zobrazení, jako je DICOM. Úplný seznam podporovaných formátů dokumentů pro anotaci naleznete v dokumentaci.

Stáhněte si DLL nebo instalační program MSI z části ke stažení nebo nainstalujte API do své aplikace .NET prostřednictvím NuGet. Můžete také použít následující příkaz ze Správce balíčků.

PM> Install-Package GroupDocs.Annotation

Přidání anotací do Wordu v C#

Pojďme přidat některé z různých druhů anotací do dokumentů aplikace Word. Existuje mnoho různých typů anotací, proto se v tomto článku budeme zabývat pouze některými.

Přidejte poznámky do DOC DOCX pomocí GroupDocs API

Existují některé z podporovaných typů anotací, můžete se o každé anotaci dozvědět jednotlivě.

  • Anotace oblasti / obdélníku
  • Šipka
  • Zdůraznit
  • Vodoznak
  • Vzdálenost
  • Přeškrtnutí
  • Textové pole
  • Elipsa
  • Zvýraznit
  • Odkaz
  • Směřovat
  • Polyline
  • Výměna, nahrazení
  • Redakce zdrojů
  • Redakce textu

Přidat anotaci šipky do Wordu pomocí C#

Následují kroky, jak přidat anotaci šipky do dokumentu aplikace Word v C#.

Přidejte Arrow Anotace programově v Java a .NET
  • Načtěte dokument pomocí třídy Anotátor.
  • Inicializujte anotaci šipky pomocí třídy ArrowAnnotation.
  • Upravte polohu, velikost a číslo stránky anotace šipky.
  • Přidejte vytvořenou anotaci šipky pomocí metody Add.
  • Uložte anotovaný dokument aplikace Word do cesty pomocí metody Save.

Následující ukázka kódu ukazuje, jak přidat anotaci šipky do dokumentu aplikace Word pomocí jazyka C#.

// Přidejte anotaci šipky do dokumentů aplikace Word pomocí C#
using (Annotator annotator = new Annotator("path/document.docx"))
{
    ArrowAnnotation arrow = new ArrowAnnotation
    {
        Box = new Rectangle(100, 100, 50, 50),
        CreatedOn = DateTime.Now,
        Message = "Your Message",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -3407872,
        PenStyle = PenStyle.Solid,
        PenWidth = 2
    };
    annotator.Add(arrow);
    annotator.Save("path/annotation.docx");
}

Vložit obdélníkovou nebo plošnou anotaci do Wordu pomocí C#

Úpravy lze provést pro jakoukoli anotaci při jejím přidávání do dokumentu. Následují kroky pro přidání obdélníkové nebo plošné anotace do dokumentu DOC/DOCX s některými úpravami. Je to velmi podobné přidávání anotací Arrow, ale tentokrát používá třídu AreaAnnotation.

  • Načtěte dokument DOC/DOCX pomocí třídy Annotator.
  • Inicializujte obdélníkovou anotaci pomocí třídy AreaAnnotation.
  • Upravte polohu, velikost a barvu obdélníku.
  • Nastavte další vlastnosti, jako je číslo stránky, pozadí, neprůhlednost, styl, šířka pera, zprávy a čas.
  • Přidejte vytvořenou anotaci obdélníku do anotátoru.
  • Uložte soubor s poznámkami do cesty pomocí metody Save.
Přidejte obdélníkovou nebo plošnou anotaci programově v .NET a Java

Následující ukázka kódu ukazuje, jak přidat poznámku obdélník/oblast do dokumentu aplikace Word pomocí jazyka C#.

// Přidat oblast nebo obdélníkovou anotaci do dokumentů aplikace Word pomocí C#
using (Annotator annotator = new Annotator("path/document.docx"))
{
    AreaAnnotation area = new AreaAnnotation
    {
        BackgroundColor = 65535,
        Box = new Rectangle(80, 75, 450, 135),
        Message = "This is area annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -131,
        PenStyle = PenStyle.Dash,
        PenWidth = 3
    };
    annotator.Add(area);
    annotator.Save("path/annotation.docx");
}

Přidejte oválnou nebo elipsovou anotaci do Wordu pomocí C#

Následují kroky, jak přidat oválnou anotaci nebo elipsu do dokumentu v C#.

Přidejte elipsy nebo oválné anotace programově v C# .NET a Java
  • Načtěte dokument DOC/DOCX pomocí třídy Annotator.
  • Inicializujte anotaci elipsy pomocí třídy EllipseAnnotation.
  • Nastavte polohu a velikost inicializované elipsové anotace.
  • Přidejte vytvořenou anotaci elipsy do objektu Annotator.
  • Zadejte cestu a uložte anotovaný soubor aplikace Word pomocí metody Save.

Následující ukázka kódu ukazuje, jak přidat oválnou nebo elipsu do dokumentu aplikace Word pomocí jazyka C#.

// Přidejte oválnou nebo elipsovou anotaci do dokumentů aplikace Word pomocí C#
using (Annotator annotator = new Annotator("path/document.docx"))
{
    EllipseAnnotation ellipse = new EllipseAnnotation
    {
        BackgroundColor = -16034924,
        Box = new Rectangle(275, 475, 300, 80),
        Message = "This is ellipse annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -16034924,
        PenStyle = PenStyle.Dot,
        PenWidth = 3
    };
    annotator.Add(ellipse);
    annotator.Save("path/annotation.docx");
}

Vložit anotaci vzdálenosti do Wordu pomocí C#

Podobně můžete přidat anotaci vzdálenosti pro označení vzdálenosti mezi dvěma body. Následují kroky, jak do dokumentu přidat anotaci vzdálenosti.

Přidejte anotaci vzdálenosti programově v C# .NET a Java
  • Po načtení dokumentu aplikace Word inicializujte anotaci vzdálenosti pomocí třídy DistanceAnnotation.
  • Nastavte vzhled anotace.
  • Přidejte anotaci vzdálenosti k objektu Annotator.
  • Uložte anotované soubory Wordu do daného umístění zadáním cesty.

Následující ukázka kódu ukazuje, jak přidat anotaci vzdálenosti do dokumentu DOC/DOCX pomocí C#.

// Přidat anotaci vzdálenosti do dokumentů aplikace Word pomocí C#
using (Annotator annotator = new Annotator("path/document.docx"))
{
    DistanceAnnotation distance = new DistanceAnnotation
    {
        Box = new Rectangle(750, 235, 0, 150),
        Message = "This is the heading area",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -21197,
        PenStyle = PenStyle.Solid,
        PenWidth = 3
    };
    annotator.Add(distance);
    annotator.Save("path/annotation.docx");
}

Kompletní kód

Abych to shrnul, zde je kompletní kód s výstupem zobrazujícím všechny přidané anotace a zprávy s odpověďmi. Následující kód C# níže přidává šipku, obdélník, elipsu, poznámky vzdálenosti, zprávy a odpovědi do souboru aplikace Word.

// Přidání více anotací do Wordu pomocí C#
// Přidání anotací šipky, plochy, oválu (elipsy), vzdálenosti do DOC/DOCX se zprávami a odpověďmi pomocí C#
string outputPath = @"outputPath/annotatedDoc.docx";
string inputFile = @"inputPath/document.docx";

using (Annotator annotator = new Annotator(inputFile))
{
    ArrowAnnotation arrow = new ArrowAnnotation
    {
        Box = new Rectangle(550, 250, 60, -60),
        CreatedOn = DateTime.Now,
        Message = "This image is little upwards.",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -3407872,
        PenStyle = PenStyle.Solid,
        PenWidth = 2,
        Replies = new List<Reply>
        {
            new Reply
            {
                Comment = "Please look in to these issues.",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                    Comment = "Change Description",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                Comment = "On-Premises APIs",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                Comment = "Add images as well.",
                RepliedOn = DateTime.Now
            }
        }
    };
    AreaAnnotation area = new AreaAnnotation
    {
        BackgroundColor = 65535,
        Box = new Rectangle(80, 75, 450, 135),
        Message = "This is area annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -131,
        PenStyle = PenStyle.Dash,
        PenWidth = 3
    };
    EllipseAnnotation ellipse = new EllipseAnnotation
    {
        BackgroundColor = -16034924,
        Box = new Rectangle(275, 475, 300, 80),
        Message = "This is ellipse annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -16034924,
        PenStyle = PenStyle.Dot,
        PenWidth = 3
    };
    DistanceAnnotation distance = new DistanceAnnotation
    {
        Box = new Rectangle(750, 235, 0, 150),
        Message = "This is the heading area",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -21197,
        PenStyle = PenStyle.Solid,
        PenWidth = 3
    };
    annotator.Add(arrow);
    annotator.Add(area);
    annotator.Add(ellipse);
    annotator.Add(distance);

    annotator.Save(outputPath);
}

Odebrat anotace ze souborů Word DOC/DOCX pomocí C#

Anotace z dokumentů lze snadno odstranit. Existuje mnoho možností, jak odstranit anotace z dokumentu aplikace Word. Všechny anotace můžete odstranit najednou. Kromě toho můžete poskytnout indexy pro odstranění konkrétních poznámek. Další možnosti naleznete v článku dokumentace.

Následují kroky k odstranění všech anotací ze souboru aplikace Word.

  • Vložte dokument.
  • Inicializujte možnosti ukládání pomocí třídy SaveOptions.
  • Nastavte typy poznámek na Žádné.
  • Uložte soubor aplikace Word. Nebude v něm žádná anotace.

Následující kód ukazuje, jak odstranit anotace ze souboru Word pomocí C#.

// Odstraňte všechny anotace z dokumentu Word pomocí C#
using (Annotator annotator = new Annotator(outputPath))
{
    annotator.Save(remOutputPath, new SaveOptions {AnnotationTypes = AnnotationType.None});
}

Závěr

Stručně řečeno, naučili jste se přidávat anotace do dokumentů Wordu v aplikacích .NET pomocí C#. Konkrétně jsme do souboru Word DOC/DOCX přidali anotace šipky, elipsy, plochy a vzdálenosti. Dále jste také viděli, jak odstranit všechny anotace z libovolného souboru aplikace Word. Nyní si můžete vytvořit vlastní aplikaci pro anotaci dokumentů .NET.

Další informace o GroupDocs.Annotation for .NET naleznete v dokumentaci a v úložišti GitHub. Pro další dotazy kontaktujte podporu na fóru.

Viz také