基于JFace Text Framework构建全功能代码编辑器: 第5部分

Text Decoration

Text Decoration

对于代码编辑器来说,Text Decoration(文本装饰)是一个必需的功能。我们先来看看 Java 编辑器中对文本装饰的应用:

图1. Java 编辑器中的文本装饰

可以看到 Java 编辑器会把错误的部分用一个红色的波浪线标记出来,还可以看到对于模版来说,模版参数周围有一个小矩形,而且在左边还有相应的错误图标显示。这些都叫做文本装饰。

提示:模版会在以后的文章中进行介绍

我们在编辑代码的时候,出错是不可避免的,因此有了文本装饰功能之后,我们可以快速的发现错误位置,这对代码编辑是非常有用的。下面就来看一看要实现文本装饰功能都需要了解哪些概念。

Annotation

Annotation(标注)这个术语已经使用的很泛滥了,在很多地方都可以看到,比如 J2SE 5.0 中也有 Annotation 的概念。放到 JTF 中来讲,标注指的是和某块文本区域绑定的特定信息,至于特定信息是什么,是可以自定义的。可以观察一下 JTF 中 Annotation 这个类,可以看到它有类型信息,有附加的文本信息,同时它还有很多子类,而且子类也都包含了一些扩展信息。

标注包含类型信息是很重要的,通过类型,就可以知道某个标注的目的和作用了,然后可以在界面上反映出来。图 1 中的红色波浪线,实际上是因为在那个位置上有一个错误类型的标注。

Ruler

Ruler(标尺)是显示辅助信息的一块区域,它一般附着在编辑器的周围。比如图1中那两个表示错误的图标就是显示在 VerticalRuler(垂直标尺)上的。标尺可以多于一个,在图 1 中可以看到另外一个用来显示行号的标尺,需要多少个标尺可以定制的。

IAnnotationPresentation

名称里面带了“Presentation”字样的都和界面渲染有关,而 IAnnotationPresentation 就是用来渲染标注的。这个接口只是负责在标尺上绘制标注,图1中表示错误的图标就是出自这里。如果你自己定义的标注没有实现这个接口,那么就不会出现在标尺上了。

时间: 2024-12-29 14:21:10

基于JFace Text Framework构建全功能代码编辑器: 第5部分的相关文章

基于JFace Text Framework构建全功能代码编辑器: 第1部分

引言 JFace Text Framework(JFace 文本框架,后面直接简称为 JTF)是 Eclipse 中重要的框架,是其它开发工具的基石之一,比如 JDT (Java Development Tool) 中的 Java 源代码编辑器就是基于它开发的.相信用过 JDT 的人都会对它的源代码编辑器有深刻印象,因为它的很多功能可以让我们很方便的编辑 Java 源代码,比如语法高亮和内容提示等等.所有这些功能都是在 JTF 架的基础上实现的,所以学会使用这个框架对于开发某种语言的编辑工具是至

基于JFace Text Framework构建全功能代码编辑器: 第6部分

Text Hover和Annotation Hover Text Hover Text Hover(文本悬浮)可以让用户快速的得到某种信息,而不用打开相对缓慢的 Eclipse 帮助系统.Eclipse 的 Java 编辑器使用了文本悬浮来显示 Javadoc 帮助,极大的方便了程序员.从功能上看,文本悬浮可以认为是一种增强型的 Tooltip,因为它支持显示更多的内容,并且可以显示成各种样子. 文本悬浮看起来很酷,但是原理却很简单.基本上就是三个步骤: 根据鼠标位置得到字符偏移 根据字符偏移得

基于JFace Text Framework构建全功能代码编辑器: 第4部分

Content Assistant Content Assistant Content Assistant(内容提示)可以帮助程序员快速的完成代码,并且还有代码自动补全的附加功能.这对于一个代码编辑器来说是至关重要的,也是不少人喜欢用 IDE 编写代码的原因之一.但是这个功能背后却不是那么简单的,我们先来了解一下 JTF 中和 Content Assistant 相关的概念,下面是 Eclipse 中 Java 编辑器的内容提示的样子: 图1. Java 编辑器的内容提示 先来介绍一下图 1 中

