Java Swing Ribbon（Flamingo）的使用05：小组件

这篇文章将简单介绍一下Ribbon中常用的控件空间小组件的使用，包括：设置左上角圆形菜单图标、设置左上角快捷工具条、设置右上角帮助按钮等。

在看这篇文章之前建议先看如下的一些文章。当然如果对Flamino-Ribbon已经有一些基本的了解的则不用看了。

01.关于Flamingo-Ribbon的安装与使用：Flamingo-Ribbon的使用01：安装与初始使用

02.关于Fiamingo-Ribbon界面风格设置：Flamingo-Ribbon的使用02：更改界面风格

03.关于Flamingo-Ribbon按钮样式更改：Flamingo-Ribbon的使用03：按钮中添加图片和更改样式

04.关于Flamingo-Ribbon按钮模式更改： Flamingo-Ribbon的使用04：按钮（JCommandButton）模式更改

1、设置左上角圆形菜单图标

Office 2007中在软件的左上角可以添加圆形按钮菜单，在Flamingo-Ribbon中也可以添加同样的圆形菜单按钮。

代码如下：

// 设置左上角圆图标
private void setApplicationMenu(JRibbon ribbon) {
	RibbonApplicationMenu ram = new RibbonApplicationMenu();
	ribbon.setApplicationMenu(ram); // 左上角的圆图标
}

2、设置左上角快捷工具条

Office 2007中在软件的左上角可以设置常用的按钮的快捷方式，比如复制、回退、格式刷等，在Flamingo-Ribbon中也可以添加同样的快捷按钮。

代码如下：

//左上角的工具条
private void setTaskbarComponent(JRibbon ribbon) {
	JCommandButton button1 = new JCommandButton("打开");
	JCommandButton button2 = new JCommandButton("复制");
	JCommandButton button3 = new JCommandButton("格式化");
	
//		button1.addActionListener(actionListener1);
//		button2.addActionListener(actionListener2);
//		button3.addActionListener(actionListener3);
	
	attachImage(button1, "resources/AddFile.png");
	attachImage(button2, "resources/SetEnvironment.png");
	attachImage(button3, "resources/RunAgent.png");
	
	ribbon.addTaskbarComponent(button1);
	ribbon.addTaskbarComponent(button2);
	ribbon.addTaskbarComponent(button3);
}

3、设置右上角帮助按钮

在很多桌面软件中，会在右上角放置一个帮组按钮，点击该按钮就可以弹出对该软件的帮助说明。在 Flamingo-Ribbon中也可以添加该按钮。其代码如下：

//配置帮助按钮
private void configureHelp(JRibbon ribbon) {
    ribbon.configureHelp(getResizableIconFromResource(
            "resources/Help.png"), new ActionListener() {
        @Override
        public void actionPerformed(ActionEvent e) {
            JOptionPane.showMessageDialog(null, "Help");
        }
    });
}

上述所有代码的完整形式如下：

import java.awt.Dimension;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.util.Arrays;
import java.util.List;
import javax.swing.JDialog;
import javax.swing.JFrame;
import javax.swing.JOptionPane;
import javax.swing.SwingUtilities;

import org.pushingpixels.flamingo.api.common.JCommandButton;
import org.pushingpixels.flamingo.api.common.icon.ImageWrapperResizableIcon;
import org.pushingpixels.flamingo.api.common.icon.ResizableIcon;
import org.pushingpixels.flamingo.api.ribbon.JRibbon;
import org.pushingpixels.flamingo.api.ribbon.JRibbonBand;
import org.pushingpixels.flamingo.api.ribbon.JRibbonFrame;
import org.pushingpixels.flamingo.api.ribbon.RibbonApplicationMenu;
import org.pushingpixels.flamingo.api.ribbon.RibbonElementPriority;
import org.pushingpixels.flamingo.api.ribbon.RibbonTask;
import org.pushingpixels.flamingo.api.ribbon.resize.CoreRibbonResizePolicies;
import org.pushingpixels.flamingo.api.ribbon.resize.IconRibbonBandResizePolicy;

