在 EclipseV3.3中配置和添加菜单项.docVIP

在 EclipseV3.3中配置和添加菜单项 在早期的 Eclipse 版本中，向菜单、弹出式菜单或工具栏中添加命令十分复杂。这种情况将一去不复返了！Eclipse V3.3 引入了一种比以前更简单的机制。了解如何使用 org.eclipse.ui.menus 扩展点。 菜单、弹出式菜单和工具栏 —— 几乎所有 Eclipse 插件或 Eclipse Rich Client Platform (RCP) 应用程序都需要这些组件。Eclipse V3.3 引入了一项功能，该功能提供了一种更加通用的配置和添加菜单项方法。本文将演示如何使用新菜单机制加速插件和 RCP 开发。 在 Eclipse V3.2 和早期版本中，需要使用一些扩展点向菜单、弹出式菜单或工具栏添加命令。实际上，有四个不同扩展点：org.eclipse.ui.actionSets、org.eclipse.ui.viewActions、org.eclipse.ui.editorActions 和 org.eclipse.ui.popupMenus。令人遗憾的是，每类组件都要求使用各自的扩展点，而且操作的放置和可视性都不能分开。 Eclipse V3.3 引入了一种新机制：org.eclipse.ui.menus。该扩展点是放置菜单项的新方法。 本文将说明新菜单概念，并通过创建一个小型 Eclipse RCP 应用程序来演示大多数新功能。您应当具有使用 Eclipse RCP 或插件框架的一些基本技能。第一步是从 E 下载带有插件开发环境（Plug-in Development Environment，PDE）的 Eclipse 发行版。建议下载 Eclipse Classic 的最新版本（如果您不熟悉 Eclipse，请参阅 参考资料，了解查找 Eclipse 及其他背景信息的位置）。 平台命令框架 在开始实现一个使用新菜单机制的插件之前，需要了解命令框架。命令是组件的说明性描述，与实现细节无关。命令可以归类并且可以指定键绑定。使用这种方法，可以定义一个通用键绑定，并且根据当前上下文选择特定实现。图 1 显示了一个简化的命令类图。 图 1. 命令类图 使用扩展点 mands 进行命令定义。还可以通过编程的方式创建命令。要实现这个目标，可以使用 ICommandService 接口。多个处理程序都可以处理一个命令，但是只有一个处理程序可以处理命令的具体运行时实例。要在 Eclipse 工作区中进行集成，可以把图像、菜单项和绑定指定给命令。使用类别给命令分组是一种很好的方法。使用类别可以轻松地在复杂的富客户机应用程序中进行浏览。 添加菜单组件 让我们开始使用菜单组件。示例首先将实现一个拥有单个菜单项的小型 RCP 应用程序。此菜单项只打开一个消息对话框。这个小示例将演示使用命令、处理程序和菜单的核心概念。 创建一个名为 MenuContribution 的新插件项目并将 Eclipse 版本设为 3.3。当系统询问您 “Would you like to create a rich client application?” 时，请回答 Yes。使用 Hello RCP 模板。该示例基于名为 com.ibm.de.eclipse.menu 的包。所有其他设置可以保留默认值。现在将新项目作为 Eclipse Application 来运行，然后您将看到以下窗口： 图 2. Hello RCP 示例 我们将通过此应用程序来说明不同的菜单组件。打开 plugin.xml，切换到 Extensions，然后添加 mands extension。由于所有命令都应当分组到一个类别中，因此选择命令扩展并通过右键单击 New category 创建一个新类别。填写类别的各个字段，如图 3 所示： 图 3. 命令类别详细信息 现在右键单击 New command 在命令扩展中添加一条新命令。把 ID 设为 mand.testCmd，将其命名为 Test Command，并把 categoryId 设为 mand.cat1。对于此命令，需要使用一个处理程序来执行关联的业务逻辑。添加 org.eclipse.ui.handlers 扩展点并创建一个新处理程序。该处理程序的 commandId 是 mand.testCmd。要创建处理程序类，单击图 4 中所示的类链接。图 5 显示了填写完必填参数的向导。 提示：如果要在多个扩展中使用类链接，请创建一个包含所选扩展点的必备接口的新类。 图 4. 新处理程序类链接图 5. 向导 处理程序必须实现 execute 方法。添加清单 1 中的代码行显示消息对话框。 清单 1. 处理程序的 execute 方法