The Java Developers Almanac 1.4


Order this book from Amazon.

   
Home > List of Packages > javax.swing  [141 examples] > JList  [12 examples]

e782. Arranging Items in a JList Component

By default, the items in a list are arranged vertically, in a single column, as in:
    item1
    item2
    ...
It is possible to arrange the items left-to-right and top-to-bottom, as in:
    item1    item2
    item3    item4
    item5    ...
This example creates and configures a list that displays its items left-to-right and top-to-bottom. Note that the number of columns can change as the width of the list changes.
    // Create a scrollable list
    String[] items = {"A", "B", "C", "D"};
    JList list = new JList(items);
    JScrollPane scrollingList = new JScrollPane(list);
    
    // The default layout orientation is JList.VERTICAL
    int orient = list.getLayoutOrientation();
    
    // Change the layout orientation to left-to-right, top-to-bottom
    list.setLayoutOrientation(JList.HORIZONTAL_WRAP);
The items can also be arranged top-to-bottom and left-to-right, as in:
    item1    item4
    item2    item5
    item3    ...
This example changes the layout orientation so that its items are displayed top-to-bottom and left-to-right.
    // Change orientation to top-to-bottom, left-to-right layout
    list.setLayoutOrientation(JList.VERTICAL_WRAP);
With some look and feels, a list is set to display a fixed number of rows. In order to make the number of visible rows dependent on the height of the list, the visibleRowCount property must be set to 0:
    // Make the number of rows dynamic
    list.setVisibleRowCount(0);

 Related Examples
e774. Creating a JList Component
e775. Setting the Dimensions of an Item in a JList Component
e776. Setting a Tool Tip for an Item in a JList Component
e777. Getting the Items in a JList Component
e778. Adding and Removing an Item in a JList Component
e779. Getting the Selected Items in a JList Component
e780. Setting the Selected Items in a JList Component
e781. Setting the Selection Mode of a JList Component
e783. Detecting Double and Triple Clicks on an Item in a JList Component
e784. Listening for Changes to the Selection in a JList Component
e785. Listening for Changes to the Items in a JList Component

See also: Actions    JButton    JCheckBox    JComboBox    JDesktop and JInternalFrame    JFrame, JWindow, JDialog    JLabel    JProgressBar    JRadioButton    JScrollPane    JSlider    JSpinner    JSplitPane    JTabbedPane    JToolBar    Keystrokes and Input Maps    Layout    Look and Feel    Menus    Progress Monitor    The Screen    Tool Tips    UI Default Values   


© 2002 Addison-Wesley.