javax.swing

Класс JList <E>

java.lang. Объект

java.awt. Компонент

java.awt. Контейнер

javax.swing. JComponent

javax.swing. JList <E>

Введите Параметры:

E - тип элементов этого списка

Все Реализованные Интерфейсы:

ImageObserver, MenuContainer, Сериализуемый, Доступный, С возможностью прокрутки

public class JList<E>
extends JComponent
implements Scrollable, Accessible

Компонент, который выводит на экран список объектов и позволяет пользователю выбирать один или более элементов. Отдельная модель, ListModel, поддерживает содержание списка.

Легко вывести на экран массив или Вектор объектов, используя JList конструктор, который автоматически создает только для чтения ListModel экземпляр для Вас:

 // Create a JList that displays strings from an array

 String[] data = {"one", "two", "three", "four"};
 JList<String> myList = new JList<String>(data);

 // Create a JList that displays the superclasses of JList.class, by
 // creating it with a Vector populated with this data

 Vector<Class<?>> superClasses = new Vector<Class<?>>();
 Class<JList> rootClass = javax.swing.JList.class;
 for(Class<?> cls = rootClass; cls != null; cls = cls.getSuperclass()) {
     superClasses.addElement(cls);
 }
 JList<Class<?>> myList = new JList<Class<?>>(superClasses);

 // The automatically created model is stored in JList's "model"
 // property, which you can retrieve

 ListModel<Class<?>> model = myList.getModel();
 for(int i = 0; i < model.getSize(); i++) {
     System.out.println(model.getElementAt(i));
 }
 
 

A ListModel может быть предоставлен непосредственно a JList посредством конструктора или setModel метод. Содержание не должно быть статичным - число элементов, и значения элементов могут измениться в течение долгого времени. Корректное ListModel реализация уведомляет набор javax.swing.event.ListDataListeners, которые были добавлены к этому, каждый раз, изменение происходит. Эти изменения характеризуются a javax.swing.event.ListDataEvent, который идентифицирует диапазон индексов списка, которые были изменены, добавлены, или удалены. JList's ListUI ответственно за то, что усовершенствовало визуальное представление с изменениями, слушая модель.

Простой, динамический контент, JList приложения могут использовать DefaultListModel класс, чтобы поддержать элементы списка. Этот класс реализует ListModel взаимодействуйте через интерфейс и также обеспечивает a java.util.Vector- как API. Приложения, которые нуждаются в более пользовательском ListModel реализация может вместо этого хотеть разделить на подклассы AbstractListModel, который оказывает основную поддержку для управления и уведомления слушателей. Например, реализация только для чтения AbstractListModel:

 // This list model has about 2^16 elements.  Enjoy scrolling.

 ListModel<String> bigData = new AbstractListModel<String>() {
     public int getSize() { return Short.MAX_VALUE; }
     public String getElementAt(int index) { return "Index " + index; }
 };
 
 

Состояние выбора a JList управляется другой отдельной моделью, экземпляром ListSelectionModel. JList инициализируется с моделью выбора на конструкции, и также содержит методы, чтобы запросить или установить эту модель выбора. Дополнительно, JList обеспечивает удобные методы для того, чтобы они легко управляли выбором. Эти методы, такой как setSelectedIndex и getSelectedValue, методы покрытия, которые заботятся о деталях взаимодействия с моделью выбора. По умолчанию, JList's модель выбора конфигурируется, чтобы позволить любой комбинации элементов быть выбранной за один раз; режим выбора MULTIPLE_INTERVAL_SELECTION. Режим выбора может быть изменен на модели выбора непосредственно, или через JList's покрывают метод. Ответственность за обновление модели выбора в ответ на пользовательские жесты лежит на списке ListUI.

Корректное ListSelectionModel реализация уведомляет набор javax.swing.event.ListSelectionListeners, которые были добавлены к этому каждый раз, изменение к выбору происходит. Эти изменения характеризуются a javax.swing.event.ListSelectionEvent, который идентифицирует диапазон изменения выбора.

Привилегированный способ прислушаться к изменениям в выборе списка состоит в том, чтобы добавить ListSelectionListeners непосредственно к JList. JList тогда заботится о слушании модель выбора и уведомление Ваших слушателей изменения.

Ответственность за слушание изменений выбора, чтобы усовершенствовать визуальное представление списка, лежит на списке ListUI.

Рисование ячеек в a JList обрабатывается делегатом, названным средством рендеринга ячейки, установленным в списке как cellRenderer свойство. Средство рендеринга обеспечивает a java.awt.Component это используется как "штемпель", чтобы нарисовать ячейки. Каждый раз ячейка должна быть нарисована, список ListUI просит средство рендеринга ячейки компонент, перемещает его в место, и имеет его, красят содержание ячейки посредством paint метод. Средство рендеринга ячейки по умолчанию, которое использует a JLabel компонент, чтобы представить, устанавливается списками ListUI. Можно заменить своим собственным средством рендеринга, используя код как это:

 // Display an icon and a string for each object in the list.

 class MyCellRenderer extends JLabel implements ListCellRenderer<Object> {
     final static ImageIcon longIcon = new ImageIcon("long.gif");
     final static ImageIcon shortIcon = new ImageIcon("short.gif");

     // This is the only method defined by ListCellRenderer.
     // We just reconfigure the JLabel each time we're called.

     public Component getListCellRendererComponent(
       JList<?> list,           // the list
       Object value,            // value to display
       int index,               // cell index
       boolean isSelected,      // is the cell selected
       boolean cellHasFocus)    // does the cell have focus
     {
         String s = value.toString();
         setText(s);
         setIcon((s.length() > 10) ? longIcon : shortIcon);
         if (isSelected) {
             setBackground(list.getSelectionBackground());
             setForeground(list.getSelectionForeground());
         } else {
             setBackground(list.getBackground());
             setForeground(list.getForeground());
         }
         setEnabled(list.isEnabled());
         setFont(list.getFont());
         setOpaque(true);
         return this;
     }
 }

 myList.setCellRenderer(new MyCellRenderer());
 
 

Другое задание для средства рендеринга ячейки находится в помогании определить информацию о калибровке для списка. По умолчанию, список ListUI определяет размер ячеек, прося у средства рендеринга ячейки его привилегированный размер для каждого элемента списка. Это может быть дорого для больших списков элементов. Чтобы избежать этих вычислений, можно установить a fixedCellWidth и fixedCellHeight в списке, или вычислили эти значения, автоматически основанные на единственном прототипном значении:

 JList<String> bigDataList = new JList<String>(bigData);

 // We don't want the JList implementation to compute the width
 // or height of all of the list cells, so we give it a string
 // that's as big as we'll need for any cell.  It uses this to
 // compute values for the fixedCellWidth and fixedCellHeight
 // properties.

 bigDataList.setPrototypeCellValue("Index 1234567890");
 
 

JList не реализует прокрутку непосредственно. Чтобы создать список, который прокручивает, сделайте это представлением области просмотра a JScrollPane. Например:

 JScrollPane scrollPane = new JScrollPane(myList);

 // Or in two steps:
 JScrollPane scrollPane = new JScrollPane();
 scrollPane.getViewport().setView(myList);
 

JList не обеспечивает специальной обработки двойных или тройных (или N) щелчки мышью, но легко добавить a MouseListener если Вы хотите принять меры на этих событиях. Используйте locationToIndex метод, чтобы определить, по какой ячейке щелкнули. Например:

 MouseListener mouseListener = new MouseAdapter() {
     public void mouseClicked(MouseEvent e) {
         if (e.getClickCount() == 2) {
             int index = list.locationToIndex(e.getPoint());
             System.out.println("Double clicked on Item " + index);
          }
     }
 };
 list.addMouseListener(mouseListener);
 

Предупреждение: Swing не ориентирован на многопотоковое исполнение. Для получения дополнительной информации см., что Swing Распараллеливает Политику.

Предупреждение: Сериализированные объекты этого класса не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.

См., Как Использовать Списки в Учебном руководстве по Java для дальнейшей документации. Также см. статью Усовершенствованный JList, Программирующий в Соединении Swing.

