Spec-Zone.ru › OpenJDK 27

Класс JList<E>

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JList<E>
Параметры типа:
E — тип элементов этого списка
Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible, Scrollable
@JavaBean(defaultProperty="UI", description="A component which allows for the selection of one or more objects from a list.") public class JList<E> extends JComponent implements Scrollable, Accessible
Компонент, отображающий список объектов и позволяющий пользователю выбирать один или несколько элементов. Отдельная модель, ListModel, управляет содержимым списка.

Массив или Vector объектов легко отобразить с помощью конструктора 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));
}

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

Простые приложения с динамическим содержимым, использующие JList, могут использовать класс DefaultListModel для управления элементами списка. Этот класс реализует интерфейс ListModel, а также предоставляет API, подобный java.util.Vector. Приложения, которым требуется более специализированная реализация 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; }
};

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

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

Предпочтительный способ отслеживания изменений в выделении списка — добавлять слушатели ListSelectionListener непосредственно в JList. Затем JList берет на себя отслеживание событий модели выделения и уведомление ваших слушателей об изменениях.

Ответственность за отслеживание изменений выделения с целью поддержания визуального представления списка в актуальном состоянии лежит на ListUI списка.

Отрисовка ячеек в JList обрабатывается делегатом, называемым средством визуализации ячеек (cell renderer), установленным для списка в качестве свойства cellRenderer. Средство визуализации предоставляет java.awt.Component, который используется подобно «резиновому штампу» для отрисовки ячеек. Каждый раз, когда ячейку необходимо отрисовать, ListUI списка запрашивает компонент у средства визуализации ячеек, перемещает его на нужное место и выполняет отрисовку содержимого ячейки с помощью его метода paint. Стандартное средство визуализации ячеек, использующее для отрисовки компонент JLabel, устанавливается объектом ListUI списка. Вы можете заменить его собственным средством визуализации, используя код следующего вида:


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

