Eclipse插件（RCP）CNF 扩展（五）菜单及工具条定制

悠悠 2023-10-05 22:24 5阅读 0赞

文章[Common Navigator Framework 实践（四）文件过滤][Common Navigator Framework]最后遗留了个问题，这一篇文章来解决。

## 目标 ##

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bCP5a2Q5a6d5LiB_size_20_color_FFFFFF_t_70_g_se_x_16]  
如上图所示，现在的导肮栏视图中有视图菜单和一些工具菜单，本文将讲述如何去掉这些菜单和工具菜单。

## 分析 ##

这些视图菜单和工具菜单其实是视图菜单的扩展，是CNF框架自动默认构建的，有两种方法可以优化，一、使用CNF提供的配置选项进行配置；二、在导航视图实现类中修改视图菜单和工具菜单功能。

## 实现 ##

### 一、CNF 实现 ###

CNF导航视图扩展点`org.eclipse.ui.navigator.viewer`提供了`options`标签，用于配置默认导航视图菜单是否显示。其扩展点文档描述如下：

使用这种方式配置很简单，只要粘贴相关代码即可。配置后的plugin.xml信息为：

此时导航栏视图所有菜单都被隐藏了，如下图所示  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bCP5a2Q5a6d5LiB_size_20_color_FFFFFF_t_70_g_se_x_16 1]

### 二、自定义视图菜单 ###

方法一只能控制CNF提供的视图菜单，无法扩展。因此方法二相较于方法一更加灵活。  
扩展后的导航视图实现类

package com.xzbd.navigator;
    
    import org.eclipse.jface.action.IMenuManager;
    import org.eclipse.jface.action.IToolBarManager;
    import org.eclipse.swt.widgets.Composite;
    import org.eclipse.ui.IActionBars;
    import org.eclipse.ui.IViewSite;
    import org.eclipse.ui.PartInitException;
    import org.eclipse.ui.navigator.CommonNavigator;
    
    import com.xzbd.actions.NavMenuAction01;
    import com.xzbd.actions.NavMenuAction02;
    import com.xzbd.actions.NavMenuAction03;
    
    public class MainNavigator extends CommonNavigator {
        
    	public static final String ID = "com.xzbd.views.MainNavigator";
    	
    	
    	@Override
    	public void createPartControl(Composite aParent) {
        
    		super.createPartControl(aParent);
    		addMenus();
    	}
    
    	@Override
    	public void init(IViewSite site) throws PartInitException {
        
    		super.init(site);
    		
    //		addMenus();
    	}
    	
    	/**
    	 * 添加菜单
    	 */
    	private void addMenus() {
        
    		IActionBars actionBars = getViewSite().getActionBars();
    		IMenuManager menuManager = actionBars.getMenuManager();
    		IToolBarManager toolBarManager = actionBars.getToolBarManager();
    		
    		// 添加在工具条
    		toolBarManager.add(new NavMenuAction01());
    		toolBarManager.add(new NavMenuAction02());
    		
    		// 添加在菜单中
    		menuManager.add(new NavMenuAction01());
    		menuManager.add(new NavMenuAction02());
    		menuManager.add(new NavMenuAction03());
    		
    	}
    }

添加菜单可以重写`createPartControl`和`init`，建议在`createPartControl`中重写。重写后的类中使用到的`NavMenuAction01`、`NavMenuAction02`、`NavMenuAction03`，代码比较简单，详见项目[epx][]，`NavMenuAction01`示例如下：

package com.xzbd.actions;
    
    import org.eclipse.jface.action.Action;
    
    import com.xzbd.advisor.AppActivator;
    import com.xzbd.utils.AppPrinter;
    
    public class NavMenuAction01 extends Action{
        
    	public static final String ID = NavMenuAction01.class.getSimpleName();
    	public static final String TEXT = "刷粉";
    	
    	
    	public NavMenuAction01() {
        
    		setText(TEXT);
    		setToolTipText(TEXT);
    		setImageDescriptor(AppActivator.getImageDescriptor("icons/20220417/zhangfenrenwu.png"));
    	}
    	
    	@Override
    	public void run() {
        
    		AppPrinter.println("我是导航菜单，我的任务是刷粉……");
    	}
    	
    }

## 效果展示 ##

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bCP5a2Q5a6d5LiB_size_20_color_FFFFFF_t_70_g_se_x_16 2]  
**注意**，如果导航视图比较窄，展示效果将如下图所示  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bCP5a2Q5a6d5LiB_size_20_color_FFFFFF_t_70_g_se_x_16 3]

## 总结 ##

文章目的是扩展CNF导航视图的工具条及菜单定制，使用了两种方法。第一种是CNF提供的方法，采用xml配置方式；第二种使用扩展视图类的实现。推荐使用第二种方式，这种方式是视图菜单及工具条添加菜单的原生方法，它能实现方法一的效果，并能灵活扩充。

## 系列文章 ##

[CNF系列汇总][CNF]  
[Common Navigator Framework 实践（一）自定义导航][Common Navigator Framework 1]  
[Common Navigator Framework 实践（二）菜单扩展][Common Navigator Framework 2]  
[Common Navigator Framework 实践（三）文件拖拽控制][Common Navigator Framework 3]  
[Common Navigator Framework 实践（四）文件过滤][Common Navigator Framework]  
[Common Navigator Framework 实践（五）菜单及工具条定制][Common Navigator Framework 4]

## 资料 ##

*  [Common Navigator Framwork 参考资料][Common Navigator Framwork]

## 项目地址 ##

*  [epx][]

[Common Navigator Framework]: https://blog.csdn.net/m0_47406832/article/details/123891052
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bCP5a2Q5a6d5LiB_size_20_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/9a8798993d974fbe94f8e6639182310c.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5bCP5a2Q5a6d5LiB,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bCP5a2Q5a6d5LiB_size_20_color_FFFFFF_t_70_g_se_x_16 1]: https://img-blog.csdnimg.cn/3829906dda1341e4ac4f1e71d2544ada.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5bCP5a2Q5a6d5LiB,size_20,color_FFFFFF,t_70,g_se,x_16
[epx]: https://gitee.com/xzbd/epx
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bCP5a2Q5a6d5LiB_size_20_color_FFFFFF_t_70_g_se_x_16 2]: https://img-blog.csdnimg.cn/5055432871114e62af66434bd16e9707.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5bCP5a2Q5a6d5LiB,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5bCP5a2Q5a6d5LiB_size_20_color_FFFFFF_t_70_g_se_x_16 3]: https://img-blog.csdnimg.cn/1e4f14971c9144b98907d3ea22311ac2.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5bCP5a2Q5a6d5LiB,size_20,color_FFFFFF,t_70,g_se,x_16
[CNF]: https://blog.csdn.net/m0_47406832/article/details/123890933
[Common Navigator Framework 1]: https://blog.csdn.net/m0_47406832/article/details/123916920
[Common Navigator Framework 2]: https://blog.csdn.net/m0_47406832/article/details/123890991
[Common Navigator Framework 3]: https://blog.csdn.net/m0_47406832/article/details/123891025
[Common Navigator Framework 4]: https://blog.csdn.net/m0_47406832/article/details/123891085
[Common Navigator Framwork]: https://download.csdn.net/download/m0_47406832/84265453