См. Также:

ListModel, AbstractListModel, DefaultListModel, ListSelectionModel, DefaultListSelectionModel, ListCellRenderer, DefaultListCellRenderer

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
protected class	JList. AccessibleJList Этот класс реализует поддержку доступности JList класс.
static class	JList. DropLocation Подкласс TransferHandler.DropLocation представление расположения отбрасывания для a JList.

Вложенные классы/интерфейсы javax.swing унаследованный от класса. JComponent

JComponent. AccessibleJComponent

Вложенные классы/интерфейсы java.awt унаследованный от класса. Контейнер

Контейнер. AccessibleAWTContainer

Вложенные классы/интерфейсы java.awt унаследованный от класса. Компонент

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	HORIZONTAL_WRAP Указывает на "газетный стиль" расположение с ячейками, текущими горизонтально тогда вертикально.
static int	ВЕРТИКАЛЬ Указывает на вертикальное расположение ячеек, в единственном столбце; расположение по умолчанию.
static int	VERTICAL_WRAP Указывает на "газетный стиль" расположение с ячейками, текущими вертикально тогда горизонтально.

Поля javax.swing унаследованный от класса. JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Поля java.awt унаследованный от класса. Компонент

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, наследованные от интерфейса java.awt.image. ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Сводка конструктора

Конструкторы

Конструктор и Описание
JList() Конструкции a JList с пустым, только для чтения, моделью.
JList(E[] listData) Конструкции a JList это выводит на экран элементы в указанном массиве.
JList(ListModel<E> dataModel) Конструкции a JList это выводит на экран элементы от указанного, non-null, модель.
JList(Vector<? extends E> listData) Конструкции a JList это выводит на экран элементы в указанном Vector.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	addListSelectionListener(ListSelectionListener listener) Добавляет слушатель списка, чтобы быть уведомленным каждый раз, когда изменение к выбору происходит; привилегированный способ прислушаться к изменениям состояния выбора.
void	addSelectionInterval(int anchor, int lead) Устанавливает выбор, чтобы быть объединением указанного интервала с текущим выбором.
void	clearSelection() Очищает выбор; после вызова этого метода, isSelectionEmpty возвратится true.
protected ListSelectionModel	createSelectionModel() Возвращает экземпляр DefaultListSelectionModel; вызванный во время конструкции, чтобы инициализировать свойство модели выбора списка.
void	ensureIndexIsVisible(int index) Прокручивает список в пределах области просмотра включения, чтобы сделать указанную ячейку абсолютно видимой.
protected void	fireSelectionValueChanged(int firstIndex, int lastIndex, boolean isAdjusting) Уведомляет ListSelectionListeners добавленный непосредственно к списку изменений выбора, произведенных в модели выбора.
AccessibleContext	getAccessibleContext() Добирается AccessibleContext связанный с этим JList.
int	getAnchorSelectionIndex() Возвращает индекс выбора привязки.
Прямоугольник	getCellBounds(int index0, int index1) Возвращает ограничительный прямоугольник, в системе координат списка, для диапазона ячеек, определенных этими двумя индексами.
ListCellRenderer<? super E>	getCellRenderer() Возвращает объект, ответственный за рисование элементов списка.
boolean	getDragEnabled() Включаются возвраты, перетаскивают ли автоматический обработку.
JList. DropLocation	getDropLocation() Возвращает расположение, на которое этот компонент должен визуально указать как расположение отбрасывания во время работы DnD по компоненту, или null если никакое расположение нельзя в настоящий момент показать.
DropMode	getDropMode() Возвращает режим отбрасывания для этого компонента.
int	getFirstVisibleIndex() Возвращает самый маленький индекс списка, который в настоящий момент видим.
int	getFixedCellHeight() Возвращает значение fixedCellHeight свойство.
int	getFixedCellWidth() Возвращает значение fixedCellWidth свойство.
int	getLastVisibleIndex() Возвращает самый большой индекс списка, который в настоящий момент видим.
int	getLayoutOrientation() Возвращает свойство ориентации расположения для списка: VERTICAL если расположение является единственным столбцом ячеек, VERTICAL_WRAP если расположение является "газетным стилем" с контентом, текущим вертикально тогда горизонтально, или HORIZONTAL_WRAP если расположение является "газетным стилем" с контентом, текущим горизонтально тогда вертикально.
int	getLeadSelectionIndex() Возвращает ведущий индекс выбора.
ListSelectionListener[]	getListSelectionListeners() Возвращает массив весь ListSelectionListeners добавленный к этому JList посредством addListSelectionListener.
int	getMaxSelectionIndex() Возвращает самый большой выбранный индекс ячейки, или -1 если выбор пуст.
int	getMinSelectionIndex() Возвращает самый маленький выбранный индекс ячейки, или -1 если выбор пуст.
ListModel<E>	getModel() Возвращает модель данных, которая содержит список элементов, выведенных на экран JList компонент.
int	getNextMatch(String prefix, int startIndex, Position.Bias bias) Возвращает следующий элемент списка чей toString значение запускается с данного префикса.
Размерность	getPreferredScrollableViewportSize() Вычисляет размер области просмотра, должен был вывести на экран visibleRowCount строки.
E	getPrototypeCellValue() Возвращает "формирующее прототип" значение ячейки - значение, используемое, чтобы вычислить фиксированную ширину и высоту для ячеек.
int	getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction) Возвращает расстояние, чтобы прокрутить, чтобы представить следующий или предыдущий блок.
boolean	getScrollableTracksViewportHeight() Возвраты true если это JList выводится на экран в a JViewport и область просмотра более высока чем привилегированная высота списка, или если ориентация расположения VERTICAL_WRAP и visibleRowCount <= 0; иначе возвраты false.
boolean	getScrollableTracksViewportWidth() Возвраты true если это JList выводится на экран в a JViewport и область просмотра более широка чем привилегированная ширина списка, или если ориентация расположения HORIZONTAL_WRAP и visibleRowCount <= 0; иначе возвраты false.
int	getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction) Возвращает расстояние, чтобы прокрутить, чтобы представить следующую или предыдущую строку (для вертикальной прокрутки) или столбец (для горизонтальной прокрутки).
int	getSelectedIndex() Возвращает самый маленький выбранный индекс ячейки; выбор, когда только единственный элемент выбирается в списке.
int[]	getSelectedIndices() Возвращает массив всех выбранных индексов, в увеличивающемся порядке.
E	getSelectedValue() Возвращает значение для самого маленького выбранного индекса ячейки; выбранное значение, когда только единственный элемент выбирается в списке.
Объект[]	getSelectedValues() Осуждаемый. С JDK 1.7, замененный getSelectedValuesList()
List<E>	getSelectedValuesList() Возвращает список всех выбранных пунктов, в увеличивающемся порядке, основанном на их индексах в списке.
Цвет	getSelectionBackground() Возвращает цвет, используемый, чтобы потянуть фон выбранных пунктов.
Цвет	getSelectionForeground() Возвращает цвет, используемый, чтобы потянуть передний план выбранных пунктов.
int	getSelectionMode() Возвращает текущий режим выбора для списка.
ListSelectionModel	getSelectionModel() Возвращает текущую модель выбора.
Строка	getToolTipText(MouseEvent event) Возвращает текст подсказки, который будет использоваться для данного события.
ListUI	getUI() Возвраты ListUI, объект стили, который представляет этот компонент.
Строка	getUIClassID() Возвраты "ListUI", UIDefaults ключ, используемый, чтобы искать имя javax.swing.plaf.ListUI класс, который определяет стиль для этого компонента.
boolean	getValueIsAdjusting() Возвращает значение модели выбора isAdjusting свойство.
int	getVisibleRowCount() Возвращает значение visibleRowCount свойство.
Точка	indexToLocation(int index) Возвращает источник указанного элемента в системе координат списка.
boolean	isSelectedIndex(int index) Возвраты true если указанный индекс выбирается, еще false.
boolean	isSelectionEmpty() Возвраты true если ничто не выбирается, еще false.
int	locationToIndex(Point location) Возвращает индекс ячейки, самый близкий к данному расположению в системе координат списка.
protected String	paramString() Возвраты a String представление этого JList.
void	removeListSelectionListener(ListSelectionListener listener) Удаляет слушателя выбора из списка.
void	removeSelectionInterval(int index0, int index1) Устанавливает выбор, чтобы быть разностью множеств указанного интервала и текущего выбора.
void	setCellRenderer(ListCellRenderer<? super E> cellRenderer) Устанавливает делегата, который используется, чтобы нарисовать каждую ячейку в списке.
void	setDragEnabled(boolean b) Включает или выключает автоматический, перетаскивают обработку.
void	setDropMode(DropMode dropMode) Устанавливает режим отбрасывания для этого компонента.
void	setFixedCellHeight(int height) Устанавливает фиксированное значение, которое будет использоваться для высоты каждой ячейки в списке.
void	setFixedCellWidth(int width) Устанавливает фиксированное значение, которое будет использоваться для ширины каждой ячейки в списке.
void	setLayoutOrientation(int layoutOrientation) Определяет способ, которым ячейки списка являются layed.
void	setListData(E[] listData) Создает только для чтения ListModel от массива элементов, и вызовов setModel с этой моделью.
void	setListData(Vector<? extends E> listData) Создает только для чтения ListModel от a Vector и вызовы setModel с этой моделью.
void	setModel(ListModel<E> model) Устанавливает модель, которая представляет содержание или "значение" списка, уведомляет, что свойство изменяет слушателей, и затем очищает выбор списка.
void	setPrototypeCellValue(E prototypeCellValue) Наборы prototypeCellValue свойство, и затем (если новое значение non-null), вычисляет fixedCellWidth и fixedCellHeight свойства, запрашивая компонент средства рендеринга ячейки на данное значение (и индекс 0) от средства рендеринга ячейки, и используя, что привилегированный размер компонента.
void	setSelectedIndex(int index) Выбирает единственную ячейку.
void	setSelectedIndices(int[] indices) Изменяет выбор, чтобы быть набором индексов, определенных данным массивом.
void	setSelectedValue(Object anObject, boolean shouldScroll) Выбирает указанный объект из списка.
void	setSelectionBackground(Color selectionBackground) Выбирает цвет, используемый, чтобы потянуть фон выбранных пунктов, какие средства рендеринга ячейки могут использовать заливку выбранные ячейки.
void	setSelectionForeground(Color selectionForeground) Выбирает цвет, используемый, чтобы потянуть передний план выбранных пунктов, которые средства рендеринга ячейки могут использовать, чтобы представить текст и графику.
void	setSelectionInterval(int anchor, int lead) Выбирает указанный интервал.
void	setSelectionMode(int selectionMode) Устанавливает режим выбора для списка.
void	setSelectionModel(ListSelectionModel selectionModel) Наборы selectionModel для списка к не -null ListSelectionModel реализация.
void	setUI(ListUI ui) Наборы ListUI, объект стили, который представляет этот компонент.
void	setValueIsAdjusting(boolean b) Устанавливает модель выбора valueIsAdjusting свойство.
void	setVisibleRowCount(int visibleRowCount) Наборы visibleRowCount свойство, у которого есть различные значения в зависимости от ориентации расположения: Для a VERTICAL ориентация расположения, это определяет привилегированный номер строк, чтобы вывести на экран, не требуя прокрутки; для других ориентаций это влияет на обертывание ячеек.
void	updateUI() Сбросы ListUI свойство, устанавливая это в значение обеспечило текущим стилем.

