带有批注 XPS 存储区的 DocumentViewer 的示例

更新:2007 年 11 月

DocViewerAnnotationsXps 演示如何将 XML 纸张规范 (XPS) 文档读取到 DocumentViewer 控件中,然后启用对添加用户创建的文本说明、墨迹说明和突出显示批注的支持。在此示例中,用户批注存储在一个作为 XPS 文档一部分的 XML 文件中。  

在执行该示例时,它将显示一个带有“File”(文件)|“Open...”(打开...)选项的菜单栏。选择“Open...”(打开...)时,会显示“File Open...”(打开文件...)对话框,用户可在其中浏览和选择要打开的 XpsDocument 文件(提供了一个 XPS 文档文件示例)。

文档打开后,其内容显示在主应用程序窗口的 DocumentViewer 中。在 DocumentViewer 控件中,您可以选择一个文本块来添加批注。右击选定的文本将显示“Annotations”(批注)上下文菜单,使用该菜单可选择要创建的批注类型:“Highlight”(突出显示)、“Text Note”(文本说明)或“Ink Note”(墨迹说明)批注。选择批注类型后,DocumentViewer 控件中即可显示批注突出显示或说明窗体。可以在文本说明或墨迹说明批注中添加个人注释。在 DocViewerAnnotationsXps 示例中,用户批注存储在一个作为 XPS 文档本身内的 PackagePart 的 XML 文件中。使用此设计方法,用户批注将作为文档包的一部分保存在一起。

DocViewerAnnotationsXps 示例源代码包含五个文件:

  • MyApp.xaml - 应用程序的可扩展应用程序标记语言 (XAML) 资源(本示例中没有)。

  • MyApp.xaml.cs - 用来创建和显示应用程序窗口的代码隐藏文件。

  • Window1.xaml - 用来定义以下应用程序窗口元素的 XAML 声明:主菜单、菜单命令、DocumentViewer 控件、DocumentViewer 批注上下文菜单和上下文菜单命令。

  • Window1.xaml.cs - 支持主菜单和上下文菜单命令的用户界面的代码隐藏文件。

  • AnnotationsHelperXps.cs - 批注帮助器类,支持作为 XPS 文档的一部分存储的用户批注。

还提供了一个项目文件和一个示例 XPS 文档。若要检查 XPS 文档的内容及其包含的用户批注 XML 文件,只需将文档的文件扩展名从 .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 Shell”。

  • 将示例(通常位于软件开发工具包 (SDK) 文档中)下载到您的硬盘。

  • 若要从生成环境命令窗口生成示例,请转到示例的源目录。在命令提示符处,键入 MSBUILD。

  • 若要在 Microsoft Visual Studio 中生成示例,请加载示例解决方案或项目文件,然后按 Ctrl+Shift+B。

运行示例

  • 若要在 Visual Studio 中调试运行已编译的示例,请按 F5。

  • 若要从 CMD Shell 命令窗口运行示例,请执行位于示例的源文件夹下的 .exe 文件。

请参见

任务

创建 XPS 文档示例

保存 XPS 文档示例

打印 XPS 文档

概念

Windows Presentation Foundation 中的文档