注釈 XML ストアを持つ DocumentViewer のサンプル

[アーティクル]
01/05/2009

更新 : 2007 年 11 月

DocViewerAnnotationsXml では、XML Paper Specification (XPS) ドキュメントを DocumentViewer コントロールに読み込み、ユーザーが作成したテキスト注釈、インク注釈、および強調表示の注釈の追加をサポートできるようにする方法を示します。この例では、ユーザーの注釈は XPS ドキュメントとは別の XML ファイルに格納されます。

サンプルを実行すると、[ファイル] メニューの [開く] オプションを持つメニューバーが表示されます。[Open] をクリックすると、[File Open] ダイアログボックスが表示され、ユーザーは開く XpsDocument コンテナファイル (サンプルの XML Paper Specification (XPS) ドキュメントファイルが提供されています) を参照して選択できます。

ドキュメントが開くと、そのコンテンツは、メインアプリケーションウィンドウ内の DocumentViewer コントロールに表示されます。DocumentViewer コントロール内では、コメントおよび注釈を追加するブロックテキストを選択できます。選択したテキストを右クリックすると [Annotations] コンテキストメニューが表示され、作成する注釈の種類 ([Highlight]、[Text Note]、または [Ink Note]) を選択できます。注釈の種類を選択すると、注釈の強調表示または形式が DocumentViewer コントロールに表示されます。テキスト注釈またはインク注釈には、個人的なコメントを追加できます。DocViewerAnnotationsXml のサンプルでは、ユーザーの注釈は、XML Paper Specification (XPS) ドキュメントと同じフォルダ内の別の annotations.xml ファイルに格納されます。

DocViewerAnnotationsXml サンプルのソースコードは、次の 4 つのファイルで構成されます。

MyApp.xaml - アプリケーション用の Extensible Application Markup Language (XAML) リソース (このサンプルにはありません)。
MyApp.xaml.cs - アプリケーションウィンドウの作成および表示用の分離コード。
Window1.xaml - アプリケーションウィンドウの要素 (メインメニュー、メニューコマンド、DocumentViewer コントロール、DocumentViewer の注釈コンテキストメニュー、コンテキストメニューコマンド) を定義する XAML 宣言。
Window1.xaml.cs - メインメニュー、コンテキストメニューの各コマンドのユーザーインターフェイスをサポートする分離コード。

プロジェクトファイルおよびサンプルの XPS ドキュメントも提供されます。XPS ドキュメント、およびその中に含まれるファイルのコンテンツを確認するには、単純にこのドキュメントファイルの拡張子を .xps から .zip に変更し、Zip ユーティリティを使用してそのファイルを開きます。

このサンプルでは、Windows Presentation Foundation の特定の機能を示します。そのため、アプリケーション開発のベストプラクティスに従っていません。Windows Presentation Foundation (WPF) と Microsoft .NET Framework のアプリケーション開発ベストプラクティスの包括的な説明については、適宜、次のトピックを参照してください。

ユーザー補助 - 「ユーザー補助のベストプラクティス」

セキュリティ - 「Windows Presentation Foundation のセキュリティ」

ローカリゼーション - 「WPF のグローバリゼーションおよびローカリゼーションの概要」

Download sample

サンプルのビルド

Windows ソフトウェア開発キット (SDK) をインストールして、そのビルド環境のコマンドウィンドウを開きます。[スタート] メニューの [すべてのプログラム]、[Microsoft Windows SDK] の順にポイントし、[CMD シェル] をクリックします。
サンプルをハードディスクドライブにダウンロードします。通常は、ソフトウェア開発キット (SDK) のドキュメントからダウンロードします。
ビルド環境のコマンドウィンドウからサンプルをビルドするには、サンプルのソースディレクトリに移動します。コマンドプロンプトで「MSBUILD」と入力します。
Microsoft Visual Studio でサンプルをビルドするには、サンプルソリューションかプロジェクトファイルを読み込んで、Ctrl キーと Shift キーを押しながら B キーを押します。