Методы javax.swing унаследованный от класса. JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Методы java.awt унаследованный от класса. Контейнер

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Методы java.awt унаследованный от класса. Компонент

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Полевая Деталь

ВЕРТИКАЛЬ

public static final int VERTICAL

Указывает на вертикальное расположение ячеек, в единственном столбце; расположение по умолчанию.

С тех пор:

1.4

См. Также:

setLayoutOrientation(int), Постоянные Значения полей

VERTICAL_WRAP

public static final int VERTICAL_WRAP

Указывает на "газетный стиль" расположение с ячейками, текущими вертикально тогда горизонтально.

С тех пор:

1.4

См. Также:

setLayoutOrientation(int), Постоянные Значения полей

HORIZONTAL_WRAP

public static final int HORIZONTAL_WRAP

Указывает на "газетный стиль" расположение с ячейками, текущими горизонтально тогда вертикально.

С тех пор:

1.4

См. Также:

setLayoutOrientation(int), Постоянные Значения полей

Деталь конструктора

JList

public JList(ListModel<E> dataModel)

Конструкции a JList это выводит на экран элементы от указанного, non-null, модель. Все JList конструкторы делегируют этому.

Этот конструктор регистрирует список в ToolTipManager, учет подсказок, которые будут обеспечены средствами рендеринга ячейки.

Параметры:

dataModel - модель для списка

Броски:

IllegalArgumentException - если модель null

JList

public JList(E[] listData)

Конструкции a JList это выводит на экран элементы в указанном массиве. Этот конструктор создает модель только для чтения для данного массива, и затем делегирует конструктору, который берет a ListModel.

Попытки передать a null оцените этому методу результаты в неопределенном поведении и, наиболее вероятно, исключения. Создаваемая модель ссылается на данный массив непосредственно. Попытки изменить массив после построения списка приводят к неопределенному поведению.

Параметры:

listData - массив Объектов, которые будут загружены в модель данных, non-null

JList

public JList(Vector<? extends E> listData)

Конструкции a JList это выводит на экран элементы в указанном Vector. Этот конструктор создает модель только для чтения для данного Vector, и затем делегаты в конструкторе, который берет a ListModel.

Попытки передать a null оцените этому методу результаты в неопределенном поведении и, наиболее вероятно, исключения. Создаваемая модель ссылается на данный Vector непосредственно. Попытки изменить Vector после построения списка приводит к неопределенному поведению.

Параметры:

listData - Vector быть загруженным в модель данных, non-null

JList

public JList()

Конструкции a JList с пустым, только для чтения, моделью.

Деталь метода

getUI

public ListUI getUI()

Возвраты ListUI, объект стили, который представляет этот компонент.

Возвраты:

ListUI возразите, что представляет этот компонент

setUI

public void setUI(ListUI ui)

Наборы ListUI, объект стили, который представляет этот компонент.

Параметры:

ui - ListUI объект

См. Также:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

Сбросы ListUI свойство, устанавливая это в значение обеспечило текущим стилем. Если текущее средство рендеринга ячейки было установлено разработчиком (а не стиль непосредственно), это также заставляет средство рендеринга ячейки и его дочерние элементы быть обновленным, вызывая SwingUtilities.updateComponentTreeUI на этом.

Переопределения:

updateUI в классе JComponent

См. Также:

UIManager.getUI(javax.swing.JComponent), SwingUtilities.updateComponentTreeUI(java.awt.Component)

getUIClassID

public String getUIClassID()

Возвраты "ListUI", UIDefaults ключ, используемый, чтобы искать имя javax.swing.plaf.ListUI класс, который определяет стиль для этого компонента.

Переопределения:

getUIClassID в классе JComponent

Возвраты:

строка "ListUI"

См. Также:

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getPrototypeCellValue

public E getPrototypeCellValue()

Возвращает "формирующее прототип" значение ячейки - значение, используемое, чтобы вычислить фиксированную ширину и высоту для ячеек. Это может быть null если нет такого значения.

Возвраты:

значение prototypeCellValue свойство

См. Также:

setPrototypeCellValue(E)

setPrototypeCellValue

public void setPrototypeCellValue(E prototypeCellValue)

Наборы prototypeCellValue свойство, и затем (если новое значение non-null), вычисляет fixedCellWidth и fixedCellHeight свойства, запрашивая компонент средства рендеринга ячейки на данное значение (и индекс 0) от средства рендеринга ячейки, и используя, что привилегированный размер компонента.

