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

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 с четырьмя строками, так что 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`.

Вложенные классы/интерфейсы, объявленные в классе 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

END_OF_DOCUMENT_MARKER

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

Список

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

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

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

Возвращает:

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

С:

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

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

Возвращает:

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

С:

1.4

См. также:

getListeners

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

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

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

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

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

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

getListeners в классе Component

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

С:

1.3

См. также:

обработкаСобытия

protected void processEvent(AWTEvent e)

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

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

Overrides:

processEvent в классе Component

Parameters:

e - событие

Since:

1.1

See Also:

обработкаСобытияЭлемента

protected void processItemEvent(ItemEvent e)

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

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

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

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

Parameters:

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

Since:

1.1

See Also:

обработкаСобытияДействия

protected void processActionEvent(ActionEvent e)

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

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

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

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

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, 2023, 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/21/docs/api/java.desktop/java/awt/List.html