【WPF.NET开发】文档批注

2024-01-14 08:52
文章标签 文档 开发 net wpf 批注

本文主要是介绍【WPF.NET开发】文档批注,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

本文内容

  1. 便笺
  2. 要点
  3. 数据锚定
  4. 匹配批注与批注对象

在纸质文档上编写说明或注释毫不稀奇,我们几乎认为这是理所当然的。 这些说明或注释就是“批注”,我们将其添加到文档,用于标注信息或突出显示兴趣项以供日后参考。 虽然在打印文档上编写注释很简单也很平常,但是就算在所有电子文档上添加个人注释,功能上却通常有很多限制。

本主题介绍几种常见类型的批注,重点介绍便笺和突出显示,并举例说明 Microsoft Annotations Framework 如何通过 Windows Presentation Foundation (WPF) 文档查看控件简化在应用程序中使用这些类型的批注。 支持批注的 WPF 文档查看控件包括 FlowDocumentReader 和 FlowDocumentScrollViewer,以及派生自 DocumentViewerBase 的控件,如 DocumentViewer 和 FlowDocumentPageViewer。

1、便笺

平常的便笺是将信息写在小块彩纸上,随后将这张彩纸“粘贴”到文档。 数字便笺为电子文档提供类似的功能,但灵活性更高,可包括许多其他类型的内容,如键入文本、手写注释(如 Tablet PC“墨迹”笔划)或 Web 链接。

下图显示了突出显示、文本便笺以及墨迹便笺批注的一些示例。

caf-stickynote.jpg?view=netframeworkdesktop-4.8

下面的示例演示了可用于在应用程序中启用批注支持的方法。

// ------------------------ StartAnnotations --------------------------
/// <summary>
///   Enables annotations and displays all that are viewable.</summary>
private void StartAnnotations()
{// If there is no AnnotationService yet, create one.if (_annotService == null)// docViewer is a document viewing control named in Window1.xaml._annotService = new AnnotationService(docViewer);// If the AnnotationService is currently enabled, disable it.if (_annotService.IsEnabled == true)_annotService.Disable();// Open a stream to the file for storing annotations._annotStream = new FileStream(_annotStorePath, FileMode.OpenOrCreate, FileAccess.ReadWrite);// Create an AnnotationStore using the file stream._annotStore = new XmlStreamStore(_annotStream);// Enable the AnnotationService using the new store._annotService.Enable(_annotStore);
}// end:StartAnnotations()

2、要点

当人们在纸质文档上作标记时,往往使用创造性的方法来突出显示兴趣项,例如对于句子中的某些字词,加下划线、高亮显示、圈出,或者将在空白的地方绘制标记或符号。 Microsoft Annotations Framework 中的突出显示批注具有类似的功能,用于标记在 WPF 文档查看控件中显示的信息。

下图演示了一个突出显示批注的示例。

caf-callouts.png?view=netframeworkdesktop-4.8

用户通常以如下方法创建批注:首先选择感兴趣的文本或者项,然后单击右键显示批注选项的 ContextMenu。 在下面的示例中,你可以使用 Extensible Application Markup Language 声明包含路由命令的 ContextMenu,用户可以访问这些命令来创建和管理批注。

<DocumentViewer.ContextMenu><ContextMenu><MenuItem Command="ApplicationCommands.Copy" /><Separator /><!-- Add a Highlight annotation to a user selection. --><MenuItem Command="ann:AnnotationService.CreateHighlightCommand"Header="Add Highlight" /><!-- Add a Text Note annotation to a user selection. --><MenuItem Command="ann:AnnotationService.CreateTextStickyNoteCommand"Header="Add Text Note" /><!-- Add an Ink Note annotation to a user selection. --><MenuItem Command="ann:AnnotationService.CreateInkStickyNoteCommand"Header="Add Ink Note" /><Separator /><!-- Remove Highlights from a user selection. --><MenuItem Command="ann:AnnotationService.ClearHighlightsCommand"Header="Remove Highlights" /><!-- Remove Text Notes and Ink Notes from a user selection. --><MenuItem Command="ann:AnnotationService.DeleteStickyNotesCommand"Header="Remove Notes" /><!-- Remove Highlights, Text Notes, Ink Notes from a selection. --><MenuItem Command="ann:AnnotationService.DeleteAnnotationsCommand"Header="Remove Highlights &amp; Notes" /></ContextMenu>
</DocumentViewer.ContextMenu>

3、数据锚定

Annotations Framework 将批注与用户选择的数据绑定,而不仅仅是绑定到显示视图中的某个位置。 因此,如果文档视图更改(例如,当用户滚动显示窗口或者调整其大小时),批注将仍然跟随它绑定到的所选数据。 例如,下图显示了用户在所选文本上做的批注。 当文档视图更改时(滚动、调整大小、缩放或者移动),突出显示批注将与最初所选数据一起移动。

caf-dataanchoring.png?view=netframeworkdesktop-4.8

4、匹配批注与批注对象