Этот метод полезен, когда список является слишком длинным, чтобы позволить ListUI чтобы вычислить ширину/высоту каждой ячейки, и есть единственное значение ячейки, которое, как известно, занимает так много места как любых из других, так называемого прототипа.

В то время как все три из prototypeCellValue, fixedCellHeight, и fixedCellWidth свойства могут быть изменены этим методом, PropertyChangeEvent уведомления только отправляются когда prototypeCellValue изменения свойства.

Чтобы видеть пример, который устанавливает это свойство, см. описание класса выше.

Значение по умолчанию этого свойства null.

Это - JavaBeans связанное свойство.

Параметры:

prototypeCellValue - значение, на котором можно базироваться fixedCellWidth и fixedCellHeight

См. Также:

getPrototypeCellValue(), setFixedCellWidth(int), setFixedCellHeight(int), Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

getFixedCellWidth

public int getFixedCellWidth()

Возвращает значение fixedCellWidth свойство.

Возвраты:

фиксированная ширина ячейки

См. Также:

setFixedCellWidth(int)

setFixedCellWidth

public void setFixedCellWidth(int width)

Устанавливает фиксированное значение, которое будет использоваться для ширины каждой ячейки в списке. Если width -1, ширины ячейки вычисляются в ListUI применяясь getPreferredSize к компоненту средства рендеринга ячейки для каждого элемента списка.

Значение по умолчанию этого свойства -1.

Это - JavaBeans связанное свойство.

Параметры:

width - ширина, которая будет использоваться для всех ячеек в списке

См. Также:

setPrototypeCellValue(E), setFixedCellWidth(int), Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

getFixedCellHeight

public int getFixedCellHeight()

Возвращает значение fixedCellHeight свойство.

Возвраты:

фиксированная высота ячейки

См. Также:

setFixedCellHeight(int)

setFixedCellHeight

public void setFixedCellHeight(int height)

Устанавливает фиксированное значение, которое будет использоваться для высоты каждой ячейки в списке. Если height -1, высоты ячейки вычисляются в ListUI применяясь getPreferredSize к компоненту средства рендеринга ячейки для каждого элемента списка.

Значение по умолчанию этого свойства -1.

Это - JavaBeans связанное свойство.

Параметры:

height - высота, которая будет использоваться для для всех ячеек в списке

См. Также:

setPrototypeCellValue(E), setFixedCellWidth(int), Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

getCellRenderer

public ListCellRenderer<? super E> getCellRenderer()

Возвращает объект, ответственный за рисование элементов списка.

Возвраты:

значение cellRenderer свойство

См. Также:

setCellRenderer(javax.swing.ListCellRenderer<? super E>)

setCellRenderer

public void setCellRenderer(ListCellRenderer<? super E> cellRenderer)

Устанавливает делегата, который используется, чтобы нарисовать каждую ячейку в списке. Задание средства рендеринга ячейки обсуждается подробно в документации уровня класса.

Если prototypeCellValue свойство non-null, установка средства рендеринга ячейки также вызывает fixedCellWidth и fixedCellHeight свойства, которые будут повторно вычислены. Только один PropertyChangeEvent сгенерирован однако - для cellRenderer свойство.

Значение по умолчанию этого свойства обеспечивается ListUI делегат, то есть реализацией стили.

Это - JavaBeans связанное свойство.

Параметры:

cellRenderer - ListCellRenderer это красит ячейки списка

См. Также:

getCellRenderer()

getSelectionForeground

public Color getSelectionForeground()

Возвращает цвет, используемый, чтобы потянуть передний план выбранных пунктов. DefaultListCellRenderer использование этот цвет, чтобы потянуть передний план элементов в выбранном состоянии, также, как и средства рендеринга, установленные больше всего ListUI реализации.

Возвраты:

цвет, чтобы потянуть передний план выбранных пунктов

См. Также:

setSelectionForeground(java.awt.Color), DefaultListCellRenderer

setSelectionForeground

public void setSelectionForeground(Color selectionForeground)

Выбирает цвет, используемый, чтобы потянуть передний план выбранных пунктов, которые средства рендеринга ячейки могут использовать, чтобы представить текст и графику. DefaultListCellRenderer использование этот цвет, чтобы потянуть передний план элементов в выбранном состоянии, также, как и средства рендеринга, установленные больше всего ListUI реализации.

Значение по умолчанию этого свойства определяется реализацией стили.

Это - JavaBeans связанное свойство.

Параметры:

selectionForeground - Color использовать на переднем плане для выбранных элементов списка

См. Также:

getSelectionForeground(), setSelectionBackground(java.awt.Color), JComponent.setForeground(java.awt.Color), JComponent.setBackground(java.awt.Color), JComponent.setFont(java.awt.Font), DefaultListCellRenderer

getSelectionBackground

public Color getSelectionBackground()

Возвращает цвет, используемый, чтобы потянуть фон выбранных пунктов. DefaultListCellRenderer использование этот цвет, чтобы потянуть фон элементов в выбранном состоянии, также, как и средства рендеринга, установленные больше всего ListUI реализации.

Возвраты:

цвет, чтобы потянуть фон выбранных пунктов

См. Также:

setSelectionBackground(java.awt.Color), DefaultListCellRenderer

setSelectionBackground

public void setSelectionBackground(Color selectionBackground)

Выбирает цвет, используемый, чтобы потянуть фон выбранных пунктов, какие средства рендеринга ячейки могут использовать заливку выбранные ячейки. DefaultListCellRenderer использование этот цвет, чтобы заполнить фон элементов в выбранном состоянии, также, как и средства рендеринга, установленные больше всего ListUI реализации.

Значение по умолчанию этого свойства определяется реализацией стили.

Это - JavaBeans связанное свойство.

Параметры:

selectionBackground - Color использовать для фона выбранных ячеек

См. Также:

getSelectionBackground(), setSelectionForeground(java.awt.Color), JComponent.setForeground(java.awt.Color), JComponent.setBackground(java.awt.Color), JComponent.setFont(java.awt.Font), DefaultListCellRenderer

getVisibleRowCount

public int getVisibleRowCount()

Возвращает значение visibleRowCount свойство. См. документацию для setVisibleRowCount(int) для деталей о том, как интерпретировать это значение.

Возвраты:

значение visibleRowCount свойство.

См. Также:

setVisibleRowCount(int)

setVisibleRowCount

public void setVisibleRowCount(int visibleRowCount)

Наборы visibleRowCount свойство, у которого есть различные значения в зависимости от ориентации расположения: Для a VERTICAL ориентация расположения, это определяет привилегированный номер строк, чтобы вывести на экран, не требуя прокрутки; для других ориентаций это влияет на обертывание ячеек.

В VERTICAL ориентация:
Установка этого свойства влияет на возвращаемое значение getPreferredScrollableViewportSize() метод, который используется, чтобы вычислить привилегированный размер области просмотра включения. См. что документация метода для большего количества деталей.

В HORIZONTAL_WRAP и VERTICAL_WRAP ориентации:
Это влияет, как обертываются ячейки. См. документацию setLayoutOrientation(int) для большего количества деталей.

Значение по умолчанию этого свойства 8.

Вызов этого метода с отрицательной величиной приводит к свойству, устанавливаемому в 0.

Это - JavaBeans связанное свойство.

Параметры:

visibleRowCount - целое число, определяющее привилегированное число строк, чтобы вывести на экран, не требуя прокрутки

См. Также:

getVisibleRowCount(), getPreferredScrollableViewportSize(), setLayoutOrientation(int), JComponent.getVisibleRect(), JViewport

getLayoutOrientation

public int getLayoutOrientation()

Возвращает свойство ориентации расположения для списка: VERTICAL если расположение является единственным столбцом ячеек, VERTICAL_WRAP если расположение является "газетным стилем" с контентом, текущим вертикально тогда горизонтально, или HORIZONTAL_WRAP если расположение является "газетным стилем" с контентом, текущим горизонтально тогда вертикально.

Возвраты:

значение layoutOrientation свойство

С тех пор:

1.4

См. Также:

setLayoutOrientation(int)

setLayoutOrientation

public void setLayoutOrientation(int layoutOrientation)

