Spec-Zone.ru › OpenJDK 17

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

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, Abstract Window Toolkit отправляет объекту List все события мыши, клавиатуры и фокуса, которые происходят над ним. (Старая модель событий AWT поддерживается только для обратной совместимости, и ее использование не рекомендуется.)

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

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

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

Since:
1.0
См. также:
  • ItemEvent
  • ItemListener
  • ActionEvent
  • ActionListener
  • Сериализованная форма

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

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

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

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

Конструктор Описание
List()
Создает новый прокручиваемый список.
List(int rows)
Создает новый прокручиваемый список, инициализированный указанным количеством видимых строк.
List(int rows, boolean multipleMode)
Создает новый прокручиваемый список, инициализированный для отображения указанного количества строк.

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

Модификатор и тип Метод Описание
void add(String item)
Добавляет указанный элемент в конец списка прокрутки.
void add(String item, int index)
Добавляет указанный элемент в список прокрутки в позиции, указанной индексом.
void addActionListener(ActionListener l)
Добавляет указанный слушатель событий к этому списку для получения событий действий.
void addItem(String item)
Устарело.
заменено на add(String).
void addItem(String item, int index)
Устарело.
заменено на add(String, int).
void addItemListener(ItemListener l)
Добавляет указанного слушателя элементов для получения событий элементов из этого списка.
void addNotify()
Создаёт пару для списка.
boolean allowsMultipleSelections()
Устарело.
С версии JDK 1.1, заменено на isMultipleMode().
void clear()
Устарело.
С версии JDK 1.1, заменено на removeAll().
int countItems()
Устарело.
С версии JDK 1.1, заменено на getItemCount().
void delItem(int position)
Устарело.
заменено на remove(String) и remove(int).
void delItems(int start, int end)
Устарело.
С версии JDK 1.1, не предназначено для публичного использования в будущем.
void deselect(int index)
Деселектирует элемент по указанному индексу.
AccessibleContext getAccessibleContext()
Получает AccessibleContext , связанное с этим List.
ActionListener[] getActionListeners()
Возвращает массив всех зарегистрированных слушателей событий действий в этом списке.
String getItem(int index)
Получает элемент, связанный с указанным индексом.
int getItemCount()
Получает количество элементов в списке.
ItemListener[] getItemListeners()
Возвращает массив всех зарегистрированных слушателей элементов в этом списке.
String[] getItems()
Получает элементы в списке.
<T extends EventListener>
T[]		 getListeners(Class<T> listenerType)
Возвращает массив всех объектов, текуще зарегистрированных как FooListener в этом List.
Dimension getMinimumSize()
Определяет минимальный размер этого списка прокрутки.
Dimension getMinimumSize(int rows)
Получает минимальные размеры для списка с указанным количеством строк.
Dimension getPreferredSize()
Получает предпочтительный размер этого списка прокрутки.
Dimension getPreferredSize(int rows)
Получает предпочтительные размеры для списка с указанным количеством строк.
int getRows()
Получает количество видимых строк в этом списке.
int getSelectedIndex()
Получает индекс выбранного элемента в списке.
int[] getSelectedIndexes()
Получает выбранные индексы в списке.
String getSelectedItem()
Получает выбранный элемент в этом списке прокрутки.
String[] getSelectedItems()
Получает выбранные элементы в этом списке прокрутки.
Object[] getSelectedObjects()
Получает выбранные элементы в этом списке прокрутки в массиве объектов.
int getVisibleIndex()
Получает индекс элемента, который был последний раз сделан видимым методом makeVisible.
boolean isIndexSelected(int index)
Определяет, выбран ли указанный элемент в этом списке прокрутки.
boolean isMultipleMode()
Определяет, позволяет ли этот список несколько выборов.
boolean isSelected(int index)
Устарело.
С версии JDK 1.1, заменено на isIndexSelected(int).
void makeVisible(int index)
Делает элемент по указанному индексу видимым.
Dimension minimumSize()
Устарело.
С версии JDK 1.1, заменено на getMinimumSize().
Dimension minimumSize(int rows)
Устарело.
С версии JDK 1.1, заменено на getMinimumSize(int).
protected String paramString()
Возвращает строку параметра, представляющую состояние этого списка прокрутки.
Dimension preferredSize()
Устарело.
С версии JDK 1.1, заменено на getPreferredSize().
Dimension preferredSize(int rows)
Устарело.
С версии JDK 1.1, заменено на getPreferredSize(int).
protected void processActionEvent(ActionEvent e)
Обрабатывает события действий, происходящие на этом компоненте, перенаправляя их всем зарегистрированным объектам ActionListener.
protected void processEvent(AWTEvent e)
Обрабатывает события в этом списке прокрутки.
protected void processItemEvent(ItemEvent e)
Обрабатывает события элементов, происходящие в этом списке, перенаправляя их всем зарегистрированным объектам ItemListener.
void remove(int position)
Удаляет элемент в указанной позиции из этого списка прокрутки.
void remove(String item)
Удаляет первое вхождение элемента из списка.
void removeActionListener(ActionListener l)
Удаляет указанного слушателя событий действий, чтобы он больше не получал события действий из этого списка.
void removeAll()
Удаляет все элементы из этого списка.
void removeItemListener(ItemListener l)
Удаляет указанного слушателя элементов, чтобы он больше не получал события элементов из этого списка.
void removeNotify()
Удаляет пару для этого списка.
void replaceItem(String newValue, int index)
Заменяет элемент в указанной позиции в списке прокрутки новой строкой.
void select(int index)
Выбирает элемент в указанной позиции в списке прокрутки.
void setMultipleMode(boolean b)
Устанавливает флаг, определяющий, разрешает ли этот список несколько выборов.
void setMultipleSelections(boolean b)
Устарело.
С версии JDK 1.1, заменено на setMultipleMode(boolean).

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

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

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

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

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

