在Eclipse开发中使用Retarget Action

原文地址：http://blog.youkuaiyun.com/cuser_online/article/details/6160252

Retarget Action

这是一种具有一定语义但没有实际功能的Action，它唯一的作用就是在主菜单条或主工具条上占据一个项位置，编辑器可以将具有实际功能的Action映射到某个Retarget Action，当这个编辑器被激活时，主菜单/工具条上的那个Retarget Action就会具有那个Action的功能。举例来说，Eclipse提供了IWorkbenchActionConstants.COPY这个Retarget Action，它的文字和图标都是预先定义好的，假设我们的编辑器需要一个"复制节点到剪贴板"功能，因为"复制节点"和"复制"这两个词的语义十分相近，所以可以新建一个具有实际功能的

CopyNodeAction（extends Action），然后在适当的位置调用下面代码实现二者的映射：

IActionBars.setGlobalActionHandler(IWorkbenchActionConstants.COPY，copyNodeAction)

当这个编辑器被激活时，Eclipse会检查到这个映射，让COPY项变为可用状态，并且当用户按下它时去执行CopyNodeAction里定义的操作，即run()方法里的代码。

Eclipse引入Retarget Action的目的是为了尽量减少主菜单/工具条的重建消耗，并且有利于用户使用上的一致性。在GEF应用程序里，因为很可能存在多个视图（例如编辑视图和大纲视图，即使暂时只有一个视图，也要考虑到以后扩展为多个的可能），而每个视图都应该能够完成相类似的操作，例如在树结构的大纲视图里也应该像编辑视图一样可以删除选中节点，所以一般的操作都应以映射到Retarget Action的方式建立。

 

 

我们不仅可以使用Eclipse平台内置的Retarget Action,比如ActionFactory.CUT，ActionFactory.COPY，ActionFactory.PASTE等。

也可以定义自己的Retarget Action，只需要继承org.eclipse.ui.actions.RetargetAciton即可。例如：

以下代码来自开源RCP应用eclipsetrader。

[java]  view plain copy

1. package net.sourceforge.eclipsetrader;  
2.   
3. import org.eclipse.ui.IWorkbenchWindow;  
4.   
5. import org.eclipse.ui.actions.RetargetAction;  
6.   
7.    
8.   
9. //继承自RetargetAction  
10.   
11. public class SettingsAction extends RetargetAction  
12.   
13. {  
14.   
15.    
16.   
17.     public SettingsAction(IWorkbenchWindow window)  
18.   
19.     {  
20.   
21.         super("settings", "Settings...");//前者为id,后者为显示文本  
22.   
23.         window.getPartService().addPartListener(this);  
24.   
25.         setActionDefinitionId("org.eclipse.ui.edit.settings"); //主要为快捷键设置作准备  
26.   
27.     }  
28.   
29. }  
30.   
31.    
32.   
33. 1.在ApplicationActionBar的makeActions方法中，创建Retarget Action。  
34.   
35. settingsAction = new SettingsAction(window);  
36.   
37. registger(settingsAction);  
38.   
39.    
40.   
41. 2.在fillMenuBar中这样用：  
42.   
43. menu.add(settingsAction);  
44.   
45.    
46.   
47. 3.在需要使用RetargetAction的视图或者编辑器，这样用，如在某视图的createPartControl方法中这样使：  
48.   
49.  IActionBars actionBars = getViewSite().getActionBars();  
50.   
51. actionBars.setGlobalActionHandler("cut", cutAction);  
52.   
53. actionBars.setGlobalActionHandler("copy", copyAction);  
54.   
55. actionBars.setGlobalActionHandler("paste", pasteAction = new PasteAction(this));  
56.   
57. actionBars.setGlobalActionHandler("delete", deleteAction);  
58.   
59. actionBars.setGlobalActionHandler("settings", new Action() {//重点看这里  
60.   
61.        public void run()  
62.   
63.            {  
64.   
65.                WatchlistSettingsDialog dlg = new WatchlistSettingsDialog(getWatchlist(), getViewSite().getShell());  
66.   
67.                dlg.open();  
68.   
69.             }  
70.   
71.  });  
72.   
73.    
74.   
75.