[zt]工具栏（Action Bar）

macrochen

浏览: 2488340 次
性别:
来自: 杭州

最近访客更多访客>>

beifengbei08

teaklee

吴志新

u012363178

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

Eclipse

Eclipse C C++C#Blog

FROM:http://www.blog.edu.cn/user1/19180/archives/2006/1406358.shtml

对于图形界面工具来说，工具栏是必不可少的支持。对于Eclipse插件而言，工具栏可以分为两种：主工具栏（全局）和视图工具栏。从实现的角度上，二者没有什么太大区别，只是在初始化的时候略有不同。

工具条上的每一个按钮实际上是一个Action，每个Action负责执行一些功能。Action分为普通的Action和RetargetAction两种，我们看到的工具栏上的按钮其实都是RetargetAction，他们负责提供按钮的图标、说明等等，而真正的功能则由另一个普通的Action负责实现。这就是说，在普通的Action和RetargetAction之间存在一个对应关系，当用户点中工具栏上的RetargetAction时，其对应的Action将被执行（我们称这个Action为RetargetAction的handler）。一般来说，只要二者的ID一样，那么这两个Action之间就能自动建立这种对应。实际上，存在一个函数为RetargetAction建立handler，但是默认情况下GEF帮我们做了，有关映射的问题，稍后再做讨论。

自定义一个Action

下面给出一个RetargetAction的例子：

public class MappingRetargetAction extends RetargetAction {
public MappingRetargetAction() {
super(MappingAction.ID, "do Mapping");
setToolTipText("Mapping abstract Model");
setImageDescriptor(ModelConstance.ICON_MAPPING_A);
setDisabledImageDescriptor(ModelConstance.ICON_MAPPING_D);
}
}

上面的代码一目了然，这里不再做过多的解释。接下来创建MappingAction，也就是RetargetAction的Handler。MappingAction的作用是为模型元素进行语义映射，因而，我们首先需要选中一个模型元素——重点是，MappingAction必须是SelectionAction的子类。

SelectionAction用于实现选中元素的操作，如果某一项功能需要选中一些元素后才能执行，那么你就可以使用SelectionAction。SelectionAction是WorkbenchPartAction的子类，WorkbenchPartAction的子类还包括CopyTemplateAction、EditorPartAction、PrintAction、StackAction，这看起来比较晕，不过幸运的是最常用的还是SelectionAction，或者你可以直接继承自WorkbenchPartAction甚至是Action来实现你的功能。

对于每个WorkbenchPartAction来说，最重要的方法是calculateEnabled和run，前者用于判断这个Action是否可以被激活，后者则执行这些操作，这一点对于SelectionAction也是一样的，如下面的示例：

public class MappingAction extends SelectionAction {
final static public String ID = "USER_DEFINE:Mapping";
protected MappingDialog dlg = null;
public MappingAction(IWorkbenchPart part) {
super(part);
this.setId(ID);
}
protected boolean calculateEnabled() {
IStructuredSelection s = (IStructuredSelection)this.getSelection();
if(s==null||s.size()!=1) return false;
if(s.getFirstElement() instanceof DiagramPart) return false;
if(s.getFirstElement() instanceof TextObjectModelPart) return true;
return false;
}
public void run() {
IStructuredSelection s = (IStructuredSelection)this.getSelection();
if(dlg==null) dlg = new MappingDialog((Shell)null);
if(dlg.open()!=Window.OK) {
return;
}
MappingTextObjectCommand c = new MappingTextObjectCommand();
c.path = dlg.path;
c.model = (TextObjectModel)((TextObjectModelPart)s.getFirstElement()).getModel();
this.execute(c);
}
}

有两点需要说明，首先在初始化的时候Action的ID一定和之前的RetargetAction一致；其次，原则上run方法里可以实现全部的功能，但是出于复用的角度，我们还是讲真正的逻辑封装在一个Command里。

安装Action

首先我们需要一个ActionBarContributor，它用于创建主工具栏。其中我们主要需要实现三个函数：buildActions、declareGlobalActionKeys、contributeToToolBar。buildActions通常用于创建新的Action，declareGlobalActionKeys则用于声明那些已经存在RetargetAction的Action，比如有些功能如DELETE、UNDO、REDO等等。

GEF 在ActionBarContributor里维护了retargetActions和globalActionKeys两个列表，其中后者是一个Retarget Actions的ID列表，addRetargetAction()方法会把一个Retarget Action同时加到二者中，对于已有的Retarget Actions，我们应该在declareGlobalActionKeys()方法里调用addGlobalActionKey()方法来声明，在一个编辑器被激活的时候，与globalActionKeys里的那些ID具有相同ID值的（具有实际功能的）Action将被联系到该ID对应的Retarget Action，只要保证二者的ID相同即可实现映射。[八进制]

示例如下：

public class DiagramActionBarContributor extends ActionBarContributor {
protected void buildActions() {
addRetargetAction(new DeleteRetargetAction());
addRetargetAction(new MappingRetargetAction());
addRetargetAction(new MappingRelationshipRetargetAction());
}
protected void declareGlobalActionKeys() {
}
public void contributeToToolBar(IToolBarManager toolBarManager) {
toolBarManager.add(getAction(ActionFactory.DELETE.getId()));
toolBarManager.add(getAction(MappingAction.ID));
toolBarManager.add(getAction(MappingRelationshipAction.ID));
}
}

ActionBarContributor 中只设置了RetargetAction，真正实现功能的Action则要在Editor中进行设置。重载Editor的createActions，安装真正Action，如下：

java 代码

protected void createActions() {
super.createActions();
IAction a;
a = new MappingAction(this);
getActionRegistry().registerAction(a);
getSelectionActions().add(a.getId());
...
}

最后在plugin.xml中的Extensions选项页里选择你的Editor，并在右侧Extension Element Details里设置ContributorClass为ActionBarContributor，主工具栏就会出现我们自定义的那个Action了。

PS：八进制这篇写的真不错，推荐一下http://bjzhanghao.cnblogs.com/archive/2005/03/30/128704.html

java 代码

分享到：

[zt]1. Draw2d 设计思想 | [zt]第四章 GEF框架(3）

2007-02-14 10:30
浏览 4334
评论(0)
查看更多

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论