你可以将批注与对应的批注对象匹配。 以具有注释窗格的简单文档读取器应用程序为例。 注释窗格可能是一个列表框,用于显示锚定到文档的批注列表的文本。 如果用户在列表框中选择一项,应用程序将显示相应的批注对象所锚定到的文档段落。

下面的示例演示如何实现充当注释窗格的此类列表框的事件处理程序。

void annotationsListBox_SelectionChanged(object sender, SelectionChangedEventArgs e)
{Annotation comment = (sender as ListBox).SelectedItem as Annotation;if (comment != null){// IAnchorInfo info;// service is an AnnotationService object// comment is an Annotation objectinfo = AnnotationHelper.GetAnchorInfo(this.service, comment);TextAnchor resolvedAnchor = info.ResolvedAnchor as TextAnchor;TextPointer textPointer = (TextPointer)resolvedAnchor.BoundingStart;textPointer.Paragraph.BringIntoView();}
}

另一示例方案涉及通过电子邮件在文档读取器之间实现交换批注和便笺的应用程序。 凭借此功能,这些应用程序可以将读取器导航到包含要交换的批注的页面。

这篇关于【WPF.NET开发】文档批注的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/604609

相关文章

Go语言开发实现查询IP信息的MCP服务器

《Go语言开发实现查询IP信息的MCP服务器》随着MCP的快速普及和广泛应用,MCP服务器也层出不穷,本文将详细介绍如何在Go语言中使用go-mcp库来开发一个查询IP信息的MCP... 目录前言mcp-ip-geo 服务器目录结构说明查询 IP 信息功能实现工具实现工具管理查询单个 IP 信息工具的实现服

使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)

《使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)》PPT是一种高效的信息展示工具,广泛应用于教育、商务和设计等多个领域,PPT文档中常常包含丰富的图片内容,这些图片不仅提升了... 目录一、引言二、环境与工具三、python 提取PPT背景图片3.1 提取幻灯片背景图片3.2 提取

Android实现在线预览office文档的示例详解

《Android实现在线预览office文档的示例详解》在移动端展示在线Office文档(如Word、Excel、PPT)是一项常见需求,这篇文章为大家重点介绍了两种方案的实现方法,希望对大家有一定的... 目录一、项目概述二、相关技术知识三、实现思路3.1 方案一:WebView + Office Onl

Python实现word文档内容智能提取以及合成

《Python实现word文档内容智能提取以及合成》这篇文章主要为大家详细介绍了如何使用Python实现从10个左右的docx文档中抽取内容,再调整语言风格后生成新的文档,感兴趣的小伙伴可以了解一下... 目录核心思路技术路径实现步骤阶段一:准备工作阶段二:内容提取 (python 脚本)阶段三:语言风格调

使用Java将DOCX文档解析为Markdown文档的代码实现

《使用Java将DOCX文档解析为Markdown文档的代码实现》在现代文档处理中,Markdown(MD)因其简洁的语法和良好的可读性,逐渐成为开发者、技术写作者和内容创作者的首选格式,然而,许多文... 目录引言1. 工具和库介绍2. 安装依赖库3. 使用Apache POI解析DOCX文档4. 将解析

使用Python开发一个带EPUB转换功能的Markdown编辑器

《使用Python开发一个带EPUB转换功能的Markdown编辑器》Markdown因其简单易用和强大的格式支持,成为了写作者、开发者及内容创作者的首选格式,本文将通过Python开发一个Markd... 目录应用概览代码结构与核心组件1. 初始化与布局 (__init__)2. 工具栏 (setup_t

Spring Shell 命令行实现交互式Shell应用开发

《SpringShell命令行实现交互式Shell应用开发》本文主要介绍了SpringShell命令行实现交互式Shell应用开发,能够帮助开发者快速构建功能丰富的命令行应用程序,具有一定的参考价... 目录引言一、Spring Shell概述二、创建命令类三、命令参数处理四、命令分组与帮助系统五、自定义S

Python通过模块化开发优化代码的技巧分享

《Python通过模块化开发优化代码的技巧分享》模块化开发就是把代码拆成一个个“零件”,该封装封装,该拆分拆分,下面小编就来和大家简单聊聊python如何用模块化开发进行代码优化吧... 目录什么是模块化开发如何拆分代码改进版:拆分成模块让模块更强大:使用 __init__.py你一定会遇到的问题模www.

Spring Security基于数据库的ABAC属性权限模型实战开发教程

《SpringSecurity基于数据库的ABAC属性权限模型实战开发教程》:本文主要介绍SpringSecurity基于数据库的ABAC属性权限模型实战开发教程,本文给大家介绍的非常详细,对大... 目录1. 前言2. 权限决策依据RBACABAC综合对比3. 数据库表结构说明4. 实战开始5. MyBA

使用Python开发一个简单的本地图片服务器

《使用Python开发一个简单的本地图片服务器》本文介绍了如何结合wxPython构建的图形用户界面GUI和Python内建的Web服务器功能,在本地网络中搭建一个私人的,即开即用的网页相册,文中的示... 目录项目目标核心技术栈代码深度解析完整代码工作流程主要功能与优势潜在改进与思考运行结果总结你是否曾经