Определяет способ, которым ячейки списка являются layed. Рассмотрите a JList с пятью ячейками. Ячейки могут быть layed одним из следующих способов:

 VERTICAL:          0
                    1
                    2
                    3
                    4

 HORIZONTAL_WRAP:   0  1  2
                    3  4

 VERTICAL_WRAP:     0  3
                    1  4
                    2
 

Описание этих разметок следует:

Значение	Описание
VERTICAL	Ячейки являются layed вертикально в единственном столбце.
HORIZONTAL_WRAP	Ячейки являются layed горизонтально, переносясь к новой строке по мере необходимости. Если visibleRowCount свойство меньше чем или равно нулю, обертывание определяется шириной списка; иначе обертывание делается таким способом как, чтобы гарантировать visibleRowCount строки в списке.
VERTICAL_WRAP	Ячейки являются layed вертикально, переносясь к новому столбцу по мере необходимости. Если visibleRowCount свойство меньше чем или равно нулю, обертывание определяется высотой списка; иначе обертывание делается в visibleRowCount строки.

Значение по умолчанию этого свойства VERTICAL.

Параметры:

layoutOrientation - новая ориентация расположения, один из: VERTICAL, HORIZONTAL_WRAP или VERTICAL_WRAP

Броски:

IllegalArgumentException - если layoutOrientation не одно из допустимых значений

С тех пор:

1.4

См. Также:

getLayoutOrientation(), setVisibleRowCount(int), getScrollableTracksViewportHeight(), getScrollableTracksViewportWidth()

getFirstVisibleIndex

public int getFirstVisibleIndex()

Возвращает самый маленький индекс списка, который в настоящий момент видим. В слева направо componentOrientation, первая видимая ячейка считается самой близкой к верхнему левому углу списка. В справа налево ориентации это считается самым близким к верхнему правому углу. Если ничто не видимо, или список пуст, -1 возвращается. Отметьте, что возвращенная ячейка может только быть частично видимой.

Возвраты:

индекс первой видимой ячейки

См. Также:

getLastVisibleIndex(), JComponent.getVisibleRect()

getLastVisibleIndex

public int getLastVisibleIndex()

Возвращает самый большой индекс списка, который в настоящий момент видим. Если ничто не видимо, или список пуст, -1 возвращается. Отметьте, что возвращенная ячейка может только быть частично видимой.

Возвраты:

индекс последней видимой ячейки

См. Также:

getFirstVisibleIndex(), JComponent.getVisibleRect()

ensureIndexIsVisible

public void ensureIndexIsVisible(int index)

Прокручивает список в пределах области просмотра включения, чтобы сделать указанную ячейку абсолютно видимой. Это вызывает scrollRectToVisible с границами указанной ячейки. Для этого метода, чтобы работать, JList должен быть в пределах a JViewport.

Если данный индекс вне диапазона списка ячеек, этот метод результаты ни в чем.

Параметры:

index - индекс ячейки, чтобы сделать видимый

См. Также:

JComponent.scrollRectToVisible(java.awt.Rectangle), JComponent.getVisibleRect()

setDragEnabled

public void setDragEnabled(boolean b)

Включает или выключает автоматический, перетаскивают обработку. Чтобы включить автоматический, перетаскивают обработку, это свойство должно быть установлено в true, и список TransferHandler потребности быть non-null. Значение по умолчанию dragEnabled свойство false.

Задание удостаивания этого свойства, и распознавания пользователя перетаскивает жест, находится с реализацией стили, и в частности список ListUI. Когда автоматический перетащите обработку, включается, большинство взгляда и чувств (включая тех, которые разделяют на подклассы BasicLookAndFeel) начните перетаскивание и отбросьте работу всякий раз, когда пользователь нажимает кнопку мыши по элементу и затем перемещает мышь несколько пикселей. Установка этого свойства к true может поэтому иметь тонкий эффект на то, как выборы ведут себя.

Если стиль используется, который игнорирует это свойство, можно все еще начать перетаскивание и отбросить работу, вызывая exportAsDrag в списке TransferHandler.

Параметры:

b - включить ли автоматический, перетаскивают обработку

Броски:

HeadlessException - если b true и GraphicsEnvironment.isHeadless() возвраты true

С тех пор:

1.4

См. Также:

