Java Swing JToolBar：工具栏组件

分手后的思念是犯贱 2024-03-30 11:47 72阅读 0赞

工具栏提供了一个用来显示常用按钮和操作的组件。它可以把任意类型的组件附加到工具条上，但是通常是增加按钮。工具栏 JToolBar 类的常用构造方法如表 1 所示。

<table> 
 <thead> 
  <tr> 
   <th>构造方法</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>JToolBar()</td> 
   <td>创建新的工具栏，默认的方向为 HORIZONTAL</td> 
  </tr> 
  <tr> 
   <td>JToolBar(int orientation)</td> 
   <td>创建具有指定 orientation 的新工具栏</td> 
  </tr> 
  <tr> 
   <td>JToolBar(String name)</td> 
   <td>创建一个具有指定 name 的新工具栏</td> 
  </tr> 
  <tr> 
   <td>JToolBar(String name,int orientation)</td> 
   <td>创建一个具有指定 name 和 orientation 的新工具栏</td> 
  </tr> 
 </tbody> 
</table>

与 JMenuBar 不一样，JToolBar 对象可以直接被添加到容器中。JTodBar 类的常用方法如表 2 所示。

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

例 1

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

(1) 创建一个 ToolBarDemo 类，继承 JPanel 父类并实现 ActionListener 接口。

> 1.  `package ch18;`
> 2.  `import javax.swing.*;`
> 3.  `import java.awt.*;`
> 4.  `import java.awt.event.*;`
> 5.  `import java.net.URL;`
> 6.  `import javax.swing.ImageIcon;`
> 7.  `import javax.swing.JFrame;`
> 8.  `import javax.swing.JPanel;`
> 9.  `import javax.swing.JToolBar;`
> 10. `public class ToolBarDemo extends JPanel implements ActionListener`
> 11. `{`
> 12. `protected JTextArea textArea;`
> 13. `protected String newline="\n";`
> 14. `static final private String OPEN="OPEN";`
> 15. `static final private String SAVE="SAVE";`
> 16. `static final private String NEW="NEW";`
> 17. `//事件监听器部分的代码省略，请查阅源文件`
> 18. `protected void displayResult(String actionDescription)`
> 19. `{`
> 20. `textArea.append(actionDescription+newline);`
> 21. `}`
> 22. `public static void main(String[] args)`
> 23. `{`
> 24. `JFrame.setDefaultLookAndFeelDecorated(true);`
> 25. `//定义窗体`
> 26. `JFrame frame=new JFrame("工具栏");`
> 27. `frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);`
> 28. `//定义面板`
> 29. `ToolBarDemo newContentPane=new ToolBarDemo();`
> 30. `newContentPane.setOpaque(true);`
> 31. `frame.setContentPane(newContentPane);`
> 32. `//显示窗体`
> 33. `frame.pack();`
> 34. `frame.setVisible(true);`
> 35. `}`
> 36. `@Override`
> 37. `public void actionPerformed(ActionEvent e)`
> 38. `{`
> 39. `// TODO 自动生成的方法存根`
> 40. `}`
> 41. `}`

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

> 1.  `public ToolBarDemo()`
> 2.  `{`
> 3.  `super(new BorderLayout());`
> 4.  `//创建工具栏`
> 5.  `JToolBar toolBar=new JToolBar();`
> 6.  `addButtons(toolBar);`
> 7.  `//创建一个文本域，用来输出一些信息`
> 8.  `textArea=new JTextArea(15, 30);`
> 9.  `textArea.setEditable(false);`
> 10. `JScrollPane scrollPane=new JScrollPane(textArea);`
> 11. `//把组件添加到面板中`
> 12. `setPreferredSize(new Dimension(450, 110));`
> 13. `add(toolBar,BorderLayout.PAGE_START);`
> 14. `add(scrollPane,BorderLayout.CENTER);`
> 15. `}`

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

> 1.  `protected void addButtons(JToolBar toolBar)`
> 2.  `{`
> 3.  `JButton button=null;`
> 4.  `button=makeNavigationButton("new1",NEW,"新建一个文件","新建");`
> 5.  `toolBar.add(button);`
> 6.  `button=makeNavigationButton("open1",OPEN,"打开一个文件","打开");`
> 7.  `toolBar.add(button);`
> 8.  `button=makeNavigationButton("save1",SAVE,"保存当前文件","保存");`
> 9.  `toolBar.add(button);`
> 10. `}`

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

> 1.  `protected JButton makeNavigationButton(String imageName,String actionCommand,String toolTipText,String altText)`
> 2.  `{`
> 3.  `//搜索图片`
> 4.  `String imgLocation=imageName+".jpg";`
> 5.  `URL imageURL=ToolBarDemo.class.getResource(imgLocation);`
> 6.  `//初始化工具按钮`
> 7.  `JButton button=new JButton();`
> 8.  `//设置按钮的命令`
> 9.  `button.setActionCommand(actionCommand);`
> 10. `//设置提示信息`
> 11. `button.setToolTipText(toolTipText);`
> 12. `button.addActionListener(this);`
> 13. `if(imageURL!=null)`
> 14. `{`
> 15. `//找到图像`
> 16. `button.setIcon(new ImageIcon(imageURL));`
> 17. `}`
> 18. `else`
> 19. `{`
> 20. `//没有图像`
> 21. `button.setText(altText);`
> 22. `System.err.println("Resource not found: "+imgLocation);`
> 23. `}`
> 24. `return button;`
> 25. `}`

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

![b619a633b122b788aba230563bc04f55.gif][]

图1 无图片工具栏

[b619a633b122b788aba230563bc04f55.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/ebc4dff9e90548c5baffa30ea8613656.gif