面板组件
Swing组件中不仅具有JFrame和JDialog这样的顶级窗口,还提供了一些面板组件(也称之为中间容器),这些面板组件不能单独存在,只能放置在顶级窗口容器中。其中最常见的面板组件有两种:JPanel和JScrollPane,接下来分别来介绍这两种面板组件。
1.JPanel
JPanel面板组件是一个无边框,不能被移动、放大、缩小或者关闭的面板,它的默认布局管理器是FlowLayout。当然也可以使用JPanel带参数的构造函数JPanel(LayoutManager layout)或者它的setLayout()方法为其制定布局管理器。
JPanel面板组件类并没有包含多少特殊的组件操作方法,多数都是从其父类(如Container)继承过来的,在使用过程中也非常简单。
2.JScrollPane
与JPanel不同的是,JScrollPane是一个带有滚动条的面板容器,而且这个面板只能添加一个组件,如果想向JScrollPane面板中添加多个组件,应该先将这多个组件添加到某个组件中,然后再将这个组件添加到JScrollPane中。接下来学习一下JScrollPane的常用构造方法,如表1所示。
表1 JScrollPane常用构造方法
方法声明 | 功能描述 |
---|---|
JScrollPane() | 创建一个空的JScrollPane面板 |
JScrollPane(Component view) | 创建一个显示指定组件的JScrollPane面板,只要组件的内容超过视图大小就会显示水平和垂直滚动条 |
JScrollPane(Component view, int vsbPolicy,int hsbPolicy) | 创建一个显示指定容器、并具有指定滚动条策略的JScrollPane。参数vsbPolicy和hsbPolicy分别表示垂直滚动条策略和水平滚动条策略 |
表1中,列出了JScrollPane常用的三个构造方法,其中,第一个构造方法用于创建一个空的JScrollPane面板;第二个构造方法用于创建显示指定组件的JScrollPane面板,这两个方法都比较简单;第三个构造方法,是在第二个构造方法的基础上指定滚动条策略。如果在构造方法中没用指定显示组件和滚动条策略,也可以使用JScrollPane提供的方法进行设置,如表2所示。
表2 JScrollPane设置面板滚动策略的方法
方法声明 | 功能描述 |
---|---|
void setHorizontalBarPolicy(int policy) | 指定水平滚动条策略,即水平滚动条何时显示在滚动面板上 |
void setVerticalBarPolicy(int policy) | 指定垂直滚动条策略,即垂直滚动条何时显示在滚动面板上 |
void setViewportView(Component view) | 设置在滚动面板显示的组件 |
关于上述介绍的JScrollPane面板组件的滚动策略,在ScrollPaneConstants接口中声明了多个常量属性可以用来设置不同的滚动策略,具体如表3所示。
表3 JScrollPane面板滚动策略
方法声明 | 功能描述 |
---|---|
VERTICAL_SCROLLBAR_AS_NEEDED HORIZONTAL_SCROLLBAR_AS_NEEDED | 当填充的组件视图超过客户端窗口大小时,自动显示水平和竖直放行滚动条(JscrollPane组件的默认值) |
VERTICAL_SCROLLBAR_ALWAYS HORIZONTAL_SCROLLBAR_ALWAYS | 无论填充的组件视图大小,始终显示水平和竖直放行滚动条 |
VERTICAL_SCROLLBAR_NEVER HORIZONTAL_SCROLLBAR_NEVER | 无论填充的组件视图大小,始终不显示水平和竖直放行滚动条 |
接下来通过一个案例来演示面板组件的基本使用,如文件1所示。
文件1 Example10.java
1 import java.awt.*;
2 import javax.swing.*;
3 public class Example10 {
4 private static void createAndShowGUI() {
5 // 1、创建一个JFrame容器窗口
6 JFrame f = new JFrame("PanelDemo");
7 f.setLayout(new BorderLayout());
8 f.setSize(350, 200);
9 f.setLocation(300, 200);
10 f.setVisible(true);
11 f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
12 // 2、创建JScrollPane滚动面板组件
13 JScrollPane scrollPane = new JScrollPane();
14 // 设置水平滚动条策略--滚动条需要时显示
15 scrollPane.setHorizontalScrollBarPolicy
16 (ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED);
17 // 设置垂直滚动条策略--滚动条一直显示
18 scrollPane.setVerticalScrollBarPolicy
19 (ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS);
20 // 定义一个JPanel面板组件
21 JPanel panel = new JPanel();
22 // 在JPanel面板中添加四个按钮
23 panel.add(new JButton("按钮1"));
24 panel.add(new JButton("按钮2"));
25 panel.add(new JButton("按钮3"));
26 panel.add(new JButton("按钮4"));
27 // 设置JPanel面板在滚动面板JScrollPane中显示
28 scrollPane.setViewportView(panel);
29 // 4、向JFrame容器窗口中添加JScrollPane滚动面板组件
30 f.add(scrollPane, BorderLayout.CENTER);
31 }
32 public static void main(String[] args) {
33 // 使用SwingUtilities工具类调用createAndShowGUI()方法并显示GUI程序
34 SwingUtilities.invokeLater(Example10::createAndShowGUI);
35 }
36 }
运行结果如图1所示。
图1 运行结果
文件1中,为了演示如何使用面板组件,分别创建了一个JScrollPane滚动面板、一个JPanel面板和四个按钮。首先将四个按钮添加到JPanel面板组件中,然后将该组件添加到JScrollPane面板中。由于JScrollPane指定的水平滚动条策略为HORIZONTAL_SCROLLBAR_AS_NEEDED,因此只有在面板区域中水平方向无法完整显示其内部放置的组件时,才会显示出水平滚动条(可以通过水平方向拉伸窗口查看效果),而JScrollPane的垂直滚动条策略为VERTICAL_SCROLLBAR_ALWAYS,所以垂直方向的滚动条会一直存在。