Список List

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 не допускает множественный выбор, выбор элемента снимает выделение с любого другого выбранного элемента.

Обратите внимание, что список в показанном примере был создан с четырьмя видимыми строками. После создания списка изменить количество видимых строк нельзя. По умолчанию 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

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`List.AccessibleAWTList`	Этот класс реализует поддержку специальных возможностей для класса `List`.

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

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе 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()`	Создает peer-объект списка.
`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`s для этого `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()`	Удаляет peer-объект этого списка.
`void`	`replaceItem(String newValue, int index)`	Заменяет элемент с указанным индексом в прокручиваемом списке новой строкой.
`void`	`select(int index)`	Выбирает элемент с указанным индексом в прокручиваемом списке.
`void`	`setMultipleMode(boolean b)`	Устанавливает флаг, определяющий, допускает ли этот список множественный выбор.
`void`	`setMultipleSelections(boolean b)`	Устарел. Начиная с JDK версии 1.1, заменен на `setMultipleMode(boolean)`.

Методы, объявленные в классе 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

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

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

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

List

public List() throws HeadlessException

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

Исключения:

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

См. также:

List

public List(int rows) throws HeadlessException

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

Параметры:

rows — число отображаемых элементов.

Исключения:

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

Начиная с версии:

1.1

См. также:

List

public List(int rows, boolean multipleMode) throws HeadlessException

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

Параметры:

rows — число отображаемых элементов.

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

Исключения:

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

См. также:

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

addNotify

public void addNotify()

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

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

addNotify в классе Component

См. также:

removeNotify

public void removeNotify()

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

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

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 — индекс удаляемого элемента

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

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

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

getPreferredSize в классе Component

Возвращает:

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

Начиная с версии:

1.1

См. также:

preferredSize

@Deprecated public Dimension preferredSize()

Устарело.

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

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

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

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

getMinimumSize

public Dimension getMinimumSize(int rows)

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

Параметры:

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

Возвращает:

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

Начиная с версии:

1.1

См. также:

minimumSize

@Deprecated public Dimension minimumSize(int rows)

Устарело.

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

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

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

getMinimumSize

public Dimension getMinimumSize()

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

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

getMinimumSize в классе Component

Возвращает:

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

Начиная с версии:

1.1

См. также:

minimumSize

@Deprecated public Dimension minimumSize()

Устарело.

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

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

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

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

addItemListener

public void addItemListener(ItemListener l)

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

Подробную информацию о модели многопоточности AWT см. в разделе Проблемы многопоточности AWT.

Определено в:

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

Параметры:

l — прослушиватель элементов

Начиная с версии:

1.1

См. также:

removeItemListener

public void removeItemListener(ItemListener l)

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

Подробную информацию о модели многопоточности AWT см. в разделе Проблемы многопоточности AWT.

Определено в:

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

Параметры:

l — прослушиватель элементов

Начиная с версии:

1.1

См. также:

getItemListeners

public ItemListener[] getItemListeners()

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

Возвращает:

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

Начиная с версии:

1.4

См. также:

addActionListener

public void addActionListener(ActionListener l)

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

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

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

Параметры:

l — прослушиватель действий

С:

1.1

См. также:

removeActionListener

public void removeActionListener(ActionListener l)

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

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

Параметры:

l — прослушиватель действий

С:

1.1

См. также:

getActionListeners

public ActionListener[] getActionListeners()

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

Возвращает:

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

С:

1.4

См. также:

getListeners

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

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

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

ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));

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

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

getListeners в классе Component

Параметры типа:

T — тип прослушивателей

Параметры:

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

Возвращает:

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

Выбрасывает:

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

С:

1.3

См. также:

processEvent

protected void processEvent(AWTEvent e)

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

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

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

processEvent в классе Component

Параметры:

e — событие

С:

1.1

См. также:

processItemEvent

protected void processItemEvent(ItemEvent e)

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

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

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

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

Параметры:

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

С:

1.1

См. также:

processActionEvent

protected void processActionEvent(ActionEvent e)

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

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

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

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

Параметры:

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

С:

1.1

См. также:

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, 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/List.html