JList<\/code> is a swing component through which we can display the list of objects. This swing component allows user to select one or more elements. Lists can have many items, so they are often put in scroll panes. A separate model, ListModel<\/code>, maintains the contents of the list. An array of objects can be easily displayed using the JList<\/code> constructor that builds a read only ListModel<\/code> instance automatically.
\n
\n <\/p>\n2. JAVA Swing List<\/h2>\n2.1. Setup<\/h3>\n
This Example demonstrates how to create a List using Swing in eclipse.<\/p>\n
Prerequisite<\/b>
\nThis example is developed on Eclipse therefore a compatible Eclipse IDE is required to be installed on the system.
\nWe also need WindowBuilder tool to be installed on Eclipse IDE for the easiness of the work. To learn how to install WindowBuilder tool please visit the Setup section 2.1<\/b> of the following link Setup section 2.1<\/b> of the following link click here<\/strong><\/a><\/p>\nCreate a new JAVA project lets say swing_1<\/p>\n
\n- Go to src\u2192 right click\u2192 New\u2192 Other\u2192 WindowBuilder\u2192 select Swing Designer\u2192 Application Window.<\/li>\n
- Enter the name of the application(eg. SwingListExample ) and click finish.<\/li>\n<\/ul>\n
This will create SwingListExample.java file and will provide Source and Design tab.<\/p>\n
2.2 Creating a List<\/h3>\n
In this example we will dynamically add and remove element to and from a list using Hire and Fire Button. To create a list a model ,i.e, ListModel<\/code> is required.<\/p>\nA ListModel<\/code> can be supplied directly to a JList<\/code> by way of a constructor or the setModel method. A correct ListModel<\/code> implementation notifies the set of javax.swing.event.ListDataListeners<\/code> that have been added to it, each time a change occurs.<\/p>\nThese changes are characterized by a javax.swing.event.ListDataEvent<\/code>, which identifies the range of list indices that have been modified, added, or removed. JList’s ListUI is responsible for keeping the visual representation up to date with changes, by listening to the model. DefaultListModel class is used to maintain list elements by JList<\/code> applications. This class implements the ListModel<\/code> interface and also provides a java.util.Vector <\/code>like API.<\/p>\nApplications that need a more custom ListModel<\/code> implementation may instead wish to subclass AbstractListModel<\/code>, which provides basic support for managing and notifying listeners.<\/p>\n2.3. Creating a Model<\/h3>\n
There are three ways to create a list model:<\/p>\n
\n- DefaultListModel \u2014 everything is pretty much taken care of for you. The examples in this page use DefaultListModel.<\/li>\n
- AbstractListModel \u2014 you manage the data and invoke the “fire” methods. For this approach, you must subclass AbstractListModel and implement the getSize and getElementAt methods inherited from the ListModel interface.<\/li>\n
- ListModel \u2014 you manage everything<\/li>\n<\/ul>\n
2.4. Initializing a list<\/h3>\n
SwingListExample.java<\/em><\/span><\/p>\n listModel = new DefaultListModel();\r\n listModel.addElement(\"Jasmine Mehra\");\r\n listModel.addElement(\"Ankit Mishra\");\r\n listModel.addElement(\"Madhuri Sanghvi\");\r\n listModel.addElement(\"Alok Kumar\");\r\n listModel.addElement(\"Rohit Bothra\");\r\n listModel.addElement(\"Rahul Aggarwal\");\r\n \r\n \r\n \/\/Create the list and put it in a scroll pane.\r\n list = new JList(listModel);\r\n list.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);\r\n list.setSelectedIndex(0);\r\n list.addListSelectionListener(this);\r\n list.setVisibleRowCount(5);\r\n JScrollPane listScrollPane = new JScrollPane(list);\r\n\r\n<\/pre>\nThe above code creates and sets up the list. The code passes an array to the list’s constructor. The array is filled with strings. In our example, the strings happen to be person’s names.<\/p>\n
Other JList<\/code> constructors let you initialize a list from a Vector or from an object that adheres to the ListModel<\/code> interface. If you initialize a list with an array or vector, the constructor implicitly creates a default list model. The default list model is immutable \u2014 you cannot add, remove, or replace items in the list. To create a list whose items can be changed individually, set the list’s model to an instance of a mutable list model class, such as an instance of DefaultListModel<\/code>. You can set a list’s model when you create the list or by calling the setModel method. <\/div> <\/div><\/p>\n setSelectionMode<\/code> specifies how many items the user can select, and whether they must be contiguous.
\n setLayoutOrientation<\/code> lets the list display its data in multiple columns. The possible value such as, JList.HORIZONTAL_WRAP <\/code> demonstrates that the list should display its items from left to right before wrapping to a new row. Another value that can be used is JList.VERTICAL_WRAP <\/code>, which specifies that the data be displayed from top to bottom before wrapping to a new column.<\/p>\nsetVisibleRowCount(-1)<\/code> makes the list display the maximum number of items possible in the available space onscreen. Another popular use of setVisibleRowCount<\/code> is to specify to the lists’s scroll pane how many rows the list prefers to display.<\/p>\n2.5. Selecting Items in a List<\/h3>\n
A list uses an instance of ListSelectionModel <\/code> to manage its selection. By default, a list selection model allows any combination of items to be selected at a time. You can specify a different selection mode by calling the setSelectionMode method on the list. For example, SwingListExample set the selection mode to SINGLE_SELECTION (a constant defined by ListSelectionModel) so that only one item in the list can be selected. The three list selection modes are described below:<\/p>\n\n- SINGLE_SELECTION <\/b>: Only one item can be selected at a time. When the user selects an item, any previously selected item is deselected first.<\/li>\n
- SINGLE_INTERVAL_SELECTION<\/b>: Multiple, contiguous items can be selected. When the user begins a new selection range, any previously selected items are deselected first.<\/li>\n
- MULTIPLE_INTERVAL_SELECTION <\/b>: The default. Any combination of items can be selected. The user must explicitly deselect items.<\/li>\n<\/ul>\n
3. Change in Values<\/h2>\n
No matter which selection mode your list uses, the list fires list selection events whenever the selection changes. You can process these events by adding a list selection listener to the list with the addListSelectionListener<\/code> method. A list selection listener must implement one method: valueChanged <\/code>. Here is the valueChanged<\/code> method for the listener in SwingListExample.<\/p>\nSwingListExample.java<\/em><\/span><\/p>\n \/\/This method is required by ListSelectionListener.\r\n public void valueChanged(ListSelectionEvent e) {\r\n if (e.getValueIsAdjusting() == false) {\r\n \r\n if (list.getSelectedIndex() == -1) {\r\n \/\/No selection, disable fire button.\r\n fireButton.setEnabled(false);\r\n \r\n } else {\r\n \/\/Selection, enable the fire button.\r\n fireButton.setEnabled(true);\r\n }\r\n }\r\n }\r\n<\/pre>\n3.1 Adding and removing items to and from a List<\/h3>\n
The SwingListExample example creates a list whose contents can change. Here is the SwingListExample code that creates a mutable list model object, puts the initial items in it, and uses the list model to create a list:<\/p>\n
SwingListExample.java<\/em><\/span><\/p>\n \r\n\r\n listModel = new DefaultListModel();\r\n listModel.addElement(\"Jasmine Mehra\");\r\n listModel.addElement(\"Ankit Mishra\");\r\n listModel.addElement(\"Madhuri Sanghvi\");\r\n listModel.addElement(\"Alok Kumar\");\r\n listModel.addElement(\"Rohit Bothra\");\r\n listModel.addElement(\"Rahul Aggarwal\");\r\n \r\n \/\/Create the list and put it in a scroll pane.\r\n list = new JList(listModel);\r\n\r\n<\/pre>\nThis example uses an instance of DefaultListModel<\/code>, a class provided by Swing. To create a DefaulLIstModel<\/code> a program needs to explicitly mention it. If your requirement is not met through DefaultListModel<\/code> then you can write a custom list model, which must adhere to the ListModel<\/code> interface.<\/p>\nHere is the actionPerformed method for the action listener shared by the Hire button and the text field:<\/p>\n
SwingListExample.java<\/em><\/span><\/p>\n \r\n\r\n public void actionPerformed(ActionEvent e) {\r\n String name = employeeName.getText();\r\n \r\n \/\/User didn't type in a unique name...\r\n if (name.equals(\"\") || alreadyInList(name)) {\r\n Toolkit.getDefaultToolkit().beep();\r\n employeeName.requestFocusInWindow();\r\n employeeName.selectAll();\r\n return;\r\n }\r\n \r\n int index = list.getSelectedIndex(); \/\/get selected index\r\n if (index == -1) { \/\/no selection, so insert at beginning\r\n index = 0;\r\n } else { \/\/add after the selected item\r\n index++;\r\n }\r\n \r\n listModel.insertElementAt(employeeName.getText(), index);\r\n \/\/If we just wanted to add to the end, we'd do this:\r\n \/\/listModel.addElement(employeeName.getText());\r\n \r\n \/\/Reset the text field.\r\n employeeName.requestFocusInWindow();\r\n employeeName.setText(\"\");\r\n \r\n \/\/Select the new item and make it visible.\r\n list.setSelectedIndex(index);\r\n list.ensureIndexIsVisible(index);\r\n }\r\n<\/pre>\nThis code uses the list model’s insertElementAt method to insert the new name after the current selection or, if no selection exists, at the beginning of the list. If you just wish to add to the end of the list, you can use DefaultListModel’s addElement method instead.
\nWhenever items are added to, removed from, or modified in a list, the list model fires list data events.<\/p>\n
The following code snippet shows the actionPerformed<\/code> method for the action listener registered on the Fire button. removes method is used to remove the selected item from the list. Fire button is disabled if the list is empty.<\/p>\nSwingListExample.java<\/em><\/span><\/p>\n \r\n\r\n public void actionPerformed(ActionEvent e) {\r\n \/\/This method can be called only if\r\n \/\/there's a valid selection\r\n \/\/so go ahead and remove whatever's selected.\r\n int index = list.getSelectedIndex();\r\n listModel.remove(index);\r\n \r\n int size = listModel.getSize();\r\n \r\n if (size == 0) { \/\/Nobody's left, disable firing.\r\n fireButton.setEnabled(false);\r\n \r\n } else { \/\/Select an index.\r\n if (index == listModel.getSize()) {\r\n \/\/removed item in last position\r\n index--;\r\n }\r\n \r\n list.setSelectedIndex(index);\r\n list.ensureIndexIsVisible(index);\r\n }\r\n }\r\n\r\n<\/pre>\n3.2 List API<\/h3>\n
The following tables list the commonly used JList<\/code> constructors and methods. Much of the operation of a list is managed by other objects. The items in the list are managed by a list model object, the selection is managed by a list selection model object, and most programs put a list in a scroll panel to handle scrolling.<\/p>\nThe API for using lists falls into these categories:<\/p>\n
3.2.1 Initializing List Data<\/h4>\n\nJList(ListModel)<\/code>,JList(Object[])<\/code>,JList(Vector)<\/code>JList()<\/code>: Create a list with the initial list items specified. The second and third constructors implicitly create an immutable ListModel<\/code> you should not subsequently modify the passed-in array or Vector.<\/li>\nvoid setModel(ListModel)<\/code>,ListModel getModel()<\/code>: Set or get the model that contains the contents of the list.<\/li>\nvoid setListData(Object[])<\/code>,void setListData(Vector)<\/code>: Set the items in the list. These methods implicitly create an immutable ListModel<\/code>.<\/li>\n<\/ul>\n3.2.2 Displaying the List<\/h4>\n\nvoid setVisibleRowCount(int)<\/code>,int getVisibleRowCount()<\/code>: Set or get the visibleRowCount property. For a VERTICAL layout orientation, this sets or gets the preferred number of rows to display without requiring scrolling. For the HORIZONTAL_WRAP or VERTICAL_WRAP layout orientations, it defines how the cells wrap. See the setLayoutOrientation(int) for more information. The default value of this property is VERTICAL.<\/li>\nvoid setLayoutOrientation(int)<\/code>,int getLayoutOrientation()<\/code>: Set or get the way list cells are laid out. The possible layout formats are specified by the JList-defined values VERTICAL (a single column of cells; the default), HORIZONTAL_WRAP (“newspaper” style with the content flowing horizontally then vertically), and VERTICAL_WRAP (“newspaper” style with the content flowing vertically then horizontally).<\/li>\nint getFirstVisibleIndex()<\/code>,int getLastVisibleIndex()<\/code>: Get the index of the first or last visible item.<\/li>\nvoid ensureIndexIsVisible(int)<\/code>: Scroll so that the specified index is visible within the viewport that this list is in.<\/li>\n<\/ul>\nSimilarly, there are methods and constructors for other 2 categories too.<\/p>\n
\n- Managing the List’s Selection<\/li>\n
- Managing List Data<\/li>\n<\/ul>\n
4. Code & Output<\/h2>\n
The upper sections described how an item can be added or removed to or from the list at the runtime.
\nIn this example we have created 2 buttons Hire and Fire. Hire adds an element at runtime at a specified position whereas, Fire removes an element from the specified position.<\/p>\n
After execution of code output will look like the one below.<\/p>\n
![\"JAVA](\"http:\/\/examples.javacodegeeks.com\/wp-content\/uploads\/2016\/06\/L1.jpg\")
<\/a>![\"JAVA](\"http:\/\/examples.javacodegeeks.com\/wp-content\/uploads\/2016\/06\/L2.jpg\")
<\/a>