PDFビューワは、テキスト注釈とその返信を追加する機能をPDFドキュメント内のコメントとして提供します。本機能は、ディスカッションを行ったり、質問したり、重要な情報を追加したりするのに非常に役立ちます。コメントパネルを使用すると、テキスト注釈に返信を追加したり、コメントパネルですべてのコメントを表示したり、コメントを編集または削除したり、レビューステータスを割り当てたりすることができます。

コメントの追加

PDFビューワのコンテキストメニューを使用して、PDFドキュメントにコメントを直接追加できます。コンテキストメニューを使用すると、選択項目に付箋を追加したり、コメントを追加したりできます。これらのオプションは、デフォルトでコンテキストメニューで使用できます。コメントパネルを使用して、新しく追加されたコメントを表示したり、コメントを編集または削除することができます。コメントを追加すると、コメントパネルが自動的にアクティブになり、リスト内の新しいコメントに焦点が当てられます。詳細については、「コメントパネル」を参照してください。

選択範囲にコメントの追加

コンテキストメニューの［コメントを追加］オプションを使用して、選択したテキストにコメントを追加することができます。

以下の画像は、選択範囲にコメントを追加する方法を示しています。

PDFドキュメントに付箋の追加

コンテキストメニューの［付箋を追加］オプションを使用して、PDFドキュメントに付箋を追加することができます。

以下の画像は、PDFドキュメントに付箋を追加する方法を示しています。

コメントパネルで、返信を追加したり、作成者名を設定したり、メモを変更または削除したり、レビューステータスを割り当てたりすることもできます。.

コメントパネル

コメントパネルには、コメントを簡単に操作するためのさまざまな機能が用意されており、PDFドキュメントの作成者とコミュニケーションをとることができます。コメントパネルのコメントに返信を追加したり、作成者名を設定したり、コメントを編集または削除したり、レビューステータスを割り当てたりすることができます。詳細については、「コメントパネルによるコメントの操作」を参照してください。

コメントまたは付箋を追加すると、コメントパネルが自動的にアクティブになり、リスト内の新しいコメントに焦点が当てられます。コメントパネルが表示されると、Tabキーを使用してコメント間を移動できます。コメントパネルを表示するには、次のいずれかを選択できます。

• ページを右クリックし、コンテキストメニューから［コメントパネルを表示］を選択します。
• PDFビューワの右端にある矢印をクリックします。

PDFビューワでは、コメントパネルのサイズを変更することもできます。コメントパネルのサイズを変更するには、次のいずれかを選択できます。

• コメントパネルの境界線にカーソルを置き、サイズ変更のハンドルを表示します。
• マウスボタンを左クリックし、ポインタを左または右に移動して、サイドバーの幅を広げたり狭めたりします。

コメントパネルの有効化

コメントパネルはデフォルトで非表示になっています。次に示すように、addReplyTool メソッドを使用してプログラムでコメントパネルを有効にすることができます。

viewer.addReplyTool();

次のコードを使用して、コメントパネルをデフォルトで展開状態で有効にすることもできます。

viewer.addReplyTool("expanded");

コメントパネルによるコメントの操作

コメントに返信の追加

［返信］をクリックすると、コメントパネルのコメントに返信を追加できます。

コメントの作成者の設定

コメントを返信する際、デフォルトで作成者名は匿名ユーザーとして表示されます。ただし、次のいずれかの方法で作成者名を設定することができます。

• コメントパネル内の作成者名ラベルをクリックすることで組み込みのテキストエディタを有効にし、コメントパネルで作成者名を直接設定します。
  
• 次のコードのように API の userName オプションを使用することで作成者の名前を設定します。

  Index.cshtml	コードのコピー
  var viewer = new DsPdfViewer("#root", { userName: 'Jaime Smith', supportApi: 'api/pdf-viewer' });

コメントにレビューステータスの追加

［アクション］ > ［ステータス］をクリックして、コメントパネルのコメントにレビューステータスを追加することもできます。

ステータスはコメントにアイコンとして追加され、カーソルを合わせると担当者の名前が表示されます。レビューステータスは、元のコメントの下のPDFドキュメントにも表示されます。あるユーザーがテキスト注釈にステータスを1つしか割り当てられませんが、複数のユーザーがあるテキスト注釈にステータスを割り当てることができます。

次のプロパティを設定することにより、コードでテキスト注釈のステータスを割り当てることも可能です：title、state、stateModel、referenceType、referenceAnnotationId。以下のサンプルコードは、IDが「6R」のテキスト注釈に返信を追加し、「完了」ステータスを割り当てる方法を示しています。

function addCompletedStatus() {
    viewer.findAnnotations("6R").then(function (searchResult) {
        var userName = "Jane Donahue";
        var replyAnnotation = viewer.cloneAnnotation(searchResult[0].annotation);
        replyAnnotation.title = userName;
        replyAnnotation.stateModel = 'Review';
        replyAnnotation.state = 'Completed';
        replyAnnotation.referenceType = 'R';
        replyAnnotation.referenceAnnotationId = '6R';
        replyAnnotation.contents = 'Status Completed set by ' + userName;
        viewer.addAnnotation(0, replyAnnotation);
    });
}

コメントの編集・削除

次の画像で示すように、テキスト注釈または返信を、コメントパネルでクリックすると編集できます。

コメントリスト内のコメントに返信すると、コメントパネルにPDFページ上のコメントが強調表示されます。

［アクション］ > ［削除］をクリックしてコメントや返信を削除できます。

コメントパネルのカスタマイズ

コメントパネルの動作をプログラムでカスタマイズすることができます。次のコードのように、さまざまなカスタマイズを実現できます。

例1：コメントパネルの自動アクティブ化を無効にする

var viewer = new DsPdfViewer("#root", { replyTool: { autoExpandOnCommentAdd: false }});

例2：コメントパネルのアイコンの色を有効にする

var viewer = new DsPdfViewer("#root", { replyTool: { useColoredIcons: true }});