WPF 中的文档

项目
08/12/2011

Windows Presentation Foundation (WPF) 提供一系列丰富的文档功能，与先前几代的 Windows 相比，可以创建旨在更方便地访问和读取的高保真内容文档。除增强的功能和质量外，WPF 还对文档显示、打包和安全性能提供集成服务。本主题介绍了 WPF 文档类型和文档打包。

本主题包括下列各节。

文档类型
文档控件和文本布局
文档打包
XPS 文档
相关主题

文档类型

WPF 基于文档用途将文档分成两个大的类别；这些文档类别分别被称为“固定文档”和“流文档”。

固定文档适用于需要精确的"what you see is what you get" (WYSIWYG)表示形式的应用程序，这与使用的显示器或打印机硬件无关。固定文档的典型用途包括桌面发布、字处理和窗体布局，在这些情况下，遵循原始页面设计非常关键。作为其布局的一部分，固定文档独立于所使用的显示或打印设备来对内容元素进行精确地定位安放。例如，一个固定文档页面在 96 dpi 显示器上显示的效果与在 600 dpi 激光打印机或 4800 dpi 照相排字机上输出的效果是严格一样的。虽然文档质量会根据每台设备的功能达到最优化，但是页面布局在所有情况下都保持不变。

比较而言，当易读性是文档的主要使用要求时，流文档旨在优化查看和可读性并得到最佳利用。流文档根据运行时变量（例如，窗口大小、设备分辨率和可选的用户首选项）来动态调整和重新排列文档内容，而不是设置为一个预定义的布局。网页就是流文档的一个简单示例，在网页上页面内容会动态调整格式以适应当前窗口。流文档会基于运行时环境来优化用户的查看和阅读体验。例如，在高分辨率的 19 英寸显示器上或小型 2x3 英寸 PDA 屏幕上，同一流文档会动态调整格式以达到最理想的可读性。此外，流文档还具有很多内置功能，包括搜索、能够优化可读性的查看模式以及更改字体大小和外观的功能。请参见流文档概述了解有关流文档的演示、示例和详细信息。

文档控件和文本布局

.NET Framework 提供一组预建的控件，可以简化固定文档、流文档和应用程序内常规文本的使用。固定文档内容的显示是由 DocumentViewer 控件支持的。流文档内容的显示是由以下三个不同的控件支持的：FlowDocumentReader、FlowDocumentPageViewer 和 FlowDocumentScrollViewer，它们分别映射到不同的用户方案（请参见下面的小节）。其他 WPF 控件提供简化的布局以支持常规文本使用（请参见下面的用户界面中的文本）。

固定文档控件 - DocumentViewer

DocumentViewer 控件旨在显示 FixedDocument 内容。 DocumentViewer 控件提供一个直观的用户界面，为常见的操作（包括打印输出、复制到剪贴板、缩放和文本搜索功能）提供内置支持。此控件提供常见的滚动机制，支持对页面内容的访问。与所有 WPF 控件类似，DocumentViewer 支持完整或部分样式调整，这使得控件可以在视觉效果方面几乎与任何应用程序或环境相集成。

DocumentViewer 设计为以只读方式显示内容，不支持对内容进行编辑或修改。

流文档控件

**注意：**有关流文档功能及如何创建流文档的更多详细信息，请参见流文档概述。

流文档内容的显示是由以下三个控件支持的：FlowDocumentReader、FlowDocumentPageViewer 和 FlowDocumentScrollViewer。

FlowDocumentReader

FlowDocumentReader 包含一些功能，使用户能够在各种查看模式之间进行动态选择，这些查看模式包括单页（一次一页）查看模式、一次两页（书本阅读格式）查看模式和连续滚动（无界限）查看模式。有关这些查看模式的更多信息，请参见 FlowDocumentReaderViewingMode。如果您不需要在不同查看模式之间动态切换的功能，则可以使用 FlowDocumentPageViewer 和 FlowDocumentScrollViewer，它们提供了固定使用特定查看模式的轻量级流内容查看器。

FlowDocumentPageViewer 和 FlowDocumentScrollViewer

FlowDocumentPageViewer 以一次一页的查看模式显示内容，而 FlowDocumentScrollViewer 以连续滚动模式显示内容。 FlowDocumentPageViewer 和 FlowDocumentScrollViewer 都固定使用特定查看模式。与 FlowDocumentReader 相比，后者包含一些功能，使用户能够动态地在各种查看模式（由 FlowDocumentReaderViewingMode 枚举提供）之间进行选择，但代价是需要消耗比 FlowDocumentPageViewer 或 FlowDocumentScrollViewer 更多的资源。

默认情况下，总是显示垂直滚动条，而水平滚动条则在需要时显示。 FlowDocumentScrollViewer 的默认 UI 不包括工具栏；但是 IsToolBarVisible 属性可用于启用内置工具栏。

用户界面中的文本

除了可以将文本添加到文档外，显然文本还可以用于应用程序 UI（如窗体）中。 WPF 包括多个用于在屏幕中绘制文本的控件。每个控件都面向不同的方案，并具有自己的功能和限制列表。通常，当需要支持的文本有限（例如user interface (UI) 中的简短语句）时，应使用 TextBlock 元素。当需要支持文本极少时，可以使用 Label。有关更多信息，请参见TextBlock 概述。

