JFace text support

JFace text support
先要将org.eclipse.text_x.y.z和org.eclipse.jface.text_x.y.z加到classpath


TextViewer and Document
两个重要的接口：IDocument和ITextViewer。JFace为其提供了默认的实现。

一个IDocument的实例持有被编辑的真实的文本信息。它的主要实现是Document类。AbstractDocument提供了部分实现，你可通过继承它来添加自己的实现。IDocument允许通过IDocumentListener接口来获取内容编辑的通知。

IDocument还提供了以下功能
Positions
可以给每一个text区域分配一个记号来作为它的Position。当被指定给某个ducument时一个Position对象有an offset and a length of text。如果document的text被更新的话，Position也会同步更新，所以他永远都是指向同一段文字。Position类本身提供了一些基本的功能，可通过继承他来完善更多有用的功能。

Partition content types
每个document由一个或多个partitions组成，通过ITypedRegion接口来表现。每一个partition可以有各自的内容类型，如plain text, rich text, or HTML。要使用它，你要创建一个IDocumentPartitioner然后assign给你的document,然后document的partitioner就会负责响应对指定位置内容类型的查询，它必须通过实现computePartitioning()来返回包含此document中所有ITypedRegions的一个数组。不需要实现你自己的document partitioner。如果没有创建，整个document就是一个区域，类型为IDocument.DEFAULT_CONTENT_TYPE。

Searching
IDocument通过search()提供了搜索的功能。不支持regular expressions or other patterns，但提供了search start location,direction, and case sensitivity and whether to match whole words only.

ITextViewer将一个标准的text widget转换成一个基于document的text widget

ITextViewer的默认实现是TextViewer，它使用StyledText来显示数据。ITextViewer支持text modifications的listener，也支持visual events（如改变viewport，即text的当前可视区域）的监听器。

虽然作为ITextViewer的默认应用，如果你想要修改显示，TextViewer允许你直接accessStyledText，但建议你使用TextPresentation，因为它可以收集该文档中带有的各个不同的StyleRanges。

ITextViewer还支持很多不同类型的插件，可用来修改widget的行为。可以被customized的功能有：
1.通过IUndoManager来支持undo
2.通过ITextDoubleClickStrategy来支持对鼠标双击的处理
3.通过IAutoIndentStrategy来支持文本的自动缩进
4.通过ITextHover来实现，当鼠标停留在document的一个section上时，显示text.
要使用上述插件，你需要分配一个适当的接口实例给text viewer，然后调用activatePlugins().

如下列出了org.eclipse.jface.text的子包及其作用