Список классов

Все реализованные интерфейсы:
ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible 
public class List
extends Component
implements ItemSelectable, Accessible

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

Например, код . . . 

List lst = new List(4, false);
lst.add("Mercury");
lst.add("Venus");
lst.add("Earth");
lst.add("JavaSoft");
lst.add("Mars");
lst.add("Jupiter");
lst.add("Saturn");
lst.add("Uranus");
lst.add("Neptune");
lst.add("Pluto");
cnt.add(lst);

где cnt — контейнер, создаёт следующий прокручиваемый список:

Shows a list containing: Venus, Earth, JavaSoft, and Mars. Javasoft is selected.

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

Обратите внимание, что в примере список был создан с четырьмя видимыми строками. После создания количество видимых строк изменить нельзя. Стандартный список List создаётся с четырьмя строками, поэтому lst = new List() эквивалентно list = new List(4, false).

Начиная с Java 1.1, Abstract Window Toolkit отправляет объекту List все события мыши, клавиатуры и фокуса, которые происходят над ним. (Старая модель событий AWT поддерживается только для обеспечения обратной совместимости, и её использование не рекомендуется.)

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

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

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

С момента:
1.0
См. также:
ItemEvent, ItemListener, ActionEvent, ActionListener, Форматированный список сериализации

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

Модификатор и тип Класс Описание
protected class  List.AccessibleAWTList

Этот класс реализует поддержку функций доступности для класса List.

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

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

Поля

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

Конструктор Описание
List()

Создаёт новый прокручиваемый список.
List​(int rows)

Создаёт новый прокручиваемый список, инициализированный указанным количеством видимых строк.
List​(int rows, boolean multipleMode)

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

Методы

Модификатор и тип Метод Описание
void add​(String item)

Добавляет указанный элемент в конец списка прокрутки.
void add​(String item, int index)

Добавляет указанный элемент в список прокрутки в позиции, указанной индексом.
void addActionListener​(ActionListener l)

Добавляет указанного обработчика действий для получения событий действий от этого списка.
void addItem​(String item)

Устаревшее.

заменено на add(String).
void addItem​(String item, int index)

Устаревшее.

заменено на add(String, int).
void addItemListener​(ItemListener l)

Добавляет указанного обработчика элементов для получения событий элементов из этого списка.
void addNotify()

Создаёт объект-виртуальную машину для списка.
boolean allowsMultipleSelections()

Устаревшее.

С версии JDK 1.1, заменено на isMultipleMode().
void clear()

Устаревшее.

С версии JDK 1.1, заменено на removeAll().
int countItems()

Устаревшее.

С версии JDK 1.1, заменено на getItemCount().
void delItem​(int position)

Устаревшее.

заменено на remove(String) и remove(int).
void delItems​(int start, int end)

Устаревшее.

С версии JDK 1.1, в дальнейшем не предназначен для публичного использования.
void deselect​(int index)

Отменяет выбор элемента в указанном индексе.
AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим List.
ActionListener[] getActionListeners()

Возвращает массив всех зарегистрированных обработчиков действий в этом списке.
String getItem​(int index)

Получает элемент, связанный с указанным индексом.
int getItemCount()

Возвращает количество элементов в списке.
ItemListener[] getItemListeners()

Возвращает массив всех зарегистрированных обработчиков элементов в этом списке.
String[] getItems()

Получает элементы в списке.
<T extends EventListener>
T[]		 getListeners​(Class<T> listenerType)

Возвращает массив всех объектов, в данный момент зарегистрированных как FooListener в этом List.
Dimension getMinimumSize()

Определяет минимальный размер этого списка прокрутки.
Dimension getMinimumSize​(int rows)

Получает минимальные размеры для списка с указанным количеством строк.
Dimension getPreferredSize()

Получает предпочтительный размер этого списка прокрутки.
Dimension getPreferredSize​(int rows)

Получает предпочтительные размеры для списка с указанным количеством строк.
int getRows()

Возвращает количество видимых строк в этом списке.
int getSelectedIndex()

Получает индекс выбранного элемента в списке.
int[] getSelectedIndexes()

Возвращает выбранные индексы в списке.
String getSelectedItem()

Получает выбранный элемент в этом списке прокрутки.
String[] getSelectedItems()

Возвращает выбранные элементы в этом списке прокрутки.
Object[] getSelectedObjects()

Получает выбранные элементы в этом списке прокрутки в массиве объектов.
int getVisibleIndex()

Получает индекс элемента, который был последним сделан видимым методом makeVisible.
boolean isIndexSelected​(int index)

