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

java.lang.Object
- java.awt.Component
- - java.awt.List

Все реализованные интерфейсы:: 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.

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

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

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

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

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

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

С момента:: JDK1.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, getPeer, 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, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, 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

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

List

public List()
     throws HeadlessException

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

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

List

public List(int rows)
     throws HeadlessException

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

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

List

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()

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

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

countItems

@Deprecated
public int countItems()

Устарело. С версии JDK 1.1 заменено на getItemCount().

getItem

public String getItem(int index)

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

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

getItems

public String[] getItems()

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

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

add

public void add(String item)

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

Параметры:: item - добавляемый элемент
С версии:: JDK1.1

addItem

@Deprecated
public void addItem(String item)

Устарело. заменено на add(String).

add

public void add(String item,
                int index)

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

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

addItem

@Deprecated
public void addItem(String item,
                                int index)

Устарело. заменено на add(String, int).

replaceItem

public void replaceItem(String newValue,
                        int index)

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

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

removeAll

public void removeAll()

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

С версии:: JDK1.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 - если элемент не существует в списке
С версии:: JDK1.1

remove

public void remove(int position)

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

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

delItem

@Deprecated
public void delItem(int position)

Устарело. заменено на remove(String) и remove(int).

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
Возвращает:: массив Objects, представляющих выбранные элементы в этом списке со скроллингом; если ни один элемент не выбран, возвращается массив нулевой длины.
См. также:: 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 в противном случае
С:: JDK1.1
См. также:: select(int), deselect(int)

isSelected

@Deprecated
public boolean isSelected(int index)

Устаревшее. Начиная с версии JDK 1.1, заменено на isIndexSelected(int).

getRows

public int getRows()

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

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

isMultipleMode

public boolean isMultipleMode()

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

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

allowsMultipleSelections

@Deprecated
public boolean allowsMultipleSelections()

Устаревшее. Начиная с версии JDK 1.1, заменено на isMultipleMode().

setMultipleMode

public void setMultipleMode(boolean b)

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

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

setMultipleSelections

@Deprecated
public void setMultipleSelections(boolean b)

Устаревшее. Начиная с версии JDK 1.1, заменено на setMultipleMode(boolean).

getVisibleIndex

public int getVisibleIndex()

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

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

makeVisible

public void makeVisible(int index)

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

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

getPreferredSize

public Dimension getPreferredSize(int rows)

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

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

preferredSize

@Deprecated
public Dimension preferredSize(int rows)

Устаревшее. Начиная с версии JDK 1.1, заменено на getPreferredSize(int).

getPreferredSize

public Dimension getPreferredSize()

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

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

preferredSize

@Deprecated
public Dimension preferredSize()

Устаревшее. Начиная с версии JDK 1.1, заменено на getPreferredSize().

Переопределяет:: preferredSize в классе Component

getMinimumSize

public Dimension getMinimumSize(int rows)

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

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

minimumSize

@Deprecated
public Dimension minimumSize(int rows)

Устаревшее. Начиная с версии JDK 1.1, заменено на getMinimumSize(int).

getMinimumSize

public Dimension getMinimumSize()

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

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

minimumSize

@Deprecated
public Dimension minimumSize()

Устаревшее. Начиная с версии JDK 1.1, заменено на getMinimumSize().

Переопределяет:: minimumSize в классе Component

addItemListener

public void addItemListener(ItemListener l)

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

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

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

removeItemListener

public void removeItemListener(ItemListener l)

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

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

Определено в:: removeItemListener в интерфейсе ItemSelectable
Параметры:: l - обработчик событий элемента
С:: JDK1.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 для получения подробностей о модели потоков AWT.

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

removeActionListener

public void removeActionListener(ActionListener l)

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

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

Параметры:: l - обработчик событий действия
С:: JDK1.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
Параметры:: 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 - событие
С момента:: JDK1.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 - событие элемента
С момента:: JDK1.1
См. также:: ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), Component.enableEvents(long)

processActionEvent

protected void processActionEvent(ActionEvent e)

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

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

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

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

Параметры:: e - событие действия
С момента:: JDK1.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, не предназначен для публичного использования в будущем. Ожидается, что этот метод будет сохранён только как метод пакета.

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.