JScrollPane（滚动面板）
# 1. 概述
官方JavaDocsApi: javax.swing.JScrollPane (opens new window)
JScrollPane，滚动面板。JScrollPane 支持水平和垂直滚动视图。文本区域、表格等需要显示较多数据而空间又有限时，通常使用 JScrollPane 进行包裹以实现滚动显示。
JScrollPane 内包含一个视口（ViewPort），表示 JScrollPane 的显示区域。视口内包含一个需要滚动显示的组件，称为视图。
JScrollPane 常用构造方法:
/**
* 参数说明:
* view: 需要滚动显示的视图组件
* vsbPolicy: 垂直滚动条的显示策略
* hsbPolicy: 水平滚动条的显示策略
*/
JScrollPane()
JScrollPane(Component view)
JScrollPane(Component view, int vsbPolicy, int hsbPolicy)
JScrollPane(int vsbPolicy, int hsbPolicy)
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
滚动条的显示策略的取值:
/*
* 垂直滚动条（vsbPolicy）
*/
ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED // 需要时显示（默认）
ScrollPaneConstants.VERTICAL_SCROLLBAR_NEVER // 从不显示
ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS // 总是显示
/*
* 水平滚动条（hsbPolicy）
*/
ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED // 需要时显示（默认）
ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER // 从不显示
ScrollPaneConstants.HORIZONTAL_SCROLLBAR_ALWAYS // 总是显示
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
JScrollPane 常用方法:
// 设置滚动显示视图内容组件
void setViewportView(Component view)
// 设置垂直滚动条的显示策略
void setVerticalScrollBarPolicy(int policy)
// 设置水平滚动条的显示策略
void setHorizontalScrollBarPolicy(int policy)
// 是否响应鼠标滚动事件，默认响应
void setWheelScrollingEnabled(boolean handleWheel)
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
# 2. 代码实例
package com.xiets.swing;
import javax.swing.*;
import java.awt.*;
public class Main {
public static void main(String[] args) {
JFrame jf = new JFrame("测试窗口");
jf.setSize(250, 250);
jf.setLocationRelativeTo(null);
jf.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
// 创建文本区域组件
JTextArea textArea = new JTextArea();
textArea.setLineWrap(true); // 自动换行
textArea.setFont(new Font(null, Font.PLAIN, 18)); // 设置字体
// 创建滚动面板, 指定滚动显示的视图组件(textArea), 垂直滚动条一直显示, 水平滚动条从不显示
JScrollPane scrollPane = new JScrollPane(
textArea,
ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS,
ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER
);
jf.setContentPane(scrollPane);
jf.setVisible(true);
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
结果展示:
上次更新: 2024-09-19 12:17:39