Определяет, выбран ли указанный элемент в этом списке прокрутки.
boolean isMultipleMode()

Определяет, разрешает ли этот список множественный выбор.
boolean isSelected​(int index)

Устаревшее.

С версии JDK 1.1, заменено на isIndexSelected(int).
void makeVisible​(int index)

Делает элемент с указанным индексом видимым.
Dimension minimumSize()

Устаревшее.

С версии JDK 1.1, заменено на getMinimumSize().
Dimension minimumSize​(int rows)

Устаревшее.

С версии JDK 1.1, заменено на getMinimumSize(int).
protected String paramString()

Возвращает строку параметров, представляющую состояние этого списка прокрутки.
Dimension preferredSize()

Устаревшее.

С версии JDK 1.1, заменено на getPreferredSize().
Dimension preferredSize​(int rows)

Устаревшее.

С версии JDK 1.1, заменено на getPreferredSize(int).
protected void processActionEvent​(ActionEvent e)

Обрабатывает события действий, происходящие на этом компоненте, перенаправляя их любым зарегистрированным ActionListener объектам.
protected void processEvent​(AWTEvent e)

Обрабатывает события в этом списке прокрутки.
protected void processItemEvent​(ItemEvent e)

Обрабатывает события элементов, происходящие в этом списке, перенаправляя их любым зарегистрированным ItemListener объектам.
void remove​(int position)

Удаляет элемент в указанной позиции из этого списка прокрутки.
void remove​(String item)

Удаляет первое вхождение элемента из списка.
void removeActionListener​(ActionListener l)

Удаляет указанного обработчика действий, чтобы он больше не получал события действий из этого списка.
void removeAll()

Удаляет все элементы из этого списка.
void removeItemListener​(ItemListener l)

Удаляет указанного обработчика элементов, чтобы он больше не получал события элементов из этого списка.
void removeNotify()

Удаляет виртуальную машину для этого списка.
void replaceItem​(String newValue, int index)

Заменяет элемент в указанном индексе в списке прокрутки новой строкой.
void select​(int index)

Выбирает элемент в указанном индексе в списке прокрутки.
void setMultipleMode​(boolean b)

Устанавливает флаг, определяющий, разрешает ли этот список множественный выбор.
void setMultipleSelections​(boolean b)

Устаревшее.

С версии JDK 1.1, заменено на setMultipleMode(boolean).

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

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

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

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

Список

public List()
     throws HeadlessException

Создаёт новый список со скроллингом. По умолчанию отображается четыре строки и запрещено множественное выделение. Обратите внимание, что это удобный метод для List(0, false). Также обратите внимание, что количество отображаемых строк в списке изменить после его создания нельзя.

Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless()

Список

public List(int rows)
     throws HeadlessException

Создаёт новый список со скроллингом, инициализированный указанным количеством видимых строк. По умолчанию запрещено множественное выделение. Обратите внимание, что это удобный метод для List(rows, false). Также обратите внимание, что количество отображаемых строк в списке изменить после его создания нельзя.

Параметры:
rows - количество отображаемых элементов.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
С тех пор:
1.1
См. также:
GraphicsEnvironment.isHeadless()

Список

public List(int rows,
            boolean multipleMode)
     throws HeadlessException

Создаёт новый список со скроллингом, настроенный на отображение указанного количества строк. Если задано нулевое количество строк, список будет создан с четырьмя строками по умолчанию. Также обратите внимание, что количество видимых строк в списке изменить после его создания нельзя. Если значение multipleMode равно true, то пользователь может выбрать несколько элементов из списка. Если оно равно false, то можно выбирать только по одному элементу за раз.

Параметры:
rows - количество отображаемых элементов.
multipleMode - если true, то разрешено множественное выделение; в противном случае можно выбирать только один элемент за раз.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless()

Методы

addNotify

public void addNotify()

Создаёт пару для списка. Пара позволяет нам изменять внешний вид списка, не изменяя его функциональности.

Переопределяет:
addNotify в классе Component
См. также:
Component.isDisplayable(), Component.removeNotify(), Component.invalidate()

removeNotify

public void removeNotify()

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

Переопределяет:
removeNotify в классе Component
См. также:
Component.isDisplayable(), Component.addNotify()

getItemCount

public int getItemCount()

Получает количество элементов в списке.

Возвращает:
количество элементов в списке
С:
1.1
См. также:
getItem(int)

countItems

@Deprecated
public int countItems()
Устарело.
Начиная с версии JDK 1.1, заменено на getItemCount().

Возвращает количество элементов в списке.

Возвращает:
количество элементов в списке

getItem

public String getItem(int index)

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

Параметры:
index - позиция элемента
Возвращает:
элемент, связанный с указанным индексом
См. также:
getItemCount()

getItems

public String[] getItems()

Получает элементы в списке.

Возвращает:
массив строк, содержащих элементы списка
С:
1.1
См. также:
select(int), deselect(int), isIndexSelected(int)

add

public void add(String item)

Добавляет указанный элемент в конец прокручиваемого списка.

Параметры:
item - добавляемый элемент
С:
1.1

addItem

@Deprecated
public void addItem(String item)
Устарело.
заменено на add(String).

Добавляет указанный элемент в конец списка.

Параметры:
item - добавляемый элемент

add

public void add(String item,
                int index)

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

Параметры:
item - добавляемый элемент; если этот параметр null, то элемент обрабатывается как пустая строка, ""
index - позиция, в которую нужно добавить элемент
С:
1.1

addItem

@Deprecated
public void addItem(String item,
                    int index)
Устарело.
заменено на add(String, int).

Добавляет указанный элемент в список в позицию, указанную индексом.

Параметры:
item - добавляемый элемент
index - позиция, в которую нужно добавить элемент

replaceItem

public void replaceItem(String newValue,
                        int index)

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

Параметры:
newValue - новая строка для замены существующего элемента
index - позиция заменяемого элемента
Исключения:
ArrayIndexOutOfBoundsException - если index выходит за пределы диапазона

removeAll

public void removeAll()

Удаляет все элементы из этого списка.

С:
1.1
См. также:
remove(java.lang.String), delItems(int, int)

clear

@Deprecated
public void clear()
Устарело.
Начиная с версии JDK 1.1, заменено на removeAll().

remove

public void remove(String item)

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

Параметры:
item - элемент для удаления из списка
Исключения:
IllegalArgumentException - если элемента нет в списке
С:
1.1

remove

public void remove(int position)

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

Параметры:
position - индекс удаляемого элемента
Исключения:
ArrayIndexOutOfBoundsException - если position меньше 0 или больше getItemCount()-1
С:
1.1
См. также:
add(String, int)

delItem

@Deprecated
public void delItem(int position)
Устарело.
заменено на remove(String) и remove(int).

Удаляет элемент по указанной позиции.

Параметры:
position - индекс удаляемого элемента

getSelectedIndex

public int getSelectedIndex()

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

Возвращает:
индекс выбранного элемента; если ни один элемент не выбран или выбрано несколько элементов, возвращается -1.
См. также:
select(int), deselect(int), isIndexSelected(int)

getSelectedIndexes

public int[] getSelectedIndexes()

Получает выбранные индексы в списке.

Возвращает:
массив выбранных индексов в этом прокручиваемом списке; если ни один элемент не выбран, возвращается массив нулевой длины.
См. также:
select(int), deselect(int), isIndexSelected(int)

getSelectedItem

public String getSelectedItem()

Получает выбранный элемент в этом прокручиваемом списке.

Возвращает:
выбранный элемент в списке; если ни один элемент не выбран или выбрано несколько элементов, возвращается null.
См. также:
select(int), deselect(int), isIndexSelected(int)

getSelectedItems

public String[] getSelectedItems()

Получает выбранные элементы в этом прокручиваемом списке.

Возвращает:
массив выбранных элементов в этом прокручиваемом списке; если ни один элемент не выбран, возвращается массив нулевой длины.
См. также:
select(int), deselect(int), isIndexSelected(int)

getSelectedObjects

public Object[] getSelectedObjects()

Получает выбранные элементы в этом прокручиваемом списке в массиве объектов.

Определено в:
getSelectedObjects в интерфейсе ItemSelectable
Возвращает:
массив Object представляющих выбранные элементы в этом прокручиваемом списке; если ни один элемент не выбран, возвращается массив нулевой длины.
См. также:
getSelectedItems(), ItemSelectable

select

public void select(int index)

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

Обратите внимание, что передача параметров за пределами диапазона недопустима и приведёт к неопределённому поведению.

Обратите внимание, что этот метод в первую очередь используется для первоначального выбора элемента в этом компоненте. Программное вызов этого метода не вызовет ItemEvent. Единственный способ вызвать ItemEvent — взаимодействие пользователя.

Параметры:
index - позиция выбираемого элемента
См. также:
getSelectedItem(), deselect(int), isIndexSelected(int)

deselect

public void deselect(int index)

Снимает выделение с элемента по указанному индексу.

Обратите внимание, что передача параметров за пределами диапазона недопустима и приведёт к неопределённому поведению.

