Zapomnij o omawianiu treści dokumentów i opinii w długich wątkach e-maili. Po prostu używaj adnotacji do oznaczania dokumentów wiadomościami i odpowiedziami. W tym artykule dowiesz się, jak programowo dodawać i usuwać adnotacje do znaczników dokumentów programu Word w języku C# za pomocą aplikacji .NET.

Oto tematy omówione pokrótce poniżej:

Interfejs API platformy .NET do dodawania adnotacji i oznaczania plików Word

GroupDocs.Annotation zapewnia interfejs API .NET do pracy z adnotacjami do dokumentów i obrazów w aplikacjach .NET. Interfejs API umożliwia dodawanie, usuwanie i wyodrębnianie adnotacji z dokumentów programu Word. Ponadto obsługuje arkusze kalkulacyjne, prezentacje, obrazy, pliki PDF, strony internetowe, wiadomości e-mail, rysunki programu Visio. Na liście znajdują się również niektóre rysunki AutoCAD i formaty obrazowania cyfrowego, takie jak DICOM. Pełną listę obsługiwanych formatów dokumentów dla adnotacji można znaleźć w dokumentacji.

Pobierz instalator bibliotek DLL lub MSI z sekcji pobierania lub zainstaluj interfejs API w swojej aplikacji .NET za pośrednictwem NuGet. Możesz także użyć następującego polecenia z Menedżera pakietów.

PM> Install-Package GroupDocs.Annotation

Dodaj adnotacje do programu Word w języku C#

Dodajmy niektóre z różnych rodzajów adnotacji do dokumentów programu Word. Istnieje wiele różnych rodzajów adnotacji, dlatego w tym artykule omówimy tylko kilka z nich.

Dodaj adnotacje do DOC DOCX za pomocą GroupDocs API

Istnieje kilka obsługiwanych typów adnotacji, możesz poznać każdą adnotację z osobna.

  • Adnotacja obszaru / prostokąta
  • Strzałka
  • Podkreślać
  • znak wodny
  • Dystans
  • Skreślony
  • Pole tekstowe
  • Elipsa
  • Atrakcja
  • Połączyć
  • Punkt
  • Polilinia
  • Wymiana
  • Redakcja zasobów
  • Redagowanie tekstu

Dodaj adnotację strzałki do programu Word za pomocą C#

Poniżej przedstawiono kroki dodawania adnotacji strzałek do dokumentu programu Word w języku C#.

Programowe dodawanie adnotacji strzałek w językach Java i .NET
  • Załaduj dokument, używając klasy Annotator.
  • Zainicjuj adnotację strzałki za pomocą klasy ArrowAnnotation.
  • Dostosuj położenie, rozmiar, numer strony adnotacji strzałki.
  • Dodaj utworzoną adnotację strzałkową za pomocą metody Dodaj.
  • Zapisz dokument programu Word z adnotacjami w ścieżce przy użyciu metody Save.

Poniższy przykładowy kod pokazuje, jak dodać adnotację strzałki do dokumentu programu Word przy użyciu języka C#.

// Dodaj adnotację Arrow do dokumentów programu Word za pomocą języka 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");
}

Wstaw adnotację prostokąta lub obszaru do programu Word za pomocą C#

Dostosowania można dokonać dla dowolnej adnotacji podczas dodawania jej do dokumentu. Poniżej przedstawiono kroki dodawania adnotacji prostokąta lub obszaru do dokumentu DOC/DOCX z pewnymi dostosowaniami. Jest to bardzo podobne do dodawania adnotacji Arrow, ale tym razem wykorzystuje klasę AreaAnnotation.

  • Załaduj dokument DOC/DOCX, używając klasy Annotator.
  • Zainicjuj adnotację prostokąta za pomocą klasy AreaAnnotation.
  • Dostosuj położenie, rozmiar i kolor prostokąta.
  • Ustaw inne właściwości, takie jak numer strony, tło, krycie, styl, szerokość pióra, komunikaty i czas.
  • Dodaj utworzoną adnotację prostokąta do adnotatora.
  • Zapisz plik z adnotacjami w ścieżce przy użyciu metody Save.
Programowe dodawanie adnotacji prostokąta lub obszaru w .NET i Javie

Poniższy przykładowy kod pokazuje, jak dodać adnotację prostokąta/obszaru do dokumentu programu Word przy użyciu języka C#.

