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.

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#.

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

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#.

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

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