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

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.

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

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

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

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

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

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

С:

1.0

См. также:

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

Модификатор и тип	Класс	Описание
`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.

См. также:

Список

public List(int rows) throws HeadlessException

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

Параметры:

rows - количество элементов для отображения.

Исключения:

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

С:

1.1

См. также:

Список

public List(int rows, boolean multipleMode) throws HeadlessException

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

Параметры:

rows - количество элементов для отображения.

multipleMode - если true, то разрешен множественный выбор; в противном случае можно выбрать только один элемент за раз.

Исключения:

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

См. также:

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

addNotify

public void addNotify()

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

Переопределяет:

addNotify в классе Component

См. также:

removeNotify

public void removeNotify()

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

Переопределяет:

removeNotify в классе Component

См. также:

getItemCount

public int getItemCount()

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

Возвращает:

количество элементов в списке

С:

1.1

См. также:

countItems

@Deprecated public int countItems()

Устарело.

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

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

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

getItem

public String getItem(int index)

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

Параметры:

index - позиция элемента

Возвращает:

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

См. также:

getItems

public String[] getItems()

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

Возвращает:

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

С:

1.1

См. также:

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

См. также:

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

См. также:

delItem

@Deprecated public void delItem(int position)

Устарело.

заменено на remove(String) и remove(int).

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

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

END_OF_DOCUMENT_MARKER

getSelectedIndex

public int getSelectedIndex()

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

Возвращает:

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

См. также:

getSelectedIndexes

public int[] getSelectedIndexes()

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

Возвращает:

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

См. также:

getSelectedItem

public String getSelectedItem()

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

Возвращает:

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

См. также:

getSelectedItems

public String[] getSelectedItems()

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

Возвращает:

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

См. также:

getSelectedObjects

public Object[] getSelectedObjects()

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

Определяется:

getSelectedObjects в интерфейсе ItemSelectable

Возвращает:

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

См. также:

select

public void select(int index)

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

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

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

Параметры:

index - позиция элемента для выделения

См. также:

deselect

public void deselect(int index)

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

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

Параметры:

index - позиция элемента для снятия выделения

См. также:

isIndexSelected

public boolean isIndexSelected(int index)

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

Параметры:

index - проверяемый элемент

Возвращает:

true, если указанный элемент выбран; false в противном случае

С:

1.1

См. также:

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

См. также:

allowsMultipleSelections

@Deprecated public boolean allowsMultipleSelections()

Устаревшее.

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

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

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

setMultipleMode

public void setMultipleMode(boolean b)

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

Параметры:

b - если true, то разрешается множественный выбор; в противном случае, только один элемент из списка может быть выбран одновременно

С:

1.1

См. также:

setMultipleSelections

@Deprecated public void setMultipleSelections(boolean b)

Устаревшее.

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

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

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

getVisibleIndex

public int getVisibleIndex()

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

Возвращает:

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

См. также:

makeVisible

public void makeVisible(int index)

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

Параметры:

index - позиция элемента

См. также:

getPreferredSize

public Dimension getPreferredSize(int rows)

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

Параметры:

rows - количество строк в списке

Возвращает:

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

С:

1.1

См. также:

preferredSize

@Deprecated public Dimension preferredSize(int rows)

Устаревшее.

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

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

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

getPreferredSize

public Dimension getPreferredSize()

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

Overrides:

getPreferredSize в классе Component

Returns:

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

Since:

1.1

See Also:

preferredSize

@Deprecated public Dimension preferredSize()

Устарело.

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

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

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

Overrides:: preferredSize в классе Component
Returns:: предпочтительный размер компонента

getMinimumSize

public Dimension getMinimumSize(int rows)

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

Parameters:

rows - количество строк в списке

Returns:

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

Since:

1.1

See Also:

minimumSize

@Deprecated public Dimension minimumSize(int rows)

Устарело.

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

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

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

getMinimumSize

public Dimension getMinimumSize()

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

Overrides:

getMinimumSize в классе Component

Returns:

минимальные размеры, необходимые для отображения этого списка прокрутки

Since:

1.1

See Also:

minimumSize

@Deprecated public Dimension minimumSize()

Устарело.

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

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

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

Overrides:: minimumSize в классе Component
Returns:: минимальный размер этого компонента

addItemListener

public void addItemListener(ItemListener l)

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

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

Specified by:

addItemListener в интерфейсе ItemSelectable

Parameters:

l - слушатель элементов

Since:

1.1

See Also:

removeItemListener

public void removeItemListener(ItemListener l)

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

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

Specified by:

removeItemListener в интерфейсе ItemSelectable

Parameters:

l - слушатель элементов

Since:

1.1

See Also:

getItemListeners

public ItemListener[] getItemListeners()

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

Returns:

все слушатели элементов этого списка или пустой массив, если слушатели элементов не зарегистрированы

Since:

1.4

See Also:

addActionListener

public void addActionListener(ActionListener l)

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

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

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

Parameters:

l - слушатель действий

Since:

1.1

See Also:

removeActionListener

public void removeActionListener(ActionListener l)

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

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

Parameters:

l - слушатель действий

Since:

1.1

See Also:

getActionListeners

public ActionListener[] getActionListeners()

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

Returns:

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

Since:

1.4

See Also:

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

Если таких слушателей нет, этот метод возвращает пустой массив.

Overrides:

getListeners в классе Component

Type Parameters:

T - тип слушателей

Parameters:

listenerType - тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, являющийся потомком java.util.EventListener

Returns:

массив всех объектов, зарегистрированных в качестве FooListener в этом списке, или пустой массив, если такие слушатели не были добавлены

Throws:

ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

Since:

1.3

See Also:

processEvent

protected void processEvent(AWTEvent e)

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

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

Overrides:

processEvent в классе Component

Parameters:

e - событие

Since:

1.1

See Also:

processItemEvent

protected void processItemEvent(ItemEvent e)

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

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

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

Parameters:

e - событие элемента

Since:

1.1

See Also:

processActionEvent

protected void processActionEvent(ActionEvent e)

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

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

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

Parameters:

e - событие действия

Since:

1.1

See Also:

paramString

protected String paramString()

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

Overrides:: paramString в классе Component
Returns:: строка параметров этого списка с прокруткой

delItems

@Deprecated public void delItems(int start, int end)

Deprecated.

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

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

Parameters:: start - начальный индекс диапазона для удаления; end - конечный индекс диапазона для удаления

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Returns:: AccessibleAWTList, который служит AccessibleContext этого List
Since:: 1.3

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/List.html