SWT/JFace下的TreeViewer的使用

2.英文入门篇：看http://www.eclipse.org/articles/Article-TreeViewer/TreeViewerArticle.htm，这个写得比较详细，有利于整体把握。

TreeViewer类是对Tree小部件进行的包装。一个树状视图按父子关系的层次列表显示对象。这个视图需要设置标签以及内容提供器。CheckboxTreeViewer增强了它的功能，支持灰色处理以及对每个项添加了一个复选框。有用的API如下：

add(Object, Object)为该视图给定的父亲项添加给定的孩子项。

add(Object, Object[])为该视图给定的父亲项添加给定的孩子项数组。

addTreeListener(ITreeViewerListener)在该视图中为收缩以及展开事件添加一个监听器。

collapseAll()从根节点起收缩视图树的所有节点。

collapseToLevel(Object, int)收缩给定子树根节点中给定级别的项。

扫描二维码关注公众号，回复： 2031768 查看本文章

expandAll()从根节点起展开视图树的所有节点。

expandToLevel(int)扩展视图树根节点的给定级别的项。

expandToLevel(Object, int)扩展所有给定祖先项，使给定的项在视图树控件中变为可见，然后扩展给定子树根节点中给定级别的项。

getExpandedElements()返回该视图树中处于扩展节点的列表，包括当前隐藏起来但是标记为可见的项，这些项位于一个收缩先驱下面。

getExpandedState(Object)返回当前给定的项是扩展还是收缩的。

Tree getTree()返回该树视图的树控件。

getVisibleExpandedElements()为用户返回扩展并且可见的项。

isExpandable(Object)返回给定项的树节点可不可以扩展。

remove(Object)从视图中移除给定项。

remove(Object[])从视图中移除给定项数组。

reveal(Object)确定给定项可见，根据需要在视图滚动。

scrollDown(int, int)从给定的坐标向下滚动视图控件。

scrollUp(int, int)从给定的坐标向上滚动视图控件。

setAutoExpandLevel(int)设置自动扩展的级别。

setContentProvider(IContentProvider)设置内容提供器，它实现自AbstractTreeViewer，该方法检查内容提供器是不是ITreeContentProvider类型。

setExpandedElements(Object[])设置该视图树中哪些节点是扩展的。

setExpandedState(Object, boolean)设置给定的元素是扩展还是收缩。

setLabelProvider(IBaseLabelProvider)设置标签提供器，树视图实现了该视图框架方法，确定给定的标签提供器是不是ILabelProvider的实例。

CheckboxTreeViewer添加了一下有用的API：

addCheckStateListener(ICheckStateListener)为视图中的项添加一个监听器，监听它的选中状态的改变。

getChecked(Object)返回给定元素的选择状态。

getCheckedElements()返回视图树中选中的项列表，包括当前隐藏着但是标记为选中的项，它们位于收缩的先驱下面。

getGrayed(Object)返回给定项的灰色状态。

getGrayedElements()返回视图树中灰色的项列表，包括当前隐藏着但是标记为灰色的项，它们位于收缩的先驱下面。

setChecked(Object, boolean)设置树视图中给定元素的选中状态。

setCheckedElements(Object[])设置树视图中给定元素数组的选中状态。

setGrayChecked(Object, boolean)设置选择以及灰色选择，它比调用setGrayed和setChecked两个方法更加优化。

setGrayed(Object, boolean)设置树视图中给定元素的灰色处理状态。

setGrayedElements(Object[])设置树视图中给定元素数组的灰色处理状态。

setParentsGrayed(Object, boolean)设置视图中给定元素以及它父亲的灰色处理状态。

setSubtreeChecked(Object, boolean)设置视图中给定项以及它可见孩子的选中状态。