基于JFace Text Framework构建全功能代码编辑器: 第10部分

Text Formatting Text Formatting(文本格式化)可以快速的将源代码按照预定的规则排版,JTF 只是定义了这个框架,将其发挥到极致的是 JDT.打开 Eclipse 的设置页,找到 General->Java->Code Style->Formatter,你会发现在这里可以编辑名目繁多的格式化选项.JDT 提供的代码格式化功能强大的令人眩目,但本文的目的是介绍这个强大功能下的基础设施. IFormattingStrategy IFormattingStrateg

基于JFace Text Framework构建全功能代码编辑器: 第8部分

Hyperlink Hyperlink(超链接)在 Java 编辑器中用来进行快速的代码定位,当你按住 Ctrl 键并把鼠标指向一个函数名的时候,函数名会显示为超链接,点击之后代码会跳转到函数的声明处.这个功能使得 Eclipse 浏览代码很方便,这次我就来介绍如何在自己的编辑器中添加超链接功能. 超链接的定位 编辑器不会知道哪块区域应该显示为超链接,这是通过 IHyperlinkDetector 接口实现的.这里牵涉到语义方面的内容,因为你必须要能知道鼠标下面到底是个什么.在解析器那一层需要实

基于JFace Text Framework构建全功能代码编辑器: 第7部分

Quick Assistant Quick Assistant(快速帮助)的基本用途是为源代码中的错误提供一些快速的解决方案.快速的意思是指这个方案足够简单或者足够模式化,可以由程序帮你自动完成.当然快速帮助是无法解决深层次的问题的,不过一般我们在编写代码的时候,犯的最多的都是一些小错误,所以快速帮助是个非常有用的功能. 在 Java 编辑器中,快速帮助看上去就是下图的样子: 图1. Java 编辑器中的快速帮助 可见,不管是从名字上,还是界面上,快速帮助都非常类似我提过的 Content As

基于JFace Text Framework构建全功能代码编辑器: 第9部分

Template Template(模版)可以用来快速添加某种固定形式的代码,中间还可以插入参数.对于 Java 编辑器来说,你可以在 Eclipse 的设置中找到相应的属性页,路径是 General->Java->Editor->Templates.这个属性页是Eclipse标准的模版属性页,因为它做的比较完善,所以一般不需要自己写一个. 仔细探索一下这个属性页,尝试编辑一下模版,你可能会发现很多不了解的概念,下面我会一一解释 模版属性 模版包含一些基本属性: Name(名称):这个模

基于JFace Text Framework构建全功能代码编辑器: 第11部分

Text Folding Text Folding(文本折叠)其实在 Eclipse 2.1 的时候就已经出现了苗头,在 Eclipse 3.0 之后,文本折叠的架构被重新设计了,开始逐渐变的实用.我们先来了解一下JTF为了文本折叠做了哪些工作. ProjectionViewer SourceViewer 本身不支持文本折叠,所以 JTF 添加了一个 ProjectionViewer 专门支持文本折叠,它是 SourceViewer 的子类. 主从文档结构 JTF 是不可能神奇的知道哪些文本是可

基于JFace Text Framework构建全功能代码编辑器: 第2部分

Syntax Highlight Syntax Highlight(语法高亮)是指把文本的不同内容用不同的颜色,字体等渲染,通过这种方式,用户可以快速发现某种内容,可以在短时间内对全文的结构有一个大概的了解.本文探讨如何在 JTF 中实现语法高亮. 前提 语法高亮是把一段文本中的不同内容使用不同的样式来渲染的功能,如下图所示: 图1. Java编辑器的语法高亮 图 1 中的 Java 源代码的不同部分被 Java 编辑器渲染成了不同颜色.比如关键字是偏红的,并且是粗体:变量是蓝色,注释是绿色等等