CN101128816A - 用于显示分页内容并与之交互的方法和系统 - Google Patents

Abstract

一种由另一计算机程序主存来向该程序提供包括允许用户与内容交互在内的文档查看功能的文档查看器控件(4.204)。接口向程序提供对文档查看功能的插入访问，文档查看功能包括滚动(4.441)、缩放(4.442)、查找(4.443)、布局(4.444)、复制等。可经由接口来检索和设置属性，且可发出命令。结果是任何程序可按照一致的方式来提供文档查看功能。而且，程序开发员经由样式等可按给定程序所需地停用和/或覆盖默认功能，来定制和/或扩展文档查看器。

Description

用于显示分页内容并与之交互的方法和系统

发明领域

本发明一般涉及计算机，尤其涉及在计算机系统上显示内容。

背景

计算机系统的最常见用途之一是用于显示文档的内容。当代计算机系统和程序在查看文档时提供了极大的灵活性，包括跳转至文档中超链接的位置、放大和缩小内容、允许用户通过指示所需页码来跳转至所需页面、滚动和使用键盘键来导航文档、以及执行众多其它文档查看选项。

然而，想要显示分页内容的应用程序开发员一般编写代码来提供其自己的文档查看功能。这部分是因为迄今为止一般不存在供开发员提供这样的查看功能的任何其它方式，但也因为存在不同类型的应用程序和内容，而应用程序开发员想要提供对其特定程序和将要显示的那种类型的内容有意义的特征。

同时，内容查看代码提供的众多功能和特征在各程序之间是常见的。例如，缩放、滚动、文本搜索等可在浏览器、文字处理器、文档阅读器和其它程序中找到。将这些特征单独编码到每个应用程序中将是高度低效的，且一般较不健壮，因为存在众多自定义代码，因此可能有更多的隐错。而且，这导致不一致性，因为各个应用程序各自提供其自己的查看内容的方式。结果，用户仅为了查看内容就必须学会众多不同类型的程序及其用户界面；有时用户看来与另一程序所提供的特征相同的特征实际上表现得相当不同。类似地，键组合和/或功能键通常随程序不同而具有不同的意义。

需要的是一种使程序包括常见的文档查看功能和特征以使这些功能和特征跨程序一致和健壮的方式。同时，任何这样的解决方案应是可扩展的，以使开发员能够添加某种程度的定制以按需修改文档查看在给定程序中的操作。

概述

简要地，本发明提供了一种其中在控件中提供文档查看器的方法和系统，以及允许主存程序包括文档查看器的功能并对其扩展的应用程序编程接口和方法。文档查看器控件负责页面布局、导航和管理与任何适当格式化的内容的一般用户交互。功能包括打印、关键字查找、比例缩放、内容流的多遍布局(multi-pass layout)和/或内容导航。主存程序可选择性地停用这些特征中不需要的任何特征、可激活可用但默认是不活动的特征、并且还可使用附加特征来扩充文档查看器控件。

主机程序使用文档查看器控件来在其查看区中显示内容。一种文档查看控件提供默认用户界面，一般包括顶部的工具栏区及其下方的内容查看区(视口)。在工具栏区中，文档查看控件可显示各用户界面元素，诸如用于管理查看文档的方式的一个或多个按钮和其它交互式项目。也提供了滚动条。默认地，常见文档交互功能作为经由工具栏或菜单激活的命令来提供，以便滚动和缩放、查找(搜索文本)以及复制。可提供打印。主存程序可选择性地不使用所有默认文档查看器特征，和/或激活默认未启用的特征和功能。一个示例工具栏区提供了菜单按钮、放大按钮、缩放组合框、缩小按钮、复制按钮、和查找按钮。

在一个示例性实现中，文档查看控件经由公有方法展示了若干属性和命令。文档查看控件可包含执行文档查看功能的其它控件，例如处理滚动行为的滚动控件、处理缩放的缩放控件、对文本内容搜索匹配文本的查找控件、布置页面的网格以便用户导航的布局控件、以及处理菜单相关功能的菜单控件。

可返回给程序的属性可包括内容相关数据、页面计数数据、第一可见页面数据、最后可见页面数据、水平偏移量数据、垂直偏移量数据、范围宽度数据、范围高度数据、视口宽度数据、视口高度数据、指示是否示出页面边界的数据、缩放百分比数据、网格列计数数据、垂直页面间隔数据、水平页面间隔数据、指示是否处于文档开始处的数据、指示是否处于文档结尾处的数据、指示文档是否可被放大的数据、指示文档是否可被缩小的数据、以及指示工具栏状态的数据。可由程序设置的属性可包括内容相关数据、第一可见页面数据、水平偏移量数据、垂直偏移量数据、示出页面边界数据、缩放百分比数据、网格列计数数据、垂直页面间隔数据、水平页面间隔数据以及改变工具栏状态的数据。命令包括切换工具栏命令、适合网格列计数命令、回流文档命令、查看缩略图命令、视图适合宽度命令、以及视图适合高度命令。