class MyCellRenderer extends JLabel implements ListCellRenderer<Object> {
    static final ImageIcon longIcon = new ImageIcon("long.gif");
    static final 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 списка определяет размер ячеек, запрашивая у средства визуализации ячеек предпочтительный размер для каждого элемента списка. Для больших списков элементов это может быть ресурсоемкой операцией. Чтобы избежать этих вычислений, вы можете задать свойства 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 не реализует прокрутку напрямую. Чтобы создать список с поддержкой прокрутки, сделайте его представлением области просмотра (viewport view) для JScrollPane. Например:

JScrollPane scrollPane = new JScrollPane(myList);

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

JList не предоставляет специальной обработки двойных, тройных (или N-кратных) щелчков мыши, но при желании можно легко добавить 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, поддержка долговременного хранения всех JavaBeans была добавлена в пакет java.beans. См. XMLEncoder.

Дополнительную документацию см. в разделе Использование списков обучающего руководства The Java Tutorial.

Начиная с:
1.2
См. также:
  • ListModel
  • AbstractListModel
  • DefaultListModel
  • ListSelectionModel
  • DefaultListSelectionModel
  • ListCellRenderer
  • DefaultListCellRenderer

Краткое описание вложенных классов

Модификатор и тип Класс Описание
protected class  JList.AccessibleJList
Этот класс реализует поддержку специальных возможностей для класса JList.
static final class  JList.DropLocation
Подкласс TransferHandler.DropLocation, представляющий место сброса для JList.

Вложенные классы/интерфейсы, объявленные в классе JComponent

JComponent.AccessibleJComponent
Модификатор и тип Класс Описание
class  JComponent.AccessibleJComponent
Внутренний класс JComponent, используемый для предоставления стандартной поддержки специальных возможностей.

Вложенные классы/интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer
Модификатор и тип Класс Описание
protected class  Container.AccessibleAWTContainer
Внутренний класс Container, используемый для предоставления стандартной поддержки специальных возможностей.

Вложенные классы/интерфейсы, объявленные в классе Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Модификатор и тип Класс Описание
protected class  Component.AccessibleAWTComponent
Внутренний класс Component, используемый для предоставления стандартной поддержки специальных возможностей.
static enum  Component.BaselineResizeBehavior
Перечисление распространенных способов изменения базовой линии компонента при изменении размера.
protected class  Component.BltBufferStrategy
Внутренний класс для побитового переноса (blitting) закадровых поверхностей на компонент.
protected class  Component.FlipBufferStrategy
Внутренний класс для переключения буферов в компоненте.

Краткое описание полей

Модификатор и тип Поле Описание
static final int HORIZONTAL_WRAP
Указывает на компоновку в «газетном стиле», где ячейки располагаются сначала по горизонтали, а затем по вертикали.
static final int VERTICAL
Указывает на вертикальную компоновку ячеек в один столбец; компоновка по умолчанию.
static final int VERTICAL_WRAP
Указывает на компоновку в «газетном стиле», где ячейки располагаются сначала по вертикали, а затем по горизонтали.

Поля, объявленные в классе JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Модификатор и тип Поле Описание
protected EventListenerList listenerList
Список слушателей событий для этого компонента.
static final String TOOL_TIP_TEXT_KEY
Комментарий, отображаемый при наведении курсора на компонент, также известный как «всплывающая подсказка».
protected ComponentUI ui
Делегат внешнего вида и поведения (look and feel) для этого компонента.
static final int UNDEFINED_CONDITION
Константа, используемая некоторыми API для обозначения отсутствия определенного условия.
static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
Константа, используемая для registerKeyboardAction, означающая, что команда должна быть вызвана, когда принимающий компонент является предком сфокусированного компонента или сам является сфокусированным компонентом.
static final int WHEN_FOCUSED
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда компонент имеет фокус.
static final int WHEN_IN_FOCUSED_WINDOW
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда принимающий компонент находится в окне, имеющем фокус, или сам является сфокусированным компонентом.

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Модификатор и тип Поле Описание
protected AccessibleContext accessibleContext
Объект AccessibleContext, связанный с этим Component.
static final float BOTTOM_ALIGNMENT
Вспомогательная константа для удобства использования getAlignmentY.
static final float CENTER_ALIGNMENT
Вспомогательная константа для удобства использования getAlignmentY и getAlignmentX.
static final float LEFT_ALIGNMENT
Вспомогательная константа для удобства использования getAlignmentX.
static final float RIGHT_ALIGNMENT
Вспомогательная константа для удобства использования getAlignmentX.
static final float TOP_ALIGNMENT
Вспомогательная константа для удобства использования getAlignmentY().

Поля, объявленные в интерфейсе ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Модификатор и тип Поле Описание
static final int ABORT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что асинхронно отслеживаемое изображение было прервано до завершения его формирования.
static final int ALLBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что ранее отрисованное статическое изображение теперь завершено и может быть отрисовано снова в окончательном виде.
static final int ERROR
Этот флаг в аргументе infoflags метода imageUpdate указывает, что при асинхронном отслеживании изображения произошла ошибка.
static final int FRAMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что еще один полный кадр многокадрового изображения, который ранее был отрисован, теперь доступен для повторной отрисовки.
static final int HEIGHT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что высота базового изображения теперь доступна и может быть получена из аргумента height метода обратного вызова imageUpdate.
static final int PROPERTIES
Этот флаг в аргументе infoflags метода imageUpdate указывает, что свойства изображения теперь доступны.
static final int SOMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что стало доступно больше пикселей, необходимых для отрисовки масштабированного варианта изображения.
static final int WIDTH
Этот флаг в аргументе infoflags метода imageUpdate указывает, что ширина базового изображения теперь доступна и может быть получена из аргумента width метода обратного вызова imageUpdate.

Краткое описание конструкторов

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

Краткое описание методов

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

Методы, объявленные в классе JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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, hide, 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
Модификатор и тип Метод Описание
void addAncestorListener(AncestorListener listener)
Регистрирует listener для получения AncestorEvents, когда он сам или любой из его предков перемещается либо становится видимым или невидимым.
void addNotify()
Уведомляет данный компонент о том, что у него появился родительский компонент.
void addVetoableChangeListener(VetoableChangeListener listener)
Добавляет VetoableChangeListener в список слушателей.
void computeVisibleRect(Rectangle visibleRect)
Возвращает «видимый прямоугольник» компонента Component — пересечение видимых прямоугольников для этого компонента и всех его предков.
boolean contains(int x, int y)
Предоставляет делегату UI возможность определить точную форму этого компонента для обработки событий мыши.
JToolTip createToolTip()
Возвращает экземпляр JToolTip, который следует использовать для отображения всплывающей подсказки.
void disable()
Устарело.
Начиная с версии JDK 1.1 заменено на java.awt.Component.setEnabled(boolean).
void enable()
Устарело.
Начиная с версии JDK 1.1 заменено на java.awt.Component.setEnabled(boolean).
void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Поддержка оповещения об изменении связанных свойств для логических свойств.
void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка оповещения об изменении связанных свойств для целочисленных свойств.
protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue)
Поддерживает оповещение об изменении свойств с вето (constrained properties).
ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)
Возвращает объект, который будет выполнять действие, зарегистрированное для указанного нажатия клавиши.
final ActionMap getActionMap()
Возвращает ActionMap, используемый для определения того, какое действие Action запускать для конкретной привязки KeyStroke.
float getAlignmentX()
Переопределяет Container.getAlignmentX для возврата горизонтального выравнивания.
float getAlignmentY()
Переопределяет Container.getAlignmentY для возврата вертикального выравнивания.
AncestorListener[] getAncestorListeners()
Возвращает массив всех слушателей предков, зарегистрированных для этого компонента.
boolean getAutoscrolls()
Возвращает свойство autoscrolls.
int getBaseline(int width, int height)
Возвращает базовую линию.
Component.BaselineResizeBehavior getBaselineResizeBehavior()
Возвращает значение enum, указывающее, как базовая линия компонента изменяется при изменении размера.
Border getBorder()
Возвращает рамку этого компонента или null, если рамка в данный момент не установлена.
Rectangle getBounds(Rectangle rv)
Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
final Object getClientProperty(Object key)
Возвращает значение свойства с указанным ключом.
protected Graphics getComponentGraphics(Graphics g)
Возвращает графический объект, используемый для отрисовки этого компонента.
JPopupMenu getComponentPopupMenu()
Возвращает JPopupMenu, назначенный для этого компонента.
int getConditionForKeyStroke(KeyStroke aKeyStroke)
Возвращает условие, определяющее, происходит ли зарегистрированное действие в ответ на указанное нажатие клавиши.
int getDebugGraphicsOptions()
Возвращает состояние отладки графики.
static Locale getDefaultLocale()
Возвращает локаль по умолчанию, используемую для инициализации свойства локали каждого JComponent при создании.
FontMetrics getFontMetrics(Font font)
Возвращает FontMetrics для указанного Font.
Graphics getGraphics()
Возвращает графический контекст этого компонента, который позволяет рисовать на компоненте.
int getHeight()
Возвращает текущую высоту этого компонента.
boolean getInheritsPopupMenu()
Возвращает true, если JPopupMenu должен наследоваться от родителя.
final InputMap getInputMap()
Возвращает InputMap, который используется, когда компонент имеет фокус.
final InputMap getInputMap(int condition)
Возвращает InputMap, который используется во время condition.
InputVerifier getInputVerifier()
Возвращает верификатор ввода для этого компонента.
Insets getInsets()
Если для этого компонента была задана рамка, возвращает внутренние отступы (insets) рамки; в противном случае вызывает super.getInsets.
Insets getInsets(Insets insets)
Возвращает объект Insets, содержащий значения внутренних отступов этого компонента.
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, зарегистрированных в данный момент как FooListener в этом JComponent.
Point getLocation(Point rv)
Сохраняет начало координат x,y этого компонента в «возвращаемое значение» rv и возвращает rv.
Dimension getMaximumSize()
Если максимальный размер был установлен в значение, отличное от null, просто возвращает его.
Dimension getMinimumSize()
Если минимальный размер был установлен в значение, отличное от null, просто возвращает его.
Component getNextFocusableComponent()
Устарело.
Начиная с версии 1.4 заменено на FocusTraversalPolicy.
Point getPopupLocation(MouseEvent event)
Возвращает предпочтительное положение для отображения контекстного меню в системе координат этого компонента.
Dimension getPreferredSize()
Если preferredSize было установлено в значение, отличное от null, просто возвращает его.
KeyStroke[] getRegisteredKeyStrokes()
Возвращает KeyStrokes, которые инициируют зарегистрированные действия.
JRootPane getRootPane()
Возвращает предка JRootPane для этого компонента.
Dimension getSize(Dimension rv)
Сохраняет ширину/высоту этого компонента в «возвращаемое значение» rv и возвращает rv.
Point getToolTipLocation(MouseEvent event)
Возвращает положение всплывающей подсказки в системе координат этого компонента.
String getToolTipText()
Возвращает строку всплывающей подсказки, заданную с помощью setToolTipText.
Container getTopLevelAncestor()
Возвращает предка верхнего уровня этого компонента (содержащий его Window) или null, если этот компонент не был добавлен ни в один контейнер.
TransferHandler getTransferHandler()
Возвращает свойство transferHandler.
boolean getVerifyInputWhenFocusTarget()
Возвращает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед тем, как этот компонент запросит фокус.
VetoableChangeListener[] getVetoableChangeListeners()
Возвращает массив всех слушателей вето на изменения (vetoable change listeners), зарегистрированных для этого компонента.
Rectangle getVisibleRect()
Возвращает «видимый прямоугольник» компонента Component — пересечение видимого прямоугольника этого компонента, new Rectangle(0, 0, getWidth(), getHeight()), и видимых прямоугольников всех его предков.
int getWidth()
Возвращает текущую ширину этого компонента.
int getX()
Возвращает текущую координату x начала координат компонента.
int getY()
Возвращает текущую координату y начала координат компонента.
void grabFocus()
Запрашивает передачу фокуса ввода этому Component, а также чтобы предок верхнего уровня этого Component стал сфокусированным окном.
void hide()
Устарело.
boolean isDoubleBuffered()
Возвращает, должен ли этот компонент использовать буфер для отрисовки.
static boolean isLightweightComponent(Component c)
Возвращает true, если этот компонент является легковесным, то есть если он не имеет аналога (peer) в нативной оконной системе.
boolean isManagingFocus()
Устарело.
Начиная с версии 1.4 заменено на Component.setFocusTraversalKeys(int, Set) и Container.setFocusCycleRoot(boolean).
boolean isOpaque()
Возвращает true, если этот компонент полностью непрозрачен.
boolean isOptimizedDrawingEnabled()
Возвращает true, если этот компонент размещает свои дочерние элементы мозаикой (т. е. гарантирует, что они не перекрываются).
final boolean isPaintingForPrint()
Возвращает true, если текущая операция отрисовки на этом компоненте является частью операции print.
protected boolean isPaintingOrigin()
Возвращает true, если отрисовка, вызванная на дочернем компоненте, должна приводить к тому, что отрисовка начнется с этого Component или одного из его предков.
boolean isPaintingTile()
Возвращает true, если компонент в данный момент выполняет отрисовку тайла.
boolean isRequestFocusEnabled()
Возвращает true, если этот JComponent должен получать фокус; в противном случае возвращает false.
boolean isValidateRoot()
Если этот метод возвращает true, вызовы revalidate потомками этого компонента приведут к валидации всего дерева, начиная с этого корня.
void paint(Graphics g)
Вызывается Swing для отрисовки компонентов.
protected void paintBorder(Graphics g)
Отрисовывает рамку компонента.
protected void paintChildren(Graphics g)
Отрисовывает дочерние элементы этого компонента.
protected void paintComponent(Graphics g)
Вызывает метод paint делегата UI, если делегат UI не равен null.
void paintImmediately(int x, int y, int w, int h)
Немедленно отрисовывает указанную область в этом компоненте и всех его потомках, перекрывающих эту область.
void paintImmediately(Rectangle r)
Отрисовывает указанную область немедленно.
void print(Graphics g)
Вызовите этот метод для вывода компонента на печать на указанный Graphics.
void printAll(Graphics g)
Вызовите этот метод для вывода компонента на печать.
protected void printBorder(Graphics g)
Печатает рамку компонента.
protected void printChildren(Graphics g)
Печатает дочерние элементы этого компонента.
protected void printComponent(Graphics g)
Вызывается во время операции печати.
protected void processComponentKeyEvent(KeyEvent e)
Обрабатывает любые события клавиатуры, которые распознает сам компонент.
protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
Вызывается для обработки привязок клавиш для ks в результате KeyEvent e.
protected void processKeyEvent(KeyEvent e)
Переопределяет processKeyEvent для обработки событий.
protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, происходящие на этом компоненте, путем их диспетчеризации любым зарегистрированным объектам MouseListener; обратитесь к Component.processMouseEvent(MouseEvent) для получения полного описания этого метода.
protected void processMouseMotionEvent(MouseEvent e)
Обрабатывает события перемещения мыши, такие как MouseEvent.MOUSE_DRAGGED.
final void putClientProperty(Object key, Object value)
Добавляет произвольное «клиентское свойство» (пара ключ/значение) к этому компоненту.
void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел; для аналогичного поведения используйте комбинацию getActionMap() и getInputMap().
void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел; для аналогичного поведения используйте комбинацию getActionMap() и getInputMap().
void removeAncestorListener(AncestorListener listener)
Отменяет регистрацию listener, чтобы он больше не получал AncestorEvents.
void removeNotify()
Уведомляет данный компонент о том, что у него больше нет родительского компонента.
void removeVetoableChangeListener(VetoableChangeListener listener)
Удаляет VetoableChangeListener из списка слушателей.
void repaint(long tm, int x, int y, int width, int height)
Добавляет указанную область в список измененных областей (dirty region list), если компонент отображается на экране.
void repaint(Rectangle r)
Добавляет указанную область в список измененных областей (dirty region list), если компонент отображается на экране.
boolean requestDefaultFocus()
Устарело.
Начиная с версии 1.4 заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
void requestFocus()
Запрашивает передачу фокуса ввода этому Component.
boolean requestFocus(boolean temporary)
Запрашивает передачу фокуса ввода этому Component.
boolean requestFocusInWindow()
Запрашивает передачу фокуса ввода этому Component.
protected boolean requestFocusInWindow(boolean temporary)
Запрашивает передачу фокуса ввода этому Component.
void resetKeyboardActions()
Отменяет регистрацию всех привязок на первом уровне InputMaps и ActionMap.
void reshape(int x, int y, int w, int h)
Устарело.
Начиная с версии JDK 5 заменено на Component.setBounds(int, int, int, int).
void revalidate()
Поддерживает отложенную автоматическую компоновку.
void scrollRectToVisible(Rectangle aRect)
Пересылает сообщение scrollRectToVisible() родителю компонента JComponent.
final void setActionMap(ActionMap am)
Устанавливает ActionMap в am.
void setAlignmentX(float alignmentX)
Устанавливает горизонтальное выравнивание.
void setAlignmentY(float alignmentY)
Устанавливает вертикальное выравнивание.
void setAutoscrolls(boolean autoscrolls)
Устанавливает свойство autoscrolls.
void setBackground(Color bg)
Устанавливает цвет фона для этого компонента.
void setBorder(Border border)
Устанавливает рамку этого компонента.
void setComponentPopupMenu(JPopupMenu popup)
Устанавливает JPopupMenu для этого JComponent.
void setDebugGraphicsOptions(int debugOptions)
Включает или отключает диагностическую информацию о каждой графической операции, выполняемой внутри компонента или одного из его потомков.
static void setDefaultLocale(Locale l)
Задает локаль по умолчанию, используемую для инициализации свойства локали каждого JComponent при создании.
void setDoubleBuffered(boolean aFlag)
Задает, должен ли этот компонент использовать буфер для отрисовки.
void setEnabled(boolean enabled)
Определяет, включен данный компонент или нет.
void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Задает клавиши обхода фокуса для указанной операции обхода для этого Component.
void setFont(Font font)
Устанавливает шрифт для этого компонента.
void setForeground(Color fg)
Устанавливает цвет переднего плана для этого компонента.
void setInheritsPopupMenu(boolean value)
Определяет, должен ли getComponentPopupMenu делегировать обработку родителю, если для этого компонента не назначен JPopupMenu.
final void setInputMap(int condition, InputMap map)
Устанавливает InputMap для использования при условии condition в map.
void setInputVerifier(InputVerifier inputVerifier)
Устанавливает верификатор ввода для этого компонента.
void setMaximumSize(Dimension maximumSize)
Устанавливает максимальный размер этого компонента в константное значение.
void setMinimumSize(Dimension minimumSize)
Устанавливает минимальный размер этого компонента в константное значение.
void setNextFocusableComponent(Component aComponent)
Устарело.
Начиная с версии 1.4 заменено на FocusTraversalPolicy
void setOpaque(boolean isOpaque)
Если значение true, компонент отрисовывает каждый пиксель в пределах своих границ.
void setPreferredSize(Dimension preferredSize)
Устанавливает предпочтительный размер этого компонента.
void setRequestFocusEnabled(boolean requestFocusEnabled)
Предоставляет подсказку относительно того, должен ли этот JComponent получать фокус.
void setToolTipText(String text)
Регистрирует текст для отображения во всплывающей подсказке.
void setTransferHandler(TransferHandler newHandler)
Устанавливает TransferHandler, который обеспечивает поддержку передачи данных в этот компонент и из него с помощью операций вырезать/скопировать/вставить и перетаскивания (drag and drop).
protected void setUI(ComponentUI newUI)
Задает делегат внешнего вида (look and feel) для этого компонента.
void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
Устанавливает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед тем, как этот компонент запросит фокус.
void setVisible(boolean aFlag)
Делает компонент видимым или невидимым.
void unregisterKeyboardAction(KeyStroke aKeyStroke)
Этот метод устарел.
void update(Graphics g)
Вызывает paint.

