eclipsaection深入学习笔记.docVIP

Eclipse Action 深入学习笔记(1) 以前做插件用到的ActionSet都只是依葫芦画瓢,没有真正理解它,现在开始好好学习学习,主要是看Building Commercial-Quality Plug-ins写的 Action的组成包括几个部分,一个是在plugin.xml中的声明,一个是在Eclipse UI中会用到的IAction实例化对象, 另一个是封装在IActionDelegate中的action执行代码. action的实例化是基于plugin.xml配置文件和IActionDelegate定义的,Eclipse可以先在界面上将action显示出 来,直到用户点击了菜单或者工具条按钮才会去真正的加载插件,这也就是所谓的Eclipse的延迟加载机制 IActionDelegate有几个子类需要说明一下: IActionDelegate2 如果实现IActionDelegate需要一些其他的信息,而这些信息在IActionDelegate销毁时需要同时被销毁时, 它可以提供相关是生命周期事件方法来处理 IEditorActionDelegate 是跟editor相关的 IObjectActionDelegate 是跟上下文菜单相关的 IViewActionDelegate 是跟view相关的 IWorkbenchWindowActionDelegate是跟menubar和toolbar相关的 Actions和Eclipse中的其他东东一样,也是通过扩展点org.eclipse.ui.actionSets来添加到Eclipse IDE的各个地方,actions的外在表现形式主要有menubar, toolbar, context menu这样几种 在actionSets的下级节点是actionSet, 它有几个属性,id,label都不用说了,还有一个visible属性,表示在打开Eclipse时是否显示该action,通常我们可以通过 Window Customize Perspective...来设置action是否可见 在actionSet下可以添加menu节点, 它的id,label属性不用说了,其中的path是用来指定菜单的显示位置的,一般设置为additions action并不是直接添加到menu上的, 而是跟menu内部的group关联的,所以我们必须先在menu下创建group,即新建groupMarker, 其name必须保证在当前menu下唯一, menu还有一种叫separator的group, 在separator group处添加的menu item会在这个组中的第一个菜单项上面添加一条水平线.而groupMarker则不会有线, 当其他action要添加到该menu group下时,使用水平线进行分组就显得非常必要 group只是用来标识menu的位置,即指这个位置可以添加菜单项, 而不是实际的menu item, 实际的menu item是action 因为menu会有层次关系,所以actionSet中专门用一个menu节点来表现这种层次关系, 而toolbar则没有这种情况,所以这里没有提供toolbar节点 在actionSet下添加action就是最终我们要toolbar上显示的按钮和menubar上的menu item, 这里有几个属性, id和label不用说了,menuBarPath是menu要显示的位置, 比如com.qualityeclipse.favorites.workbenchMenu/content,这个值就是actionSet+ /+group name, toolbarPath 就是toolbar item的显示位置, 比如Normal/additions, 还有几个属性不常用到,但是有必要解释一下 allowLabelUpdate这个要在retarget属性为true的时候有效,还不是很清楚 class 是menu或button要执行的动作, 如果使用的是pulldown风格的action,还需要实现IWorkbenchWindowPulldownDelegate接口,它的构造函数是无 参数的,如果要传递参数,还需要是要实现IExecutableExtension 接口, 这个接口还不是很清楚 definitionId 这个是用来指定action对应的command唯一标识符的 enablesFor 是一个表达式,用来表示当前action是否可用 retarget 不是很理解 state主要是针对style属性为radio和toggle的,表示当前action是否被选中 s