GraphicsEnvironment.isHeadless(), getDragEnabled(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandler

getDragEnabled

public boolean getDragEnabled()

Включаются возвраты, перетаскивают ли автоматический обработку.

Возвраты:

значение dragEnabled свойство

С тех пор:

1.4

См. Также:

setDragEnabled(boolean)

setDropMode

public final void setDropMode(DropMode dropMode)

Устанавливает режим отбрасывания для этого компонента. Для обратной совместимости значение по умолчанию для этого свойства DropMode.USE_SELECTION. Использование одного из других режимов рекомендуется, однако, для улучшенного пользовательского опыта. DropMode.ON, например, подобное поведение предложений показа элементов как выбрано, но делает так, не влияя на фактический выбор в списке.

JList поддерживает следующие режимы отбрасывания:

• DropMode.USE_SELECTION
• DropMode.ON
• DropMode.INSERT
• DropMode.ON_OR_INSERT

Режим отбрасывания только значим, если у этого компонента есть a TransferHandler это принимает отбрасывания.

Параметры:

dropMode - режим отбрасывания, чтобы использовать

Броски:

IllegalArgumentException - если режим отбрасывания неподдерживается или null

С тех пор:

1.6

См. Также:

getDropMode(), getDropLocation(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandler

getDropMode

public final DropMode getDropMode()

Возвращает режим отбрасывания для этого компонента.

Возвраты:

режим отбрасывания для этого компонента

С тех пор:

1.6

См. Также:

setDropMode(javax.swing.DropMode)

getDropLocation

public final JList.DropLocation getDropLocation()

Возвращает расположение, на которое этот компонент должен визуально указать как расположение отбрасывания во время работы DnD по компоненту, или null если никакое расположение нельзя в настоящий момент показать.

Этот метод не предназначается для того, чтобы запросить расположение отбрасывания от a TransferHandler, поскольку расположение отбрасывания только устанавливается после TransferHandler's canImport возвратился и учел расположение, которое будет показано.

Когда это свойство изменяется, событие изменения свойства с именем "dropLocation" запускается компонентом.

По умолчанию ответственность за то, чтобы прислушаться к изменениям к этому свойству и указать на расположение отбрасывания визуально лежит на списке ListUI, который может нарисовать это непосредственно и/или установить средство рендеринга ячейки, чтобы сделать так. Разработчики, желающие реализовывать пользовательское рисование расположения отбрасывания и/или заменять средство рендеринга ячейки по умолчанию, возможно, должны соблюдать это свойство.

Возвраты:

расположение отбрасывания

С тех пор:

1.6

См. Также:

setDropMode(javax.swing.DropMode), TransferHandler.canImport(TransferHandler.TransferSupport)

getNextMatch

public int getNextMatch(String prefix,
               int startIndex,
               Position.Bias bias)

Возвращает следующий элемент списка чей toString значение запускается с данного префикса.

Параметры:

prefix - строка, чтобы протестировать на соответствие

startIndex - индекс для того, чтобы начать поиск

bias - поисковое направление, любая Позиция. Смещение. Передайте или Позиция. Смещение. Назад.

Возвраты:

индекс следующего элемента списка, который запускается с префикса; иначе -1

Броски:

IllegalArgumentException - если префикс null или startIndex за пределы

С тех пор:

1.4

getToolTipText

public String getToolTipText(MouseEvent event)

Возвращает текст подсказки, который будет использоваться для данного события. Это переопределяет JComponent's getToolTipText сначала проверять компонент средства рендеринга ячейки на ячейку, по которой событие имело место, возвращая его текст подсказки, если любой. Эта реализация позволяет Вам определять текст подсказки на уровне ячейки, при использовании setToolTipText на Вашем компоненте средства рендеринга ячейки.

Отметьте: Для JList должным образом вывести на экран подсказки его средств рендеринга этим способом, JList должен быть зарегистрированный компонент с ToolTipManager. Эта регистрация делается автоматически в конструкторе. Однако, если позже JList незарегистрировано, посредством звонка setToolTipText(null), подсказки от средств рендеринга больше не будут выводить на экран.

Переопределения:

getToolTipText в классе JComponent

Параметры:

event - MouseEvent выбирать текст подсказки для

См. Также:

JComponent.setToolTipText(java.lang.String), JComponent.getToolTipText()

locationToIndex

public int locationToIndex(Point location)

Возвращает индекс ячейки, самый близкий к данному расположению в системе координат списка. Чтобы определить, содержит ли ячейка фактически указанное расположение, сравните точку с границами ячейки, в соответствии с getCellBounds. Этот метод возвраты -1 если модель пуста

Это - метод покрытия, который делегирует к методу того же самого имени в списке ListUI. Это возвращается -1 если список имеет нет ListUI.

Параметры:

location - координаты точки

Возвраты:

индекс ячейки, самый близкий к данному расположению, или -1

indexToLocation

public Point indexToLocation(int index)

Возвращает источник указанного элемента в системе координат списка. Этот метод возвраты null если индекс не допустим.

Это - метод покрытия, который делегирует к методу того же самого имени в списке ListUI. Это возвращается null если список имеет нет ListUI.

Параметры:

index - индекс ячейки

Возвраты:

источник ячейки, или null

getCellBounds

public Rectangle getCellBounds(int index0,
                      int index1)

Возвращает ограничительный прямоугольник, в системе координат списка, для диапазона ячеек, определенных этими двумя индексами. Эти индексы могут быть предоставлены в любом порядке.

Если меньший индекс вне диапазона списка ячеек, этот метод возвраты null. Если меньший индекс допустим, но больший индекс вне диапазона списка, границы только первого индекса возвращается. Иначе, границы допустимого диапазона возвращается.

Это - метод покрытия, который делегирует к методу того же самого имени в списке ListUI. Это возвращается null если список имеет нет ListUI.

Параметры:

index0 - первый индекс в диапазоне

index1 - второй индекс в диапазоне

Возвраты:

ограничительный прямоугольник для диапазона ячеек, или null

getModel

public ListModel<E> getModel()

Возвращает модель данных, которая содержит список элементов, выведенных на экран JList компонент.

Возвраты:

ListModel это обеспечивает выведенный на экран список элементов

См. Также:

setModel(javax.swing.ListModel<E>)

setModel

public void setModel(ListModel<E> model)

Устанавливает модель, которая представляет содержание или "значение" списка, уведомляет, что свойство изменяет слушателей, и затем очищает выбор списка.

Это - JavaBeans связанное свойство.

Параметры:

model - ListModel это обеспечивает список элементов для дисплея

Броски:

IllegalArgumentException - если model null

См. Также:

getModel(), clearSelection()

setListData

public void setListData(E[] listData)

Создает только для чтения ListModel от массива элементов, и вызовов setModel с этой моделью.

Попытки передать a null оцените этому методу результаты в неопределенном поведении и, наиболее вероятно, исключения. Создаваемая модель ссылается на данный массив непосредственно. Попытки изменить массив после вызова этого метода приводят к неопределенному поведению.

Параметры:

listData - массив E содержа элементы, чтобы вывести на экран в списке

См. Также:

setModel(javax.swing.ListModel<E>)

setListData

public void setListData(Vector<? extends E> listData)

Создает только для чтения ListModel от a Vector и вызовы setModel с этой моделью.

Попытки передать a null оцените этому методу результаты в неопределенном поведении и, наиболее вероятно, исключения. Создаваемая модель ссылается на данный Vector непосредственно. Попытки изменить Vector после вызова этого метода приводит к неопределенному поведению.

Параметры:

listData - a Vector содержа элементы, чтобы вывести на экран в списке

См. Также:

setModel(javax.swing.ListModel<E>)

createSelectionModel

protected ListSelectionModel createSelectionModel()

Возвращает экземпляр DefaultListSelectionModel; вызванный во время конструкции, чтобы инициализировать свойство модели выбора списка.

Возвраты:

a DefaultListSelecitonModel, используемый, чтобы инициализировать свойство модели выбора списка во время конструкции

См. Также:

setSelectionModel(javax.swing.ListSelectionModel), DefaultListSelectionModel

getSelectionModel

public ListSelectionModel getSelectionModel()

Возвращает текущую модель выбора. Модель выбора поддерживает состояние выбора списка. См. документацию уровня класса для большего количества деталей.

Возвраты:

ListSelectionModel это поддерживает выборы списка

См. Также:

setSelectionModel(javax.swing.ListSelectionModel), ListSelectionModel

fireSelectionValueChanged

protected void fireSelectionValueChanged(int firstIndex,
                             int lastIndex,
                             boolean isAdjusting)

Уведомляет ListSelectionListeners добавленный непосредственно к списку изменений выбора, произведенных в модели выбора. JList прислушивается к изменениям, произведенным в выборе в модели выбора, и пересылает уведомление слушателям, добавленным к списку непосредственно, вызывая этот метод.

Этот метод создает a ListSelectionEvent с этим списком как источник, и указанные параметры, и отправляет это зарегистрированному ListSelectionListeners.

Параметры:

firstIndex - первый индекс в диапазоне, <= lastIndex

lastIndex - последний индекс в диапазоне, >= firstIndex

isAdjusting - является ли это один в серии многократных событий, где изменения все еще производятся

См. Также:

addListSelectionListener(javax.swing.event.ListSelectionListener), removeListSelectionListener(javax.swing.event.ListSelectionListener), ListSelectionEvent, EventListenerList

addListSelectionListener

public void addListSelectionListener(ListSelectionListener listener)

Добавляет слушатель списка, чтобы быть уведомленным каждый раз, когда изменение к выбору происходит; привилегированный способ прислушаться к изменениям состояния выбора. JList заботится о прислушивании к изменениям состояния выбора в модели выбора, и уведомляет данного слушателя каждого изменения. ListSelectionEvents отправленный слушателю имеют a source набор свойств к этому списку.

Параметры:

listener - ListSelectionListener добавить

См. Также:

getSelectionModel(), getListSelectionListeners()

removeListSelectionListener

public void removeListSelectionListener(ListSelectionListener listener)

Удаляет слушателя выбора из списка.

Параметры:

listener - ListSelectionListener удалить

См. Также:

addListSelectionListener(javax.swing.event.ListSelectionListener), getSelectionModel()

getListSelectionListeners

public ListSelectionListener[] getListSelectionListeners()

Возвращает массив весь ListSelectionListeners добавленный к этому JList посредством addListSelectionListener.

Возвраты:

весь из ListSelectionListeners в этом списке, или пустом массиве, если никакие слушатели не были добавлены

С тех пор:

1.4

См. Также:

addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectionModel

public void setSelectionModel(ListSelectionModel selectionModel)

Наборы selectionModel для списка к не -null ListSelectionModel реализация. Модель выбора обрабатывает задачу создания единственных выборов, выборов непрерывных диапазонов, и выборов состоящих из нескольких несмежных участков.

Это - JavaBeans связанное свойство.

Параметры:

selectionModel - ListSelectionModel это реализует выборы

Броски:

IllegalArgumentException - если selectionModel null

См. Также:

getSelectionModel()

setSelectionMode

public void setSelectionMode(int selectionMode)

Устанавливает режим выбора для списка. Это - метод покрытия, который устанавливает режим выбора непосредственно на модели выбора.

Следующий список описывает принятые режимы выбора:

• ListSelectionModel.SINGLE_SELECTION - Только один индекс списка может быть выбран за один раз. В этом режиме, setSelectionInterval и addSelectionInterval эквивалентны, обе замены текущего выбора с индексом, представленным вторым параметром ("вывод").
• ListSelectionModel.SINGLE_INTERVAL_SELECTION - Только один непрерывный интервал может быть выбран за один раз. В этом режиме, addSelectionInterval ведет себя как setSelectionInterval (замена текущего выбора}, если данный интервал не сразу смежен с или перекрывает существующий выбор, и может использоваться, чтобы вырастить выбор.
• ListSelectionModel.MULTIPLE_INTERVAL_SELECTION - В этом режиме нет никакого ограничения на то, что может быть выбрано. Этот режим является значением по умолчанию.

Параметры:

selectionMode - режим выбора

Броски:

IllegalArgumentException - если режим выбора не является одним из позволенных

См. Также:

getSelectionMode()

getSelectionMode

public int getSelectionMode()

Возвращает текущий режим выбора для списка. Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

Возвраты:

текущий режим выбора

См. Также:

setSelectionMode(int)

getAnchorSelectionIndex

public int getAnchorSelectionIndex()

Возвращает индекс выбора привязки. Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

Возвраты:

индекс выбора привязки

См. Также:

ListSelectionModel.getAnchorSelectionIndex()

getLeadSelectionIndex

public int getLeadSelectionIndex()

Возвращает ведущий индекс выбора. Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

Возвраты:

ведущий индекс выбора

См. Также:

ListSelectionModel.getLeadSelectionIndex()

getMinSelectionIndex

public int getMinSelectionIndex()

Возвращает самый маленький выбранный индекс ячейки, или -1 если выбор пуст. Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

Возвраты:

самый маленький выбранный индекс ячейки, или -1

См. Также:

ListSelectionModel.getMinSelectionIndex()

getMaxSelectionIndex

public int getMaxSelectionIndex()

Возвращает самый большой выбранный индекс ячейки, или -1 если выбор пуст. Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

Возвраты:

самый большой выбранный индекс ячейки

См. Также:

ListSelectionModel.getMaxSelectionIndex()

isSelectedIndex

public boolean isSelectedIndex(int index)

Возвраты true если указанный индекс выбирается, еще false. Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

Параметры:

index - индекс, который будет запрошен для состояния выбора

Возвраты:

true если указанный индекс выбирается, еще false

См. Также:

ListSelectionModel.isSelectedIndex(int), setSelectedIndex(int)

isSelectionEmpty

public boolean isSelectionEmpty()

Возвраты true если ничто не выбирается, еще false. Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

Возвраты:

true если ничто не выбирается, еще false

См. Также:

ListSelectionModel.isSelectionEmpty(), clearSelection()

clearSelection

public void clearSelection()

Очищает выбор; после вызова этого метода, isSelectionEmpty возвратится true. Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

См. Также:

ListSelectionModel.clearSelection(), isSelectionEmpty()

setSelectionInterval

public void setSelectionInterval(int anchor,
                        int lead)

Выбирает указанный интервал. Оба anchor и lead индексы включаются. anchor не должно быть меньше чем или равным lead. Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

Сошлитесь на документацию класса модели выбора, используемого для деталей о как значения меньше чем 0 обрабатываются.

Параметры:

anchor - первый индекс, который выберет

lead - последний индекс, который выберет

См. Также:

ListSelectionModel.setSelectionInterval(int, int), DefaultListSelectionModel.setSelectionInterval(int, int), createSelectionModel(), addSelectionInterval(int, int), removeSelectionInterval(int, int)

addSelectionInterval

public void addSelectionInterval(int anchor,
                        int lead)

Устанавливает выбор, чтобы быть объединением указанного интервала с текущим выбором. Оба anchor и lead индексы включаются. anchor не должно быть меньше чем или равным lead. Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

Сошлитесь на документацию класса модели выбора, используемого для деталей о как значения меньше чем 0 обрабатываются.

Параметры:

anchor - первый индекс, который добавит к выбору

lead - последний индекс, который добавит к выбору

См. Также:

ListSelectionModel.addSelectionInterval(int, int), DefaultListSelectionModel.addSelectionInterval(int, int), createSelectionModel(), setSelectionInterval(int, int), removeSelectionInterval(int, int)

removeSelectionInterval

public void removeSelectionInterval(int index0,
                           int index1)

Устанавливает выбор, чтобы быть разностью множеств указанного интервала и текущего выбора. Оба index0 и index1 индексы удаляются. index0 не должно быть меньше чем или равным index1. Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

Сошлитесь на документацию класса модели выбора, используемого для деталей о как значения меньше чем 0 обрабатываются.

Параметры:

index0 - первый индекс, который удалит из выбора

index1 - последний индекс, который удалит из выбора

См. Также:

ListSelectionModel.removeSelectionInterval(int, int), DefaultListSelectionModel.removeSelectionInterval(int, int), createSelectionModel(), setSelectionInterval(int, int), addSelectionInterval(int, int)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

Устанавливает модель выбора valueIsAdjusting свойство. Когда true, предстоящие изменения к выбору нужно считать частью единственного изменения. Это свойство используется внутренне, и разработчики обычно не должны вызывать этот метод. Например, когда модель обновляется в ответ на пользователя, перетаскивают, значение свойства устанавливается в true когда перетаскивание инициируется и устанавливается в false когда перетаскивание заканчивается. Это позволяет слушателям обновлять только, когда изменение было завершено, вместо того, чтобы обработать все промежуточные значения.

Можно хотеть использовать это непосредственно, делая серию изменений, которые нужно считать частью единственного изменения.

Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка. См. документацию для ListSelectionModel.setValueIsAdjusting(boolean) для большего количества деталей.

Параметры:

b - новое значение для свойства

См. Также:

ListSelectionModel.setValueIsAdjusting(boolean), ListSelectionEvent.getValueIsAdjusting(), getValueIsAdjusting()

getValueIsAdjusting

public boolean getValueIsAdjusting()

Возвращает значение модели выбора isAdjusting свойство.

Это - метод покрытия, который делегирует к методу того же самого имени на модели выбора списка.

Возвраты:

значение модели выбора isAdjusting свойство.

См. Также:

setValueIsAdjusting(boolean), ListSelectionModel.getValueIsAdjusting()

getSelectedIndices

public int[] getSelectedIndices()

Возвращает массив всех выбранных индексов, в увеличивающемся порядке.

Возвраты:

все выбранные индексы, в увеличивающемся порядке, или пустом массиве, если ничто не выбирается

См. Также:

removeSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectedIndex

public void setSelectedIndex(int index)

Выбирает единственную ячейку. Ничего не делает, если данный индекс больше чем или равен размеру модели. Это - метод удобства, который использует setSelectionInterval на модели выбора. Сошлитесь на документацию для класса модели выбора, используемого для деталей о как значения меньше чем 0 обрабатываются.

Параметры:

index - индекс ячейки, чтобы выбрать

См. Также:

ListSelectionModel.setSelectionInterval(int, int), isSelectedIndex(int), addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectedIndices

public void setSelectedIndices(int[] indices)

Изменяет выбор, чтобы быть набором индексов, определенных данным массивом. Игнорируются индексы, больше чем или равный размеру модели. Это - метод удобства, который очищает выбор и затем использует addSelectionInterval на модели выбора, чтобы добавить индексы. Сошлитесь на документацию класса модели выбора, используемого для деталей о как значения меньше чем 0 обрабатываются.

Параметры:

indices - массив индексов ячеек, чтобы выбрать, non-null

Броски:

NullPointerException - если данный массив null

См. Также:

ListSelectionModel.addSelectionInterval(int, int), isSelectedIndex(int), addListSelectionListener(javax.swing.event.ListSelectionListener)

getSelectedValues

@Deprecated
public Object[] getSelectedValues()

Осуждаемый. С JDK 1.7, замененный getSelectedValuesList()

Возвращает массив всех выбранных значений, в увеличивающемся порядке, основанном на их индексах в списке.

Возвраты:

выбранные значения, или пустой массив, если ничто не выбирается

См. Также:

isSelectedIndex(int), getModel(), addListSelectionListener(javax.swing.event.ListSelectionListener)

getSelectedValuesList

public List<E> getSelectedValuesList()

Возвращает список всех выбранных пунктов, в увеличивающемся порядке, основанном на их индексах в списке.

Возвраты:

выбранные пункты, или пустой список, если ничто не выбирается

С тех пор:

1.7

См. Также:

isSelectedIndex(int), getModel(), addListSelectionListener(javax.swing.event.ListSelectionListener)

getSelectedIndex

public int getSelectedIndex()

Возвращает самый маленький выбранный индекс ячейки; выбор, когда только единственный элемент выбирается в списке. Когда многократные элементы выбираются, это - просто самый маленький выбранный индекс. Возвраты -1 если нет никакого выбора.

Этот метод является покрытием, которое делегирует к getMinSelectionIndex.

Возвраты:

самый маленький выбранный индекс ячейки

См. Также:

getMinSelectionIndex(), addListSelectionListener(javax.swing.event.ListSelectionListener)

getSelectedValue

public E getSelectedValue()

Возвращает значение для самого маленького выбранного индекса ячейки; выбранное значение, когда только единственный элемент выбирается в списке. Когда многократные элементы выбираются, это - просто значение для самого маленького выбранного индекса. Возвраты null если нет никакого выбора.

Это - метод удобства, который просто возвращает значение модели для getMinSelectionIndex.

Возвраты:

первое выбранное значение

См. Также:

getMinSelectionIndex(), getModel(), addListSelectionListener(javax.swing.event.ListSelectionListener)

setSelectedValue

public void setSelectedValue(Object anObject,
                    boolean shouldScroll)

Выбирает указанный объект из списка.

Параметры:

anObject - объект выбрать

shouldScroll - true если список должен прокрутить, чтобы вывести на экран выбранный объект, если Вы существуете; иначе false

getPreferredScrollableViewportSize

public Dimension getPreferredScrollableViewportSize()

Вычисляет размер области просмотра, должен был вывести на экран visibleRowCount строки. Значение, возвращенное этим методом, зависит от ориентации расположения:

VERTICAL:
Это тривиально если оба fixedCellWidth и fixedCellHeight были установлены (или явно или определяя прототипное значение ячейки). Ширина просто fixedCellWidth плюс горизонтальные вставки списка. Высота fixedCellHeight умноженный на visibleRowCount, плюс вертикальные вставки списка.

Если также fixedCellWidth или fixedCellHeight не были определены, эвристика используются. Если модель пуста, ширина fixedCellWidth, если больше чем 0, или трудно кодированное значение 256. Высота fixedCellHeight умноженный на visibleRowCount, если fixedCellHeight больше чем 0, иначе это - трудно кодированное значение 16 умноженный на visibleRowCount.

Если модель не пуста, ширина является шириной привилегированного размера, обычно ширина самого широкого элемента списка. Высота fixedCellHeight умноженный на visibleRowCount, плюс вертикальные вставки списка.

VERTICAL_WRAP или HORIZONTAL_WRAP:
Этот метод просто возвращает значение из getPreferredSize. Список ListUI как ожидают, переопределит getPreferredSize возвратить соответствующее значение.

Определенный:

getPreferredScrollableViewportSize в интерфейсе Scrollable

Возвраты:

размерность, содержащая размер области просмотра, должна была вывести на экран visibleRowCount строки

См. Также:

getPreferredScrollableViewportSize(), setPrototypeCellValue(E)

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle visibleRect,
                             int orientation,
                             int direction)

Возвращает расстояние, чтобы прокрутить, чтобы представить следующую или предыдущую строку (для вертикальной прокрутки) или столбец (для горизонтальной прокрутки).

Для горизонтальной прокрутки, если ориентация расположения VERTICAL, тогда размер шрифта списка возвращается (или 1 если шрифт null).

Определенный:

getScrollableUnitIncrement в интерфейсе Scrollable

Параметры:

visibleRect - область представления, видимая в пределах области просмотра

orientation - SwingConstants.HORIZONTAL или SwingConstants.VERTICAL

direction - меньше или равный, чтобы обнулить, чтобы прокрутить/назад, больше чем нуль для вниз/вперед

Возвраты:

инкремент "модуля" для того, чтобы прокрутить в указанном направлении; всегда положительный

Броски:

IllegalArgumentException - если visibleRect null, или orientation не один из SwingConstants.VERTICAL или SwingConstants.HORIZONTAL

См. Также:

getScrollableBlockIncrement(java.awt.Rectangle, int, int), Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)

