Rigla cu cursor

Clasa javax.swing.JSlider oferă o componentă care are aspectul unei rigle prevăzute cu cursor. Prin deplasarea cursorului cu ajutorul mouse-ului se modifică valoarea indicată de riglă. Valoarea minimă şi cea maximă de pe scala riglei şi valoarea unei diviziuni se indică prin program. Rolul riglei poate fi asemănat cu cel al unui dispozitiv de ajustare continuă, cum este potenţiometrul din aparatura electronică.

La deplasarea cursorului, rigla generează evenimente din clasa javax.swing.event.ChangeEvent, care sunt ascultate cu o clasă care implementează interfaţa javax.swing.event.ChangeListener.

Crearea riglei se face folosind unul dintre constructorii ei, dintre care cel mai complet este
public JSlider(int orientation, int min, int max, int value)
în care
    orientation - orientarea riglei, care poate fi JSlider.HORIZONTAL sau JSlider.VERTICAL;
   min, max - valorile minimă şi maximă de pe scala riglei;
   value - valoarea indicată iniţial de cursorul riglei (trebuie să fie în intervalul [min,max]).
Pentru a stabili aspectul riglei se folosesc metodele
    public void setMajorTickSpacing(int n) - stabilirea valorii diviziunilor mari
    public void setMinorTickSpacing(int n) - stabilirea valorii diviziunilor mici
    public void setPaintTicks(boolean b) - determină dacă diviziunile vor fi vizibile
    public void setPaintLabels(boolean b) - determină dacă vor fi afişate valorile numerice ale diviziunilor.

Pentru aprofundarea utilizării riglelor cu cursor, recomandăm consultarea capitolului How to Use Sliders din Java Tutorial.

Exemplu
În fişierul TestRigla.java este dat un exemplu de aplicaţie în care se testează o riglă cu cursor realizată ca instanţă a clasei JSlider.
La partea superioară a ferestrei apare o riglă în poziţie orizontală. Când se modifică cu mouse-ul poziţia cursorului, în eticheta de la partea inferioară a ferestrei aplicaţiei se afişeaza noua valoare indicată de riglă.

import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import javax.swing.event.*;

class TestRigla {
static AF af=new AF();
static AscultRigla ascult=new AscultRigla();
static IUG iug=new IUG("O rigla ajustabila");

/* clasa imbricata pentru interfata utilizator grafica */
static class IUG extends JFrame {
JSlider rigla;
JLabel label;

IUG(String titlu) { // constructorul clasei IUG
   super(titlu);
   setSize(450, 150);
   setLocation(200, 50);
   Container cp=getContentPane();
   addWindowListener(af); // adaugarea ascultatorului de fereastra

   /* Se creeaza o "eticheta" pentru afisarea mesajelor */
   label=new JLabel("Deplasati cursorul riglei si urmariti efectul");
   label.setBorder(BorderFactory.createTitledBorder(
      "Afisarea mesajelor privind valoarea ajustata"));
   cp.add(label, BorderLayout.SOUTH);

   rigla=new JSlider(JSlider.HORIZONTAL, -20, 80, 35);
   rigla.setBorder(BorderFactory.createTitledBorder(
         "Ajustarea valorii"));
   rigla.setMajorTickSpacing(10);
   rigla.setMinorTickSpacing(1);
   rigla.setPaintTicks(true);
   rigla.setPaintLabels(true);
   rigla.addChangeListener(ascult);

   cp.add(rigla, BorderLayout.CENTER);

   setVisible(true);
}
}

/* Clasa ascultatoare de fereastra */
static class AF extends WindowAdapter {
public void windowClosing(WindowEvent e) {
   System.exit(0); // incheierea executarii aplicatiei
}
}

/* Clasa ascultatoare a evenimentelor de ajustare a riglei */
static class AscultRigla implements ChangeListener {
public void stateChanged(ChangeEvent e) {
    iug.label.setText("Noua valoare: "+iug.rigla.getValue());
}
}

/* Metoda principala a aplicatiei */
public static void main(String args[]) {
}
}