注釈は通常、ドキュメント内のエラーについて言及したり、その内容について話し合ったりするために使用されます。注釈を使用すると、電子メールスレッド内での長くて終わりのない議論を避けることができます。この記事では、JavaでWord文書をマークアップするためにプログラムで注釈を追加および削除する方法を学習します。
以下は、以下で簡単に説明するトピックです。
Wordファイルに注釈を付けてマークアップするJavaAPI
GroupDocs.Annotation は、注釈を処理するためのJavaAPIを提供します。 APIを使用すると、Word文書や他の多くのファイル形式から注釈を追加、削除、および抽出できます。 サポートされているドキュメント形式 には次のものが含まれます。スプレッドシート、プレゼンテーション、画像、PDFファイル、Webページ、電子メールメッセージ、Visio図面。
ダウンロードまたは構成
ダウンロードセクション から** JAR **ファイルをダウンロードするか、**mavenベース*のpom.xmlの最新のリポジトリと依存関係の構成を取得します。 *Javaアプリケーション。
<repository>
<id>GroupDocsJavaAPI</id>
<name>GroupDocs Java API</name>
<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation</artifactId>
<version>21.7.2</version>
</dependency>
JavaでWordに注釈を追加する
Word文書にさまざまな種類の注釈を追加してみましょう。アノテーションにはさまざまな種類があるため、ここではほんの一部を取り上げます。
JavaでWordに矢印注釈を追加
以下は、JavaでWord文書に矢印注釈を追加する手順です。
- Annotator クラスを使用してドキュメントをロードします。
- ArrowAnnotation クラスで矢印アノテーションを初期化します。
- 矢印注釈の位置、サイズ、ページ番号を調整します。
- add() メソッドを使用して、作成された矢印注釈を追加します。
- 適切なsave() メソッドを使用して、注釈付きのWord文書をパスに保存します。
次のJavaコードサンプルは、Word文書に矢印注釈を追加する方法を示しています。
// JavaのWord文書にArrow注釈を追加する
final Annotator annotator = new Annotator("path/document.docx");
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(100, 100, 100, 100));
arrow.setMessage("Arrow annotation");
arrow.setOpacity(0.7);
arrow.setPageNumber(0);
arrow.setPenColor(0x65535);
arrow.setPenStyle(PenStyle.Dot);
arrow.setPenWidth((byte) 3);
annotator.add(arrow);
annotator.save("path/annotatedDoc.docx");
JavaのWordに長方形または領域の注釈を挿入する
以下は、いくつかのカスタマイズを使用して、DOC/DOCXドキュメントに長方形または領域の注釈を追加する手順です。 Arrow注釈の追加に似ていますが、AreaAnnotation を使用します。
- Annotator クラスを使用してWord DOC/DOCXドキュメントをロードします。
- AreaAnnotation クラスを使用して長方形の注釈を初期化します。
- 長方形の位置、サイズ、色を調整します。
- ページ番号、背景、不透明度、スタイル、ペン幅、メッセージ、時間 などの他のプロパティを設定します。
- 作成した長方形の注釈をアノテーターに追加します。
- save() メソッドを使用して、注釈付きのWord文書をパスに保存します。
次のJavaコードサンプルは、Wordドキュメントに長方形/領域の注釈を追加する方法を示しています。
// JavaのWord文書に面積または長方形の注釈を追加する
final Annotator annotator = new Annotator("path/document.docx");
AreaAnnotation area = new AreaAnnotation();
area.setBackgroundColor(65535);
area.setBox(new Rectangle(100, 100, 100, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("This is area annotation");
area.setOpacity(0.7);
area.setPageNumber(0);
area.setPenColor(65535);
area.setPenStyle(PenStyle.Dot);
area.setPenWidth((byte) 3);
area.setReplies(replies);
annotator.add(area);
annotator.save("path/annotatedDoc.docx");
JavaのWordに楕円または楕円の注釈を追加する
以下は、Javaでドキュメントに楕円/楕円の注釈を追加する手順です。
- Annotator クラスを使用してDOC/DOCXドキュメントをロードします。
- EllipseAnnotation クラスを使用して楕円アノテーションを初期化します。
- 初期化された楕円注釈の位置とサイズを設定します。
- 作成した楕円注釈をアノテーターに追加します。
- 適切なsave() メソッドを使用して、注釈付きのWordファイルを保存します。
次のJavaコードサンプルは、任意のWord文書に楕円/楕円の注釈を追加する方法を示しています。
// JavaのWord文書に楕円または楕円の注釈を追加する
final Annotator annotator = new Annotator("path/document.docx");
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBackgroundColor(65535);
ellipse.setBox(new Rectangle(100, 100, 100, 100));
ellipse.setCreatedOn(Calendar.getInstance().getTime());
ellipse.setMessage("This is ellipse annotation");
ellipse.setOpacity(0.7);
ellipse.setPageNumber(0);
ellipse.setPenColor(65535);
ellipse.setPenStyle(PenStyle.Dot);
ellipse.setPenWidth((byte) 3);
ellipse.setReplies(replies);
annotator.add(ellipse);
annotator.save("path/annotatedDoc.docx");
JavaでWordに距離注釈を挿入
同様に、距離アノテーションを使用して2点間の距離を指定できます。以下は、Javaでドキュメントに距離注釈を追加する手順です。
- Wordドキュメントを読み込んだ後、DistanceAnnotation クラスを使用して距離アノテーションを初期化します。
- 注釈の外観を設定します。
- 距離注釈をAnnotatorオブジェクトに追加します。
- 注釈付きドキュメントを指定された場所に保存するか、適切なsave() メソッドを使用します。
次のJavaコードサンプルは、DOC/DOCXドキュメントに距離注釈を追加する方法を示しています。
// JavaのWord文書に距離注釈を追加する
final Annotator annotator = new Annotator("path/document.docx");
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(200, 150, 200, 30));
distance.setCreatedOn(Calendar.getInstance().getTime());
distance.setMessage("This is distance annotation");
distance.setOpacity(0.7);
distance.setPageNumber(0);
distance.setPenColor(65535);
distance.setPenStyle(PenStyle.Dot);
distance.setPenWidth((byte) 3);
distance.setReplies(replies);
annotator.add(distance);
annotator.save("path/annotatedDoc.docx");
JavaのWordDOC/DOCXファイルから注釈を削除する
Word文書から注釈を削除する方法はたくさんあります。特定の注釈を削除するためのインデックスを提供することにより、特定の注釈を削除できます。さらに、すべての注釈を一度に削除できます。アノテーションを削除するための詳細とJavaソースコードについては、別の記事で説明しています。
以下は、Wordファイルからすべての注釈を削除する手順です。
- ドキュメントをロードします。
- 保存オプション を初期化します。
- アノテーションタイプ を[なし]に設定します。
- Wordファイルを保存します。注釈はありません。
次のコードは、JavaでWordファイルから注釈を削除する方法を示しています。
// JavaのWord文書からすべての注釈を削除します
final Annotator annotator = new Annotator("path/annotatedDoc.docx");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
annotator.save("path/annotationsRemoved.docx", saveOptions);
結論
要約すると、Javaアプリケーション内でWord文書に注釈を追加する方法を学びました。具体的には、GroupDocs.Annotation for Java を使用して、Word DOC / DOCXファイルに矢印、楕円、面積、距離の注釈を追加しました。さらに、Wordファイルからすべての注釈を削除する方法も確認しました。これで、独自のドキュメントアノテーターJavaアプリケーションを作成してみることができます。
APIの詳細については、ドキュメント およびGitHub リポジトリをご覧ください。詳細については、フォーラム のサポートにお問い合わせください。