SWT/JFace下的TreeViewer的使用（自己总结）

1.入门篇:参照http://www.cnblogs.com/huqingyu/archive/2008/04/10/1146209.html，写得很详细也很简单

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)收缩给定子树根节点中给定级别的项。

   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)设置视图中给定项以及它可见孩子的选中状态。