`
benniaolk
  • 浏览: 36785 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

GEF实现Eclipse的Outline视图

阅读更多

1、 首先要实现EditPartFactory接口——EditPartFactoryOutlineImp,该接口为Outline视图提供控制器EditPart对象,注意该EditPartFactoryImp要与编辑视图——即真正的编辑区的EditPartFactory接口实现类PartFactoryEditAreaImp保持一致,否则无法同步编辑区与Outline的同步。当然,并不是编辑区的所有元素都应反应到Outline视图中,这要根据自己的需要在EditPartFactoryOutlineImp创建EditPart对象。
2、 Outline视图中的树控制器的构建:需要实现EditPartFactory接口——TreePartFactory,实现public EditPart createEditPart(EditPart context, Object model)方法,在该方法里为每个结点——model创建其子模型的树模型。Outline的树结构的根结点应该在编辑区的——GraphicalEditorWithFlyoutPalette继承类的内部类ContentOutlinePage继承类的public void createControl(Composite parent)方法中进行创建,通过getViewer().setContents(model)方法将根模型注入Outline视图中。
另外,为了维护Outline的树,需要继承AbstractTreeEditPart,及实现PropertyChangeListener接口,主要需要重载或实现的一些方法为:

//此方法负责处理由于鼠标选中或更改对树造成的变化,对树结构进行刷新
public void propertyChange(PropertyChangeEvent evt)
//树结点的图标
protected Image getImage()
//树结点的文本
protected String getText()
//该方法负责处理由于鼠标选中或其他事件激活某树结点该做的事情,如果为该树结点添加PropertyChangeListener。
public void activate()
//与上面的方法相反
public void deactivate()
//得到当前树结点的模型
protected List getModelChildren()

 

 

补充资料:
在Eclipse 里,当编辑器(Editor)被激活时,大纲视图自动通过这个编辑器的getAdapter()方法寻找它提供的大纲(大纲实现IcontentOutlinePage 接口)。GEF 提供了ContentOutlinePage 类用来实现大纲视图,我们要做的就是实现一个它的子类,并重点实现createControl()方法。ContentOutlinePage 是org.eclipse.ui.part.Page 的一个子类,大纲视图则是PageBookView 的子类,在大纲视图中有一个PageBook,包含了很多Page 并可以在它们之间切换,切换的依据就是当前活动的Editor。因此,我们在createControl()方法里要做的就是构造这个Page,简化后的代码如下所示:

private Control outline;
public OutlinePage() {
   super(new TreeViewer());
}
public void createControl(Composite parent) {
    outline = getViewer().createControl(parent);
    getSelectionSynchronizer().addViewer(getViewer());
    getViewer().setEditDomain(getEditDomain());
    getViewer().setEditPartFactory(new TreePartFactory());
    getViewer().setContents(getDiagram());
}

 

由于我们在构造方法里指定了使用树结构显示大纲,所以createControl()里的第一句就会使outline 变量得到一个Tree(见org.eclipse.gef.ui.parts.TreeViewer 的代码),第二句把TreeViewer 加到选择同步器中,从而让用户不论在大纲或编辑区域里选择EditPart 时,另一方都能自动做出同样的选择;最后三行的作用在以前的帖子里都有介绍,总体目的是把大纲视图的模型与编辑区域的模型联系在一起,这样,对于同一个模型我们就有了两个视图,体会到MVC 的好处了吧。
实现大纲视图最重要的工作基本就是这些,但还没有完,我们要在init()方法里绑定UNDO/REDO/DELETE 等命令到Eclipse 主窗口,否则当大纲视图处于活动状态时,主工具条上的这些命令就会变为不可用状态;在 getControl()方法里要返回我们的outline 成员变量,也就是指定让这个控件出现在大纲视图中;在dispose()方法里应该把这个TreeViewer 从选择同步器中移除;最后,必须在PracticeEditor 里覆盖getAdapter()方法,前面说过,这个方法是在Editor 激活时被大纲视图调用的,所以在这里必须把我们实现好的OutlinePage 返回给大纲视图使用,代码如下:

public Object getAdapter(Class type) {
  if (type == IContentOutlinePage.class)
  return new OutlinePage();
  return super.getAdapter(type);
}

 

1
0
分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics