Класс 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
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
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 |
Создает JList, отображающий элементы указанного массива. |
JList |
Создает JList, отображающий элементы в указанном Vector. |
JList |
Создает JList, отображающий элементы из указанной модели (non-null). |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addListSelectionListener |
Добавляет слушателя к списку для получения уведомлений при каждом изменении выделения; предпочтительный способ прослушивания изменений состояния выделения. |
void |
addSelectionInterval |
Устанавливает выделение как объединение указанного интервала с текущим выделением. |
void |
clearSelection() |
Очищает выделение; после вызова этого метода isSelectionEmpty возвращает true. |
protected ListSelectionModel |
createSelectionModel() |
Возвращает экземпляр DefaultListSelectionModel; вызывается во время конструирования для инициализации свойства модели выделения списка. |
void |
ensureIndexIsVisible |
Прокручивает список внутри содержащей его области просмотра (viewport), чтобы сделать указанную ячейку полностью видимой. |
protected void |
fireSelectionValueChanged |
Уведомляет ListSelectionListener, добавленные непосредственно в список, об изменениях выделения, внесенных в модель выделения. |
AccessibleContext |
getAccessibleContext() |
Возвращает AccessibleContext, связанный с этим JList. |
int |
getAnchorSelectionIndex() |
Возвращает якорный индекс выделения. |
Rectangle |
getCellBounds |
Возвращает ограничивающий прямоугольник в системе координат списка для диапазона ячеек, заданного двумя индексами. |
ListCellRenderer |
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 |
getModel() |
Возвращает модель данных, содержащую список элементов, отображаемых компонентом JList. |
int |
getNextMatch |
Возвращает следующий элемент списка, чье значение toString начинается с заданного префикса. |
Dimension |
getPreferredScrollableViewportSize() |
Вычисляет размер области просмотра, необходимый для отображения строк в количестве visibleRowCount. |
E |
getPrototypeCellValue() |
Возвращает «прототипное» значение ячейки — значение, используемое для вычисления фиксированной ширины и высоты ячеек. |
int |
getScrollableBlockIncrement |
Возвращает расстояние прокрутки для отображения следующего или предыдущего блока. |
boolean |
getScrollableTracksViewportHeight() |
Возвращает true, если этот JList отображается в JViewport и область просмотра выше предпочтительной высоты списка, или если ориентация компоновки равна VERTICAL_WRAP и visibleRowCount <= 0; в противном случае возвращает false. |
boolean |
getScrollableTracksViewportWidth() |
Возвращает true, если этот JList отображается в JViewport и область просмотра шире предпочтительной ширины списка, или если ориентация компоновки равна HORIZONTAL_WRAP и visibleRowCount <= 0; в противном случае возвращает false. |
int |
getScrollableUnitIncrement |
Возвращает расстояние прокрутки для отображения следующей или предыдущей строки (для вертикальной прокрутки) или столбца (для горизонтальной прокрутки). |
int |
getSelectedIndex() |
Возвращает наименьший индекс выделенной ячейки; выделение, когда в списке выбран только один элемент. |
int[] |
getSelectedIndices() |
Возвращает массив всех выделенных индексов в порядке возрастания. |
E |
getSelectedValue() |
Возвращает значение для наименьшего индекса выделенной ячейки; выбранное значение, когда в списке выбран только один элемент. |
Object[] |
getSelectedValues() |
Устарело. |
List |
getSelectedValuesList() |
Возвращает список всех выбранных элементов в порядке возрастания их индексов в списке. |
Color |
getSelectionBackground() |
Возвращает цвет, используемый для отрисовки фона выбранных элементов. |
Color |
getSelectionForeground() |
Возвращает цвет, используемый для отрисовки переднего плана выбранных элементов. |
int |
getSelectionMode() |
Возвращает текущий режим выделения для списка. |
ListSelectionModel |
getSelectionModel() |
Возвращает текущую модель выделения. |
String |
getToolTipText |
Возвращает текст всплывающей подсказки, используемый для данного события. |
ListUI |
getUI() |
Возвращает ListUI — объект внешнего вида и поведения (look and feel), выполняющий рендеринг этого компонента. |
String |
getUIClassID() |
Возвращает "ListUI" — ключ UIDefaults, используемый для поиска имени класса javax.swing.plaf.ListUI, определяющего внешний вид и поведение для этого компонента. |
boolean |
getValueIsAdjusting() |
Возвращает значение свойства isAdjusting модели выделения. |
int |
getVisibleRowCount() |
Возвращает значение свойства visibleRowCount. |
Point |
indexToLocation |
Возвращает начальную точку указанного элемента в системе координат списка. |
boolean |
isSelectedIndex |
Возвращает true, если указанный индекс выделен, иначе false. |
boolean |
isSelectionEmpty() |
Возвращает true, если ничего не выбрано, иначе false. |
int |
locationToIndex |
Возвращает индекс ячейки, ближайшей к заданной координате в системе координат списка. |
protected String |
paramString() |
Возвращает представление этого JList в виде строки String. |
void |
removeListSelectionListener |
Удаляет слушателя выделения из списка. |
void |
removeSelectionInterval |
Устанавливает выделение как разность между указанным интервалом и текущим выделением. |
void |
setCellRenderer |
Задает делегат, который используется для отрисовки каждой ячейки в списке. |
void |
setDragEnabled |
Включает или выключает автоматическую обработку перетаскивания (drag). |
final void |
setDropMode |
Устанавливает режим сброса для этого компонента. |
void |
setFixedCellHeight |
Устанавливает фиксированное значение высоты для каждой ячейки списка. |
void |
setFixedCellWidth |
Устанавливает фиксированное значение ширины для каждой ячейки списка. |
void |
setLayoutOrientation |
Определяет способ компоновки ячеек списка. |
void |
setListData |
Создает доступный только для чтения ListModel из массива элементов и вызывает setModel с этой моделью. |
void |
setListData |
Создает доступный только для чтения ListModel из Vector и вызывает setModel с этой моделью. |
void |
setModel |
Устанавливает модель, представляющую содержимое или «значение» списка, уведомляет слушателей изменения свойств, а затем очищает выделение списка. |
void |
setPrototypeCellValue |
Устанавливает свойство prototypeCellValue, а затем (если новое значение равно non-null) вычисляет свойства fixedCellWidth и fixedCellHeight путем запроса компонента отрисовщика ячеек для заданного значения (и индекса 0) у отрисовщика ячеек и использования предпочтительного размера этого компонента. |
void |
setSelectedIndex |
Выделяет одну ячейку. |
void |
setSelectedIndices |
Изменяет выделение на набор индексов, указанных в данном массиве. |
void |
setSelectedValue |
Выбирает указанный объект из списка. |
void |
setSelectionBackground |
Устанавливает цвет, используемый для отрисовки фона выбранных элементов, который отрисовщики ячеек могут использовать для заливки выбранных ячеек. |
void |
setSelectionForeground |
Устанавливает цвет, используемый для отрисовки переднего плана выбранных элементов, который отрисовщики ячеек могут использовать для отображения текста и графики. |
void |
setSelectionInterval |
Выделяет указанный интервал. |
void |
setSelectionMode |
Устанавливает режим выделения для списка. |
void |
setSelectionModel |
Задает selectionModel для списка отличной от null реализацией ListSelectionModel. |
void |
setUI |
Устанавливает ListUI — объект внешнего вида и поведения (look and feel), выполняющий рендеринг этого компонента. |
void |
setValueIsAdjusting |
Устанавливает свойство valueIsAdjusting модели выделения. |
void |
setVisibleRowCount |
Устанавливает свойство 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 |
Регистрирует listener для получения AncestorEvents, когда он сам или любой из его предков перемещается либо становится видимым или невидимым. |
void |
addNotify() |
Уведомляет данный компонент о том, что у него появился родительский компонент. |
void |
addVetoableChangeListener |
Добавляет VetoableChangeListener в список слушателей. |
void |
computeVisibleRect |
Возвращает «видимый прямоугольник» компонента Component — пересечение видимых прямоугольников для этого компонента и всех его предков. |
boolean |
contains |
Предоставляет делегату 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 |
Поддержка оповещения об изменении связанных свойств для логических свойств. |
void |
firePropertyChange |
Поддержка оповещения об изменении связанных свойств для целочисленных свойств. |
protected void |
fireVetoableChange |
Поддерживает оповещение об изменении свойств с вето (constrained properties). |
ActionListener |
getActionForKeyStroke |
Возвращает объект, который будет выполнять действие, зарегистрированное для указанного нажатия клавиши. |
final ActionMap |
getActionMap() |
Возвращает ActionMap, используемый для определения того, какое действие Action запускать для конкретной привязки KeyStroke. |
float |
getAlignmentX() |
Переопределяет Container.getAlignmentX для возврата горизонтального выравнивания. |
float |
getAlignmentY() |
Переопределяет Container.getAlignmentY для возврата вертикального выравнивания. |
AncestorListener[] |
getAncestorListeners() |
Возвращает массив всех слушателей предков, зарегистрированных для этого компонента. |
boolean |
getAutoscrolls() |
Возвращает свойство autoscrolls. |
int |
getBaseline |
Возвращает базовую линию. |
Component.BaselineResizeBehavior |
getBaselineResizeBehavior() |
Возвращает значение enum, указывающее, как базовая линия компонента изменяется при изменении размера. |
Border |
getBorder() |
Возвращает рамку этого компонента или null, если рамка в данный момент не установлена. |
Rectangle |
getBounds |
Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv. |
final Object |
getClientProperty |
Возвращает значение свойства с указанным ключом. |
protected Graphics |
getComponentGraphics |
Возвращает графический объект, используемый для отрисовки этого компонента. |
JPopupMenu |
getComponentPopupMenu() |
Возвращает JPopupMenu, назначенный для этого компонента. |
int |
getConditionForKeyStroke |
Возвращает условие, определяющее, происходит ли зарегистрированное действие в ответ на указанное нажатие клавиши. |
int |
getDebugGraphicsOptions() |
Возвращает состояние отладки графики. |
static Locale |
getDefaultLocale() |
Возвращает локаль по умолчанию, используемую для инициализации свойства локали каждого JComponent при создании. |
FontMetrics |
getFontMetrics |
Возвращает FontMetrics для указанного Font. |
Graphics |
getGraphics() |
Возвращает графический контекст этого компонента, который позволяет рисовать на компоненте. |
int |
getHeight() |
Возвращает текущую высоту этого компонента. |
boolean |
getInheritsPopupMenu() |
Возвращает true, если JPopupMenu должен наследоваться от родителя. |
final InputMap |
getInputMap() |
Возвращает InputMap, который используется, когда компонент имеет фокус. |
final InputMap |
getInputMap |
Возвращает InputMap, который используется во время condition. |
InputVerifier |
getInputVerifier() |
Возвращает верификатор ввода для этого компонента. |
Insets |
getInsets() |
Если для этого компонента была задана рамка, возвращает внутренние отступы (insets) рамки; в противном случае вызывает super.getInsets. |
Insets |
getInsets |
Возвращает объект Insets, содержащий значения внутренних отступов этого компонента. |
<T extends EventListener> |
getListeners |
Возвращает массив всех объектов, зарегистрированных в данный момент как FooListener в этом JComponent. |
Point |
getLocation |
Сохраняет начало координат x,y этого компонента в «возвращаемое значение» rv и возвращает rv. |
Dimension |
getMaximumSize() |
Если максимальный размер был установлен в значение, отличное от null, просто возвращает его. |
Dimension |
getMinimumSize() |
Если минимальный размер был установлен в значение, отличное от null, просто возвращает его. |
Component |
getNextFocusableComponent() |
Устарело. Начиная с версии 1.4 заменено на FocusTraversalPolicy. |
Point |
getPopupLocation |
Возвращает предпочтительное положение для отображения контекстного меню в системе координат этого компонента. |
Dimension |
getPreferredSize() |
Если preferredSize было установлено в значение, отличное от null, просто возвращает его. |
KeyStroke[] |
getRegisteredKeyStrokes() |
Возвращает KeyStrokes, которые инициируют зарегистрированные действия. |
JRootPane |
getRootPane() |
Возвращает предка JRootPane для этого компонента. |
Dimension |
getSize |
Сохраняет ширину/высоту этого компонента в «возвращаемое значение» rv и возвращает rv. |
Point |
getToolTipLocation |
Возвращает положение всплывающей подсказки в системе координат этого компонента. |
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 |
Возвращает 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 |
Вызывается Swing для отрисовки компонентов. |
protected void |
paintBorder |
Отрисовывает рамку компонента. |
protected void |
paintChildren |
Отрисовывает дочерние элементы этого компонента. |
protected void |
paintComponent |
Вызывает метод paint делегата UI, если делегат UI не равен null. |
void |
paintImmediately |
Немедленно отрисовывает указанную область в этом компоненте и всех его потомках, перекрывающих эту область. |
void |
paintImmediately |
Отрисовывает указанную область немедленно. |
void |
print |
Вызовите этот метод для вывода компонента на печать на указанный Graphics. |
void |
printAll |
Вызовите этот метод для вывода компонента на печать. |
protected void |
printBorder |
Печатает рамку компонента. |
protected void |
printChildren |
Печатает дочерние элементы этого компонента. |
protected void |
printComponent |
Вызывается во время операции печати. |
protected void |
processComponentKeyEvent |
Обрабатывает любые события клавиатуры, которые распознает сам компонент. |
protected boolean |
processKeyBinding |
Вызывается для обработки привязок клавиш для ks в результате KeyEvent e. |
protected void |
processKeyEvent |
Переопределяет processKeyEvent для обработки событий. |
protected void |
processMouseEvent |
Обрабатывает события мыши, происходящие на этом компоненте, путем их диспетчеризации любым зарегистрированным объектам MouseListener; обратитесь к Component.processMouseEvent(MouseEvent) для получения полного описания этого метода. |
protected void |
processMouseMotionEvent |
Обрабатывает события перемещения мыши, такие как MouseEvent.MOUSE_DRAGGED. |
final void |
putClientProperty |
Добавляет произвольное «клиентское свойство» (пара ключ/значение) к этому компоненту. |
void |
registerKeyboardAction |
Этот метод устарел; для аналогичного поведения используйте комбинацию getActionMap() и getInputMap(). |
void |
registerKeyboardAction |
Этот метод устарел; для аналогичного поведения используйте комбинацию getActionMap() и getInputMap(). |
void |
removeAncestorListener |
Отменяет регистрацию listener, чтобы он больше не получал AncestorEvents. |
void |
removeNotify() |
Уведомляет данный компонент о том, что у него больше нет родительского компонента. |
void |
removeVetoableChangeListener |
Удаляет VetoableChangeListener из списка слушателей. |
void |
repaint |
Добавляет указанную область в список измененных областей (dirty region list), если компонент отображается на экране. |
void |
repaint |
Добавляет указанную область в список измененных областей (dirty region list), если компонент отображается на экране. |
boolean |
requestDefaultFocus() |
Устарело. Начиная с версии 1.4 заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
|
void |
requestFocus() |
Запрашивает передачу фокуса ввода этому Component. |
boolean |
requestFocus |
Запрашивает передачу фокуса ввода этому Component. |
boolean |
requestFocusInWindow() |
Запрашивает передачу фокуса ввода этому Component. |
protected boolean |
requestFocusInWindow |
Запрашивает передачу фокуса ввода этому Component. |
void |
resetKeyboardActions() |
Отменяет регистрацию всех привязок на первом уровне InputMaps и ActionMap. |
void |
reshape |
Устарело. Начиная с версии JDK 5 заменено на Component.setBounds(int, int, int, int). |
void |
revalidate() |
Поддерживает отложенную автоматическую компоновку. |
void |
scrollRectToVisible |
Пересылает сообщение scrollRectToVisible() родителю компонента JComponent. |
final void |
setActionMap |
Устанавливает ActionMap в am. |
void |
setAlignmentX |
Устанавливает горизонтальное выравнивание. |
void |
setAlignmentY |
Устанавливает вертикальное выравнивание. |
void |
setAutoscrolls |
Устанавливает свойство autoscrolls. |
void |
setBackground |
Устанавливает цвет фона для этого компонента. |
void |
setBorder |
Устанавливает рамку этого компонента. |
void |
setComponentPopupMenu |
Устанавливает JPopupMenu для этого JComponent. |
void |
setDebugGraphicsOptions |
Включает или отключает диагностическую информацию о каждой графической операции, выполняемой внутри компонента или одного из его потомков. |
static void |
setDefaultLocale |
Задает локаль по умолчанию, используемую для инициализации свойства локали каждого JComponent при создании. |
void |
setDoubleBuffered |
Задает, должен ли этот компонент использовать буфер для отрисовки. |
void |
setEnabled |
Определяет, включен данный компонент или нет. |
void |
setFocusTraversalKeys |
Задает клавиши обхода фокуса для указанной операции обхода для этого Component. |
void |
setFont |
Устанавливает шрифт для этого компонента. |
void |
setForeground |
Устанавливает цвет переднего плана для этого компонента. |
void |
setInheritsPopupMenu |
Определяет, должен ли getComponentPopupMenu делегировать обработку родителю, если для этого компонента не назначен JPopupMenu. |
final void |
setInputMap |
Устанавливает InputMap для использования при условии condition в map. |
void |
setInputVerifier |
Устанавливает верификатор ввода для этого компонента. |
void |
setMaximumSize |
Устанавливает максимальный размер этого компонента в константное значение. |
void |
setMinimumSize |
Устанавливает минимальный размер этого компонента в константное значение. |
void |
setNextFocusableComponent |
Устарело. Начиная с версии 1.4 заменено на FocusTraversalPolicy
|
void |
setOpaque |
Если значение true, компонент отрисовывает каждый пиксель в пределах своих границ. |
void |
setPreferredSize |
Устанавливает предпочтительный размер этого компонента. |
void |
setRequestFocusEnabled |
Предоставляет подсказку относительно того, должен ли этот JComponent получать фокус. |
void |
setToolTipText |
Регистрирует текст для отображения во всплывающей подсказке. |
void |
setTransferHandler |
Устанавливает TransferHandler, который обеспечивает поддержку передачи данных в этот компонент и из него с помощью операций вырезать/скопировать/вставить и перетаскивания (drag and drop). |
protected void |
setUI |
Задает делегат внешнего вида (look and feel) для этого компонента. |
void |
setVerifyInputWhenFocusTarget |
Устанавливает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед тем, как этот компонент запросит фокус. |
void |
setVisible |
Делает компонент видимым или невидимым. |
void |
unregisterKeyboardAction |
Этот метод устарел. |
void |
update |
Вызывает 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 |
add |
Добавляет указанный компонент в этот контейнер в заданную позицию. |
void |
add |
Добавляет указанный компонент в конец этого контейнера. |
void |
add |
Добавляет указанный компонент в этот контейнер с указанными ограничениями по указанному индексу. |
Component |
add |
Добавляет указанный компонент в этот контейнер. |
void |
addContainerListener |
Добавляет указанный прослушиватель контейнера для получения событий контейнера от этого контейнера. |
protected void |
addImpl |
Добавляет указанный компонент в этот контейнер по указанному индексу. |
void |
addPropertyChangeListener |
Добавляет PropertyChangeListener в список прослушивателей. |
void |
addPropertyChangeListener |
Добавляет PropertyChangeListener в список прослушивателей для определенного свойства. |
void |
applyComponentOrientation |
Задает свойство ComponentOrientation этого контейнера и всех содержащихся в нем компонентов. |
boolean |
areFocusTraversalKeysSet |
Возвращает значение, указывающее, был ли явно определен набор (Set) клавиш обхода фокуса для заданной операции обхода фокуса для этого Container. |
int |
countComponents() |
Устарело. Начиная с версии JDK 1.1, заменено на getComponentCount(). |
void |
deliverEvent |
Устарело. Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent e)
|
void |
doLayout() |
Заставляет этот контейнер разместить свои компоненты. |
Component |
findComponentAt |
Находит видимый дочерний компонент, содержащий указанную позицию. |
Component |
findComponentAt |
Находит видимый дочерний компонент, содержащий указанную точку. |
Component |
getComponent |
Возвращает n-й компонент в этом контейнере. |
Component |
getComponentAt |
Находит компонент, содержащий позицию x,y. |
Component |
getComponentAt |
Возвращает компонент, содержащий указанную точку. |
int |
getComponentCount() |
Возвращает количество компонентов в этой панели. |
Component[] |
getComponents() |
Возвращает все компоненты в этом контейнере. |
int |
getComponentZOrder |
Возвращает индекс z-порядка компонента внутри контейнера. |
ContainerListener[] |
getContainerListeners() |
Возвращает массив всех прослушивателей контейнера, зарегистрированных для этого контейнера. |
Set |
getFocusTraversalKeys |
Возвращает набор (Set) клавиш обхода фокуса для заданной операции обхода для этого Container. |
FocusTraversalPolicy |
getFocusTraversalPolicy() |
Возвращает политику обхода фокуса, которая будет управлять переходом с помощью клавиатуры по дочерним элементам этого Container, или null, если этот Container не является корнем цикла обхода фокуса. |
LayoutManager |
getLayout() |
Возвращает менеджер компоновки для этого контейнера. |
Point |
getMousePosition |
Возвращает положение указателя мыши в координатном пространстве этого Container, если Container находится под указателем мыши, в противном случае возвращает null. |
Insets |
insets() |
Устарело. Начиная с версии JDK 1.1, заменено на getInsets(). |
void |
invalidate() |
Делает контейнер недействительным. |
boolean |
isAncestorOf |
Проверяет, содержится ли компонент в иерархии компонентов этого контейнера. |
boolean |
isFocusCycleRoot() |
Возвращает значение, указывающее, является ли этот Container корнем цикла обхода фокуса. |
boolean |
isFocusCycleRoot |
Возвращает значение, указывающее, является ли указанный Container корнем цикла обхода фокуса для цикла обхода фокуса этого Container. |
final boolean |
isFocusTraversalPolicyProvider() |
Возвращает значение, указывающее, предоставляет ли этот контейнер политику обхода фокуса. |
boolean |
isFocusTraversalPolicySet() |
Возвращает значение, указывающее, была ли явно задана политика обхода фокуса для этого Container. |
void |
layout() |
Устарело. Начиная с версии JDK 1.1, заменено на doLayout(). |
void |
list |
Выводит список этого контейнера в указанный выходной поток. |
void |
list |
Выводит список, начиная с указанного отступа, в указанный модуль записи печати (print writer). |
Component |
locate |
Устарело. Начиная с версии JDK 1.1, заменено на getComponentAt(int, int). |
Dimension |
minimumSize() |
Устарело. Начиная с версии JDK 1.1, заменено на getMinimumSize(). |
void |
paintComponents |
Отрисовывает каждый из компонентов в этом контейнере. |
Dimension |
preferredSize() |
Устарело. Начиная с версии JDK 1.1, заменено на getPreferredSize(). |
void |
printComponents |
Печатает каждый из компонентов в этом контейнере. |
protected void |
processContainerEvent |
Обрабатывает события контейнера, происходящие в этом контейнере, диспетчеризируя их любым зарегистрированным объектам ContainerListener. |
protected void |
processEvent |
Обрабатывает события в этом контейнере. |
void |
remove |
Удаляет компонент, указанный с помощью index, из этого контейнера. |
void |
remove |
Удаляет указанный компонент из этого контейнера. |
void |
removeAll() |
Удаляет все компоненты из этого контейнера. |
void |
removeContainerListener |
Удаляет указанный прослушиватель контейнера, чтобы он больше не получал события контейнера от этого контейнера. |
void |
setComponentZOrder |
Перемещает указанный компонент на указанный индекс z-порядка в контейнере. |
void |
setFocusCycleRoot |
Задает, является ли этот Container корнем цикла обхода фокуса. |
void |
setFocusTraversalPolicy |
Задает политику обхода фокуса, которая будет управлять переходом по клавишам по дочерним элементам этого Container, если этот Container является корнем цикла обхода фокуса. |
final void |
setFocusTraversalPolicyProvider |
Задает, будет ли этот контейнер использоваться для предоставления политики обхода фокуса. |
void |
setLayout |
Задает менеджер компоновки для этого контейнера. |
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 |
Устарело. Начиная с версии JDK 1.1, следует регистрировать этот компонент как ActionListener на компоненте, генерирующем события действия. |
void |
add |
Добавляет указанное всплывающее меню к компоненту. |
void |
addComponentListener |
Добавляет указанный слушатель компонентов для получения событий компонента от этого компонента. |
void |
addFocusListener |
Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента, когда этот компонент получает фокус ввода. |
void |
addHierarchyBoundsListener |
Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит данный контейнер. |
void |
addHierarchyListener |
Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит данный контейнер. |
void |
addInputMethodListener |
Добавляет указанный слушатель методов ввода для получения событий метода ввода от этого компонента. |
void |
addKeyListener |
Добавляет указанный слушатель клавиатуры для получения событий клавиш от этого компонента. |
void |
addMouseListener |
Добавляет указанный слушатель мыши для получения событий мыши от этого компонента. |
void |
addMouseMotionListener |
Добавляет указанный слушатель перемещения мыши для получения событий перемещения мыши от этого компонента. |
void |
addMouseWheelListener |
Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента. |
Rectangle |
bounds() |
Устарело. Начиная с версии JDK 1.1, заменено на getBounds(). |
int |
checkImage |
Возвращает статус построения экранного представления указанного изображения. |
int |
checkImage |
Возвращает статус построения экранного представления указанного изображения. |
protected AWTEvent |
coalesceEvents |
Потенциально объединяет отправляемое событие с существующим событием. |
boolean |
contains |
Проверяет, содержит ли этот компонент указанную точку, где координаты x и y точки определены относительно системы координат этого компонента. |
Image |
createImage |
Создает закадровое отрисовываемое изображение, используемое для двойной буферизации. |
Image |
createImage |
Создает изображение из указанного поставщика изображений. |
VolatileImage |
createVolatileImage |
Создает энергонезависимое закадровое отрисовываемое изображение, используемое для двойной буферизации. |
VolatileImage |
createVolatileImage |
Создает энергонезависимое закадровое отрисовываемое изображение с заданными возможностями. |
protected final void |
disableEvents |
Отключает доставку событий, определенных указанным параметром маски событий, этому компоненту. |
final void |
dispatchEvent |
Диспетчеризует событие этому компоненту или одному из его подкомпонентов. |
void |
enable |
Устарело. Начиная с версии JDK 1.1, заменено на setEnabled(boolean). |
protected final void |
enableEvents |
Включает доставку событий, определенных указанным параметром маски событий, этому компоненту. |
void |
enableInputMethods |
Включает или отключает поддержку методов ввода для этого компонента. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
protected void |
firePropertyChange |
Поддержка оповещения об изменениях связанных свойств типа 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 |
Возвращает массив всех слушателей, связанных с именованным свойством. |
Dimension |
getSize() |
Возвращает размер этого компонента в виде объекта Dimension. |
Toolkit |
getToolkit() |
Возвращает инструментарий (toolkit) этого компонента. |
final Object |
getTreeLock() |
Возвращает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потока) для операций с деревом компонентов AWT и разметкой. |
boolean |
gotFocus |
Устарело. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent). |
boolean |
handleEvent |
Устарело. Начиная с версии JDK 1.1, заменено на processEvent(AWTEvent). |
boolean |
hasFocus() |
Возвращает true, если этот Component является владельцем фокуса. |
boolean |
imageUpdate |
Перерисовывает компонент при изменении изображения. |
boolean |
inside |
Устарело. Начиная с версии 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 |
Устарело. Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent). |
boolean |
keyUp |
Устарело. Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent). |
void |
list() |
Выводит список этого компонента в стандартный поток системного вывода System.out. |
void |
list |
Выводит список этого компонента в указанный поток вывода. |
void |
list |
Выводит список в указанный print writer. |
Point |
location() |
Устарело. Начиная с версии JDK 1.1, заменено на getLocation(). |
boolean |
lostFocus |
Устарело. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent). |
boolean |
mouseDown |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
boolean |
mouseDrag |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent). |
boolean |
mouseEnter |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
boolean |
mouseExit |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
boolean |
mouseMove |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent). |
boolean |
mouseUp |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
void |
move |
Устарело. Начиная с версии JDK 1.1, заменено на setLocation(int, int). |
void |
nextFocus() |
Устарело. Начиная с версии JDK 1.1, заменено на transferFocus(). |
void |
paintAll |
Отрисовывает этот компонент и все его подкомпоненты. |
boolean |
postEvent |
Устарело. Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent). |
boolean |
prepareImage |
Подготавливает изображение для отрисовки на этом компоненте с указанными шириной и высотой. |
boolean |
prepareImage |
Подготавливает изображение для отрисовки на этом компоненте. |
protected void |
processComponentEvent |
Обрабатывает события компонента, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам ComponentListener. |
protected void |
processFocusEvent |
Обрабатывает события фокуса, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам FocusListener. |
protected void |
processHierarchyBoundsEvent |
Обрабатывает события границ иерархии, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам HierarchyBoundsListener. |
protected void |
processHierarchyEvent |
Обрабатывает события иерархии, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам HierarchyListener. |
protected void |
processInputMethodEvent |
Обрабатывает события метода ввода, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам InputMethodListener. |
protected void |
processMouseWheelEvent |
Обрабатывает события колесика мыши, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам MouseWheelListener. |
void |
remove |
Удаляет указанное всплывающее меню из компонента. |
void |
removeComponentListener |
Удаляет указанный слушатель компонентов, чтобы он больше не получал события компонента от этого компонента. |
void |
removeFocusListener |
Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента. |
void |
removeHierarchyBoundsListener |
Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента. |
void |
removeHierarchyListener |
Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента. |
void |
removeInputMethodListener |
Удаляет указанный слушатель методов ввода, чтобы он больше не получал события метода ввода от этого компонента. |
void |
removeKeyListener |
Удаляет указанный слушатель клавиатуры, чтобы он больше не получал события клавиш от этого компонента. |
void |
removeMouseListener |
Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента. |
void |
removeMouseMotionListener |
Удаляет указанный слушатель перемещения мыши, чтобы он больше не получал события перемещения мыши от этого компонента. |
void |
removeMouseWheelListener |
Удаляет указанный слушатель колесика мыши, чтобы он больше не получал события колесика мыши от этого компонента. |
void |
removePropertyChangeListener |
Удаляет PropertyChangeListener из списка слушателей. |
void |
removePropertyChangeListener |
Удаляет PropertyChangeListener из списка слушателей для указанного свойства. |
void |
repaint() |
Перерисовывает этот компонент. |
void |
repaint |
Перерисовывает указанную прямоугольную область этого компонента. |
void |
repaint |
Перерисовывает компонент. |
protected boolean |
requestFocus |
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, и чтобы предок верхнего уровня этого Component стал сфокусированным Window. |
void |
requestFocus |
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, и чтобы предок верхнего уровня этого Component стал сфокусированным Window. |
boolean |
requestFocusInWindow |
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, если предок верхнего уровня этого Component уже является сфокусированным Window. |
void |
resize |
Устарело. Начиная с версии JDK 1.1, заменено на setSize(int, int). |
void |
resize |
Устарело. Начиная с версии JDK 1.1, заменено на setSize(Dimension). |
void |
setBounds |
Перемещает и изменяет размер этого компонента. |
void |
setBounds |
Перемещает и изменяет размер этого компонента в соответствии с новым ограничивающим прямоугольником r. |
void |
setComponentOrientation |
Задает языковую ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента. |
void |
setCursor |
Устанавливает изображение курсора в указанный курсор. |
void |
setDropTarget |
Связывает DropTarget с этим компонентом. |
void |
setFocusable |
Устанавливает состояние фокусируемости этого Component в указанное значение. |
void |
setFocusTraversalKeysEnabled |
Задает, включены ли клавиши обхода фокуса для этого Component. |
void |
setIgnoreRepaint |
Задает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы. |
void |
setLocale |
Устанавливает локаль этого компонента. |
void |
setLocation |
Перемещает этот компонент на новую позицию. |
void |
setLocation |
Перемещает этот компонент на новую позицию. |
void |
setMixingCutoutShape |
Задает фигуру «mixing-cutout» для этого облегченного компонента. |
void |
setName |
Задает имя компонента равным указанной строке. |
void |
setSize |
Изменяет размер этого компонента так, чтобы он имел ширину width и высоту height. |
void |
setSize |
Изменяет размер этого компонента так, чтобы он имел ширину d.width и высоту d.height. |
void |
show() |
Устарело. Начиная с версии JDK 1.1, заменено на setVisible(boolean). |
void |
show |
Устарело. Начиная с версии 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 |
Указывает, "равен" ли какой-либо другой объект этому. |
protected void |
finalize() |
Устарело, для удаления: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в будущей версии. |
final Class |
getClass() |
Возвращает класс времени выполнения данного Object. |
int |
hashCode() |
Возвращает значение хэш-кода для этого объекта. |
final void |
notify() |
Возобновляет работу одного потока, ожидающего на мониторе этого объекта. |
final void |
notifyAll() |
Возобновляет работу всех потоков, ожидающих на мониторе этого объекта. |
final void |
wait() |
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания. |
final void |
wait |
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет определенное время. |
final void |
wait |
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет определенное время. |
Подробное описание полей
VERTICAL
public static final int VERTICAL
- Since:
- 1.4
- See Also:
VERTICAL_WRAP
public static final int VERTICAL_WRAP
- Since:
- 1.4
- See Also:
HORIZONTAL_WRAP
public static final int HORIZONTAL_WRAP
- Since:
- 1.4
- See Also:
Подробное описание конструкторов
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:
updateUI
public void updateUI()
ListUI, устанавливая его в значение, предоставляемое текущим внешним видом и функциональностью. Если текущее средство отрисовки ячеек было установлено разработчиком (а не самим внешним видом и функциональностью), это также приводит к обновлению средства отрисовки ячеек и его дочерних элементов путем вызова на нем SwingUtilities.updateComponentTreeUI.- Overrides:
-
updateUIв классеJComponent - See Also:
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()
"ListUI", ключ UIDefaults, используемый для поиска имени класса javax.swing.plaf.ListUI, определяющего внешний вид и функциональность этого компонента.- Overrides:
-
getUIClassIDв классеJComponent - Returns:
- строку "ListUI"
- See Also:
getPrototypeCellValue
public E getPrototypeCellValue()
null, если такого значения нет.- Returns:
- значение свойства
prototypeCellValue - See Also:
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:
getFixedCellWidth
public int getFixedCellWidth()
fixedCellWidth.- Returns:
- фиксированную ширину ячейки
- See Also:
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:
getFixedCellHeight
public int getFixedCellHeight()
fixedCellHeight.- Returns:
- фиксированную высоту ячейки
- See Also:
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:
getCellRenderer
public ListCellRenderer<? super E> getCellRenderer()
- Returns:
- значение свойства
cellRenderer - See Also:
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:
getSelectionForeground
public Color getSelectionForeground()
DefaultListCellRenderer использует этот цвет для отрисовки переднего плана элементов в выбранном состоянии, как и средства отрисовки, установленные большинством реализаций ListUI.- Returns:
- цвет для отрисовки переднего плана выбранных элементов
- See Also:
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:
getSelectionBackground
public Color getSelectionBackground()
DefaultListCellRenderer использует этот цвет для отрисовки фона элементов в выбранном состоянии, как и средства отрисовки, установленные большинством реализаций ListUI.- Returns:
- цвет для отрисовки фона выбранных элементов
- See Also:
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:
getVisibleRowCount
public int getVisibleRowCount()
visibleRowCount. Подробные сведения о том, как интерпретировать это значение, см. в документации для setVisibleRowCount(int).- Returns:
- значение свойства
visibleRowCount. - See Also:
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:
getLayoutOrientation
public int getLayoutOrientation()
VERTICAL, если компоновка представляет собой один столбец ячеек; VERTICAL_WRAP, если компоновка выполнена в «газетном стиле» с заполнением содержимого по вертикали, затем по горизонтали; или HORIZONTAL_WRAP, если компоновка выполнена в «газетном стиле» с заполнением содержимого по горизонтали, затем по вертикали.- Returns:
- значение свойства
layoutOrientation - Since:
- 1.4
- See Also:
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 |
Ячейки располагаются горизонтально, переносясь на новую строку по мере необходимости. Если свойство visibleRowCount меньше или равно нулю, перенос определяется шириной списка; в противном случае перенос выполняется таким образом, чтобы обеспечить visibleRowCount строк в списке. |
VERTICAL_WRAP |
Ячейки располагаются вертикально, переносясь в новый столбец по мере необходимости. Если свойство visibleRowCount меньше или равно нулю, перенос определяется высотой списка; в противном случае перенос выполняется по достижении visibleRowCount строк. |
VERTICAL.- Parameters:
-
layoutOrientation- новая ориентация компоновки, одно из значений:VERTICAL,HORIZONTAL_WRAPилиVERTICAL_WRAP - Throws:
-
IllegalArgumentException- еслиlayoutOrientationне является одним из допустимых значений - Since:
- 1.4
- See Also:
getFirstVisibleIndex
@BeanProperty(bound=false) public int getFirstVisibleIndex()
componentOrientation первая видимая ячейка находится ближе всего к верхнему левому углу списка. При ориентации справа налево она находится ближе всего к верхнему правому углу. Если ничего не видно или список пуст, возвращается -1. Обратите внимание, что возвращаемая ячейка может быть видима лишь частично.- Returns:
- индекс первой видимой ячейки
- See Also:
getLastVisibleIndex
@BeanProperty(bound=false) public int getLastVisibleIndex()
-1. Обратите внимание, что возвращаемая ячейка может быть видима лишь частично.- Returns:
- индекс последней видимой ячейки
- See Also:
ensureIndexIsVisible
public void ensureIndexIsVisible(int index)
scrollRectToVisible с границами указанной ячейки. Для работы этого метода JList должен находиться внутри JViewport. Если заданный индекс находится вне диапазона ячеек списка, этот метод ничего не выполняет.
- Parameters:
-
index- индекс ячейки, которую необходимо сделать видимой - See Also:
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:
getDragEnabled
public boolean getDragEnabled()
- Returns:
- значение свойства
dragEnabled - Since:
- 1.4
- See Also:
setDropMode
public final void setDropMode(DropMode dropMode)
DropMode.USE_SELECTION. Однако для улучшения взаимодействия с пользователем рекомендуется использовать один из других режимов. Например, DropMode.ON предлагает аналогичное поведение с отображением элементов как выбранных, но делает это без изменения фактического выделения в списке. JList поддерживает следующие режимы сброса:
DropMode.USE_SELECTIONDropMode.ONDropMode.INSERTDropMode.ON_OR_INSERT
TransferHandler, принимающий сброс данных.- Parameters:
-
dropMode- используемый режим сброса - Throws:
-
IllegalArgumentException- если режим сброса не поддерживается или равенnull - Since:
- 1.6
- See Also:
getDropMode
public final DropMode getDropMode()
- Returns:
- режим сброса для этого компонента
- Since:
- 1.6
- See Also:
getDropLocation
@BeanProperty(bound=false) public final JList.DropLocation getDropLocation()
null, если в данный момент местоположение отображаться не должно. Этот метод не предназначен для запроса места сброса из TransferHandler, поскольку место сброса устанавливается только после того, как метод TransferHandler в canImport завершил работу и разрешил отображение местоположения.
При изменении этого свойства компонент генерирует событие изменения свойства с именем "dropLocation".
По умолчанию обязанность прослушивать изменения этого свойства и визуально отображать место сброса возложена на компонент ListUI списка, который может отрисовывать его напрямую и/или устанавливать для этого рендерер ячеек. Разработчикам, желающим реализовать пользовательскую отрисовку места сброса и/или заменить стандартный рендерер ячеек, может потребоваться учитывать это свойство.
- Returns:
- место сброса
- Since:
- 1.6
- See Also:
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:
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
@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:
setListData
public void setListData(E[] listData)
ListModel из массива элементов и вызывает метод setModel с этой моделью. Попытки передать значение null в этот метод приводят к неопределенному поведению и, скорее всего, к исключениям. Созданная модель напрямую ссылается на переданный массив. Попытки изменить массив после вызова этого метода приводят к неопределенному поведению.
- Parameters:
-
listData- массив объектовE, содержащий элементы для отображения в списке - See Also:
setListData
public void setListData(Vector<? extends E> listData)
ListModel из объекта Vector и вызывает метод setModel с этой моделью. Попытки передать значение null в этот метод приводят к неопределенному поведению и, скорее всего, к исключениям. Созданная модель напрямую ссылается на переданный Vector. Попытки изменить Vector после вызова этого метода приводят к неопределенному поведению.
- Parameters:
-
listData- объектVector, содержащий элементы для отображения в списке - See Also:
createSelectionModel
protected ListSelectionModel createSelectionModel()
DefaultListSelectionModel; вызывается во время конструирования для инициализации свойства модели выделения списка.- Returns:
- объект
DefaultListSelectionModel, используемый для инициализации свойства модели выделения списка во время конструирования - See Also:
getSelectionModel
public ListSelectionModel getSelectionModel()
- Returns:
ListSelectionModel, управляющий выделением элементов списка- See Also:
fireSelectionValueChanged
protected void fireSelectionValueChanged(int firstIndex, int lastIndex, boolean isAdjusting)
ListSelectionListener, добавленных непосредственно к списку, об изменениях выборки, внесенных в модель выделения. JList прослушивает изменения выделения в модели выделения и пересылает уведомления слушателям, добавленным непосредственно к списку, путем вызова этого метода. Этот метод создает объект ListSelectionEvent с данным списком в качестве источника и указанными аргументами, а затем отправляет его зарегистрированным ListSelectionListeners.
- Parameters:
-
firstIndex- первый индекс в диапазоне,<= lastIndex -
lastIndex- последний индекс в диапазоне,>= firstIndex -
isAdjusting- является ли это событие одним из серии событий, где изменения все еще продолжаются - See Also:
addListSelectionListener
public void addListSelectionListener(ListSelectionListener listener)
JList берет на себя отслеживание изменений состояния выделения в модели выделения и уведомляет указанного слушателя о каждом изменении. Объекты ListSelectionEvent, отправляемые слушателю, имеют свойство source, указывающее на этот список.- Parameters:
-
listener- добавляемый слушательListSelectionListener - See Also:
removeListSelectionListener
public void removeListSelectionListener(ListSelectionListener listener)
- Parameters:
-
listener- удаляемый слушательListSelectionListener - See Also:
getListSelectionListeners
@BeanProperty(bound=false) public ListSelectionListener[] getListSelectionListeners()
ListSelectionListener, добавленных к этому объекту JList с помощью addListSelectionListener.- Returns:
- все слушатели
ListSelectionListenerэтого списка или пустой массив, если слушатели не были добавлены - Since:
- 1.4
- See Also:
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:
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
public int getSelectionMode()
- Returns:
- текущий режим выделения
- See Also:
getAnchorSelectionIndex
@BeanProperty(bound=false) public int getAnchorSelectionIndex()
- Returns:
- опорный индекс выделения
- See Also:
getLeadSelectionIndex
@BeanProperty(bound=false, description="The lead selection index.") public int getLeadSelectionIndex()
- Returns:
- лидирующий индекс выделения
- See Also:
getMinSelectionIndex
@BeanProperty(bound=false) public int getMinSelectionIndex()
-1, если выделение пусто. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.- Returns:
- наименьший индекс выбранной ячейки или
-1 - See Also:
getMaxSelectionIndex
@BeanProperty(bound=false) public int getMaxSelectionIndex()
-1, если выделение пусто. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.- Returns:
- наибольший индекс выбранной ячейки
- See Also:
isSelectedIndex
public boolean isSelectedIndex(int index)
true, если указанный индекс выбран, иначе false. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.- Parameters:
-
index- индекс, состояние выделения которого проверяется - Returns:
-
true, если указанный индекс выбран, иначеfalse - See Also:
isSelectionEmpty
@BeanProperty(bound=false) public boolean isSelectionEmpty()
true, если ничего не выбрано, иначе false. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.- Returns:
-
true, если ничего не выбрано, иначеfalse - See Also:
clearSelection
public void clearSelection()
isSelectionEmpty вернет true. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.- See Also:
setSelectionInterval
public void setSelectionInterval(int anchor, int lead)
anchor и lead. Индекс anchor не обязательно должен быть меньше или равен lead. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка. Обратитесь к документации используемого класса модели выделения для получения подробной информации о том, как обрабатываются значения меньше 0.
- Parameters:
-
anchor- первый индекс для выделения -
lead- последний индекс для выделения - See Also:
addSelectionInterval
public void addSelectionInterval(int anchor, int lead)
anchor и lead. Индекс anchor не обязательно должен быть меньше или равен lead. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка. Обратитесь к документации используемого класса модели выделения для получения подробной информации о том, как обрабатываются значения меньше 0.
- Parameters:
-
anchor- первый индекс, добавляемый к выделению -
lead- последний индекс, добавляемый к выделению - See Also:
removeSelectionInterval
public void removeSelectionInterval(int index0, int index1)
index0 и index1. Индекс index0 не обязательно должен быть меньше или равен index1. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка. Обратитесь к документации используемого класса модели выделения для получения подробной информации о том, как обрабатываются значения меньше 0.
- Parameters:
-
index0- первый индекс, удаляемый из выделения -
index1- последний индекс, удаляемый из выделения - See Also:
setValueIsAdjusting
public void setValueIsAdjusting(boolean b)
valueIsAdjusting модели выделения. Если установлено значение true, предстоящие изменения выделения должны рассматриваться как часть одного составного изменения. Это свойство используется внутри системы, и разработчикам обычно нет необходимости вызывать этот метод. Например, когда модель обновляется в ответ на перетаскивание пользователем, значение свойства устанавливается в true при начале перетаскивания и в false при завершении. Это позволяет слушателям обновляться только после завершения изменения, а не обрабатывать все промежуточные значения. Вы можете использовать это напрямую, если выполняете серию изменений, которые должны рассматриваться как часть одного составного изменения.
Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка. Дополнительные сведения см. в документации к методу ListSelectionModel.setValueIsAdjusting(boolean).
- Parameters:
-
b- новое значение свойства - See Also:
getValueIsAdjusting
public boolean getValueIsAdjusting()
isAdjusting модели выделения. Это метод-обертка, делегирующий выполнение одноименному методу в модели выделения списка.
- Returns:
- значение свойства
isAdjustingмодели выделения. - See Also:
getSelectedIndices
public int[] getSelectedIndices()
- Returns:
- все выбранные индексы в порядке возрастания или пустой массив, если ничего не выбрано
- See Also:
setSelectedIndex
@BeanProperty(bound=false, description="The index of the selected cell.") public void setSelectedIndex(int index)
setSelectionInterval в модели выделения. Обратитесь к документации используемого класса модели выделения для получения подробной информации о том, как обрабатываются значения меньше 0.- Parameters:
-
index- индекс ячейки для выделения - See Also:
setSelectedIndices
public void setSelectedIndices(int[] indices)
addSelectionInterval в модели выделения для добавления индексов. Подробнее о том, как обрабатываются значения меньше 0, см. в документации используемого класса модели выделения.- Параметры:
-
indices- массив индексов ячеек для выделения,non-null - Исключения:
-
NullPointerException- если указанный массив равенnull - См. также:
getSelectedValues
@Deprecated @BeanProperty(bound=false) public Object[] getSelectedValues()
getSelectedValuesList()
- Возвращает:
- выделенные значения или пустой массив, если ничего не выделено
- См. также:
getSelectedValuesList
@BeanProperty(bound=false) public List<E> getSelectedValuesList()
- Возвращает:
- выделенные элементы или пустой список, если ничего не выделено
- Начиная с:
- 1.7
- См. также:
getSelectedIndex
public int getSelectedIndex()
-1, если ничего не выбрано. Этот метод является оболочкой, которая делегирует вызов getMinSelectionIndex.
- Возвращает:
- наименьший индекс выделенной ячейки
- См. также:
getSelectedValue
@BeanProperty(bound=false) public E getSelectedValue()
null, если ничего не выбрано. Это удобный метод, который просто возвращает значение модели для getMinSelectionIndex.
- Возвращает:
- первое выделенное значение
- См. также:
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строк - См. также:
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
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 - См. также:
getScrollableTracksViewportWidth
@BeanProperty(bound=false) public boolean getScrollableTracksViewportWidth()
true, если этот JList отображается в JViewport и область просмотра шире предпочтительной ширины списка, или если ориентация компоновки равна HORIZONTAL_WRAP и visibleRowCount <= 0; в противном случае возвращает false. Если false, ширина области просмотра не отслеживается. Это позволяет использовать горизонтальную прокрутку, если сам JViewport встроен в JScrollPane.
- Указано в:
-
getScrollableTracksViewportWidthв интерфейсеScrollable - Возвращает:
- должна ли внешняя область просмотра принудительно согласовывать ширину списка со своей шириной
- См. также:
getScrollableTracksViewportHeight
@BeanProperty(bound=false) public boolean getScrollableTracksViewportHeight()
true, если этот JList отображается в JViewport и область просмотра выше предпочтительной высоты списка, или если ориентация компоновки равна VERTICAL_WRAP и visibleRowCount <= 0; в противном случае возвращает false. Если false, высота области просмотра не отслеживается. Это позволяет использовать вертикальную прокрутку, если сам JViewport встроен в JScrollPane.
- Указано в:
-
getScrollableTracksViewportHeightв интерфейсеScrollable - Возвращает:
- должна ли внешняя область просмотра принудительно согласовывать высоту списка со своей высотой
- См. также:
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
© 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.
getSelectedValuesList()