getScrollableBlockIncrement

public int getScrollableBlockIncrement(Rectangle visibleRect,
                              int orientation,
                              int direction)

Возвращает расстояние, чтобы прокрутить, чтобы представить следующий или предыдущий блок.

Для вертикальной прокрутки используются следующие правила:

• прокручивая вниз, возвращает расстояние до прокрутки так, чтобы последний видимый элемент стал первым абсолютно видимым элементом
• прокручивая, возвращает расстояние до прокрутки так, чтобы первый видимый элемент стал последним абсолютно видимым элементом
• возвраты visibleRect.height если список пуст

Для горизонтальной прокрутки, когда ориентация расположения также VERTICAL_WRAP или HORIZONTAL_WRAP:

• прокручивая право, возвращает расстояние до прокрутки так, чтобы последний видимый элемент стал первым абсолютно видимым элементом
• прокручивая оставленный, возвращает расстояние до прокрутки так, чтобы первый видимый элемент стал последним абсолютно видимым элементом
• возвраты visibleRect.width если список пуст

Для горизонтальной прокрутки и VERTICAL ориентация, возвраты visibleRect.width.

Отметьте что значение visibleRect должно быть равное this.getVisibleRect().

Определенный:

getScrollableBlockIncrement в интерфейсе Scrollable

