欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

GEF实现Eclipse的Outline视图

程序员文章站 2024-03-24 10:47:16
...

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);
}