Если элемент по указанному индексу не выбран, операция игнорируется.

Параметры:
index - позиция отменяемого элемента
См. также:
select(int), getSelectedItem(), isIndexSelected(int)

isIndexSelected

public boolean isIndexSelected(int index)

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

Параметры:
index - проверяемый элемент
Возвращает:
true если указанный элемент выбран; false в противном случае
С:
1.1
См. также:
select(int), deselect(int)

isSelected

@Deprecated
public boolean isSelected(int index)
Устарело.
Начиная с версии JDK 1.1, заменено на isIndexSelected(int).

Определяет, выбран ли указанный элемент в списке.

Параметры:
index - указывает проверяемый элемент
Возвращает:
true если элемент выбран; в противном случае false

getRows

public int getRows()

Получает количество видимых строк в этом списке. Обратите внимание, что после создания List, это число никогда не изменится.

Возвращает:
количество видимых строк в этом прокручиваемом списке

isMultipleMode

public boolean isMultipleMode()

Определяет, разрешает ли этот список несколько выборов.

Возвращает:
true если этот список разрешает несколько выборов; в противном случае false
С:
1.1
См. также:
setMultipleMode(boolean)

allowsMultipleSelections

@Deprecated
public boolean allowsMultipleSelections()
Устарело.
Начиная с версии JDK 1.1, заменено на isMultipleMode().

Определяет, разрешает ли этот список несколько выборов.

Возвращает:
true если этот список разрешает несколько выборов; в противном случае false

setMultipleMode

public void setMultipleMode(boolean b)

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

Параметры:
b - если true , то разрешены множественные выборы; в противном случае, можно выбрать только один элемент из списка
С:
1.1
См. также:
isMultipleMode()

setMultipleSelections

@Deprecated
public void setMultipleSelections(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setMultipleMode(boolean).

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

Параметры:
b - true для включения множественного режима, false в противном случае

getVisibleIndex

public int getVisibleIndex()

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

Возвращает:
индекс элемента, который был последним отображен видимым
См. также:
makeVisible(int)

makeVisible

public void makeVisible(int index)

Делает видимым элемент с указанным индексом.

Параметры:
index - позиция элемента
См. также:
getVisibleIndex()

getPreferredSize

public Dimension getPreferredSize(int rows)

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

Параметры:
rows - количество строк в списке
Возвращает:
предпочтительные размеры для отображения этого прокручиваемого списка, учитывая, что указанное количество строк должно быть видимым
С:
1.1
См. также:
Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize(int rows)
Устарело.
Начиная с версии JDK 1.1, заменено на getPreferredSize(int).

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

Параметры:
rows - количество строк
Возвращает:
предпочтительные размеры для отображения этого списка

getPreferredSize

public Dimension getPreferredSize()

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

Переопределяет:
getPreferredSize в классе Component
Возвращает:
предпочтительные размеры для отображения этого прокручиваемого списка
С:
1.1
См. также:
Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getPreferredSize().

Описание скопировано из класса: Component

Возвращает предпочтительный размер компонента.

Переопределяет:
preferredSize в классе Component
Возвращает:
предпочтительный размер компонента

getMinimumSize

public Dimension getMinimumSize(int rows)

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

Параметры:
rows - количество строк в списке
Возвращает:
минимальные размеры для отображения этого прокручиваемого списка при условии, что указанное количество строк должно быть видимым
С:
1.1
См. также:
Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize(int rows)
Устарело.
Начиная с версии JDK 1.1, заменено на getMinimumSize(int).

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

Параметры:
rows - количество строк в списке
Возвращает:
минимальные размеры для отображения этого списка

getMinimumSize

public Dimension getMinimumSize()

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

Переопределяет:
getMinimumSize в классе Component
Возвращает:
минимальные размеры, необходимые для отображения этого прокручиваемого списка
С:
1.1
См. также:
Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getMinimumSize().

Описание скопировано из класса: Component

Возвращает минимальный размер этого компонента.

Переопределяет:
minimumSize в классе Component
Возвращает:
минимальный размер этого компонента

addItemListener

public void addItemListener(ItemListener l)

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

Обратитесь к AWT Threading Issues за подробностями о модели потоков AWT.

Указано в:
addItemListener в интерфейсе ItemSelectable
Параметры:
l - обработчик событий элементов
С:
1.1
См. также:
removeItemListener(java.awt.event.ItemListener), getItemListeners(), select(int), deselect(int), ItemEvent, ItemListener

removeItemListener

public void removeItemListener(ItemListener l)

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

Обратитесь к AWT Threading Issues за подробностями о модели потоков AWT.

Указано в:
removeItemListener в интерфейсе ItemSelectable
Параметры:
l - обработчик событий элементов
С:
1.1
См. также:
addItemListener(java.awt.event.ItemListener), getItemListeners(), ItemEvent, ItemListener

getItemListeners

public ItemListener[] getItemListeners()

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

Возвращает:
все обработчики событий элементов этого списка или пустой массив, если обработчики событий элементов не зарегистрированы
С:
1.4
См. также:
addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener), ItemEvent, ItemListener