Методы, объявленные в классе Container

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
Модификатор и тип Метод Описание
Component add(Component comp)
Добавляет указанный компонент в конец этого контейнера.
Component add(Component comp, int index)
Добавляет указанный компонент в этот контейнер в заданную позицию.
void add(Component comp, Object constraints)
Добавляет указанный компонент в конец этого контейнера.
void add(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер с указанными ограничениями по указанному индексу.
Component add(String name, Component comp)
Добавляет указанный компонент в этот контейнер.
void addContainerListener(ContainerListener l)
Добавляет указанный прослушиватель контейнера для получения событий контейнера от этого контейнера.
protected void addImpl(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер по указанному индексу.
void addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener в список прослушивателей.
void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Добавляет PropertyChangeListener в список прослушивателей для определенного свойства.
void applyComponentOrientation(ComponentOrientation o)
Задает свойство ComponentOrientation этого контейнера и всех содержащихся в нем компонентов.
boolean areFocusTraversalKeysSet(int id)
Возвращает значение, указывающее, был ли явно определен набор (Set) клавиш обхода фокуса для заданной операции обхода фокуса для этого Container.
int countComponents()
Устарело.
Начиная с версии JDK 1.1, заменено на getComponentCount().
void deliverEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent e)
void doLayout()
Заставляет этот контейнер разместить свои компоненты.
Component findComponentAt(int x, int y)
Находит видимый дочерний компонент, содержащий указанную позицию.
Component findComponentAt(Point p)
Находит видимый дочерний компонент, содержащий указанную точку.
Component getComponent(int n)
Возвращает n-й компонент в этом контейнере.
Component getComponentAt(int x, int y)
Находит компонент, содержащий позицию x,y.
Component getComponentAt(Point p)
Возвращает компонент, содержащий указанную точку.
int getComponentCount()
Возвращает количество компонентов в этой панели.
Component[] getComponents()
Возвращает все компоненты в этом контейнере.
int getComponentZOrder(Component comp)
Возвращает индекс z-порядка компонента внутри контейнера.
ContainerListener[] getContainerListeners()
Возвращает массив всех прослушивателей контейнера, зарегистрированных для этого контейнера.
Set<AWTKeyStroke> getFocusTraversalKeys(int id)
Возвращает набор (Set) клавиш обхода фокуса для заданной операции обхода для этого Container.
FocusTraversalPolicy getFocusTraversalPolicy()
Возвращает политику обхода фокуса, которая будет управлять переходом с помощью клавиатуры по дочерним элементам этого Container, или null, если этот Container не является корнем цикла обхода фокуса.
LayoutManager getLayout()
Возвращает менеджер компоновки для этого контейнера.
Point getMousePosition(boolean allowChildren)
Возвращает положение указателя мыши в координатном пространстве этого Container, если Container находится под указателем мыши, в противном случае возвращает null.
Insets insets()
Устарело.
Начиная с версии JDK 1.1, заменено на getInsets().
void invalidate()
Делает контейнер недействительным.
boolean isAncestorOf(Component c)
Проверяет, содержится ли компонент в иерархии компонентов этого контейнера.
boolean isFocusCycleRoot()
Возвращает значение, указывающее, является ли этот Container корнем цикла обхода фокуса.
boolean isFocusCycleRoot(Container container)
Возвращает значение, указывающее, является ли указанный Container корнем цикла обхода фокуса для цикла обхода фокуса этого Container.
final boolean isFocusTraversalPolicyProvider()
Возвращает значение, указывающее, предоставляет ли этот контейнер политику обхода фокуса.
boolean isFocusTraversalPolicySet()
Возвращает значение, указывающее, была ли явно задана политика обхода фокуса для этого Container.
void layout()
Устарело.
Начиная с версии JDK 1.1, заменено на doLayout().
void list(PrintStream out, int indent)
Выводит список этого контейнера в указанный выходной поток.
void list(PrintWriter out, int indent)
Выводит список, начиная с указанного отступа, в указанный модуль записи печати (print writer).
Component locate(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на getComponentAt(int, int).
Dimension minimumSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getMinimumSize().
void paintComponents(Graphics g)
Отрисовывает каждый из компонентов в этом контейнере.
Dimension preferredSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getPreferredSize().
void printComponents(Graphics g)
Печатает каждый из компонентов в этом контейнере.
protected void processContainerEvent(ContainerEvent e)
Обрабатывает события контейнера, происходящие в этом контейнере, диспетчеризируя их любым зарегистрированным объектам ContainerListener.
protected void processEvent(AWTEvent e)
Обрабатывает события в этом контейнере.
void remove(int index)
Удаляет компонент, указанный с помощью index, из этого контейнера.
void remove(Component comp)
Удаляет указанный компонент из этого контейнера.
void removeAll()
Удаляет все компоненты из этого контейнера.
void removeContainerListener(ContainerListener l)
Удаляет указанный прослушиватель контейнера, чтобы он больше не получал события контейнера от этого контейнера.
void setComponentZOrder(Component comp, int index)
Перемещает указанный компонент на указанный индекс z-порядка в контейнере.
void setFocusCycleRoot(boolean focusCycleRoot)
Задает, является ли этот Container корнем цикла обхода фокуса.
void setFocusTraversalPolicy(FocusTraversalPolicy policy)
Задает политику обхода фокуса, которая будет управлять переходом по клавишам по дочерним элементам этого Container, если этот Container является корнем цикла обхода фокуса.
final void setFocusTraversalPolicyProvider(boolean provider)
Задает, будет ли этот контейнер использоваться для предоставления политики обхода фокуса.
void setLayout(LayoutManager mgr)
Задает менеджер компоновки для этого контейнера.
void transferFocusDownCycle()
Передает фокус на один цикл обхода фокуса вниз.
void validate()
Проверяет допустимость этого контейнера и всех его подкомпонентов.
protected void validateTree()
Рекурсивно спускается по дереву контейнеров и повторно вычисляет компоновку для любых поддеревьев, помеченных как нуждающиеся в этом (помеченных как недействительные).

Методы, объявленные в классе Component

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, 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, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
Модификатор и тип Метод Описание
boolean action(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, следует регистрировать этот компонент как ActionListener на компоненте, генерирующем события действия.
void add(PopupMenu popup)
Добавляет указанное всплывающее меню к компоненту.
void addComponentListener(ComponentListener l)
Добавляет указанный слушатель компонентов для получения событий компонента от этого компонента.
void addFocusListener(FocusListener l)
Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента, когда этот компонент получает фокус ввода.
void addHierarchyBoundsListener(HierarchyBoundsListener l)
Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит данный контейнер.
void addHierarchyListener(HierarchyListener l)
Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит данный контейнер.
void addInputMethodListener(InputMethodListener l)
Добавляет указанный слушатель методов ввода для получения событий метода ввода от этого компонента.
void addKeyListener(KeyListener l)
Добавляет указанный слушатель клавиатуры для получения событий клавиш от этого компонента.
void addMouseListener(MouseListener l)
Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
void addMouseMotionListener(MouseMotionListener l)
Добавляет указанный слушатель перемещения мыши для получения событий перемещения мыши от этого компонента.
void addMouseWheelListener(MouseWheelListener l)
Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента.
Rectangle bounds()
Устарело.
Начиная с версии JDK 1.1, заменено на getBounds().
int checkImage(Image image, int width, int height, ImageObserver observer)
Возвращает статус построения экранного представления указанного изображения.
int checkImage(Image image, ImageObserver observer)
Возвращает статус построения экранного представления указанного изображения.
protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)
Потенциально объединяет отправляемое событие с существующим событием.
boolean contains(Point p)
Проверяет, содержит ли этот компонент указанную точку, где координаты x и y точки определены относительно системы координат этого компонента.
Image createImage(int width, int height)
Создает закадровое отрисовываемое изображение, используемое для двойной буферизации.
Image createImage(ImageProducer producer)
Создает изображение из указанного поставщика изображений.
VolatileImage createVolatileImage(int width, int height)
Создает энергонезависимое закадровое отрисовываемое изображение, используемое для двойной буферизации.
VolatileImage createVolatileImage(int width, int height, ImageCapabilities caps)
Создает энергонезависимое закадровое отрисовываемое изображение с заданными возможностями.
protected final void disableEvents(long eventsToDisable)
Отключает доставку событий, определенных указанным параметром маски событий, этому компоненту.
final void dispatchEvent(AWTEvent e)
Диспетчеризует событие этому компоненту или одному из его подкомпонентов.
void enable(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setEnabled(boolean).
protected final void enableEvents(long eventsToEnable)
Включает доставку событий, определенных указанным параметром маски событий, этому компоненту.
void enableInputMethods(boolean enable)
Включает или отключает поддержку методов ввода для этого компонента.
void firePropertyChange(String propertyName, byte oldValue, byte newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, char oldValue, char newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, double oldValue, double newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, float oldValue, float newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, long oldValue, long newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, short oldValue, short newValue)
Сообщает об изменении связанного свойства.
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
Поддержка оповещения об изменениях связанных свойств типа Object.
Color getBackground()
Возвращает цвет фона этого компонента.
Rectangle getBounds()
Возвращает границы этого компонента в виде объекта Rectangle.
ColorModel getColorModel()
Возвращает экземпляр ColorModel, используемый для отображения компонента на устройстве вывода.
ComponentListener[] getComponentListeners()
Возвращает массив всех слушателей компонентов, зарегистрированных для этого компонента.
ComponentOrientation getComponentOrientation()
Получает языковую ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
Cursor getCursor()
Возвращает курсор, установленный для компонента.
DropTarget getDropTarget()
Возвращает DropTarget, связанный с этим Component.
Container getFocusCycleRootAncestor()
Возвращает Container, который является корнем цикла обхода фокуса для цикла обхода фокуса этого Component.
FocusListener[] getFocusListeners()
Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
boolean getFocusTraversalKeysEnabled()
Возвращает, включены ли клавиши обхода фокуса для этого Component.
Font getFont()
Возвращает шрифт этого компонента.
Color getForeground()
Возвращает цвет переднего плана этого компонента.
GraphicsConfiguration getGraphicsConfiguration()
Возвращает GraphicsConfiguration, связанный с этим Component.
HierarchyBoundsListener[] getHierarchyBoundsListeners()
Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
HierarchyListener[] getHierarchyListeners()
Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
boolean getIgnoreRepaint()
Возвращает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
InputContext getInputContext()
Возвращает контекст ввода, используемый этим компонентом для обработки взаимодействия с методами ввода при вводе текста в этот компонент.
InputMethodListener[] getInputMethodListeners()
Возвращает массив всех слушателей методов ввода, зарегистрированных для этого компонента.
InputMethodRequests getInputMethodRequests()
Возвращает обработчик запросов метода ввода, который поддерживает запросы от методов ввода для этого компонента.
KeyListener[] getKeyListeners()
Возвращает массив всех слушателей клавиатуры, зарегистрированных для этого компонента.
Locale getLocale()
Возвращает локаль этого компонента.
Point getLocation()
Возвращает положение этого компонента в виде точки, задающей левый верхний угол компонента.
Point getLocationOnScreen()
Возвращает положение этого компонента в виде точки, определяющей левый верхний угол компонента в пространстве координат экрана.
MouseListener[] getMouseListeners()
Возвращает массив всех слушателей мыши, зарегистрированных для этого компонента.
MouseMotionListener[] getMouseMotionListeners()
Возвращает массив всех слушателей перемещения мыши, зарегистрированных для этого компонента.
Point getMousePosition()
Возвращает положение указателя мыши в координатном пространстве этого Component, если Component находится непосредственно под указателем мыши, в противном случае возвращает null.
MouseWheelListener[] getMouseWheelListeners()
Возвращает массив всех слушателей колесика мыши, зарегистрированных для этого компонента.
String getName()
Возвращает имя компонента.
Container getParent()
Возвращает родительский элемент этого компонента.
PropertyChangeListener[] getPropertyChangeListeners()
Возвращает массив всех слушателей изменения свойств, зарегистрированных для этого компонента.
PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Возвращает массив всех слушателей, связанных с именованным свойством.
Dimension getSize()
Возвращает размер этого компонента в виде объекта Dimension.
Toolkit getToolkit()
Возвращает инструментарий (toolkit) этого компонента.
final Object getTreeLock()
Возвращает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потока) для операций с деревом компонентов AWT и разметкой.
boolean gotFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
boolean handleEvent(Event evt)
Устарело.
Начиная с версии JDK 1.1, заменено на processEvent(AWTEvent).
boolean hasFocus()
Возвращает true, если этот Component является владельцем фокуса.
boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Перерисовывает компонент при изменении изображения.
boolean inside(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на contains(int, int).
boolean isBackgroundSet()
Возвращает, был ли цвет фона явно установлен для этого Component.
boolean isCursorSet()
Возвращает, был ли курсор явно установлен для этого Component.
boolean isDisplayable()
Определяет, отображаем ли этот компонент.
boolean isEnabled()
Определяет, включен ли этот компонент.
boolean isFocusable()
Возвращает, может ли этот Component получать фокус.
boolean isFocusOwner()
Возвращает true, если этот Component является владельцем фокуса.
boolean isFocusTraversable()
Устарело.
Начиная с версии 1.4, заменено на isFocusable().
boolean isFontSet()
Возвращает, был ли шрифт явно установлен для этого Component.
boolean isForegroundSet()
Возвращает, был ли цвет переднего плана явно установлен для этого Component.
boolean isLightweight()
Облегченный компонент не имеет собственного пира инструментария (native toolkit peer).
boolean isMaximumSizeSet()
Возвращает true, если максимальный размер был установлен в значение, отличное от null, иначе возвращает false.
boolean isMinimumSizeSet()
Возвращает, был ли вызван метод setMinimumSize со значением, отличным от null.
boolean isPreferredSizeSet()
Возвращает true, если предпочтительный размер был установлен в значение, отличное от null, иначе возвращает false.
boolean isShowing()
Определяет, отображается ли этот компонент на экране.
boolean isValid()
Определяет, является ли этот компонент корректным (valid).
boolean isVisible()
Определяет, должен ли этот компонент быть видимым, когда видим его родительский элемент.
boolean keyDown(Event evt, int key)
Устарело.
Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
boolean keyUp(Event evt, int key)
Устарело.
Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
void list()
Выводит список этого компонента в стандартный поток системного вывода System.out.
void list(PrintStream out)
Выводит список этого компонента в указанный поток вывода.
void list(PrintWriter out)
Выводит список в указанный print writer.
Point location()
Устарело.
Начиная с версии JDK 1.1, заменено на getLocation().
boolean lostFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
boolean mouseDown(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseDrag(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
boolean mouseEnter(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseExit(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseMove(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
boolean mouseUp(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
void move(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на setLocation(int, int).
void nextFocus()
Устарело.
Начиная с версии JDK 1.1, заменено на transferFocus().
void paintAll(Graphics g)
Отрисовывает этот компонент и все его подкомпоненты.
boolean postEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent).
boolean prepareImage(Image image, int width, int height, ImageObserver observer)
Подготавливает изображение для отрисовки на этом компоненте с указанными шириной и высотой.
boolean prepareImage(Image image, ImageObserver observer)
Подготавливает изображение для отрисовки на этом компоненте.
protected void processComponentEvent(ComponentEvent e)
Обрабатывает события компонента, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам ComponentListener.
protected void processFocusEvent(FocusEvent e)
Обрабатывает события фокуса, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам FocusListener.
protected void processHierarchyBoundsEvent(HierarchyEvent e)
Обрабатывает события границ иерархии, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам HierarchyBoundsListener.
protected void processHierarchyEvent(HierarchyEvent e)
Обрабатывает события иерархии, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам HierarchyListener.
protected void processInputMethodEvent(InputMethodEvent e)
Обрабатывает события метода ввода, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам InputMethodListener.
protected void processMouseWheelEvent(MouseWheelEvent e)
Обрабатывает события колесика мыши, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам MouseWheelListener.
void remove(MenuComponent popup)
Удаляет указанное всплывающее меню из компонента.
void removeComponentListener(ComponentListener l)
Удаляет указанный слушатель компонентов, чтобы он больше не получал события компонента от этого компонента.
void removeFocusListener(FocusListener l)
Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
void removeHierarchyBoundsListener(HierarchyBoundsListener l)
Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
void removeHierarchyListener(HierarchyListener l)
Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
void removeInputMethodListener(InputMethodListener l)
Удаляет указанный слушатель методов ввода, чтобы он больше не получал события метода ввода от этого компонента.
void removeKeyListener(KeyListener l)
Удаляет указанный слушатель клавиатуры, чтобы он больше не получал события клавиш от этого компонента.
void removeMouseListener(MouseListener l)
Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента.
void removeMouseMotionListener(MouseMotionListener l)
Удаляет указанный слушатель перемещения мыши, чтобы он больше не получал события перемещения мыши от этого компонента.
void removeMouseWheelListener(MouseWheelListener l)
Удаляет указанный слушатель колесика мыши, чтобы он больше не получал события колесика мыши от этого компонента.
void removePropertyChangeListener(PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей.
void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей для указанного свойства.
void repaint()
Перерисовывает этот компонент.
void repaint(int x, int y, int width, int height)
Перерисовывает указанную прямоугольную область этого компонента.
void repaint(long tm)
Перерисовывает компонент.
protected boolean requestFocus(boolean temporary, FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, и чтобы предок верхнего уровня этого Component стал сфокусированным Window.
void requestFocus(FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, и чтобы предок верхнего уровня этого Component стал сфокусированным Window.
boolean requestFocusInWindow(FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, если предок верхнего уровня этого Component уже является сфокусированным Window.
void resize(int width, int height)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(int, int).
void resize(Dimension d)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(Dimension).
void setBounds(int x, int y, int width, int height)
Перемещает и изменяет размер этого компонента.
void setBounds(Rectangle r)
Перемещает и изменяет размер этого компонента в соответствии с новым ограничивающим прямоугольником r.
void setComponentOrientation(ComponentOrientation o)
Задает языковую ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
void setCursor(Cursor cursor)
Устанавливает изображение курсора в указанный курсор.
void setDropTarget(DropTarget dt)
Связывает DropTarget с этим компонентом.
void setFocusable(boolean focusable)
Устанавливает состояние фокусируемости этого Component в указанное значение.
void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
Задает, включены ли клавиши обхода фокуса для этого Component.
void setIgnoreRepaint(boolean ignoreRepaint)
Задает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
void setLocale(Locale l)
Устанавливает локаль этого компонента.
void setLocation(int x, int y)
Перемещает этот компонент на новую позицию.
void setLocation(Point p)
Перемещает этот компонент на новую позицию.
void setMixingCutoutShape(Shape shape)
Задает фигуру «mixing-cutout» для этого облегченного компонента.
void setName(String name)
Задает имя компонента равным указанной строке.
void setSize(int width, int height)
Изменяет размер этого компонента так, чтобы он имел ширину width и высоту height.
void setSize(Dimension d)
Изменяет размер этого компонента так, чтобы он имел ширину d.width и высоту d.height.
void show()
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).
void show(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).
Dimension size()
Устарело.
Начиная с версии JDK 1.1, заменено на getSize().
String toString()
Возвращает строковое представление этого компонента и его значений.
void transferFocus()
Передает фокус следующему компоненту, как если бы этот Component являлся владельцем фокуса.
void transferFocusBackward()
Передает фокус предыдущему компоненту, как если бы этот Component являлся владельцем фокуса.
void transferFocusUpCycle()
Перемещает фокус на один цикл обхода фокуса вверх.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, "равен" ли какой-либо другой объект этому.
protected void finalize()
Устарело, для удаления: этот элемент API подлежит удалению в будущей версии.
Финализация устарела и подлежит удалению в будущей версии.
final Class<?> getClass()
Возвращает класс времени выполнения данного Object.
int hashCode()
Возвращает значение хэш-кода для этого объекта.
final void notify()
Возобновляет работу одного потока, ожидающего на мониторе этого объекта.
final void notifyAll()
Возобновляет работу всех потоков, ожидающих на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет определенное время.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет определенное время.

Подробное описание полей

VERTICAL

public static final int VERTICAL
Указывает на вертикальное расположение ячеек в один столбец; компоновка по умолчанию.
Since:
1.4
See Also:
  • setLayoutOrientation(int)
  • Постоянные значения полей

VERTICAL_WRAP

public static final int VERTICAL_WRAP
Указывает на компоновку в «газетном стиле», при которой ячейки заполняются по вертикали, а затем по горизонтали.
Since:
1.4
See Also:
  • setLayoutOrientation(int)
  • Постоянные значения полей

HORIZONTAL_WRAP

public static final int HORIZONTAL_WRAP
Указывает на компоновку в «газетном стиле», при которой ячейки заполняются по горизонтали, а затем по вертикали.
Since:
1.4
See Also:
  • setLayoutOrientation(int)
  • Постоянные значения полей

Подробное описание конструкторов

JList

public JList(ListModel<E> dataModel)
Создает JList, отображающий элементы из указанной модели, отличной от non-null. Все конструкторы JList делегируют вызов этому конструктору.

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

Parameters:
dataModel - модель для списка
Throws:
IllegalArgumentException - если модель равна null

JList

public JList(E[] listData)
Создает JList, отображающий элементы из указанного массива. Этот конструктор создает модель только для чтения для заданного массива, а затем делегирует вызов конструктору, принимающему ListModel.

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

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

JList

public JList(Vector<? extends E> listData)
Создает JList, отображающий элементы из указанного Vector. Этот конструктор создает модель только для чтения для заданного Vector, а затем делегирует вызов конструктору, принимающему ListModel.

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

Parameters:
listData - Vector для загрузки в модель данных, non-null

JList

public JList()
Создает JList с пустой моделью только для чтения.

Подробное описание методов

getUI

public ListUI getUI()
Возвращает ListUI, объект внешнего вида и функциональности, который отрисовывает этот компонент.
Overrides:
getUI в классе JComponent
Returns:
объект ListUI, который отрисовывает этот компонент

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") public void setUI(ListUI ui)
Устанавливает ListUI, объект внешнего вида и функциональности, который отрисовывает этот компонент.
Parameters:
ui - объект ListUI
See Also:
  • UIDefaults.getUI(JComponent)

updateUI

public void updateUI()
Сбрасывает свойство ListUI, устанавливая его в значение, предоставляемое текущим внешним видом и функциональностью. Если текущее средство отрисовки ячеек было установлено разработчиком (а не самим внешним видом и функциональностью), это также приводит к обновлению средства отрисовки ячеек и его дочерних элементов путем вызова на нем SwingUtilities.updateComponentTreeUI.
Overrides:
updateUI в классе JComponent
See Also:
  • UIManager.getUI(JComponent)
  • SwingUtilities.updateComponentTreeUI(Component)

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает "ListUI", ключ UIDefaults, используемый для поиска имени класса javax.swing.plaf.ListUI, определяющего внешний вид и функциональность этого компонента.
Overrides:
getUIClassID в классе JComponent
Returns:
строку "ListUI"
See Also:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(JComponent)

getPrototypeCellValue

public E getPrototypeCellValue()
Возвращает «прототипное» значение ячейки — значение, используемое для вычисления фиксированной ширины и высоты ячеек. Оно может быть равно null, если такого значения нет.
Returns:
значение свойства prototypeCellValue
See Also:
  • setPrototypeCellValue(E)

setPrototypeCellValue

@BeanProperty(visualUpdate=true, description="The cell prototype value, used to compute cell width and height.") public void setPrototypeCellValue(E prototypeCellValue)
Устанавливает свойство prototypeCellValue, а затем (если новое значение отлично от non-null) вычисляет свойства fixedCellWidth и fixedCellHeight путем запроса компонента отрисовки ячейки для данного значения (и индекса 0) у средства отрисовки ячеек и использования предпочтительного размера этого компонента.

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

Хотя этот метод может изменять все три свойства (prototypeCellValue, fixedCellHeight и fixedCellWidth), уведомления PropertyChangeEvent отправляются только при изменении свойства prototypeCellValue.

Пример установки этого свойства приведен в описании класса выше.

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

Это связанное свойство JavaBeans (bound property).

Parameters:
prototypeCellValue - значение, на основе которого определяются fixedCellWidth и fixedCellHeight
See Also:
  • getPrototypeCellValue()
  • setFixedCellWidth(int)
  • setFixedCellHeight(int)
  • Container.addPropertyChangeListener(PropertyChangeListener)

getFixedCellWidth

public int getFixedCellWidth()
Возвращает значение свойства fixedCellWidth.
Returns:
фиксированную ширину ячейки
See Also:
  • setFixedCellWidth(int)

setFixedCellWidth

@BeanProperty(visualUpdate=true, description="Defines a fixed cell width when greater than zero.") public void setFixedCellWidth(int width)
Устанавливает фиксированное значение, используемое для ширины каждой ячейки в списке. Если width равно -1, ширина ячеек вычисляется в ListUI путем применения getPreferredSize к компоненту отрисовки ячейки для каждого элемента списка.

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

Это связанное свойство JavaBeans (bound property).

Parameters:
width - ширина, используемая для всех ячеек в списке
See Also:
  • setPrototypeCellValue(E)
  • getFixedCellWidth()
  • Container.addPropertyChangeListener(PropertyChangeListener)

getFixedCellHeight

public int getFixedCellHeight()
Возвращает значение свойства fixedCellHeight.
Returns:
фиксированную высоту ячейки
See Also:
  • setFixedCellHeight(int)

setFixedCellHeight

@BeanProperty(visualUpdate=true, description="Defines a fixed cell height when greater than zero.") public void setFixedCellHeight(int height)
Устанавливает фиксированное значение, используемое для высоты каждой ячейки в списке. Если height равно -1, высота ячеек вычисляется в ListUI путем применения getPreferredSize к компоненту отрисовки ячейки для каждого элемента списка.

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

Это связанное свойство JavaBeans (bound property).

Parameters:
height - высота, используемая для всех ячеек в списке
See Also:
  • setPrototypeCellValue(E)
  • setFixedCellWidth(int)
  • Container.addPropertyChangeListener(PropertyChangeListener)

getCellRenderer

public ListCellRenderer<? super E> getCellRenderer()
Возвращает объект, отвечающий за отрисовку элементов списка.
Returns:
значение свойства cellRenderer
See Also:
  • setCellRenderer(ListCellRenderer)

setCellRenderer

@BeanProperty(visualUpdate=true, description="The component used to draw the cells.") public void setCellRenderer(ListCellRenderer<? super E> cellRenderer)
Устанавливает делегат, который используется для отрисовки каждой ячейки в списке. Задачи средства отрисовки ячеек подробно рассматриваются в документации уровня класса.

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

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

Это связанное свойство JavaBeans (bound property).

Parameters:
cellRenderer - ListCellRenderer, выполняющий отрисовку ячеек списка
See Also:
  • getCellRenderer()

getSelectionForeground

public Color getSelectionForeground()
Возвращает цвет, используемый для отображения переднего плана (текста) выбранных элементов. DefaultListCellRenderer использует этот цвет для отрисовки переднего плана элементов в выбранном состоянии, как и средства отрисовки, установленные большинством реализаций ListUI.
Returns:
цвет для отрисовки переднего плана выбранных элементов
See Also:
  • setSelectionForeground(Color)
  • DefaultListCellRenderer

setSelectionForeground

@BeanProperty(visualUpdate=true, description="The foreground color of selected cells.") public void setSelectionForeground(Color selectionForeground)
Устанавливает цвет, используемый для отображения переднего плана выбранных элементов, который средства отрисовки ячеек могут использовать для отображения текста и графики. DefaultListCellRenderer использует этот цвет для отрисовки переднего плана элементов в выбранном состоянии, как и средства отрисовки, установленные большинством реализаций ListUI.

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

Это связанное свойство JavaBeans (bound property).

Parameters:
selectionForeground - Color для использования в качестве цвета переднего плана для выбранных элементов списка
See Also:
  • getSelectionForeground()
  • setSelectionBackground(Color)
  • JComponent.setForeground(Color)
  • JComponent.setBackground(Color)
  • JComponent.setFont(Font)
  • DefaultListCellRenderer

getSelectionBackground

public Color getSelectionBackground()
Возвращает цвет, используемый для отображения фона выбранных элементов. DefaultListCellRenderer использует этот цвет для отрисовки фона элементов в выбранном состоянии, как и средства отрисовки, установленные большинством реализаций ListUI.
Returns:
цвет для отрисовки фона выбранных элементов
See Also:
  • setSelectionBackground(Color)
  • DefaultListCellRenderer

setSelectionBackground

@BeanProperty(visualUpdate=true, description="The background color of selected cells.") public void setSelectionBackground(Color selectionBackground)
Устанавливает цвет, используемый для отображения фона выбранных элементов, который средства отрисовки ячеек могут использовать для заливки выбранных ячеек. DefaultListCellRenderer использует этот цвет для заливки фона элементов в выбранном состоянии, как и средства отрисовки, установленные большинством реализаций ListUI.

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

Это связанное свойство JavaBeans (bound property).

Parameters:
selectionBackground - Color для использования в качестве фона выбранных ячеек
See Also:
  • getSelectionBackground()
  • setSelectionForeground(Color)
  • JComponent.setForeground(Color)
  • JComponent.setBackground(Color)
  • JComponent.setFont(Font)
  • DefaultListCellRenderer

getVisibleRowCount

public int getVisibleRowCount()
Возвращает значение свойства visibleRowCount. Подробные сведения о том, как интерпретировать это значение, см. в документации для setVisibleRowCount(int).
Returns:
значение свойства visibleRowCount.
See Also:
  • setVisibleRowCount(int)

setVisibleRowCount

@BeanProperty(visualUpdate=true, description="The preferred number of rows to display without requiring scrolling") public void setVisibleRowCount(int visibleRowCount)
Устанавливает свойство visibleRowCount, которое имеет разное значение в зависимости от ориентации компоновки: для ориентации компоновки VERTICAL оно задает предпочтительное количество отображаемых строк без необходимости прокрутки; для других ориентаций оно влияет на перенос ячеек.

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

В ориентациях HORIZONTAL_WRAP и VERTICAL_WRAP:
Это влияет на способ переноса ячеек. Дополнительные сведения см. в документации по setLayoutOrientation(int).

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

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

Это связанное свойство JavaBeans (bound property).

Parameters:
visibleRowCount - целое число, указывающее предпочтительное количество строк для отображения без необходимости прокрутки
See Also:
  • getVisibleRowCount()
  • getPreferredScrollableViewportSize()
  • setLayoutOrientation(int)
  • JComponent.getVisibleRect()
  • JViewport

getLayoutOrientation

public int getLayoutOrientation()
Возвращает свойство ориентации компоновки для списка: VERTICAL, если компоновка представляет собой один столбец ячеек; VERTICAL_WRAP, если компоновка выполнена в «газетном стиле» с заполнением содержимого по вертикали, затем по горизонтали; или HORIZONTAL_WRAP, если компоновка выполнена в «газетном стиле» с заполнением содержимого по горизонтали, затем по вертикали.
Returns:
значение свойства layoutOrientation
Since:
1.4
See Also:
  • setLayoutOrientation(int)

setLayoutOrientation

@BeanProperty(visualUpdate=true, enumerationValues={"JList.VERTICAL","JList.HORIZONTAL_WRAP","JList.VERTICAL_WRAP"}, description="Defines the way list cells are laid out.") public void setLayoutOrientation(int layoutOrientation)
Определяет способ компоновки ячеек списка. Рассмотрим JList с пятью ячейками. Ячейки могут быть скомпонованы одним из следующих способов:
VERTICAL:          0
                   1
                   2
                   3
                   4

HORIZONTAL_WRAP:   0  1  2
                   3  4

VERTICAL_WRAP:     0  3
                   1  4
                   2

Ниже приведено описание этих компоновок:

Описывает компоновки VERTICAL, HORIZONTAL_WRAP и VERTICAL_WRAP
Значение Описание
VERTICAL Ячейки располагаются вертикально в один столбец.
HORIZONTAL_WRAP Ячейки располагаются горизонтально, переносясь на новую строку по мере необходимости. Если свойство visibleRowCount меньше или равно нулю, перенос определяется шириной списка; в противном случае перенос выполняется таким образом, чтобы обеспечить visibleRowCount строк в списке.
VERTICAL_WRAP Ячейки располагаются вертикально, переносясь в новый столбец по мере необходимости. Если свойство visibleRowCount меньше или равно нулю, перенос определяется высотой списка; в противном случае перенос выполняется по достижении visibleRowCount строк.
Значение этого свойства по умолчанию — VERTICAL.
Parameters:
layoutOrientation - новая ориентация компоновки, одно из значений: VERTICAL, HORIZONTAL_WRAP или VERTICAL_WRAP
Throws:
IllegalArgumentException - если layoutOrientation не является одним из допустимых значений
Since:
1.4
See Also:
  • getLayoutOrientation()
  • setVisibleRowCount(int)
  • getScrollableTracksViewportHeight()
  • getScrollableTracksViewportWidth()

getFirstVisibleIndex

@BeanProperty(bound=false) public int getFirstVisibleIndex()
Возвращает наименьший индекс списка, который виден в данный момент. При ориентации слева направо componentOrientation первая видимая ячейка находится ближе всего к верхнему левому углу списка. При ориентации справа налево она находится ближе всего к верхнему правому углу. Если ничего не видно или список пуст, возвращается -1. Обратите внимание, что возвращаемая ячейка может быть видима лишь частично.
Returns:
индекс первой видимой ячейки
See Also:
  • getLastVisibleIndex()
  • JComponent.getVisibleRect()

getLastVisibleIndex

@BeanProperty(bound=false) public int getLastVisibleIndex()
Возвращает наибольший индекс списка, который виден в данный момент. Если ничего не видно или список пуст, возвращается -1. Обратите внимание, что возвращаемая ячейка может быть видима лишь частично.
Returns:
индекс последней видимой ячейки
See Also:
  • getFirstVisibleIndex()
  • JComponent.getVisibleRect()

ensureIndexIsVisible

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

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

Parameters:
index - индекс ячейки, которую необходимо сделать видимой
See Also:
  • JComponent.scrollRectToVisible(Rectangle)
  • JComponent.getVisibleRect()

setDragEnabled

@BeanProperty(bound=false, description="determines whether automatic drag handling is enabled") public void setDragEnabled(boolean b)
Включает или выключает автоматическую обработку перетаскивания. Чтобы включить автоматическую обработку перетаскивания, для этого свойства должно быть установлено значение true, а TransferHandler списка не должен быть равен non-null. Значение свойства dragEnabled по умолчанию — false.

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

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

Parameters:
b - включить или выключить автоматическую обработку перетаскивания
Throws:
HeadlessException - если b равен true и GraphicsEnvironment.isHeadless() возвращает true
Since:
1.4
See Also:
  • GraphicsEnvironment.isHeadless()
  • getDragEnabled()
  • JComponent.setTransferHandler(TransferHandler)
  • TransferHandler

getDragEnabled

public boolean getDragEnabled()
Возвращает значение, указывающее, включена ли автоматическая обработка перетаскивания.
Returns:
значение свойства dragEnabled
Since:
1.4
See Also:
  • setDragEnabled(boolean)

setDropMode

public final void setDropMode(DropMode dropMode)
Устанавливает режим сброса (drop mode) для этого компонента. Для обратной совместимости значением по умолчанию для этого свойства является DropMode.USE_SELECTION. Однако для улучшения взаимодействия с пользователем рекомендуется использовать один из других режимов. Например, DropMode.ON предлагает аналогичное поведение с отображением элементов как выбранных, но делает это без изменения фактического выделения в списке.

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

  • DropMode.USE_SELECTION
  • DropMode.ON
  • DropMode.INSERT
  • DropMode.ON_OR_INSERT
Режим сброса имеет значение только в том случае, если этот компонент имеет TransferHandler, принимающий сброс данных.
Parameters:
dropMode - используемый режим сброса
Throws:
IllegalArgumentException - если режим сброса не поддерживается или равен null
Since:
1.6
See Also:
  • getDropMode()
  • getDropLocation()
  • JComponent.setTransferHandler(TransferHandler)
  • TransferHandler

getDropMode

public final DropMode getDropMode()
Возвращает режим сброса для этого компонента.
Returns:
режим сброса для этого компонента
Since:
1.6
See Also:
  • setDropMode(DropMode)

getDropLocation

@BeanProperty(bound=false) public final JList.DropLocation getDropLocation()
Возвращает местоположение, которое этот компонент должен визуально отображать как место сброса во время операции DnD над компонентом, или null, если в данный момент местоположение отображаться не должно.

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

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

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

Returns:
место сброса
Since:
1.6
See Also:
  • setDropMode(DropMode)
  • TransferHandler.canImport(TransferHandler.TransferSupport)

getNextMatch

public int getNextMatch(String prefix, int startIndex, Position.Bias bias)
Возвращает следующий элемент списка, значение toString которого начинается с заданного префикса.
Parameters:
prefix - строка для проверки совпадения
startIndex - индекс для начала поиска
bias - направление поиска, либо Position.Bias.Forward, либо Position.Bias.Backward.
Returns:
индекс следующего элемента списка, начинающегося с префикса; в противном случае -1
Throws:
IllegalArgumentException - если префикс равен null или startIndex выходит за границы
Since:
1.4

getToolTipText

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

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

Overrides:
getToolTipText в классе JComponent
Parameters:
event - объект MouseEvent, для которого извлекается текст подсказки
Returns:
строка, содержащая всплывающую подсказку
See Also:
  • JComponent.setToolTipText(String)
  • JComponent.getToolTipText()

locationToIndex

public int locationToIndex(Point location)
Возвращает индекс ячейки, ближайшей к заданной точке в системе координат списка. Чтобы определить, действительно ли ячейка содержит указанную точку, сравните точку с границами ячейки, возвращаемыми методом getCellBounds. Этот метод возвращает -1, если модель пуста

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

Parameters:
location - координаты точки
Returns:
индекс ячейки, ближайшей к заданной точке, или -1

indexToLocation

public Point indexToLocation(int index)
Возвращает начало координат указанного элемента в системе координат списка. Этот метод возвращает null, если индекс недопустим.

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

Parameters:
index - индекс ячейки
Returns:
начало координат ячейки или null

getCellBounds

public Rectangle getCellBounds(int index0, int index1)
Возвращает ограничивающий прямоугольник в системе координат списка для диапазона ячеек, заданного двумя индексами. Эти индексы могут быть переданы в любом порядке.

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

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

Parameters:
index0 - первый индекс в диапазоне
index1 - второй индекс в диапазоне
Returns:
ограничивающий прямоугольник для диапазона ячеек или null

getModel

public ListModel<E> getModel()
Возвращает модель данных, содержащую список элементов, отображаемых компонентом JList.
Returns:
ListModel, предоставляющий отображаемый список элементов
See Also:
  • setModel(ListModel)

setModel

@BeanProperty(visualUpdate=true, description="The object that contains the data to be drawn by this JList.") public void setModel(ListModel<E> model)
Устанавливает модель, представляющую содержимое или "значение" списка, уведомляет слушателей изменения свойств и затем очищает выборку в списке.

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

Parameters:
model - ListModel, предоставляющий список элементов для отображения
Throws:
IllegalArgumentException - если model равен null
See Also:
  • getModel()
  • clearSelection()

setListData

public void setListData(E[] listData)
Создает доступную только для чтения модель ListModel из массива элементов и вызывает метод setModel с этой моделью.

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

Parameters:
listData - массив объектов E, содержащий элементы для отображения в списке
See Also:
  • setModel(ListModel)

setListData

public void setListData(Vector<? extends E> listData)
Создает доступную только для чтения модель ListModel из объекта Vector и вызывает метод setModel с этой моделью.

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

Parameters:
listData - объект Vector, содержащий элементы для отображения в списке
See Also:
  • setModel(ListModel)

createSelectionModel

protected ListSelectionModel createSelectionModel()
Возвращает экземпляр DefaultListSelectionModel; вызывается во время конструирования для инициализации свойства модели выделения списка.
Returns:
объект DefaultListSelectionModel, используемый для инициализации свойства модели выделения списка во время конструирования
See Also:
  • setSelectionModel(ListSelectionModel)
  • DefaultListSelectionModel

getSelectionModel

public ListSelectionModel getSelectionModel()
Возвращает текущую модель выделения. Модель выделения управляет состоянием выделения элементов списка. Дополнительные сведения см. в документации на уровне класса.
Returns:
ListSelectionModel, управляющий выделением элементов списка
See Also:
  • setSelectionModel(ListSelectionModel)
  • ListSelectionModel

fireSelectionValueChanged

protected void fireSelectionValueChanged(int firstIndex, int lastIndex, boolean isAdjusting)
Уведомляет слушателей ListSelectionListener, добавленных непосредственно к списку, об изменениях выборки, внесенных в модель выделения. JList прослушивает изменения выделения в модели выделения и пересылает уведомления слушателям, добавленным непосредственно к списку, путем вызова этого метода.

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

Parameters:
firstIndex - первый индекс в диапазоне, <= lastIndex
lastIndex - последний индекс в диапазоне, >= firstIndex
isAdjusting - является ли это событие одним из серии событий, где изменения все еще продолжаются
See Also:
  • addListSelectionListener(ListSelectionListener)
  • removeListSelectionListener(ListSelectionListener)
  • ListSelectionEvent
  • EventListenerList

addListSelectionListener

public void addListSelectionListener(ListSelectionListener listener)
Добавляет слушателя к списку для получения уведомлений при каждом изменении состояния выделения; предпочтительный способ прослушивания изменений состояния выделения. JList берет на себя отслеживание изменений состояния выделения в модели выделения и уведомляет указанного слушателя о каждом изменении. Объекты ListSelectionEvent, отправляемые слушателю, имеют свойство source, указывающее на этот список.
Parameters:
listener - добавляемый слушатель ListSelectionListener
See Also:
  • getSelectionModel()
  • getListSelectionListeners()

removeListSelectionListener

public void removeListSelectionListener(ListSelectionListener listener)
Удаляет слушателя выделения из списка.
Parameters:
listener - удаляемый слушатель ListSelectionListener
See Also:
  • addListSelectionListener(ListSelectionListener)
  • getSelectionModel()

getListSelectionListeners

@BeanProperty(bound=false) public ListSelectionListener[] getListSelectionListeners()
Возвращает массив всех слушателей ListSelectionListener, добавленных к этому объекту JList с помощью addListSelectionListener.
Returns:
все слушатели ListSelectionListener этого списка или пустой массив, если слушатели не были добавлены
Since:
1.4
See Also:
  • addListSelectionListener(ListSelectionListener)

setSelectionModel

@BeanProperty(description="The selection model, recording which cells are selected.") public void setSelectionModel(ListSelectionModel selectionModel)
Устанавливает selectionModel для списка в отличную от null реализацию ListSelectionModel. Модель выделения берет на себя задачу выполнения одиночного выделения, выделения непрерывных диапазонов и несмежных элементов.

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

Parameters:
selectionModel - ListSelectionModel, реализующий управление выделением
Throws:
IllegalArgumentException - если selectionModel имеет значение null
See Also:
  • getSelectionModel()

setSelectionMode

@BeanProperty(bound=false, enumerationValues={"ListSelectionModel.SINGLE_SELECTION","ListSelectionModel.SINGLE_INTERVAL_SELECTION","ListSelectionModel.MULTIPLE_INTERVAL_SELECTION"}, description="The selection mode.") public void setSelectionMode(int selectionMode)
Устанавливает режим выделения для списка. Это метод-обертка, который устанавливает режим выделения непосредственно в модели выделения.

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

  • ListSelectionModel.SINGLE_SELECTION - Одновременно может быть выбран только один индекс списка. В этом режиме методы setSelectionInterval и addSelectionInterval эквивалентны, и оба заменяют текущее выделение индексом, представленным вторым аргументом ("lead").
  • ListSelectionModel.SINGLE_INTERVAL_SELECTION - Одновременно может быть выбран только один непрерывный интервал. В этом режиме addSelectionInterval ведет себя как setSelectionInterval (заменяя текущее выделение), за исключением случаев, когда заданный интервал непосредственно примыкает к существующему выделению или перекрывает его, и может использоваться для расширения выделения.
  • ListSelectionModel.MULTIPLE_INTERVAL_SELECTION - В этом режиме нет ограничений на то, что может быть выделено. Этот режим используется по умолчанию.
Parameters:
selectionMode - режим выделения
Throws:
IllegalArgumentException - если указанный режим выделения не входит в число допустимых
See Also:
  • getSelectionMode()

getSelectionMode

public int getSelectionMode()
Возвращает текущий режим выделения для списка. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.
Returns:
текущий режим выделения
See Also:
  • setSelectionMode(int)

getAnchorSelectionIndex

@BeanProperty(bound=false) public int getAnchorSelectionIndex()
Возвращает опорный индекс выделения (anchor). Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.
Returns:
опорный индекс выделения
See Also:
  • ListSelectionModel.getAnchorSelectionIndex()

getLeadSelectionIndex

@BeanProperty(bound=false, description="The lead selection index.") public int getLeadSelectionIndex()
Возвращает лидирующий индекс выделения (lead). Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.
Returns:
лидирующий индекс выделения
See Also:
  • ListSelectionModel.getLeadSelectionIndex()

getMinSelectionIndex

@BeanProperty(bound=false) public int getMinSelectionIndex()
Возвращает наименьший индекс выбранной ячейки или -1, если выделение пусто. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.
Returns:
наименьший индекс выбранной ячейки или -1
See Also:
  • ListSelectionModel.getMinSelectionIndex()

getMaxSelectionIndex

@BeanProperty(bound=false) public int getMaxSelectionIndex()
Возвращает наибольший индекс выбранной ячейки или -1, если выделение пусто. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.
Returns:
наибольший индекс выбранной ячейки
See Also:
  • ListSelectionModel.getMaxSelectionIndex()

isSelectedIndex

public boolean isSelectedIndex(int index)
Возвращает true, если указанный индекс выбран, иначе false. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.
Parameters:
index - индекс, состояние выделения которого проверяется
Returns:
true, если указанный индекс выбран, иначе false
See Also:
  • ListSelectionModel.isSelectedIndex(int)
  • setSelectedIndex(int)

isSelectionEmpty

@BeanProperty(bound=false) public boolean isSelectionEmpty()
Возвращает true, если ничего не выбрано, иначе false. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.
Returns:
true, если ничего не выбрано, иначе false
See Also:
  • ListSelectionModel.isSelectionEmpty()
  • clearSelection()

clearSelection

public void clearSelection()
Очищает выделение; после вызова этого метода метод isSelectionEmpty вернет true. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.
See Also:
  • ListSelectionModel.clearSelection()
  • isSelectionEmpty()

setSelectionInterval

public void setSelectionInterval(int anchor, int lead)
Выделяет указанный интервал. Включаются оба индекса: anchor и lead. Индекс anchor не обязательно должен быть меньше или равен lead. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.

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

Parameters:
anchor - первый индекс для выделения
lead - последний индекс для выделения
See Also:
  • 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.

Parameters:
anchor - первый индекс, добавляемый к выделению
lead - последний индекс, добавляемый к выделению
See Also:
  • 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.

Parameters:
index0 - первый индекс, удаляемый из выделения
index1 - последний индекс, удаляемый из выделения
See Also:
  • 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).

Parameters:
b - новое значение свойства
See Also:
  • ListSelectionModel.setValueIsAdjusting(boolean)
  • ListSelectionEvent.getValueIsAdjusting()
  • getValueIsAdjusting()

getValueIsAdjusting

public boolean getValueIsAdjusting()
Возвращает значение свойства isAdjusting модели выделения.

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

Returns:
значение свойства isAdjusting модели выделения.
See Also:
  • setValueIsAdjusting(boolean)
  • ListSelectionModel.getValueIsAdjusting()

getSelectedIndices

public int[] getSelectedIndices()
Возвращает массив всех выбранных индексов в порядке возрастания.
Returns:
все выбранные индексы в порядке возрастания или пустой массив, если ничего не выбрано
See Also:
  • removeSelectionInterval(int, int)
  • addListSelectionListener(ListSelectionListener)

setSelectedIndex

@BeanProperty(bound=false, description="The index of the selected cell.") public void setSelectedIndex(int index)
Выделяет одну ячейку. Ничего не делает, если указанный индекс больше или равен размеру модели. Это удобный метод, использующий setSelectionInterval в модели выделения. Обратитесь к документации используемого класса модели выделения для получения подробной информации о том, как обрабатываются значения меньше 0.
Parameters:
index - индекс ячейки для выделения
See Also:
  • ListSelectionModel.setSelectionInterval(int, int)
  • isSelectedIndex(int)
  • addListSelectionListener(ListSelectionListener)

setSelectedIndices

public void setSelectedIndices(int[] indices)
Изменяет выделение на набор индексов, указанных в данном массиве. Индексы, большие или равные размеру модели, игнорируются. Это удобный метод, который очищает выделение, а затем использует addSelectionInterval в модели выделения для добавления индексов. Подробнее о том, как обрабатываются значения меньше 0, см. в документации используемого класса модели выделения.
Параметры:
indices - массив индексов ячеек для выделения, non-null
Исключения:
NullPointerException - если указанный массив равен null
См. также:
  • ListSelectionModel.addSelectionInterval(int, int)
  • isSelectedIndex(int)
  • addListSelectionListener(ListSelectionListener)

getSelectedValues

@Deprecated @BeanProperty(bound=false) public Object[] getSelectedValues()
Устарело.
Начиная с версии JDK 1.7 заменен на getSelectedValuesList()
Возвращает массив всех выделенных значений в порядке возрастания их индексов в списке.
Возвращает:
выделенные значения или пустой массив, если ничего не выделено
См. также:
  • isSelectedIndex(int)
  • getModel()
  • addListSelectionListener(ListSelectionListener)

getSelectedValuesList

@BeanProperty(bound=false) public List<E> getSelectedValuesList()
Возвращает список всех выделенных элементов в порядке возрастания их индексов в списке.
Возвращает:
выделенные элементы или пустой список, если ничего не выделено
Начиная с:
1.7
См. также:
  • isSelectedIndex(int)
  • getModel()
  • addListSelectionListener(ListSelectionListener)

getSelectedIndex

public int getSelectedIndex()
Возвращает наименьший индекс выделенной ячейки; выделение, когда в списке выбран только один элемент. Если выбрано несколько элементов, возвращается наименьший выбранный индекс. Возвращает -1, если ничего не выбрано.

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

Возвращает:
наименьший индекс выделенной ячейки
См. также:
  • getMinSelectionIndex()
  • addListSelectionListener(ListSelectionListener)

getSelectedValue

@BeanProperty(bound=false) public E getSelectedValue()
Возвращает значение для наименьшего индекса выделенной ячейки; выделенное значение, когда в списке выбран только один элемент. Если выбрано несколько элементов, возвращается просто значение для наименьшего выбранного индекса. Возвращает null, если ничего не выбрано.

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

Возвращает:
первое выделенное значение
См. также:
  • getMinSelectionIndex()
  • getModel()
  • addListSelectionListener(ListSelectionListener)

setSelectedValue

public void setSelectedValue(Object anObject, boolean shouldScroll)
Выделяет указанный объект в списке. Если переданный объект равен null, выделение очищается.
Параметры:
anObject - объект для выделения
shouldScroll - true, если список должен прокручиваться для отображения выбранного объекта, если он существует; в противном случае false

getPreferredScrollableViewportSize

@BeanProperty(bound=false) public Dimension getPreferredScrollableViewportSize()
Вычисляет размер области просмотра, необходимый для отображения visibleRowCount строк. Значение, возвращаемое этим методом, зависит от ориентации компоновки:

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

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

Если модель не пуста, ширина равна ширине предпочтительного размера, обычно ширине самого широкого элемента списка. Высота равна высоте ячейки с индексом 0, умноженной на 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(Rectangle, int, int)
  • Scrollable.getScrollableUnitIncrement(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(Rectangle, int, int)
  • Scrollable.getScrollableBlockIncrement(Rectangle, int, int)

getScrollableTracksViewportWidth

@BeanProperty(bound=false) public boolean getScrollableTracksViewportWidth()
Возвращает true, если этот JList отображается в JViewport и область просмотра шире предпочтительной ширины списка, или если ориентация компоновки равна HORIZONTAL_WRAP и visibleRowCount <= 0; в противном случае возвращает false.

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

Указано в:
getScrollableTracksViewportWidth в интерфейсе Scrollable
Возвращает:
должна ли внешняя область просмотра принудительно согласовывать ширину списка со своей шириной
См. также:
  • Scrollable.getScrollableTracksViewportWidth()

getScrollableTracksViewportHeight

@BeanProperty(bound=false) public boolean getScrollableTracksViewportHeight()
Возвращает true, если этот JList отображается в JViewport и область просмотра выше предпочтительной высоты списка, или если ориентация компоновки равна VERTICAL_WRAP и visibleRowCount <= 0; в противном случае возвращает false.

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

Указано в:
getScrollableTracksViewportHeight в интерфейсе Scrollable
Возвращает:
должна ли внешняя область просмотра принудительно согласовывать высоту списка со своей высотой
См. также:
  • Scrollable.getScrollableTracksViewportHeight()

paramString

protected String paramString()
Возвращает строковое представление (String) этого JList. Этот метод предназначен для использования исключительно в целях отладки, и содержимое, а также формат возвращаемого String могут различаться в зависимости от реализации. Возвращаемое String может быть пустым, но не может быть null.
Переопределяет:
paramString в классе JComponent
Возвращает:
представление этого JList в виде String.

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этим JList. Для JList AccessibleContext принимает форму AccessibleJList.

При необходимости создается новый экземпляр AccessibleJList.

Указано в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
AccessibleJList, который выступает в качестве AccessibleContext для этого JList

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию разработчика см. в документации по Java SE, которая содержит более подробные описания, ориентированные на разработчиков, с концептуальными обзорами, определениями терминов, обходными путями и рабочими примерами кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее дочерних компаний в США и других странах.
Авторские права © 1993, 2026, Oracle и/или ее дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API