Java Tutorials

Welcome to Dream.In.Code
	Become a Java Expert! Join 307,104 Java Programmers for FREE! Get instant access to thousands of Java experts, tutorials, code snippets, and more! There are 2,047 people online right now. Registration is fast and FREE... Join Now! Chat LIVE With a Java Expert

Swing Tutorial Part IV

Swing Tutorial Part IV, Learning Swing

Options

jinnyishere
Group Icon

27 Sep, 2009 - 12:43 PM

Post #1

This chapter is about JList and JCombo box.

Remember, for all the Swing Methods and Constructors click here

Using a List

A list is a swing component that displays lists of objects within a box. We have total control over how the items in the list are displayed. To create a list and specify its items, we pass an array to the JList constructor. Then we call the setVisibleRowCount method to set the number of rows we want to be visible, thus adding the list to the scroll pane, then add the scroll pane to a panel so that we can later add to the frame.

Here we create an array of Strings

String[] months = {"Jan.", "Feb.", "March", "April", "May", "June", "July", "Aug.", "Sept.", "Oct.", "Nov.", "Dec"};

Now, adding the Strings to the list

list = new JList(months);

Then set 5 rows to be visible on the list

list.setVisibleRowCount(5)

Hence, add the list to the scroll pane

JScrollPane scroll = new JScrollPane(list);

Finally, add the scroll pane to a panel

JPanle panel = new JPanel();

Now, Lets see a more detail and complete example with outputs

CODE

/*
    The program demonstrate the use of a list

*
*/

import javax.swing.*;

public class List extends JFrame
{
    JPanel panel;
    JScrollPane scroll;
    JList list;
    JLabel msg;

    public List()
    {
        // Sets the title of the window

        setTitle("JList Window");

        // Sets the size of the window

        setSize(300, 400);

        // Sets the action when the window close

        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

        // Sets the label of the window

        msg = new JLabel("Here are the months");

        // Create a String of array

        String[] months = {"Jan.", "Feb.", "March", "April", "May", "June",
                                    "July", "Aug.", "Sept.", "Oct.", "Nov.", "Dec."};

        // Adds the array of string into the list

        list = new JList(months);

        // Sets the visibility of the list

        list.setVisibleRowCount(5);

        // Adds the list to a scroll pane

        JScrollPane scroll = new JScrollPane(list);

        // Adds the scroll pane and the label to a panel

        panel = new JPanel();
        panel.add(msg);
        panel.add(scroll);

        // Adds the panel to a content pane

        add(panel);

        // Set the window to be visible

        setVisible(true);

    }

    public static void main(String[] args)
    {
        new List();

    }
}

The above program only allows us to scroll down and up to see the list. JList also able us to select from the list then display what we've selected to the screen. Lets see a more expanded version of months, and this time we are allow to select which ever months we want from the list.

CODE

/*
    The program demonstrate the use of a list
    In addition we are able to select from the list

*
*/

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

public class SelectList extends JFrame
{
    JPanel panel;
    JScrollPane scroll;
    JList list;
    JLabel msg;
    JButton ok;

    public SelectList()
    {
        // Sets the title of the window

        setTitle("JList Window");

        // Sets the size of the window

        setSize(300, 400);

        // Sets the action when the window close

        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

        // Sets the label of the window

        msg = new JLabel("Here are the months");

        // Creates a OK button

        ok = new JButton("OK");

        // Create a String of array

        String[] months = {"Jan.", "Feb.", "March", "April", "May", "June",
                                    "July", "Aug.", "Sept.", "Oct.", "Nov.", "Dec."};

        // Adds the array of string into the list

        list = new JList(months);

        // Sets the visibility of the list

        list.setVisibleRowCount(5);

        // Adds the list to a scroll pane

        JScrollPane scroll = new JScrollPane(list);

        // Adds the scroll pane, the label and OK button to a panel

        panel = new JPanel();
        panel.add(msg);
        panel.add(scroll);
        panel.add(ok);

        // Adds the panel to a content pane

        add(panel);

        // Creates a single selection mode

        list.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);

        // Creates an event listener

        ok.addActionListener(new okButtonListener());

        // Set the window to be visible

        setVisible(true);

    }

    public class okButtonListener implements ActionListener
    {
        public void actionPerformed(ActionEvent e)
        {
            if(e.getSource()==ok)
            {
                String select = (String)list.getSelectedValue();

                JOptionPane.showMessageDialog(null, "You have selected " + select );

            }
        }
    }

    public static void main(String[] args)
    {
        new SelectList();

    }
}

The above example, the only things different from the previous example is the button and we added a new method from JList, which is setSlectionMode(int mode). Inside the button listener we added String select = (String) list.getSelectedValue() basically, it gets a single value from the list then assign it to select. The getSelectedValue method is in the JList class. What if we want to select more than one from the list, luckily we have another method in JList that allows us to select more than one from the list. I will use the same example above just so we can easily tell the difference between just a JList, a single selectable JList, and a more than one selectable JList.