Параметры:

visibleRect - область представления, видимая в пределах области просмотра

orientation - SwingConstants.HORIZONTAL или SwingConstants.VERTICAL

direction - меньше или равный, чтобы обнулить, чтобы прокрутить/назад, больше чем нуль для вниз/вперед

Возвраты:

"блочный" инкремент для того, чтобы прокрутить в указанном направлении; всегда положительный

Броски:

IllegalArgumentException - если visibleRect null, или orientation не один из SwingConstants.VERTICAL или SwingConstants.HORIZONTAL

См. Также:

getScrollableUnitIncrement(java.awt.Rectangle, int, int), Scrollable.getScrollableBlockIncrement(java.awt.Rectangle, int, int)

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()

Возвраты true если это JList выводится на экран в a JViewport и область просмотра более широка чем привилегированная ширина списка, или если ориентация расположения HORIZONTAL_WRAP и visibleRowCount <= 0; иначе возвраты false.

Если false, тогда не отслеживайте ширину области просмотра. Это позволяет горизонтальную прокрутку если JViewport самостоятельно встраивается в a JScrollPane.

Определенный:

getScrollableTracksViewportWidth в интерфейсе Scrollable

Возвраты:

должна ли область просмотра включения вынудить ширину списка соответствовать свое собственное

См. Также:

Scrollable.getScrollableTracksViewportWidth()

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()

Возвраты true если это JList выводится на экран в a JViewport и область просмотра более высока чем привилегированная высота списка, или если ориентация расположения VERTICAL_WRAP и visibleRowCount <= 0; иначе возвраты false.

Если false, тогда не отслеживайте высоту области просмотра. Это позволяет вертикальную прокрутку если JViewport самостоятельно встраивается в a JScrollPane.

Определенный:

getScrollableTracksViewportHeight в интерфейсе Scrollable

Возвраты:

должна ли область просмотра включения вынудить высоту списка соответствовать свое собственное

См. Также:

Scrollable.getScrollableTracksViewportHeight()

paramString

protected String paramString()

Возвраты a String представление этого JList. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенного String может измениться между реализациями. Возвращенный String может быть пустым, но, возможно, не null.

Переопределения:

paramString в классе JComponent

Возвраты:

a String представление этого JList.

getAccessibleContext

public AccessibleContext getAccessibleContext()

Добирается AccessibleContext связанный с этим JList. Для JList, AccessibleContext принимает форму AccessibleJList.

Новое AccessibleJList экземпляр создается в случае необходимости.

Определенный:

getAccessibleContext в интерфейсе Accessible

Переопределения:

getAccessibleContext в классе JComponent

Возвраты:

AccessibleJList это служит AccessibleContext из этого JList