Showing Images and Text in Toolbar

最新推荐文章于 2022-02-21 18:55:34 发布

liuchao1211

最新推荐文章于 2022-02-21 18:55:34 发布

阅读量668

点赞数

分类专栏： RCP 文章标签： action swt properties application interface manager

本文链接：https://blog.csdn.net/liuchao1211/article/details/5589079

版权

RCP 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

Showing both images and text for certain toolbar items is a common requirement. The text is generally placed either to the right or below the image for the action, as shown in Figure 17-3. This improves usability for new users who do not know the meanings of the images. The Workbench supports mixing images and text, but only with programmatic actions.

Let's walk through how this is done. When an application contributes actions to the top-level toolbar, it adds them to an ICoolBarManager. The ICoolBarManager interface extends IContributionManager and can manage both IActions and IContributionItems. Contributed items wrap the SWT controls that are shown in the contribution manager and are ultimately responsible for rendering the items in a menu, a composite, or a coolbar.

JFace provides a helper class called ActionContributionItem for directly adding actions to a contribution manager. Contributed action items effectively transfer the properties of an action down to an SWT control. As such, they can be used to configure whether or not text is shown on the toolbar.

To control the ActionContributionItem for an action, first create the toolbar with a style flag that includes SWT.BOTTOM or SWT.RIGHT to indicate where to show the text. Then, for each action, create an ActionConfigurationItem and set its mode to ActionContributionItem.MODE_FORCE_TEXT. Next, call ToolBarManager.add(IContributionItem) to add the contribution item to the toolbar. The following code shows how to do this in Hyperbola's ActionBarAdvisor:

org.eclipsercp.hyperbola/ApplicationActionBarAdvisor

protected void fillCoolBar(ICoolBarManager coolBar) { IToolBarManager toolbar = new ToolBarManager(coolBar.getStyle() | SWT.BOTTOM); coolBar.add(toolbar); ActionContributionItem addContactCI = new ActionContributionItem(addContactAction); addContactCI.setMode(ActionContributionItem.MODE_FORCE_TEXT); toolbar.add(addContactCI); ActionContributionItem removeContactCI = new ActionContributionItem(removeContactAction); removeContactCI.setMode(ActionContributionItem.MODE_FORCE_TEXT); toolbar.add(removeContactCI); ActionContributionItem chatActionCI = new ActionContributionItem(chatAction); chatActionCI.setMode(ActionContributionItem.MODE_FORCE_TEXT); toolbar.add(chatActionCI); coolBar.add(new Separator(IWorkbenchActionConstants.MB_ADDITIONS)); }