Список

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

Список

public List(int rows) throws HeadlessException
Создаёт новый список со скроллингом, инициализированный указанным количеством видимых строк. По умолчанию несколько выделений запрещены. Обратите внимание, что это удобный метод для List(rows, false). Также обратите внимание, что количество видимых строк в списке изменить после его создания нельзя.
Параметры:
rows - количество элементов для отображения.
Возбуждает:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
С:
1.1
См. также:
  • GraphicsEnvironment.isHeadless()

Список

public List(int rows, boolean multipleMode) throws HeadlessException
Создаёт новый список со скроллингом, инициализированный для отображения указанного количества строк. Обратите внимание, что если указано ноль строк, список будет создан с четырьмя строками по умолчанию. Также обратите внимание, что количество видимых строк в списке изменить после его создания нельзя. Если значение multipleMode равно true, то пользователь может выбрать несколько элементов из списка. Если оно равно false, то можно выбирать только один элемент за раз.
Параметры:
rows - количество элементов для отображения.
multipleMode - если true, то разрешены несколько выделений; в противном случае можно выбрать только один элемент за раз.
Возбуждает:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
  • GraphicsEnvironment.isHeadless()

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

addNotify

public void addNotify()
Создаёт виджет (peer) для списка. Виджет позволяет изменять внешний вид списка без изменения его функциональности.
Переопределяет:
addNotify в классе Component
См. также:
  • Component.isDisplayable()
  • Component.removeNotify()
  • Component.invalidate()

removeNotify

public void removeNotify()
Удаляет виджет (peer) для этого списка. Виджет позволяет изменять внешний вид списка без изменения его функциональности.
Переопределяет:
removeNotify в классе Component
См. также:
  • Component.isDisplayable()
  • Component.addNotify()

getItemCount

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

countItems

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

getItem

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

getItems

public String[] getItems()
Возвращает элементы в списке.
Возвращает:
массив строк, содержащий элементы списка
С:
1.1
См. также:
  • select(int)
  • deselect(int)
  • isIndexSelected(int)

add

public void add(String item)
Добавляет указанный элемент в конец списка со скроллингом.
Параметры:
item - добавляемый элемент
С:
1.1

addItem

@Deprecated public void addItem(String item)
Устарело.
заменено на add(String).
Добавляет указанный элемент в конец списка.
Параметры:
item - добавляемый элемент

add

public void add(String item, int index)
Добавляет указанный элемент в список со скроллингом в позицию, указанную индексом. Индекс нулевой. Если значение индекса меньше нуля или больше или равно количеству элементов в списке, то элемент добавляется в конец списка.
Параметры:
item - добавляемый элемент; если этот параметр null, то элемент обрабатывается как пустая строка, "".
index - позиция для добавления элемента
С:
1.1

addItem

@Deprecated public void addItem(String item, int index)
Устарело.
заменено на add(String, int).
Добавляет указанный элемент в список в позицию, указанную индексом.
Параметры:
item - добавляемый элемент
index - позиция для добавления элемента

replaceItem

public void replaceItem(String newValue, int index)
Заменяет элемент в списке со скроллингом по указанному индексу новой строкой.
Параметры:
newValue - новая строка для замены существующего элемента
index - позиция заменяемого элемента
Возбуждает:
ArrayIndexOutOfBoundsException - если index находится вне допустимого диапазона

removeAll

public void removeAll()
Удаляет все элементы из этого списка.
С:
1.1
См. также:
  • remove(java.lang.String)
  • delItems(int, int)

clear

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

remove

public void remove(String item)
Удаляет первое вхождение элемента из списка. Если указанный элемент выделен и является единственным выделенным элементом в списке, выбор в списке снимается.
Параметры:
item - элемент для удаления из списка
Возбуждает:
IllegalArgumentException - если элемента нет в списке
С:
1.1

remove

public void remove(int position)
Удаляет элемент по указанной позиции из этого списка со скроллингом. Если элемент с указанной позицией выделен и является единственным выделенным элементом в списке, выбор в списке снимается.
Параметры:
position - индекс удаляемого элемента
Возбуждает:
ArrayIndexOutOfBoundsException - если position меньше 0 или больше getItemCount()-1
С:
1.1
См. также:
  • add(String, int)