// Dodaj adnotację obszaru lub prostokąta w dokumentach programu Word za pomocą języka 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");
}

Dodaj adnotację owalną lub elipsę do programu Word za pomocą C#

Poniżej przedstawiono kroki dodawania adnotacji owalnej lub elipsy do dokumentu w języku C#.

Programowe dodawanie elips lub adnotacji owalnych w językach C# .NET i Java
  • Załaduj dokument DOC/DOCX, używając klasy Annotator.
  • Zainicjuj adnotację elipsy za pomocą klasy EllipseAnnotation.
  • Ustaw pozycję i rozmiar zainicjowanej adnotacji wielokropka.
  • Dodaj utworzoną adnotację elipsy do obiektu Annotator.
  • Podaj ścieżkę i zapisz plik programu Word z adnotacjami, korzystając z metody Save.

Poniższy przykładowy kod pokazuje, jak dodać adnotację owalną lub elipsy do dokumentu programu Word przy użyciu języka C#.

// Dodaj adnotację owalną lub elipsę w dokumentach programu Word za pomocą języka 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");
}

Wstaw adnotację odległości do programu Word za pomocą C#

Podobnie możesz dodać adnotację odległości, aby zaznaczyć odległość między dwoma punktami. Poniżej przedstawiono kroki, aby dodać adnotację odległości do dokumentu.

Programowe dodawanie adnotacji odległości w językach C# .NET i Java
  • Po załadowaniu dokumentu Word zainicjuj adnotację odległości przy użyciu klasy DistanceAnnotation.
  • Ustaw wygląd adnotacji.
  • Dodaj adnotację odległości do obiektu Adnotator.
  • Zapisz pliki programu Word z adnotacjami w podanej lokalizacji, określając ścieżkę.

Poniższy przykładowy kod pokazuje, jak dodać adnotację odległości do dokumentu DOC/DOCX przy użyciu języka C#.

// Dodaj adnotację odległości do dokumentów programu Word za pomocą języka 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");
}

Kompletny kod

Podsumowując, oto pełny kod z wyjściem pokazującym wszystkie dodane adnotacje i wiadomości z odpowiedziami. Poniższy kod w języku C# dodaje strzałki, prostokąty, elipsy, adnotacje odległości, komunikaty i odpowiedzi do pliku programu Word.

// Dodaj wiele adnotacji do programu Word za pomocą języka C#
// Dodawanie adnotacji Arrow, Area, Oval (Elipsa), Distance do DOC/DOCX z wiadomościami i odpowiedziami przy użyciu 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);
}

Usuń adnotacje z plików Word DOC/DOCX za pomocą C#

Adnotacje z dokumentów można łatwo usunąć. Istnieje wiele opcji usuwania adnotacji z dokumentu programu Word. Możesz usunąć wszystkie adnotacje naraz. Dodatkowo możesz podać indeksy, aby usunąć określone adnotacje. Więcej opcji znajdziesz w artykule dokumentacja.

Poniżej przedstawiono kroki, aby usunąć wszystkie adnotacje z pliku Word.

  • Załaduj dokument.
  • Zainicjuj opcje zapisywania przy użyciu klasy SaveOptions.
  • Ustaw typy adnotacji na Brak.
  • Zapisz plik Worda. Nie będzie w nim żadnej adnotacji.

Poniższy kod pokazuje, jak usunąć adnotacje z pliku programu Word przy użyciu języka C#.

// Usuń wszystkie adnotacje z dokumentu Word za pomocą C#
using (Annotator annotator = new Annotator(outputPath))
{
    annotator.Save(remOutputPath, new SaveOptions {AnnotationTypes = AnnotationType.None});
}

Wniosek

Krótko mówiąc, nauczyłeś się dodawać adnotacje do dokumentów programu Word w aplikacjach .NET przy użyciu języka C#. W szczególności dodaliśmy adnotacje strzałek, elips, obszarów i odległości do pliku Word DOC/DOCX. Ponadto widziałeś również, jak usunąć wszystkie adnotacje z dowolnego pliku Word. Teraz możesz pomyśleć o zbudowaniu własnej aplikacji .NET do adnotacji dokumentów.

Dowiedz się więcej o GroupDocs.Annotation for .NET z repozytorium documentation i GitHub. W przypadku dalszych pytań skontaktuj się z pomocą techniczną na forum.

Zobacz też