在需要显式内容的任何时刻，文档查看控件可默认地作为文档查看器来自动提供。程序可使用其自己的定制文档查看控件来覆盖默认文档查看控件。文档查看控件可被样式化，使得文档查看器的特征需求仅被指定一次来使得文档查看器如所需地呈现。应用程序可经由样式来简单地描述它想要的特征，且具有该样式的文档查看器如所指定地呈现。样式可被命名，程序借此可定义文档查看器的不同样式，然后在程序执行期间在适当时改变所使用的样式。

当结合附图考虑以下详细描述时，其它方面将是显而易见的，附图中：

附图简述

图1是表示其中可包括本发明的计算机系统的框图；

图2是根据本发明的各方面的其中文档查看控件可由系统主存的示例性配置的表示；

图3是根据本发明的各方面示出用于与文档查看控件交互的用户界面元素的示例性屏幕截图表示；

图4是根据本发明的各方面的其中示例性文档查看控件由各种其它控件构成的配置的框图；以及

图5是根据本发明的各方面的用于网格布局的、包括滚动相关界面的示例性布局类的表示。

详细描述

示例性操作系统

图1示出可在其上实现本发明的合适的计算系统环境100的示例。计算系统环境100仅是合适的计算环境的一个示例，并不旨在对本发明的使用范围或功能提出任何限制。也不应该把计算环境100解释为对示例性操作环境100中示出的任一组件或其组合有任何依赖性或要求。

本发明可用众多其它通用或专用计算系统环境或配置来操作。适合在本发明中使用的公知的计算系统、环境和/或配置的示例包括，但不限于，个人计算机、服务器计算机、手持或膝上型设备、多处理器系统、基于微控制器的系统、机顶盒、可编程消费者电子产品、网络PC、小型机、大型机、包含上述系统或设备中的任一个的分布式计算机环境等。

本发明可在诸如程序模块等由计算机执行的计算机可执行指令的通用语境中描述。一般而言，程序模块包括例程、程序、对象、组件、数据结构等，它们执行特定任务或实现特定抽象数据类型。本发明也可以在分布式计算环境中实现，其中任务由通过通信网络连接的远程处理设备执行。在分布式计算环境中，程序模块可以位于包括存储器存储设备在内的本地和远程计算机存储介质中。

参考图1，用于实现本发明的示例性系统包括计算机110形式的通用计算设备。计算机110的组件可以包括，但不限于，处理单元120、系统存储器130和将包括系统存储器在内的各种系统组件耦合至处理单元120的系统总线121。系统总线121可以是若干类型的总线结构中的任一种，包括存储器总线或存储器控制器、外围总线和使用各种总线体系结构中的任一种的局部总线。作为示例，而非限制，这样的体系结构包括工业标准体系结构(ISA)总线、微通道体系结构(MCA)总线、扩展的ISA(EISA)总线、视频电子技术标准协会(VESA)局部总线和外围部件互连(PCI)总线(也被称为Mezzanine总线)。

计算机110通常包括各种计算机可读介质。计算机可读介质可以是能够被计算机110访问的任何可用介质，且包括易失性和非易失性介质、可移动和不可移动介质。作为示例，而非限制，计算机可读介质可以包括计算机存储介质和通信介质。计算机存储介质包括以任何方法或技术实现的用于存储诸如计算机可读指令、数据结构、程序模块或其它数据等信息的易失性和非易失性、可移动和不可移动介质。计算机存储介质包括，但不限于，RAM、ROM、EEPROM、闪存或其它存储器技术；CD-ROM、数字多功能盘(DVD)或其它光盘存储；磁带盒、磁带、磁盘存储或其它磁性存储设备；或能用于存储所需信息且可以由计算机110访问的任何其它介质。通信介质通常具体化为诸如载波或其它传输机制等已调制数据信号中的计算机可读指令、数据结构、程序模块或其它数据，且包含任何信息传递介质。术语“已调制数据信号”指的是这样一种信号，其一个或多个特征以在信号中编码信息的方式被设定或更改。作为示例，而非限制，通信介质包括诸如有线网络或直接线连接的有线介质，以及诸如声学、RF、红外线和其它无线介质的无线介质。上述中任一个的组合也应包括在计算机可读介质的范围之内。

系统存储器130包括易失性或非易失性存储器形式的计算机存储介质，诸如只读存储器(ROM)131和随机存取存储器(RAM)132。基本输入/输出系统133(BIOS)包含有助于诸如启动时在计算机110中元件之间传递信息的基本例程，它通常存储在ROM 131中。RAM 132通常包含处理单元120可以立即访问和/或目前正在操作的数据和/或程序模块。作为示例，而非限制，图1示出了操作系统134、应用程序135、其它程序模块136和程序数据137。

