Java Swing JSlider：滑块组件

Dear 丶 2024-03-30 11:18 71阅读 0赞

在前面的章节中，我们介绍了 Swing 设计简单界面所需的窗口、布局组件以及如何响应事件。Swing 还提供了很多高级组件，如菜单栏、工具栏、文件选择器、表格以及树等。使用这些高级组件可以实现更为复杂的布局，也可以使程序界面更加人性化，以提高程序的灵活性。在之后的章节中，我们将开始详细介绍这些高级组件。

在学习其他高级组件之前，我们先来介绍一些布局组件，包括滑块、进度条、计时器、菜单栏和工具栏，本节我们首先来介绍滑块。

滑块（JSlider）是一个允许用户在有限区间内通过移动滑块来选择值的组件。JSlider 类的常用构造方法如表 1 所示。

<table> 
 <thead> 
  <tr> 
   <th>构造方法</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>JSlider()</td> 
   <td>创建一个范围在 0~100 且初始值为 50 的水平滑块</td> 
  </tr> 
  <tr> 
   <td>JSlider(BoundedRangeModel brm)</td> 
   <td>使用指定的 BoundedRangeModel 创建一个水平滑块</td> 
  </tr> 
  <tr> 
   <td>JSlider(int orientation)</td> 
   <td>使用指定的方向创建一个滑块，范围在 0~100 且初始值为 50</td> 
  </tr> 
  <tr> 
   <td>JSlider(int min,int max)</td> 
   <td>使用指定的最小值和最大值来创建一个水平滑块，初始值等于最小值加上最大值的平均值</td> 
  </tr> 
  <tr> 
   <td>JSlider(int min,int max,int value)</td> 
   <td>用指定的最小值、最大值和初始值创建一个水平滑块</td> 
  </tr> 
 </tbody> 
</table>

例如，创建一个最小值为 30，最大值为 120，初始值为 55 的水平滑块的语句如下所示。

> 1.  `JSIider slider=new JSIider(30,120,55);`

滑块可以显示主刻度标记以及主刻度之间的次刻度标记。刻度标记之间的值的个数由 setMajorTickSpacing() 方法和 setMinorTickSpacing() 方法来控制。刻度标记的绘制由 setPaintTicks() 方法控制。

滑块也可以在固定时间间隔（或在任意位置）沿滑块刻度打印文本标签，标签的绘制由 setLabelTable() 方法和 setPaintLabels() 方法控制。

JSIider 类常用方法如表 2 所示。

<table> 
 <thead> 
  <tr> 
   <th>方法名称</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>createStandardLabels(int increment)</td> 
   <td>创建一个数字文本标签的 Hashtable，从滑块最小值处开始增加，并使用指定的增量</td> 
  </tr> 
  <tr> 
   <td>getLabelTable()</td> 
   <td>返回哪些标签在哪些刻度绘制的字典</td> 
  </tr> 
  <tr> 
   <td>getMaj orTickSpacing()</td> 
   <td>返回主刻度标记的间隔</td> 
  </tr> 
  <tr> 
   <td>getMaximum()</td> 
   <td>从 BoundedRangeModel 返回滑块所支持的最大值</td> 
  </tr> 
  <tr> 
   <td>getMinimum()</td> 
   <td>从 BoundedRangeModel 返回滑块所支持的最小值</td> 
  </tr> 
  <tr> 
   <td>getMinorTickSpacing()</td> 
   <td>返回次刻度标记的间隔</td> 
  </tr> 
  <tr> 
   <td>getSnapToTicks()</td> 
   <td>如果滑块（及其所表示的值）解析为最靠近用户放置滑块处的刻度标记的值，则返回为 true</td> 
  </tr> 
  <tr> 
   <td>getValue()</td> 
   <td>从 BoundedRangeModel 返回滑块的当前值</td> 
  </tr> 
  <tr> 
   <td>setLabelTable(Dictionary labels)</td> 
   <td>用于指定将在给定值处绘制哪个标签</td> 
  </tr> 
  <tr> 
   <td>setMaj orTickSpacing(int n)</td> 
   <td>此方法设置主刻度标记的间隔</td> 
  </tr> 
  <tr> 
   <td>setMaximum(int maximum)</td> 
   <td>将滑块的最大值设置为 maximum</td> 
  </tr> 
  <tr> 
   <td>setMinimum(int minimum)</td> 
   <td>将滑块的最小值设置为 minimum</td> 
  </tr> 
  <tr> 
   <td>setMinorTickSpacing(int n)</td> 
   <td>设置次刻度标记的间隔</td> 
  </tr> 
  <tr> 
   <td>setOrientation(int orientation)</td> 
   <td>将滑块的方向设置为 SwingConstants.VERTICAL 或 SwingConstants.HORIZONTAL</td> 
  </tr> 
  <tr> 
   <td>setPaintLabels(boolean b)</td> 
   <td>确定是否在滑块上绘制标签</td> 
  </tr> 
  <tr> 
   <td>setPaintTicks(boolean b)</td> 
   <td>确定是否在滑块上绘制刻度标记</td> 
  </tr> 
  <tr> 
   <td>setPaintTrack(boolean b)</td> 
   <td>确定是否在滑块上绘制滑道</td> 
  </tr> 
  <tr> 
   <td>setSnapToTicks(boolean b)</td> 
   <td>指定为 true，则滑块（及其所表示的值）解析为最靠近用户放置滑块处的刻度标记的值</td> 
  </tr> 
  <tr> 
   <td>setValue(int n)</td> 
   <td>将滑块的当前值设置为 n</td> 
  </tr> 
 </tbody> 
</table>

例 1

在了解 JSIider 类的基础语法之后，下面创建一个滑块实例。实例非常简单，仅仅包含一个滑块，实例源代码如下所示。

> 1.  `package ch18;`
> 2.  `import java.awt.Container;`
> 3.  `import javax.swing.JFrame;`
> 4.  `import javax.swing.JSlider;`
> 5.  `public class JSliderDemo`
> 6.  `{`
> 7.  `public static void main(String[] agrs)`
> 8.  `{`
> 9.  `JFrame frame=new JFrame("滑块组件示例");`
> 10. `frame.setSize(100,100);`
> 11. `frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);`
> 12. `Container contentPane=frame.getContentPane();`
> 13. `JSlider slider=new JSlider(0,100);`
> 14. `slider.setMajorTickSpacing(10);`
> 15. `slider.setMinorTickSpacing(5);`
> 16. `slider.setPaintLabels(true);`
> 17. `slider.setPaintTicks(true);`
> 18. `contentPane.add(slider);`
> 19. `frame.setVisible(true);`
> 20. `}`
> 21. `}`

上述代码首先创建一个 JFrame 窗口并进行必要属性设置，接着创建一个 JSIider 对象，设置最小值为 0，最大值为 100，然后设置滑块对象的刻度值。运行此时的实例程序，效果如图 1 所示。

![63591bbef281fc2751960b2b323da103.gif][]

如果需要在滑块上添加刻度或标签，可以在“contentPane.add(slider);”前添加下面两行语句：

> 1.  `slider.setPaintLabels(true);`
> 2.  `slider.setPaintTicks(true);`

再次运行程序，此时滑块的运行效果如图 2 所示。

![bd2cb8a0218869dbc1d5c4b68479536e.gif][]

图2 具有刻度和标签的滑块

[63591bbef281fc2751960b2b323da103.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/badf432dddc64efa8c3d88e70b741ec0.gif
[bd2cb8a0218869dbc1d5c4b68479536e.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/9db2db2890a541b29ee1b666dbdc38bb.gif