public class MainFrame extends JRibbonFrame {
    static {
	   // 设置界面风格：获取系统样式
	   try {
		javax.swing.UIManager.setLookAndFeel(
			"org.pushingpixels.substance.api.skin.SubstanceOfficeBlue2007LookAndFeel");
	   } catch (Exception e) {
		e.printStackTrace();
	   }
    }
    //根据图片的地址获取该图片，返回ResizableIcon
    public static ResizableIcon getResizableIconFromResource(String resource) {
        return ImageWrapperResizableIcon.getIcon(
                MainFrame.class.getClassLoader().getResource(resource), 
                new Dimension(48, 48));
    }
    public static void main(String[] args) {
    	JFrame.setDefaultLookAndFeelDecorated(true); //windows功能失效
    	JDialog.setDefaultLookAndFeelDecorated(true); //Dialog功能失效
        SwingUtilities.invokeLater(new Runnable() {
            @SuppressWarnings({ "unchecked", "rawtypes" })
            @Override
            public void run() {
                MainFrame frame = new MainFrame();
                frame.setDefaultCloseOperation(EXIT_ON_CLOSE);
                
                JRibbonBand band = new JRibbonBand("文件", null); //新建一个Band
                
                band.setResizePolicies((List) Arrays.asList(
                		new CoreRibbonResizePolicies.None(band.getControlPanel()),
                		new IconRibbonBandResizePolicy(band.getControlPanel())));
                
                JCommandButton button1 = new JCommandButton("Square", 
                        getResizableIconFromResource("resources/Project.png"));
                JCommandButton button2 = new JCommandButton("Circle", 
                        getResizableIconFromResource("resources/Clear.png"));
                JCommandButton button3 = new JCommandButton("Triangle", 
                        getResizableIconFromResource("resources/ZoomOut.png"));
                JCommandButton button4 = new JCommandButton("Star", 
                        getResizableIconFromResource("resources/ZoomIn.png"));
                band.addCommandButton(button1, RibbonElementPriority.TOP);
                band.addCommandButton(button2, RibbonElementPriority.MEDIUM);
                band.addCommandButton(button3, RibbonElementPriority.MEDIUM);
                band.addCommandButton(button4, RibbonElementPriority.MEDIUM);
                
                //新建一个Task，并将Band添加到该Task中去
                RibbonTask task1 = new RibbonTask("One", band);
                
                JRibbon ribbon = frame.getRibbon();
                ribbon.addTask(task1);

                frame.setApplicationMenu(ribbon); //左上角圆图标
                frame.setTaskbarComponent(ribbon); //左上角的工具条
                frame.configureHelp(ribbon); //右上角的帮助按钮
                
                frame.pack();
                frame.setVisible(true);
            }
        });
    }
    
	//左上角的工具条
    private void setTaskbarComponent(JRibbon ribbon) {
		JCommandButton button1 = new JCommandButton("打开");
		JCommandButton button2 = new JCommandButton("复制");
		JCommandButton button3 = new JCommandButton("格式化");
		
//		button1.addActionListener(actionListener1);
//		button2.addActionListener(actionListener2);
//		button3.addActionListener(actionListener3);
		
		attachImage(button1, "cn/edu/njnu/resources/AddFile.png");
		attachImage(button2, "cn/edu/njnu/resources/SetEnvironment.png");
		attachImage(button3, "cn/edu/njnu/resources/RunAgent.png");
		
		ribbon.addTaskbarComponent(button1);
		ribbon.addTaskbarComponent(button2);
		ribbon.addTaskbarComponent(button3);
	}
    
    private void attachImage(JCommandButton btn, String key) {
		btn.setIcon(getResizableIconFromResource(key));
	}
    
	//配置帮助按钮
	private void configureHelp(JRibbon ribbon) {
		ribbon.configureHelp(getResizableIconFromResource(
				"resources/Help.png"), new ActionListener() {
			@Override
			public void actionPerformed(ActionEvent e) {
				JOptionPane.showMessageDialog(null, "Help");
			}
		});
	}
    
	// 设置左上角圆图标
 	private void setApplicationMenu(JRibbon ribbon) {
 		RibbonApplicationMenu ram = new RibbonApplicationMenu();
 		ribbon.setApplicationMenu(ram); // 左上角的圆图标
 	}
}

运行上述代码结果如下：

从上图可以看到：

1、在左上角多了一个圆形菜单图标，在这个菜单中可以自行添加自己想要的功能；

2、在圆形菜单的旁边多了三个快捷按钮，可以自行添加按钮的个数和按钮的触发事件；

3、在右上角脱了一个帮助按钮。

全文完。