addActionListener

public void addActionListener(ActionListener l)

Добавляет указанный обработчик событий действий для получения событий действий от этого списка. События действий происходят, когда пользователь дважды щелкает элемент списка или нажимает Enter, когда список имеет фокус клавиатуры.

Если обработчик l равен null, исключение не выбрасывается, и действие не выполняется.

Обратитесь к AWT Threading Issues за подробностями о модели потоков AWT.

Параметры:
l - обработчик событий действий
С:
1.1
См. также:
removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener

removeActionListener

public void removeActionListener(ActionListener l)

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

Обратитесь к AWT Threading Issues за подробностями о модели потоков AWT.

Параметры:
l - обработчик событий действий
С:
1.1
См. также:
addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener

getActionListeners

public ActionListener[] getActionListeners()

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

Возвращает:
все ActionListener этого списка или пустой массив, если обработчики событий действия в настоящее время не зарегистрированы
С момента:
1.4
См. также:
addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), ActionEvent, ActionListener

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

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

Вы можете указать аргумент listenerType с помощью литерала класса, например, FooListener.class. Например, вы можете запросить обработчики элементов List l с помощью следующего кода: 

ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));
Если такие обработчики не существуют, этот метод возвращает пустой массив.
Переопределяет:
getListeners в классе Component
Типы параметров:
T - тип обработчиков
Параметры:
listenerType - тип запрашиваемых обработчиков; этот параметр должен указывать интерфейс, который происходит от java.util.EventListener
Возвращает:
массив всех объектов, зарегистрированных в качестве FooListener в этом списке, или пустой массив, если такие обработчики не были добавлены
Исключения:
ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener
С момента:
1.3
См. также:
getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

Обрабатывает события в этом списке прокрутки. Если событие является экземпляром ItemEvent, вызывается метод processItemEvent. В противном случае, если событие является экземпляром ActionEvent, вызывается processActionEvent. Если событие не является событием элемента или событием действия, вызывается processEvent в суперклассе.

Обратите внимание, что если параметр события является null, поведение не определено и может привести к исключению.

Переопределяет:
processEvent в классе Component
Параметры:
e - событие
С момента:
1.1
См. также:
ActionEvent, ItemEvent, processActionEvent(java.awt.event.ActionEvent), processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent e)

Обрабатывает события элементов, происходящие в этом списке, передавая их всем зарегистрированным объектам ItemListener.

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

  • Объект ItemListener регистрируется через addItemListener.
  • События элементов включены через enableEvents.

Обратите внимание, что если параметр события null, поведение не определено и может привести к исключению.

Параметры:
e - событие элемента
С момента:
1.1
См. также:
ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), Component.enableEvents(long)

processActionEvent

protected void processActionEvent(ActionEvent e)

Обрабатывает события действий, происходящие в этом компоненте, передавая их всем зарегистрированным объектам ActionListener.

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

  • Объект ActionListener регистрируется через addActionListener.
  • События действия включены через enableEvents.

Обратите внимание, что если параметр события null, поведение не определено и может привести к исключению.

Параметры:
e - событие действия
С момента:
1.1
См. также:
ActionEvent, ActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)

paramString

protected String paramString()

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

Переопределяет:
paramString в классе Component
Возвращает:
строку параметров этого списка прокрутки

delItems

@Deprecated
public void delItems(int start,
                     int end)
Устарело.
С версии JDK 1.1, не для использования в будущем. Этот метод ожидается, чтобы остаться только как пакетный метод.

Удаляет элементы списка в указанном диапазоне индексов.

Параметры:
start - начальный индекс диапазона для удаления
end - конечный индекс диапазона для удаления

getAccessibleContext

public AccessibleContext getAccessibleContext()

Получает AccessibleContext , связанный с этим List. Для списков AccessibleContext имеет вид AccessibleAWTList. Новый экземпляр AccessibleAWTList создается при необходимости.

Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
объект AccessibleAWTList, который служит AccessibleContext этого List
С момента:
1.3

© 1993, 2020, 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/awt/List.html

Spec-Zone .ru
спецификации, руководства, описания, API