计算机110也可以包括其它可移动/不可移动、易失性/非易失性计算机存储介质。仅作为示例，图1示出了从不可移动、非易失性磁介质中读取或向其写入的硬盘驱动器141，从可移动、非易失性磁盘152中读取或向其写入的磁盘驱动器151，以及从诸如CD ROM或其它光学介质等可移动、非易失性光盘156中读取或向其写入的光盘驱动器155。可以在示例性操作环境下使用的其它可移动/不可移动、易失性/非易失性计算机存储介质包括，但不限于，盒式磁带、闪存卡、数字多功能盘、数字录像带、固态RAM、固态ROM等。硬盘驱动器141通常由诸如接口140等不可移动存储器接口连接至系统总线121，磁盘驱动器151和光盘驱动器155通常由诸如接口150等可移动存储器接口连接至系统总线121。

以上描述和在图1中示出的驱动器及其相关联的计算机存储介质为计算机110提供了对计算机可读指令、数据结构、程序模块和其它数据的存储。例如，在图1中，硬盘驱动器141被示为存储操作系统144、应用程序145、其它程序模块146和程序数据147。注意，这些组件可以与操作系统134、应用程序135、其它程序模块136和程序数据137相同或不同。操作系统144、应用程序145、其它程序模块146和程序数据147在这里被标注了不同的标号是为了说明至少它们是不同的副本。用户可以通过输入设备，诸如键盘162和定点设备161(通常指鼠标、跟踪球或触摸垫)向计算机20输入命令和信息。其它输入设备(未示出)可以包括麦克风、操纵杆、游戏垫、圆盘式卫星天线、扫描仪、手持PC的触敏屏或其它手写板等。这些和其它输入设备通常由耦合至系统总线的用户输入接口160连接至处理单元120，但也可以由其它接口或总线结构，诸如并行端口、游戏端口或通用串行总线(USB)连接。监视器191或其它类型的显示设备也经由接口，诸如视频接口190连接至系统总线121。除监视器以外，计算机也可以包括其它外围输出设备，诸如扬声器197和打印机196，它们可以通过输出外围接口190连接。

计算机110可使用至一个或多个远程计算机，诸如远程计算机180的逻辑连接在网络化环境下操作。远程计算机180可以是个人计算机、服务器、路由器、网络PC、对等设备或其它常见网络节点，且通常包括上文相对于计算机110描述的许多或所有元件，尽管在图1中只示出存储器存储设备181。图1中所示逻辑连接包括局域网(LAN)171和广域网(WAN)173，但也可以包括其它网络。这样的连网环境在办公室、企业范围计算机网络、内联网和因特网中是常见的。

当在LAN连网环境中使用时，计算机110通过网络接口或适配器170连接至LAN 171。当在WAN连网环境中使用时，计算机110通常包括调制解调器172或用于通过诸如因特网等WAN 173建立通信的其它装置。调制解调器172可以是内置或外置的，它可以通过用户输入接口160或其它合适的机制连接至系统总线121。在网络化环境中，相对于计算机110描述的程序模块或其部分可以存储在远程存储器存储设备中。作为示例，而非限制，图1示出了远程应用程序185驻留在存储器设备181上。可以理解，所示的网络连接是示例性的，且可以使用在计算机之间建立通信链路的其它手段。

分页内容显示和交互

本发明一般针对作为控件来提供的文档查看器，它本质上是可由另一程序主存以便向程序提供某些功能的对象。该文档查看器控件提供负责页面布局、导航和管理与任何适当格式化的内容的一般用户交互的交互式查看解决方案。例如，在一个实现中，该文档查看器控件允许查看实现iDocumentPaginator(文档分页器)接口的任何内容，以及实现文档查看器控件的自定义解决方案。

根据本发明的各方面，作为对象，文档查看器控件可被添加至任何适当配置的应用程序。程序可自动或显式地例如通过标记来调用文档查看器控件。一旦被添加，文档查看器提供一组核心特征，包括使用页面网格的混合格式(用于基于可用空间来调节例如文本换行的大小和/或固定内容和/或可回流内容)布局、打印、关键字查找、比例缩放、内容流的多遍布局和/或内容导航。主存程序可选择性地停用那些特征中不需要的任何特征、可激活可用但默认为不活动的特征、并且还可使用附加特征来扩充文档查看器控件。

如可以理解的，实现本发明的众多方式都是可行的，但仅在此处描述替换方式中的某一些。例如，以下将主要参考合成控件对象模型来描述本发明，其中文档查看控件包含提供其某些功能的其它控件。然而，这对本发明而言不是必需的，其它模型，诸如其中文档查看器直接包括查看功能、特征和逻辑而不包含其它对象的模型也是可行的。因此，本发明不限于此处所述的任何特定示例或实现，而是可按照一般在计算时提供好处和优点的各种方式来使用。

转向图2，示出了表示其中本发明可根据本发明的各方面来操作的示例性配置的框图。该配置包括主机(例如，应用程序)程序200和在其被称为视口210的查看区中显示内容的文档查看控件204，其中如此处所使用的，文档本质上包括任何类型的可见内容，因此可包括文本、图形、动画文本和/或图形、以及视频、或其任何组合。主机程序200包括在诸如图1的计算机系统120等计算机系统上执行的计算机程序，且可以是常规应用程序、操作系统组件或实用程序、另一控件等。

文档查看控件204在一个实现中名为DocumentViewer，它提供默认用户界面，一般包括位于顶部的工具栏区212及其下方的内容查看区(视口210)。在工具栏区212中，文档查看控件204可显示用户界面元素，诸如用于管理查看文档的方式的一个或多个按钮和其它交互式项目。在图2的示例文档查看器屏幕截图中也示出了允许用户在视口210内滚动内容的滚动条用户界面元素214。

在一个示例实现中，文档查看控件204默认地提供多个常见文档交互功能，例如用于导航、查找(搜索文本)、复制和缩放。打印是可默认提供的用户交互功能的另一示例。根据本发明的各方面，如下所述，应用程序可简单地“插入”控件来具有其默认功能。主存程序200可例如通过移除、隐藏、禁用和/或覆盖默认值来选择性地不使用所有默认文档查看器特征。程序200也可激活默认未启用的特征和功能。

作为某些默认特征的示例，图3是示出根据本发明的各方面的在操作中的文档查看控件204的一个示例性视图的屏幕截图。在该表示中，文档查看控件204的工具栏区212包括工具栏项目321-325，包括菜单按钮320、放大按钮321、缩放组合框322、缩小按钮323、复制按钮324和查找按钮325。注意到，其它按钮(诸如打印按钮)没有出现，因为它们默认未提供，或即使默认提供了也已经被不想要提供相应功能的主存程序停用。还注意到，文档查看控件204和/或主存应用程序200可提供允许用户例如通过允许添加附加的工具栏项目和移除任何现有的工具栏项目来定制工具栏的界面。

在一般在图4中表示的一个示例性实现中，文档查看控件204包括当被实例化、主存和执行时可经由公有方法440展示若干属性和命令的对象。通过公有方法440，文档查看控件204可提供对其自己的功能的访问，并且还可提供对其它所包含的控件441-446的访问来执行其它文档查看功能。例如，文档查看控件204可包含处理滚动行为的滚动控件441、处理缩放的缩放控件442、对文本内容搜索匹配文本的查找控件443、布置页面的网格以便用户导航的布局控件444、以及处理菜单相关功能，诸如包括当最小化工具栏时提供供用户交互式地发出命令的替换方式的菜单控件445。滚动、缩放和布局一般分别在题为“Method and System forNavigating Paginated Content in Page-Based Increments”、“Method and System forZooming in and out of Paginated Content”、和“Method and System for Laying OutPaginated Content for Viewing”的共同待批的美国专利申请中描述，这些申请均转让给本发明的受让人并与本发明同时提交，且通过引用包含在此。其它控件(例如，处理“复制”操作的控件)可被包含在文档查看控件204中，如在图4中由框446表示的。注意到，尽管未在图4中特别示出，但这些控件441-446中的某一些或全部可独立地公有地展示。

回到图3中所表示的示例实现，文档查看器的工具栏区212提供展示诸如缩放、复制和查找等文档查看控件的用户界面项目。其中某一些被连系至文档查看控件204本机处理的命令，但诸如缩放等某一些被数据绑定至关于文档查看控件204的属性。工具栏可例如通过“ToogleToolbar”命令来最小化和最大化。当被最大化时，工具栏包括工具栏控件位于其中的面板；在处于最小化状态时，除菜单项目以外，工具栏不可见。

工具栏中的每一控制按钮被给予一标识符和“选项卡”顺序，以便于访问和测试。在示例从左自右顺序中，工具栏中的第一个用户界面元素是菜单按钮，当其被最小化时展示最大化的工具栏中通常可用的同一组命令。这些菜单项目(及其相关联的命令)可包括复制-ApplicationCommands.Copy、查找-ApplicationCommands.Find、打印-ApplicationCommands.Print、放大-NavigationCommands.IncreaseZoom、缩小-NavigationCommands.DecreaseZoom、显示/隐藏工具栏-document viewing control.ToogleToolbar。菜单按钮可通过对菜单控件的属性(例如，IsMouseOver(鼠标在上方)和IsMousePressed(鼠标被按下))上的PropertyTriggers(属性触发器)的使用来基于鼠标活动改变外观。这些命令中的某一些或全部可被连系至标准命令库。

当经由点击或经由菜单激活时，缩小按钮使得文档查看控件缩小当前文档。类似地，当放大按钮被激活时，它使得文档查看控件对当前文档放大。缩放组合框包含各种预定义的“缩放档(Zoom Stop)”和其它缩放相关设置(例如，“100％”、“50％”、“1页”等)。文档查看控件的缩放组合框可按照DocumentViewer的样式来实现，从而将DocumentViewer的DocumentLayout(文档布局)属性数据绑定至ComboBox(组合框)的SelectedItemValue(所选项目值)属性。或者，开发员可使用命令或属性来直接设置网格列的数目和/或缩放百分比。组合框中的每一条目可以是DocumentLayout类型的样式化数据项，借此当选中组合框中的一个项目时，可更新文档查看控件的页面布局。

