blog211218. Eclipse text之StyledText, TextViewer和SourceViewer概述
StyledText, TextViewer和SourceViewer是Eclipse text实现文本编辑功能的基础类. 熟悉这三个类是了解eclipse text机理的第一步.
StyledText是SWT ui widget, TextViewer是对StyledText的封装, SourceViewer是进一步的增强.
StyledText
StyledText是SWT中的control, 父类是canvas. 实现了基本的文本显示和有关listener的支持. 简要分述如下,
- 按行组织文本, 以Run为单位渲染文本.
- 支持指定文本片段的textStyle
- 支持selection
- 支持block selection mode
- 支持wordWrap
- 支持caret
- 支持tab
- 支持dragAndDrop和clipBoard.
- 支持margins, indent, justify,
- 支持lineIndent, lineJustify, lineAlignment, lineSpacing, lineBullet
- 支持bidi
- 支持verify.
StyledText的实现依赖于StyledTextContent和StyledTextRenderer.
TextViewer
TextViewer的父类是Viewer, 是对StyleText的封装. 集成了文本编辑的诸多功能,
- 支持undoManager, textDoubleClickStrategy, textHover, 和autoIndentStrategy
- 支持text, textInput, viewport listeners
- 支持document接口
- 支持投影文档projectionDocument
- 支持PaintManager. painter用于特殊图形绘制, 例如annotation, cursorLine等.
- 支持textSelection, 包括blockTextSelecton.
- 支持hyperLink
- 支持text hover. 显示hover提示.
SourceViewer
SourceViewer是TextViewer的子类, 进一步增强了文本编辑功能,
- 支持左侧边条区域, 称作verticalRuler, 和右侧边条区域, 称作overviewRuler
- 支持annotation. annotation可以按照允许显示的位置进行分类, 一类是文本区域, 另一类是侧标条.
- 支持code mining高级能力的实现.
- 支持contentAsistant
- 支持reconciler, 即背景线程中执行任务, 例如代码分析, 语法着色.
驽马一架 一花一世界 2021/12/18 @ 优快云