SWING - JScrollBar Class
Introduction
The class JScrollBar is an implementation of scrollbar.
Class Declaration
Following is the declaration for javax.swing.JScrollBar class −
public class JScrollBar
extends JComponent
implements Adjustable, Accessible
Field
Following are the fields for javax.swing.ImageIcon class −
protected int blockIncrement
protected BoundedRangeModel model − The model that represents the scrollbar's minimum, maximum, extent (aka "visibleAmount") and current value.
protected int orientation
protected int unitIncrement
Class Constructors
| Sr.No. | Constructor & Description |
|---|---|
| 1 |
JScrollBar() Creates a vertical scrollbar with the initial values. |
| 2 |
JScrollBar(int orientation) Creates a scrollbar with the specified orientation and the initial values. |
| 3 |
JScrollBar(int orientation, int value, int extent, int min, int max) Creates a scrollbar with the specified orientation, value, extent, minimum, and maximum. |
Class Methods
| Sr.No. | Method & Description |
|---|---|
| 1 |
void addAdjustmentListener(AdjustmentListener l) Adds an AdjustmentListener. |
| 2 |
protected void fireAdjustmentValueChanged(int id, int type, int value) Notifies listeners that the scrollbar's model has changed. |
| 3 |
AccessibleContext getAccessibleContext() Gets the AccessibleContext associated with this JScrollBar. |
| 4 |
AdjustmentListener[] getAdjustmentListeners() Returns an array of all the AdjustmentListeners added to this JScrollBar with addAdjustmentListener(). |
| 5 |
int getBlockIncrement() For backwards compatibility with java.awt.Scrollbar. |
| 6 |
int getBlockIncrement(int direction) Returns the amount to change the scrollbar's value by, given a block (usually "page") up/down request. |
| 7 |
int getMaximum() The maximum value of the scrollbar is maximum - extent. |
| 8 |
Dimension getMaximumSize() The scrollbar is flexible along it's scrolling axis and rigid along the other axis. |
| 9 |
int getMinimum() Returns the minimum value supported by the scrollbar (usually zero). |
| 10 |
Dimension getMinimumSize() The scrollbar is flexible along it's scrolling axis and rigid along the other axis. |
| 11 |
BoundedRangeModel getModel() Returns data model that handles the scrollbar's four fundamental properties: minimum, maximum, value, extent. |
| 12 |
int getOrientation() Returns the component's orientation (horizontal or vertical). |
| 13 |
ScrollBarUI getUI() Returns the delegate that implements the look and feel for this component. |
| 14 |
String getUIClassID() Returns the name of the LookAndFeel class for this component. |
| 15 |
int getUnitIncrement() For backwards compatibility with java.awt.Scrollbar. |
| 16 |
int getUnitIncrement(int direction) Returns the amount to change the scrollbar's value by, given a unit up/down request. |
| 17 |
int getValue() Returns the scrollbar's value. |
| 18 |
boolean getValueIsAdjusting() True if the scrollbar knob is being dragged. |
| 19 |
int getVisibleAmount() Returns the scrollbar's extent, aka its "visibleAmount". |
| 20 |
protected String paramString() Returns a string representation of this JScrollBar. |
| 21 |
void removeAdjustmentListener(AdjustmentListener l) Removes an AdjustmentEvent listener. |
| 22 |
void setBlockIncrement(int blockIncrement) Sets the blockIncrement property. |
| 23 |
void setEnabled(boolean x) Enables the component so that the knob position can be changed. |
| 24 |
void setMaximum(int maximum) Sets the model's maximum property. |
| 25 |
void setMinimum(int minimum) Sets the model's minimum property. |
| 26 |
void setModel(BoundedRangeModel newModel) Sets the model that handles the scrollbar's four fundamental properties: minimum, maximum, value, extent. |
| 27 |
void setOrientation(int orientation) Set the scrollbar's orientation to either VERTICAL or HORIZONTAL. |
| 28 |
void setUI(ScrollBarUI ui) Sets the L&F object that renders this component. |
| 29 |
void setUnitIncrement(int unitIncrement) Sets the unitIncrement property. |
| 30 |
void setValue(int value) Sets the scrollbar's value. |
| 31 |
void setValueIsAdjusting(boolean b) Sets the model's valueIsAdjusting property. |
| 32 |
void setValues(int newValue, int newExtent, int newMin, int newMax) Sets the four BoundedRangeModel properties after forcing the arguments to obey the usual constraints. |
| 33 |
void setVisibleAmount(int extent) Set the model's extent property. |
| 34 |
void updateUI() Overrides JComponent.updateUI. |
Methods Inherited
This class inherits methods from the following classes −
- java.lang.Object
JScrollBar Example
Create the following Java program using any editor of your choice in say D:/ > SWING > com > tutorialspoint > gui >
SwingControlDemo.java
package com.tutorialspoint.gui;
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
public class SwingControlDemo {
private JFrame mainFrame;
private JLabel headerLabel;
private JLabel statusLabel;
private JPanel controlPanel;
public SwingControlDemo(){
prepareGUI();
}
public static void main(String[] args){
SwingControlDemo swingControlDemo = new SwingControlDemo();
swingControlDemo.showScrollbarDemo();
}
private void prepareGUI(){
mainFrame = new JFrame("Java Swing Examples");
mainFrame.setSize(400,400);
mainFrame.setLayout(new GridLayout(3, 1));
mainFrame.addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent windowEvent){
System.exit(0);
}
});
headerLabel = new JLabel("", JLabel.CENTER);
statusLabel = new JLabel("",JLabel.CENTER);
statusLabel.setSize(350,100);
controlPanel = new JPanel();
controlPanel.setLayout(new FlowLayout());
mainFrame.add(headerLabel);
mainFrame.add(controlPanel);
mainFrame.add(statusLabel);
mainFrame.setVisible(true);
}
private void showScrollbarDemo() {
headerLabel.setText("Control in action: JScrollbar");
final JScrollBar horizontalScroller = new JScrollBar(JScrollBar.HORIZONTAL);
final JScrollBar verticalScroller = new JScrollBar();
verticalScroller.setOrientation(JScrollBar.VERTICAL);
horizontalScroller.setMaximum (100);
horizontalScroller.setMinimum (1);
verticalScroller.setMaximum (100);
verticalScroller.setMinimum (1);
horizontalScroller.addAdjustmentListener(new AdjustmentListener() {
@Override
public void adjustmentValueChanged(AdjustmentEvent e) {
statusLabel.setText("Horozontal: "
+horizontalScroller.getValue()
+" ,Vertical: "
+ verticalScroller.getValue());
}
});
verticalScroller.addAdjustmentListener(new AdjustmentListener() {
@Override
public void adjustmentValueChanged(AdjustmentEvent e) {
statusLabel.setText("Horozontal: "
+horizontalScroller.getValue()
+" ,Vertical: "+ verticalScroller.getValue());
}
});
controlPanel.add(horizontalScroller);
controlPanel.add(verticalScroller);
mainFrame.setVisible(true);
}
}
Compile the program using the command prompt. Go to D:/ > SWING and type the following command.
D:\SWING>javac com\tutorialspoint\gui\SwingControlDemo.java
If no error occurs, it means the compilation is successful. Run the program using the following command.
D:\SWING>java com.tutorialspoint.gui.SwingControlDemo
Verify the following output.