激活查找按钮会调用文档查看控件的查找对话框。复制使得TextEditor(文本编辑器)(例如，附加于文档查看控件204)将用户当前标记的选择复制到剪贴板，而打印调用打印对话框。

文档查看控件的内容区被称为视口210，它按页面的一列或多列的行来显示文档内容，如由布局控件布置在网格中那样。此区中的用户界面元素可包括水平和/或垂直滚动条。也可提供上下文菜单，它例如包含与工具栏中的菜单按钮相同的项目，并被附加于相同的命令。

文档查看控件经由滚动控件441为文档查看控件的内容提供了滚动功能，这在一个实现中被称为ScrollViewer(滚动查看器)。布局控件444(例如，名为DocumentGrid(文档网格))是文档查看控件的ScrollViewer所使用的IScrollInfo(滚动信息)对象，并且负责以灵活的方式显示文档内容。注意到，DocumentGrid是内部控件，且不能在文档查看控件的样式中直接指定。如图5中一般表示的，DocumentGrid实现IDocumentScrollInfo(文档滚动信息)(它实现IScrollInfo)，且被设置为ScrollViewer的孩子。ScrollViewer通过IScollInfo接口将基于滚动的信息传输给DocumentGrid；类似地，文档查看控件通过IDocumentScrollInfo(或IDocumentPresentationInfo(文档呈现信息))接口将基于页面导航/布局的信息传输给DocumentGrid。文档查看控件将设置IDocumentPresentationInfo来更新DocumentGrid的缩放、偏移量等，且DocumentGrid将调用文档查看控件的InvalidatePresentationInfo()(无效呈现信息)方法以便使文档查看控件与在DocumentGrid上改变的属性同步。

根据本发明的各方面，文档查看控件展示了若干属性和命令。下表包括可由文档查看控件204的一个实现展示的某些示例性属性和命令：

