javax/swing/JList.java

60  * It's easy to display an array or Vector of objects, using the {@code JList}
65  * // Create a JList that displays strings from an array
68  * JList<String> myList = new JList<String>(data);
70  * // Create a JList that displays the superclasses of JList.class, by
74  * Class<JList> rootClass = javax.swing.JList.class;
78  * JList<Class<?>> myList = new JList<Class<?>>(superClasses);
80  * // The automatically created model is stored in JList's "model"
90  * A {@code ListModel} can be supplied directly to a {@code JList} by way of a
97  * indices that have been modified, added, or removed. {@code JList}'s
101  * Simple, dynamic-content, {@code JList} applications can use the
120  * The selection state of a {@code JList} is managed by another separate
121  * model, an instance of {@code ListSelectionModel}. {@code JList} is
123  * methods to query or set this selection model. Additionally, {@code JList}
127  * model. By default, {@code JList}'s selection model is configured to allow any
130  * on the selection model directly, or via {@code JList}'s cover method.
141  * {@code ListSelectionListener}s directly to the {@code JList}. {@code JList}
149  * Painting of cells in a {@code JList} is handled by a delegate called a
170  *       JList<?> list,           // the list
207  * JList<String> bigDataList = new JList<String>(bigData);
209  * // We don't want the JList implementation to compute the width
219  * {@code JList} doesn't implement scrolling directly. To create a list that
229  * {@code JList} doesn't provide any special handling of double or triple
279 public class JList<E> extends JComponent implements Scrollable, Accessible
347      * a drop location for a <code>JList</code>.
410      * Constructs a {@code JList} that displays elements from the specified,
411      * {@code non-null}, model. All {@code JList} constructors delegate to
420     public JList(ListModel<E> dataModel)
442      * Constructs a <code>JList</code> that displays the elements in
455     public JList(final E[] listData)
467      * Constructs a <code>JList</code> that displays the elements in
480     public JList(final Vector<? extends E> listData) {
491      * Constructs a <code>JList</code> with an empty, read-only, model.
493     public JList() {
945      * Defines the way list cells are layed out. Consider a {@code JList}
1001             "JList.VERTICAL",
1002             "JList.HORIZONTAL_WRAP",
1003             "JList.VERTICAL_WRAP"}, description
1136      * {@code JList} must be within a <code>JViewport</code>.
1209      * <code>JList</code> supports the following drop modes:
1513      * <strong>Note:</strong> For <code>JList</code> to properly display the
1514      * tooltips of its renderers in this manner, <code>JList</code> must be a
1517      * <code>JList</code> is unregistered, by way of a call to
1641      * by the <code>JList</code> component.
1666             = "The object that contains the data to be drawn by this JList.")
1762      * of selection changes made to the selection model. {@code JList}
1800      * the selectionModel to the JList ListSelectionListeners.  The
1802      * source is the JList instead of the selectionModel itself.
1817      * changes. {@code JList} takes care of listening for selection state
1851      * to this {@code JList} by way of {@code addListSelectionListener}.
2543                            getLayoutOrientation() != JList.VERTICAL) {
2688                  getLayoutOrientation() != JList.VERTICAL) {
2757      * Returns {@code true} if this {@code JList} is displayed in a
2784      * Returns {@code true} if this {@code JList} is displayed in a
2828      * Returns a {@code String} representation of this {@code JList}.
2834      * @return  a {@code String} representation of this {@code JList}.
2860      * Gets the {@code AccessibleContext} associated with this {@code JList}.
2861      * For {@code JList}, the {@code AccessibleContext} takes the form of an
2867      *         {@code AccessibleContext} of this {@code JList}
2879      * {@code JList} class. It provides an implementation of the
2904             JList.this.addPropertyChangeListener(this);
2905             JList.this.getSelectionModel().addListSelectionListener(this);
2906             JList.this.getModel().addListDataListener(this);
2907             leadSelectionIndex = JList.this.getLeadSelectionIndex();
2958             leadSelectionIndex = JList.this.getLeadSelectionIndex();
2978             ListSelectionModel lsm = JList.this.getSelectionModel();
3067                 return new AccessibleJListChild(JList.this, i);
3094                 return new AccessibleJListChild(JList.this, i);
3120              return JList.this.getSelectedIndices().length;
3137                  return getAccessibleChild(JList.this.getSelectedIndices()[i]);
3162              JList.this.addSelectionInterval(i, i);
3173              JList.this.removeSelectionInterval(i, i);
3181              JList.this.clearSelection();
3189              JList.this.addSelectionInterval(0, getAccessibleChildrenCount() -1);
3198             private JList<E>     parent = null;
3210             public AccessibleJListChild(JList<E> parent, int indexInParent) {
3784              * JList.this.setSelectedIndex(indexInParent) and then returns true;
3791                     JList.this.setSelectedIndex(indexInParent);