JavaSwing中的容器之–JScrollPane
在Java Swing中,容器是用于容纳其他组件(如按钮、标签等)的组件。Swing提供了多种容器,它们可以嵌套使用以创建复杂的用户界面。
JScrollPane是一个轻量级组件,提供可滚动视图。JScrollPane
基本上由 滚动条、视口(要显示滚动条的组件)、以及它们之间的接线组成。可以通过以下图直观了解,以官方说明文档为准,个人理解可能有偏差。
一、构造方法
JScrollPane类提供了4个构造方法用来创建滚动视图。
方法名称 | 功能描述 |
---|---|
JScrollPane() | 创建一个空的(无视口视图)JScrollPane,其中水平和垂直滚动条在需要时出现。 |
JScrollPane(int vsbPolicy, int hsbPolicy) | 使用指定的滚动条策略创建一个空的(无视口视图)JScrollPane。 |
JScrollPane(Component view) | 创建一个 JScrollPane 来显示指定组件的内容,只要组件的内容大于视图,水平和垂直滚动条就会出现。 |
JScrollPane(Component view, int vsbPolicy, int hsbPolicy) | 创建一个 JScrollPane 在视口中显示视图组件,其视图位置可以用一对滚动条控制。 |
构造方法参数解释:
- vsbPolicy:垂直滚动条策略,取值是JScrollPane的常数。
- hsbPolicy:水平滚动条策略,取值是JScrollPane的常数。
- Componet view:view是要添加滚动条的组件
二、常用方法
JScrollPane提供了丰富的方法用,能完成设置策略、设置滚动条策略、获取滚动条策略值、设置滚动条、设置视图等功能。常见的方法如下表所示。
方法名称 | 功能描述 |
---|---|
setHorizontalScrollBarPolicy(int policy) | 确定水平滚动条何时出现在滚动窗格中。 |
setVerticalScrollBarPolicy(int policy) | 确定垂直滚动条何时出现在滚动窗格中。 |
setViewportView(Component view) | 设置视图(指定哪个组件显示滚动条) |
setWheelScrollingEnabled(boolean handleWheel) | 启用/禁用响应鼠标滚轮移动的滚动。 |
setViewport(JViewport viewport) | 添加或更新视 |
setViewportBorder(Border viewportBorder) | 在视口周围添加边框。 |
setColumnHeaderView(Component view) | 如有必要,创建列标题视口,设置其视图,然后将列标题视口添加到滚动窗格。 |
setRowHeaderView(Component view) | 如有必要,创建行标题视口,设置其视图,然后将行标题视口添加到滚动窗格。 |
setColumnHeader(JViewport columnHeader) | 删除旧的 columnHeader(如果存在);如果新的 columnHeader 不是 null ,则将其 viewPosition 的 x 坐标与视口(如果有的话)同步,然后将其添加到滚动窗格。 |
三、功能详解
1.构造方法创建滚动面板
// 创建一个无视口的ScrollPane对象
JScrollPane scrollPane1 = new JScrollPane();
// 创建一个ScrollPane对象,并设置水平和垂直滚动条始终显示
JScrollPane scrollPane2 = new JScrollPane(JScrollPane.HORIZONTAL_SCROLLBAR_ALWAYS,
JScrollPane.VERTICAL_SCROLLBAR_ALWAYS);
// 创建一个包含指定文本区域作为视口的ScrollPane对象
JScrollPane scrollPane3 = new JScrollPane(textArea);//textArea是文本区域对象
// 创建一个包含指定文本区域作为视口的ScrollPane对象,并设置水平和垂直滚动条始终显示
JScrollPane scrollPane4 = new JScrollPane(textArea,JScrollPane.HORIZONTAL_SCROLLBAR_ALWAYS,
JScrollPane.VERTICAL_SCROLLBAR_ALWAYS);
2.设置视口
调用方法setViewportView(Component view)可以设置滚动视图的视口,如果构造方法创建视图时已指定视口,该方法会替换已有视口,起到更新作用。
//创建空面板,通过setViewportView()设置视图
JScrollPane scrollPane = new JScrollPane();//创建一个空的滚动面板
scrollPane.setViewportView(textArea);//textArea是一个文本区域对象
scrollPane.setBounds(50, 20, 200, 200);//设置滚动面板的位置及大小
3.设置滚动条策略
在滚动面板中可显示水平滚动条、垂直滚动条,通过设置其策略显示滚动条。
设置水平滚动条策略
- JScrollPane.HORIZONTAL_SCROLLBAR_ALWAYS:总是显示
- JScrollPane.HORIZONTAL_SCROLLBAR_AS_NEEDED:根据需要显示
- JScrollPane.HORIZONTAL_SCROLLBAR_NEVER):从不显示
// 设置滚动面板的水平滚动条策略为始终显示
scrollPane.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_ALWAYS);
// 设置滚动面板的水平滚动条策略为按需显示
scrollPane.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_AS_NEEDED);
// 设置滚动面板的水平滚动条策略为从不显示
scrollPane.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_NEVER);
设置垂直滚动条策略
- JScrollPane.VERTICAL_SCROLLBAR_ALWAYS):总是显示
- JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED):根据需要显示
- JScrollPane.VERTICAL_SCROLLBAR_NEVER):从不显示
//设置滚动面板的垂直滚动条策略为始终显示
scrollPane.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_ALWAYS);
// 设置滚动面板的垂直滚动条策略为按需显示
scrollPane.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);
// 设置滚动面板的垂直滚动条策略为从不显示
scrollPane.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_NEVER);
4.更新视口
// 创建一个新的JPanel对象作为滚动面板的视口
JPanel viewport = new JPanel();
// 将文本区域添加到视口中
viewport.add(new JTextArea(10,10));
// 将视口设置到滚动面板中,以便滚动面板可以显示视口中的内容
scrollPane.setViewportView(viewport);
5.为视口设置边框
// 为滚动面板的视口设置边框
scrollPane.setViewportBorder(BorderFactory.createLineBorder(Color.BLUE));
6. 设置列标题、行标题
Label columnHeaderViewport = new JLabel("这是列标题");
scrollPane.setColumnHeaderView(columnHeaderViewport);//scrollpane是滚动面板对象
JLabel rowHeaderViewport = new JLabel("这是行标题n");
scrollPane.setRowHeaderView(rowHeaderViewport);
7.设置滚动条颜色
// 获取滚动面板的垂直滚动条
JScrollBar vscrollBar = scrollPane.getVerticalScrollBar();
// 设置垂直滚动条的背景颜色
vscrollBar.setBackground(new Color(164,68,223));
// 获取滚动面板的水平滚动条
JScrollBar hscrollBar = scrollPane.getHorizontalScrollBar();
// 设置水平滚动条的背景颜色
hscrollBar.setBackground(new Color(255,150,113));
8.设置滚动条单次滚动增量
获取水平或垂直滚动条,调用其setUnitIncrement( int )方法设置滚动增量,调整滚动速度
//设置滚动条的单次滚动增量,以调整滚动速度
JScrollPane scrollPane = new JScrollPane();//创建一在这里插入代码片个空的滚动面板
scrollPane.setViewportView(textArea);//textgArea是文本域对象
scrollPane.setBounds(50, 20, 200, 200);
JScrollBar vscrollBar = scrollPane.getVerticalScrollBar();//获取垂直滚动条
vscrollBar.setUnitIncrement(10);//设置单次增量为10
9.启动鼠标滚轮滚动功能
启用滚动条的鼠标滚轮滚动功能,以允许用户通过鼠标滚轮来滚动内容
scrollPane.setWheelScrollingEnabled(true);
四、总结
JScrollPane主要由滚动条、视口组成。
可以根据需要完成更新视口、设置滚动条颜色、滚动增量、设置角组件、增设边框等操作。若想对滚动条有更多的操作,可查看官方文档对JScrollBar的介绍,或者查阅作者关于JScrollBar的用法介绍。