namespace System.Windows.Controls{public class DocumentViewer:Control，IServiceProvider，IAutomationPatternProvider，IAddChild，IEnsure Visible{//公有属性//页面布局和显示控件public int          PageCount{get；}public int          FirstVisiblePage{get；set；}public int          LastVisiblePage{get；}public double       HorizontalOffset{get；set；}public double       VerticalOffset{get；set；}public double       ExtentWidth{get；}public double       ExtentHeight{get；}public double       ViewportWidth{get；}public double       ViewportHeight{get；}public bool      ShowPageBorders{get；set；}public double       ZoomPercentage{get；set；}public int          GridColumnCount{get；set；}public double    VerticalPageSpacing{get；set；}public double    HorizontalPageSpacing{get；set；}

//文档内容public IDocumentPaginator  Content{get；set；}//有用标志(用于样式化目的)public bool    IsAtStart{get；}public bool    IsAtEnd{get；}public bool    CanZoomIn{get；}public bool    CanZoomOut{get；}public bool    IsToolbarMaximized{get；set；}//用于样式化要求的附加依赖性属性public DependencyProperty ContentHostProperty；//由DocumentViewer(即，不在CommandLibrary中)工具栏所展示的公有命令public Command      ToggleToolbar；//布局相关Public Command      FitToGridColumnCount；public Command      ReflowDocument；public Command      ViewThumbnails；public Command      ViewFitToWidth；public Command      ViewFitToHeight；}}

文档查看控件204的属性和命令可由应用程序200访问。指示“get”的属性是可读的。指示“get”和“set”的属性既是可读也是可写的。可以容易地认识到，其它属性和命令可被包括在内和/或以上属性和命令中的某一些可被删除或修改，而不背离本发明的精神或范围。而且，上述属性和命令是示例性的，并且可容易地认识到，可使用其它数据结构、定义、技术和方法来实现文档查看控件204的各方面，而不背离本发明的精神或范围。

以下提供了关于属性和命令的附加细节：

public int PageCount{get；}

PageCount返回加载到文档查看控件(DocumentViewer)的当前页面数目。该数目将增加直到分页完成，此时它将指示文档中的总页数。

public int FirstVisiblePage{get；set；}

当被查询时，FirstVisiblePage返回屏幕上可见的第一个页面。这或者是自左至右内容的最左上侧的可见页面，或者是自右至左内容的最右上侧的可见页面。当被设置时，文档查看控件调用IDocumentPresentationInfo.MakePageVisible()，它试图在可能的情况下使所指定的页面，即最左上侧(或最右上侧)页面可见。这并不总是可行的(例如，处于文档的顶部或底部时或对多于一列布局时)，因此可能存在其中被分配给FirstVisiblePage的值与所读回的值不同的情况。

FirstVisiblePage是1索引的，以便使得数据绑定至用户界面更有用。小于1或大于PageCount的值将使该值限幅至范围内。设置FirstVisiblePage将导致LastVisiblePage被更新。

public int LastVisiblePage{get；}

当被查询时，LastVisiblePage返回屏幕上可见的最后一个页面。这或者是自左至右内容的最右下侧可见页面，或者是自右至左内容的最左下侧页面。LastVisiblePage是1索引的，以便使得数据绑定至用户界面更有用。小于1或大于PageCount的值将使得该值被限幅至范围内。

public double Horizontaloffset{get；set；}

给定当前页面布局，HorizontalOffset以像素为单位来指示文档中的当前水平位置。HorizontalOffset为0索引的；小于0或大于ExtentWidth的值可被限幅至范围内。

public double Verticaloffset{get；set；}

给定当前页面布局，VerticalOffset以像素为单位来指示文档中的当前垂直位置。VerticalOffset为0索引的；小于0或大于ExtentHeight的值可被限幅至范围内。

public double ExtentWidth{get；}

ExtentWidth指示文档布局的当前宽度。

public double ExtentHeight{get；}

ExtentHeight指示文档布局的当前高度。

public double ViewportWidth{get；}

ViewportWidth指示DocumentViewer的内容区(视口)的当前宽度。

public double ViewportHeight{get；}

ViewportHeight指示DocumentViewer的内容区(视口)的当前高度。

public bool ShowPageBorders{get；set；}

ShowPageBorders允许开发员启用或禁用文档查看控件中正显示的页面周围的“阴影”。

public double ZoomPercentage{get；set；}

这是被展示来使得数据绑定至UI成为简单任务的“方便”属性(例如，创建允许用户设置缩放的简单的TextBox(文本框))。基于最后的ZoomPercentage设置或页面适合调用来返回有效的缩放百分比。小于百分之五或大于百分之一千的值可被限幅至范围内。

ZoomPercentage属性也可与可分析带有“％”符号的串的TypeConverter(类型转换器)相关联。可见，数据绑定UI(例如，TextBox)可将ZoomPercentage的值显示为“100％”而非“100”。此外，它允许在标记中使用“％”符号，即<DocumentViewer ZoomPercentage＝″100％″>。

public int GridColumnCount{get；set；}

这是被展示来使得数据绑定至UI成为简单任务的“方便”属性(例如，创建允许用户设置所显示页面的所显示列数的简单的TextBox)。返回所显示的页面的列数。当被设置时，它将使得指定数目的列被布置(但不适合视图)。小于1或大于文档页数的值将被限幅至范围内。

public IDocumentPaginator Content{get；set；}

内容展示了通过IAddChild接口加载到文档查看控件内的当前IDocumentPaginator内容树并允许操纵内容。当内容被添加或移除时，它从文档查看控件的LogicalTree(逻辑树)中添加或移除。然而，当经由样式化来调用文档查看控件时，情况并不如此。在这种情况中，什么也不做；用于确定文档查看控件是否已经经由样式化调用的当前检查为“if(this.StyledParent＝＝null)”。

public bool IsAtStart  {get；}

指示文档查看控件(DocumentViewer)是否位于当前文档的顶部。在DocumentViewer样式中用于使用PropertyTriggers来启用/禁用导航按钮。

public bool IsAtEnd{get；}

指示文档查看控件是否位于当前文档的底部。在DocumentViewer样式中用于使用PropertyTriggers来启用/禁用导航按钮。

bool CanZoomIn{get；}

指示文档查看控件是否能进一步放大(即，当前是否位于最高“缩放档”)。在DocumentViewer样式中用于使用PropertyTriggers来启用/禁用缩放按钮。

public bool CanZoomOut{get；}

指示文档查看控件是否能进一步缩小(即，当前是否位于最低“缩放档”)。在DocumentViewer样式中用于使用PropertyTriggers来启用/禁用缩放按钮。

public bool IsToolbarMaximized{get；set；}

指示/设置工具栏的当前状态——它是被最小化、最大化还是被禁用了。在DocumentViewer样式中用以基于其所报告的状态来显示/隐藏工具栏。

命令

public Command ToggleToolbar

调用该命令使得文档查看控件(DocumentViewer)将“IsToolbarMaximized”属性在真与假之间来回切换。如果样式作者选择使用IsToolbarMaximized属性，这将使得UI基于DocumentViewer的样式中的PropertyTriggers改变。

public Command FitToGridColumnCount

该命令将使得当前列布局(如由GridColumnCount(网格列计数)指定的)精确适合当前视口。

public Command Ref lowDocument

该命令将使得文档中的任何可回流内容被重新分页来适于当前视口，同时显示当前指定的列计数。

public Command ViewThumbnails

将DocumentViewer.DocumentLayout置为DocumentLayout(DocumentLayoutType.Thumbnail)。

public Command ViewFitToWidth

将DocumentViewer.DocumentLayout置为DocumentLayout(DocumentLayoutType.FitToWidth)。

public Command ViewFitToHeight

将DocumentViewer.DocumentLayout置为DocumentLayout(DocumentLayoutType.FitToHeight)。

外部命令

存在文档查看控件(DocumentViewer)将处理但不会自己实现的各种命令。示例包括：

ApplicationCommands.Find

调用DocumentViewer的查找对话框。

ApplicationCommands.Print

调用DocumentViewer的打印对话框。

ComponentCommands.ScrollPageUp/Down

使得DocumentViewer按视口上/下滚动。

ComponentCommands.MoveUp/Down

使得DocumentViewer按16像素上/下滚动。

ComponentCommands.MoveLeft/Right

使得DocumentViewer按16像素左/右滚动。

ComponentCommands.MoveToHome/End

使得DocumentViewer移动至文档的开头/结尾。

ComponentCommands.ScrollByLine

使得DocumentViewer按指定的行数向上或向下滚动。

Navigat ionCommands.Zoom

将DocumentViewer的缩放置为指定水平。

NavigationCommands.IncreaseZoom/DecreaseZoom

使的DocumentViewer对内容进行放大/缩小。

NavigationCommands.GotoNextPage/GotoPrevioiusPage

使的DocumentViewer滚动至页面的下一/前一行。

DocumentViewer接口实现

IserviceProvider

文档查看控件的IServiceProvider(服务提供者)实现将展示DocumentGrid的TextView(文本查看)服务，以允许访问文档中的底层文本。

IAutomationPatternProvider

文档查看控件的IAutomationPatternProvider(自动模式提供者)接口处理对UIAutomation(UI自动化)TextPattern(文本模式)的请求，这允许Automation(自动化)系统访问所显示文档的文本内容。

IEnsure Visible

IEnsureVisible(确保可见)允许开发员强制使文档中的某些元素可见。这可用于支持超链接和某些可访问性功能。

IAddChild

IAddChild(添加孩子)允许将文档内容添加到文档查看控件的逻辑树。仅可添加一个孩子，且它必须是非空IDocumentPaginator。如果未满足这些准则，则可抛出异常。

在其中用户界面元素经由经解释的标记来显示的一个实现中，只要需要显示内容，文档查看控件204就默认地作为文档查看器来提供。然而，提供了显著的灵活性以允许程序以其自己定制的文档查看控件来覆盖默认文档查看控件204。如可从以上的API中看到，这源自设置API的众多属性的能力。

文档查看控件可被样式化，使得文档查看器的特征仅需被指定一次来使得文档查看器如所需地呈现。作为示例，考虑以下标记(其中DV表示DocumentViewer)：

<App><App.Resources>...DV.Background＝Yellow</App.Resources><DV></DV></App>

一般而言，如果需要对默认进行任何改变，则程序开发员仅需指定文档查看器是所需的程序资源，并指示所需的一个或多个改变。以上标记(大多数情况下)得到具有黄色背景的默认文档查看器；按钮、超链接等可被类似地改变。注意到，在一个实现中，内容和布局可以不被样式化，且有效的文档查看控件样式需要包含以document viewing control.ContentHost附加属性标记的ScrollViewer(滚动查看器)控件。当文档查看控件检测到应用了样式时，它会走查可视树并搜索该标记的元素。如果找不到，或如果所标记的元素不是ScrollViewer，则它将抛出异常。如果找到了正确的ScrollViewer，则文档查看控件将实例化DocumentGrid控件(用于布局)，使其成为ScrollViewer的内容，并允许DocumentGrid控件与ScrollViewer对话。

因此，样式属性可用于使文档查看器如用户所需地呈现。应用程序可简单地经由样式来描述其所想要的特征，且具有该样式的文档查看器如所指定地呈现。然而注意到，内容未被样式化。样式可指定诸如是否支持在某种水平上放大和缩小、要显示的页的列数等特征。即使API提供这样做的能力，但给定的程序可能不使用每个可用特征。因此，例如样式化的文档查看控件可在程序中用来提供有限特征以便使用户关注于定制文档查看器，例如可显示具有后退和下一按钮的单个页面，而没有缩放选项。

还注意到，样式可被命名。因此，例如程序可定义文档查看器的不同样式，然后在适当的时间改变所使用的样式，例如通过在程序中的一个时间指定一个文档查看器样式等于“XYZ”文档查看器，在另一时间指定要使用的该文档查看器等于“ABCD”文档查看器，以此类推。例如，程序可改变与正显示的内容类型一起使用的文档查看器，例如固定内容具有一个文档查看器，而基于可用空间调节(例如，文本换行)的可回流内容可经由不同样式化的查看器显示。

如可从前述详细描述中看到，提供了允许程序以跨程序一致且健壮的方式提供文档查看功能和特征的方法和系统。该方法和系统是可定制且可扩展的。

尽管本发明易于进行各种修改和替换构造，其某些所示实施例在附图中示出并在以上详细描述。然而，应理解，并不旨在将本发明限于所公开的特定形式，而是相反，意图是覆盖落入本发明的精神和范围内的所有修改、替换构造、和等效方式。

Claims (20)

1.在一个计算系统中，一种方法，包括：

提供供另一程序主存的文档查看控件，所述文档查看控件包括至少一个接口的接口集；

在所述文档查看控件的接口集处接收来自调用程序的功能调用；以及

响应于功能调用，提供文档查看功能来允许所述调用程序显示文档的内容。

2.如权利要求1所述的方法，其特征在于，提供文档查看功能包括改变所显示文档的缩放水平。

3.如权利要求1所述的方法，其特征在于，提供文档查看功能包括在所述文档中滚动以改变显示内容的方式。

4.如权利要求1所述的方法，其特征在于，提供文档查看功能包括复制所述文档中的所选内容。

5.如权利要求1所述的方法，其特征在于，还包括响应于功能调用来提供文档打印功能。

6.如权利要求1所述的方法，其特征在于，所述在接口集处接收来自调用程序的功能调用包括，接收获取属性值的请求。

7.如权利要求6所述的方法，其特征在于，所述接收获取属性值的请求包括，接收对一组中至少一个属性的值的请求，所述组包含内容相关数据、页面计数数据、第一可见页面数据、最后可见页面数据、水平偏移量数据、垂直偏移量数据、范围宽度数据、范围高度数据、视口宽度数据、视口高度数据、指示是否示出页面边界的数据、缩放百分比数据、网格列计数数据、垂直页面间隔数据、水平页面间隔数据、指示是否位于文档开始处的数据、指示是否位于文档结尾处的数据、指示文档是否可被放大的数据、指示文档是否可被缩小的数据、以及指示工具栏状态的数据。

8.如权利要求1所述的方法，其特征在于，所述在接口集处接收来自调用程序的功能调用包括，接收改变属性值的请求。

9.如权利要求8所述的方法，其特征在于，所述接收改变属性值的请求包括，接收改变一组中至少一个属性的值的请求，所述组包含内容相关数据、第一可见页面数据、水平偏移量数据、垂直偏移量数据、显示页面边界数据、缩放百分比数据、网格列计数数据、垂直页面间隔数据、水平页面间隔数据和改变工具栏状态的数据。

10.如权利要求1所述的方法，其特征在于，所述在接口集处接收来自调用程序的功能调用包括接收命令。

11.如权利要求10所述的方法，其特征在于，所述接收命令包括，接收一组中的至少一个命令，所述组包含切换工具栏命令、适合网格列计数命令、回流文档命令、查看缩略图命令、视图适合宽度命令、以及视图适合高度命令。

12.一种具有计算机可执行指令的计算机可读介质，所述指令在被执行时执行如权利要求1所述的方法。

13.在具有可执行计算机程序的计算环境中，一种系统，包括：

文档查看控件，用于显示文档的内容，所述文档查看控件提供至少一个默认特征来允许用户与所显示的内容交互；以及

所述文档查看控件的接口集，通过所述接口集所述可执行计算机程序调用所述文档查看控件来向所述计算机程序提供文档查看功能。

14.如权利要求13所述的系统，其特征在于，所述程序通过覆盖至少一个默认特征来定制所述文档查看控件的至少一部分。

15.如权利要求14所述的系统，其特征在于，所述程序经由样式来定制所述文档查看控件的至少一部分。

16.如权利要求13所述的系统，其特征在于，所述文档查看控件包含与显示文档内容相关的至少一个其它控件的控件集。

17.如权利要求16所述的系统，其特征在于，所述控件集包括滚动相关控件、缩放相关控件、查找相关控件、布局相关控件、菜单相关控件、以及复制相关控件。

18.如权利要求13所述的系统，其特征在于，所述接口提供对属性和命令的访问，所述属性包括属性集中的至少一个成员，所述属性集包括：

内容相关数据、页面计数数据、第一可见页面数据、最后可见页面数据、水平偏移量数据、垂直偏移量数据、范围宽度数据、范围高度数据、视口宽度数据、视口高度数据、指示是否示出页面边界的数据、缩放百分比数据、网格列计数数据、垂直页面间隔数据、水平页面间隔数据、指示是否位于文档开始处的数据、指示是否位于文档结尾处的数据、指示文档是否可被放大的数据、指示文档是否可被缩小的数据、和指示工具栏状态的数据，

以及

所述命令包括命令集的至少一个成员，所述命令集包括：

切换工具栏命令、适合网格列计数命令、回流文档命令、查看缩略图命令、视图适合宽度命令、和视图适合高度命令。

19.在计算环境中，一种系统，包括：

用于由另一程序主存的文档查看控件装置，所述文档查看器控件装置包括至少一个接口的接口集；以及

用于在所述接口集处接收来自调用程序的功能调用以便允许用户与经由同时由另一程序主存的所述文档查看控件装置所显示的内容交互的装置。

20.如权利要求19所述的系统，其特征在于，所述用户交互改变显示内容的方式。

Images