CODE

/*
    The program demonstrate the use of a list
    In addition we are able to select more than one from the list

*
*/

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

public class SelectLists extends JFrame
{

    JPanel panel;
    JScrollPane scroll;
    JList list;
    JLabel msg;
    JButton ok;

    public SelectLists()
    {
        // Sets the title of the window

        setTitle("JList Window");

        // Sets the size of the window

        setSize(300, 400);

        // Sets the action when the window close

        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

        // Sets the label of the window

        msg = new JLabel("Here are the months");

        // Creates a OK button

        ok = new JButton("OK");

        // Create a String of array

        String[] months = {"Jan.", "Feb.", "March", "April", "May", "June",
                                    "July", "Aug.", "Sept.", "Oct.", "Nov.", "Dec."};

        // Adds the array of string into the list

        list = new JList(months);

        // Sets the visibility of the list

        list.setVisibleRowCount(5);

        // Adds the list to a scroll pane

        JScrollPane scroll = new JScrollPane(list);

        // Adds the scroll pane, the label and OK button to a panel

        panel = new JPanel();
        panel.add(msg);
        panel.add(scroll);
        panel.add(ok);

        // Adds the panel to a content pane

        add(panel);

        // Creates a single selection mode

        list.setSelectionMode(ListSelectionModel.MULTIPLE_INTERVAL_SELECTION);

        // Creates an event listener

        ok.addActionListener(new okButtonListener());

        // Set the window to be visible

        setVisible(true);

    }

    public class okButtonListener implements ActionListener
    {
        public void actionPerformed(ActionEvent e)
        {
            if(e.getSource()==ok)
            {
                Object[] select = list.getSelectedValues();

                String msg = "You have selected the following months: \n";

                // Using a loop to store the selection in the select array

                for(Object selection : select )
                {
                    msg += (String)selection + "\n";
                }

                JOptionPane.showMessageDialog(null, msg);

                // Clears all the selection

                list.clearSelection();

            }
        }
    }

    public static void main(String[] args)
    {
        new SelectLists();

    }
}

The only difference from this example is the selectionMode has changed to MULTIPLE_INTERVAL_SELECTION, and we used a different getSelected method, in addition to that we used a loop to loop out the array. It is not much a different from the previous 3 examples besides the methods are different

JComboBox

A combo box is a combination of a text field and a drop-down list where the user can choose a value. It's very similar to a JList.

Creating a JComboBox

JComboBox jcombo = new JComboBox();

Adding items to the combo Box

jcombo.addItem("Jan.");
jcombo.addItem("Feb.");
jcombo.addItem("March");

Alternative way of adding to the combo box using array

String[] month = {"Jan.", "Feb.", "March"};

JComboBox jcombo = new JComboBox(month);

CODE

/*
    This is a simple JCombo Box GUI

*
*/

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

public class JCombo_Box extends JFrame
{
    // Sets to private so only the same class can access these members

    private JComboBox jcombo;
    private JPanel panel;
    private JButton ok;

    public JCombo_Box()
    {
        // Sets the title of the window

        setTitle("JCombo Box Window");

        // Sets the size of the window

        setSize(300, 200);

        // Sets the appearance location of the window to the middle of the screen

        setLocationRelativeTo(null);

        // Sets the action when a window is close

        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

        // Creates a JComob Box

        jcombo = new JComboBox();

        // Adds the item to the JCombo Box

        jcombo.addItem("Jan.");
        jcombo.addItem("Feb.");
        jcombo.addItem("March");
        jcombo.addItem("April");
        jcombo.addItem("May");
        jcombo.addItem("June");
        jcombo.addItem("July");
        jcombo.addItem("Aug.");
        jcombo.addItem("Sept.");
        jcombo.addItem("Oct.");
        jcombo.addItem("Nov.");
        jcombo.addItem("Dec.");

        // Create a panel

        panel = new JPanel();

        // Creates a OK button

        ok = new JButton("OK");

        // Creates a event listener to handle the event

        ok.addActionListener(new okButtonListener());

        // Adds the JCombo Box and ok button to the panel

        panel.add(jcombo);
        panel.add(ok);

        // Adds the window to the content pane

        add(panel);

        // Sets the window to be true

        setVisible(true);

    }

        /*
            JCombo Box returns an object, so when we get the selection
            We must specify what is the type of the object
            In this case the type is a String

        *
        */

    private class okButtonListener implements ActionListener
    {
        public void actionPerformed(ActionEvent e)
        {
            if(e.getSource()==ok)
            {
                String select = (String)jcombo.getSelectedItem();

                JOptionPane.showMessageDialog(null, "You have selected " + select);

            }
        }
    }

    public static void main(String[] args)
    {
        new JCombo_Box();

    }
}

Register to Make This Ad Go Away!

jinnyishere
Group Icon

4 Oct, 2009 - 09:10 AM

Post #2

Please!! Do leave some feedbacks so i know what to improve...

is it confusing, not clear enough, needs more examples and so on..

open for any suggestions...