19、Java Swing JToolBar：工具栏组件

工具栏提供了一个用来显示常用按钮和操作的组件。

它可以把任意类型的组件附加到工具条上，但是通常是增加按钮。

工具栏 JToolBar 类的常用构造方法：

• JToolBar() ----创建新的工具栏，默认的方向为 HORIZONTAL（水平方向）
• JToolBar(int orientation) ----创建具有指定 orientation（定位） 的新工具栏
• JToolBar(String name)---- 创建一个具有指定 name 的新工具栏
• JToolBar(String name,int orientation) ----创建一个具有指定 name 和 orientation
  的新工具栏

与 JMenuBar 不一样，JToolBar 对象可以直接被添加到容器中， JToolBar类的常用方法：

• add(Action a) ----添加一个指派动作的新的 JButton
• addSeparator()---- 将默认大小的分隔符添加到工具栏的末尾
• addSeparator(Dimension size)---- 将指定大小的分隔符添加到工具栏的末尾
• getComponentAtIndex(int i)---- 返回指定索引位置的组件
• getComponentIndex(Component c) ----返回指定组件的索引
• getMargin() ----返回工具栏边框和它的按钮之间的空白
• getOrientation()---- 返回工具栏的当前方向
• isFloatable()---- 获取 floatable 属性
• isRollover() ----返回 rollover 状态
• setBorderPainted(boolean b) ----设置 borderPainted 属性，如果需要绘制边框，则此属性为 true
• setFloatable(boolean b)---- 设置 floatable 属性，如果要移动工具栏，此属性必须设置为 true
• setLayout(LayoutManager mgr)---- 设置此容器的布局管理器
• setMargin(Insets m)---- 设置工具栏边框和它的按钮之间的空白
• setOrientation(int o) ----设置工具栏的方向
• setRollover(boolean rollover) ----设置此工具栏的 rollover 状态

例 1
下面通过实例来说明如何使用 JToolBar 创建工具栏，在该实例中给工具栏上的按钮添加了图片，当图片不存在时使用文字代替。主要实现步骤如下所示。

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;
import java.net.URL;
import javax.swing.ImageIcon;
import javax.swing.JFrame;
import javax.swing.JPanel;
import javax.swing.JToolBar;
public class ToolBarDemo extends JPanel implements ActionListener
{
    protected JTextArea textArea;protected String newline="\n";static final private String OPEN="OPEN";static final private String SAVE="SAVE";static final private String NEW="NEW";   //事件监听器部分的代码省略，请查阅源文件protected void displayResult(String actionDescription){
    textArea.append(actionDescription+newline);}public static void main(String[] args){
    JFrame.setDefaultLookAndFeelDecorated(true);//定义窗体JFrame frame=new JFrame("工具栏");frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);//定义面板ToolBarDemo newContentPane=new ToolBarDemo();newContentPane.setOpaque(true);frame.setContentPane(newContentPane);//显示窗体frame.pack();frame.setVisible(true);}@Overridepublic void actionPerformed(ActionEvent e){
    // TODO 自动生成的方法存根}
}

(2) 在构造方法中对工具栏进行设置，主要代码如下所示。

public ToolBarDemo()
{
    super(new BorderLayout());//创建工具栏JToolBar toolBar=new JToolBar();addButtons(toolBar);//创建一个文本域，用来输出一些信息textArea=new JTextArea(15, 30);textArea.setEditable(false);JScrollPane scrollPane=new JScrollPane(textArea);//把组件添加到面板中setPreferredSize(new Dimension(450, 110));add(toolBar,BorderLayout.PAGE_START);add(scrollPane,BorderLayout.CENTER);
}

(3) 构造方法中创建了一个工具栏 toolBar，然后调用 addButtons() 方法为工具栏设置按钮。

addButtons() 方法的代码如下：
protected void addButtons(JToolBar toolBar)
{
    JButton button=null;button=makeNavigationButton("new1",NEW,"新建一个文件","新建");toolBar.add(button);button=makeNavigationButton("open1",OPEN,"打开一个文件","打开");toolBar.add(button);button=makeNavigationButton("save1",SAVE,"保存当前文件","保存");toolBar.add(button);
}

(4) 在 addButtons() 方法中调用 makeNavigationButton() 方法，实现对工具栏上的按钮指定图片、动作指令、提示信息和无图片时的文本。具体实现代码如下：

protected JButton makeNavigationButton(String imageName,String actionCommand,String toolTipText,String altText)
{
    //搜索图片String imgLocation=imageName+".jpg";URL imageURL=ToolBarDemo.class.getResource(imgLocation);//初始化工具按钮JButton button=new JButton();//设置按钮的命令button.setActionCommand(actionCommand);//设置提示信息button.setToolTipText(toolTipText);button.addActionListener(this);if(imageURL!=null){
    //找到图像button.setIcon(new ImageIcon(imageURL));}else{
    //没有图像button.setText(altText);System.err.println("Resource not found: "+imgLocation);}return button;
}

(5) 运行程序，在窗口的顶部会看到包含 3 个按钮的工具栏。当鼠标指针放在工具按钮上时出现提示信息，如图 1 所示。