delItem

@Deprecated public void delItem(int position)
Устарело.
заменено на remove(String) и remove(int).
Удаляет элемент по указанной позиции.
Параметры:
position - индекс удаляемого элемента

getSelectedIndex

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

getSelectedIndexes

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

getSelectedItem

public String getSelectedItem()
Получает выделенный элемент в этом списке.
Возвращает:
выделенный элемент в списке; если нет выделенного элемента или выделено несколько элементов, возвращается null.
См. также:
  • select(int)
  • deselect(int)
  • isIndexSelected(int)

getSelectedItems

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

getSelectedObjects

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

select

public void select(int index)
Выбирает элемент по указанному индексу в списке.

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

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

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

deselect

public void deselect(int index)
Снимает выделение с элемента по указанному индексу.

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

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

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

isIndexSelected

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

isSelected

@Deprecated public boolean isSelected(int index)
Устарело.
С версии JDK 1.1, заменено на isIndexSelected(int).
Определяет, выбран ли указанный элемент в списке.
Параметры:
index - проверяемый элемент
Возвращает:
true если элемент выбран; в противном случае false

getRows

public int getRows()
Получает количество видимых строк в этом списке. Обратите внимание, что после создания List, это число никогда не изменится.
Возвращает:
количество видимых строк в этом списке.

isMultipleMode

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

allowsMultipleSelections

@Deprecated public boolean allowsMultipleSelections()
Устарело.
С версии JDK 1.1, заменено на isMultipleMode().
Определяет, разрешены ли в этом списке множественные выделения.
Возвращает:
true если в этом списке разрешены множественные выделения; в противном случае false

setMultipleMode

public void setMultipleMode(boolean b)
Устанавливает флаг, определяющий, разрешены ли в этом списке множественные выделения. При изменении режима выбора с множественного на одиночный, выделенные элементы меняются следующим образом: если выделенный элемент имеет указатель курсора, только этот элемент останется выделенным. Если ни один выделенный элемент не имеет указатель курсора, все элементы будут сняты с выделения.
Параметры:
b - если true то разрешены множественные выделения; в противном случае, можно выбрать только один элемент из списка
См. также:
  • isMultipleMode()

setMultipleSelections

@Deprecated public void setMultipleSelections(boolean b)
Устарело.
С версии JDK 1.1, заменено на setMultipleMode(boolean).
Включает или выключает режим множественного выбора для этого списка.
Параметры:
b - true для включения множественного режима, false в противном случае

getVisibleIndex

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

makeVisible

public void makeVisible(int index)
Делает элемент по указанному индексу видимым.
Параметры:
index - позиция элемента
См. также:
  • getVisibleIndex()

getPreferredSize

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

preferredSize

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

getPreferredSize

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

preferredSize

@Deprecated public Dimension preferredSize()
Устарело.
С версии JDK 1.1, заменено на getPreferredSize().
Описание скопировано из класса: Component
Возвращает предпочтительные размеры компонента.
Переопределяет:
preferredSize в классе Component
Возвращает:
предпочтительные размеры компонента
END_OF_DOCUMENT_MARKER

getMinimumSize

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

minimumSize

@Deprecated public Dimension minimumSize(int rows)
Устарело.
Начиная с версии JDK 1.1, заменено на getMinimumSize(int).
Возвращает минимальные размеры списка с указанным числом строк.
Параметры:
rows - количество строк в списке
Возвращает:
минимальные размеры для отображения этого списка

getMinimumSize

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

minimumSize

@Deprecated public Dimension minimumSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getMinimumSize().
Описание скопировано из класса: Component
Возвращает минимальный размер этого компонента.
Переопределяет:
minimumSize в классе Component
Возвращает:
минимальный размер этого компонента

addItemListener

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

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

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

removeItemListener

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

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

Определено в:
removeItemListener в интерфейсе ItemSelectable
Параметры:
l - слушатель событий элементов
С:
1.1
См. также:
  • addItemListener(java.awt.event.ItemListener)
  • getItemListeners()
  • ItemEvent
  • ItemListener

getItemListeners

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

addActionListener

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

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

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

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

removeActionListener

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

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

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

getActionListeners

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

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)
Возвращает массив всех объектов, зарегистрированных как FooListener в этом List. FooListener регистрируются с помощью метода addFooListener.

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

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

Обработка события

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

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

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

Обработка события элемента

protected void processItemEvent(ItemEvent e)
Обрабатывает события элементов в этом списке, рассылаея их зарегистрированным объектам ItemListener.

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

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

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

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

Обработка события действия

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

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

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

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

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

paramString

protected String paramString()
Возвращает строку параметров, представляющую состояние этого списка прокрутки. Эта строка полезна для отладки.
Переопределяет:
paramString в классе Component
Возвращает:
строку параметров этого списка прокрутки

delItems

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

getAccessibleContext

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

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/List.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API