文档打包

System.IO.Packaging APIs 提供一种有效方式，在一个便于访问、可移植和易于分发的单一容器中组织应用程序数据、文档内容和相关资源。 ZIP 文件是 Package 类型的一个示例，能够将多个对象保存为一个单元。打包 APIs 提供一个默认的 ZipPackage 实现，设计为在 XML 和 ZIP 文件结构中使用开放式打包约定标准。 WPF 打包 APIs 使得创建包以及在包内存储和访问对象变得更为简单。存储在 Package 中的对象被称为 PackagePart（“部分”）。包还可能包括已签名的数字证书，这些证书可以用于标识部分的发信方以及验证尚未修改包的内容。包还包括 PackageRelationship 功能，允许将其他信息添加到包中，或在未实际修改现有部分内容的情况下与特定部分相关联。包服务还支持 Microsoft Windows Rights Management (RM)。

WPF 包结构用作一系列关键技术的基础：

XPS 文档符合 XML Paper Specification (XPS)。
Microsoft Office "12" 开放式 XML 格式文档 (.docx)。
用于个人应用程序设计的自定义存储格式。

基于打包 API，XpsDocument 是专为存储 WPF 固定内容文档而设计。 XpsDocument 是自包含文档，可以在查看器中打开、在 DocumentViewer 控件中显示、路由到打印后台或直接输出到与 XPS 兼容的打印机。

以下小节提供有关 WPF 附带的 Package 和 XpsDocument APIs 的更多信息。

包组件

WPF 打包 API，应用程序数据和文档可以在一个可移植的单元中组织。 ZIP 文件是最常见的包类型，并且是 WPF 附带的默认包类型。 Package 本身是一个抽象类，ZipPackage 就是从中使用开放式标准 XML 和 ZIP 文件体系结构实现的。 Open 方法默认使用 ZipPackage 来创建和使用 ZIP 文件。包可以包含三种基本类型的项：

PackagePart	应用程序内容、数据、文档和资源文件。
PackageDigitalSignature	X.509 证书用于标识、身份验证和验证。
PackageRelationship	与包或特定部分相关的增加信息。

PackagePart

PackagePart（“部分”）是一个抽象类，是指存储在 Package 中的一个对象。在 ZIP 文件中，包的各个部分与存储在 ZIP 文件中的各个文件相对应。 ZipPackagePart 为存储在 ZipPackage 中的可序列化对象提供默认实现。与文件系统类似，包中包含的部分存储在分层目录或“文件夹样式”组织中。使用 WPF 打包 API，应用程序可以使用单一 ZIP 容器写入、存储和读取多个 PackagePart 对象。

PackageDigitalSignature

为安全起见，PackageDigitalSignature（“数字签名”）可以与包内的部分关联。 PackageDigitalSignature 合并了 509，提供以下两个功能：

标识部分的发信方并对其进行身份验证。
验证部件是否尚未被修改。

数字签名不会阻止部分被修改，但如果该部分已经以任何方式发生改变，则对该数字签名的验证检查将失败。然后应用程序可采取适当的操作（例如，阻止部分打开，或通知用户该部分已修改，是不安全的）。

PackageRelationship

PackageRelationship（“关系”）提供一种机制，用于将其他信息与包或包内的部分关联。关系是一种包级别的设备，可以在未修改实际部分内容的情况下将其他信息与部分关联。在许多情况下，直接向部分内容中插入新数据通常是不切实际的：

部分及其内容架构的实际类型未知。
即使已知，内容架构可能也不会提供添加新信息的方式。
部分可能已进行数字签名或加密，不能进行修改。

包关系提供一种可检测到的方式，用于添加其他信息并将该信息与各个部分或整个包关联。包关系用于两种主要功能：

定义一个部分与另一个部分之间的依赖关系。
定义添加注释或与部分相关的其他数据的信息关系。

PackageRelationship 提供一个快速、可检测到的方式来定义依赖关系，并添加与包的部分或整个包相关联的其他信息。

依赖关系

依赖关系用于描述一个部分对其他部分的依赖性。例如，一个包可能包含包括一个或多个 <img> 图像标记的 HTML 部分。此图像标记指的是作为其他包的内部部分或外部部分（可通过 Internet 访问）定位的图像。创建与 HTML 文件关联的 PackageRelationship，可以使查找和访问从属资源更加快速和方便。浏览器或查看器应用程序可以直接访问部分关系，并立即在无需了解架构或未分析文档的情况下开始汇编从属资源。

信息关系

与注释或批注类似，PackageRelationship 还可以用于存储要与部分关联的其他类型的信息，而不必实际修改部分内容本身。

XPS 文档

XML Paper Specification (XPS) 文档是一个包，其中包含一个或多个固定文档以及呈现操作所需的所有资源和信息。 XPS 还是 Windows Vista 固有的后台打印文件格式。 XpsDocument 存储在标准 ZIP 数据集中，可以包括 XML 和二进制组件的组合，如图像和字体文件。PackageRelationships 用于定义内容和完全呈现文档所需的资源之间的依赖关系。 XpsDocument 设计提供一种单一高保真文档解决方案，支持以下多种用途：