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

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

Модификатор и тип	Класс	Описание
`protected class`	`Component.AccessibleAWTComponent`	Внутренний класс Component, обеспечивающий поддержку специальных возможностей по умолчанию.
`static enum`	`Component.BaselineResizeBehavior`	Перечисление распространенных способов изменения базовой линии компонента при изменении его размера.
`protected class`	`Component.BltBufferStrategy`	Внутренний класс для переноса содержимого внеэкранных поверхностей в компонент.
`protected class`	`Component.FlipBufferStrategy`	Внутренний класс для переключения буферов компонента.

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Модификатор и тип	Поле	Описание
`protected AccessibleContext`	`accessibleContext`	`AccessibleContext`, связанный с этим `Component`.
`static final float`	`BOTTOM_ALIGNMENT`	Удобная константа для `getAlignmentY`.
`static final float`	`CENTER_ALIGNMENT`	Удобная константа для `getAlignmentY` и `getAlignmentX`.
`static final float`	`LEFT_ALIGNMENT`	Удобная константа для `getAlignmentX`.
`static final float`	`RIGHT_ALIGNMENT`	Удобная константа для `getAlignmentX`.
`static final float`	`TOP_ALIGNMENT`	Удобная константа для `getAlignmentY()`.

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

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

Модификатор и тип	Поле	Описание
`static final int`	`ABORT`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что отслеживаемое асинхронно изображение было прервано до завершения создания.
`static final int`	`ALLBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что статическое изображение, которое ранее было нарисовано, теперь готово и может быть нарисовано повторно в окончательном виде.
`static final int`	`ERROR`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что при асинхронном отслеживании изображения произошла ошибка.
`static final int`	`FRAMEBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что теперь доступен для повторного рисования еще один полный кадр ранее нарисованного многостраничного изображения.
`static final int`	`HEIGHT`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что высота исходного изображения теперь доступна и может быть получена из аргумента height метода обратного вызова imageUpdate.
`static final int`	`PROPERTIES`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что свойства изображения теперь доступны.
`static final int`	`SOMEBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что стали доступны дополнительные пиксели, необходимые для рисования масштабированного варианта изображения.
`static final int`	`WIDTH`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что ширина исходного изображения теперь доступна и может быть получена из аргумента width метода обратного вызова imageUpdate.

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

Конструктор	Описание
`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` в этом `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

Модификатор и тип	Метод	Описание
`boolean`	`action(Event evt, Object what)`	Устарело. Начиная с версии JDK 1.1, вместо этого следует зарегистрировать этот компонент как ActionListener на компоненте, который генерирует события действия.
`void`	`add(PopupMenu popup)`	Добавляет к компоненту указанное всплывающее меню.
`void`	`addComponentListener(ComponentListener l)`	Добавляет указанный прослушиватель компонентов для получения событий компонента от этого компонента.
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный прослушиватель фокуса для получения событий фокуса от этого компонента, когда компонент получает фокус ввода.
`void`	`addHierarchyBoundsListener(HierarchyBoundsListener l)`	Добавляет указанный прослушиватель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
`void`	`addHierarchyListener(HierarchyListener l)`	Добавляет указанный прослушиватель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
`void`	`addInputMethodListener(InputMethodListener l)`	Добавляет указанный прослушиватель методов ввода для получения событий методов ввода от этого компонента.
`void`	`addKeyListener(KeyListener l)`	Добавляет указанный прослушиватель клавиатуры для получения событий клавиатуры от этого компонента.
`void`	`addMouseListener(MouseListener l)`	Добавляет указанный прослушиватель мыши для получения событий мыши от этого компонента.
`void`	`addMouseMotionListener(MouseMotionListener l)`	Добавляет указанный прослушиватель движения мыши для получения событий движения мыши от этого компонента.
`void`	`addMouseWheelListener(MouseWheelListener l)`	Добавляет указанный прослушиватель колеса мыши для получения событий колеса мыши от этого компонента.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список прослушивателей.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список прослушивателей для определенного свойства.
`void`	`applyComponentOrientation(ComponentOrientation orientation)`	Устанавливает свойство `ComponentOrientation` этого компонента и всех содержащихся в нем компонентов.
`boolean`	`areFocusTraversalKeysSet(int id)`	Возвращает, был ли явно задан для этого Component набор клавиш перехода фокуса для указанной операции перехода фокуса.
`Rectangle`	`bounds()`	Устарело. Начиная с версии JDK 1.1 заменено на `getBounds()`.
`int`	`checkImage(Image image, int width, int height, ImageObserver observer)`	Возвращает состояние создания экранного представления указанного изображения.
`int`	`checkImage(Image image, ImageObserver observer)`	Возвращает состояние создания экранного представления указанного изображения.
`protected AWTEvent`	`coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)`	При возможности объединяет публикуемое событие с существующим событием.
`boolean`	`contains(int x, int y)`	Проверяет, «содержит» ли этот компонент указанную точку; координаты `x` и `y` считаются заданными относительно системы координат этого компонента.
`boolean`	`contains(Point p)`	Проверяет, «содержит» ли этот компонент указанную точку; координаты x и y точки считаются заданными относительно системы координат этого компонента.
`Image`	`createImage(int width, int height)`	Создает рисуемое изображение вне экрана для двойной буферизации.
`Image`	`createImage(ImageProducer producer)`	Создает изображение из указанного производителя изображений.
`VolatileImage`	`createVolatileImage(int width, int height)`	Создает изменяемое рисуемое изображение вне экрана для двойной буферизации.
`VolatileImage`	`createVolatileImage(int width, int height, ImageCapabilities caps)`	Создает изменяемое рисуемое изображение вне экрана с указанными возможностями.
`void`	`deliverEvent(Event e)`	Устарело. Начиная с версии JDK 1.1 заменено на `dispatchEvent(AWTEvent e)`.
`void`	`disable()`	Устарело. Начиная с версии JDK 1.1 заменено на `setEnabled(boolean)`.
`protected final void`	`disableEvents(long eventsToDisable)`	Запрещает доставку этому компоненту событий, определенных параметром маски событий.
`final void`	`dispatchEvent(AWTEvent e)`	Передает событие этому компоненту или одному из его подкомпонентов.
`void`	`doLayout()`	Запрашивает у менеджера компоновки размещение этого компонента.
`void`	`enable()`	Устарело. Начиная с версии JDK 1.1 заменено на `setEnabled(boolean)`.
`void`	`enable(boolean b)`	Устарело. Начиная с версии JDK 1.1 заменено на `setEnabled(boolean)`.
`protected final void`	`enableEvents(long eventsToEnable)`	Разрешает доставку этому компоненту событий, определенных параметром маски событий.
`void`	`enableInputMethods(boolean enable)`	Включает или отключает поддержку методов ввода для этого компонента.
`protected void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)`	Поддержка оповещения об изменениях привязанных свойств типа boolean.
`void`	`firePropertyChange(String propertyName, byte oldValue, byte newValue)`	Оповещает об изменении привязанного свойства.
`void`	`firePropertyChange(String propertyName, char oldValue, char newValue)`	Оповещает об изменении привязанного свойства.
`void`	`firePropertyChange(String propertyName, double oldValue, double newValue)`	Оповещает об изменении привязанного свойства.
`void`	`firePropertyChange(String propertyName, float oldValue, float newValue)`	Оповещает об изменении привязанного свойства.
`protected void`	`firePropertyChange(String propertyName, int oldValue, int newValue)`	Поддержка оповещения об изменениях привязанных свойств типа integer.
`void`	`firePropertyChange(String propertyName, long oldValue, long newValue)`	Оповещает об изменении привязанного свойства.
`void`	`firePropertyChange(String propertyName, short oldValue, short newValue)`	Оповещает об изменении привязанного свойства.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Поддержка оповещения об изменениях привязанных свойств типа Object.
`float`	`getAlignmentX()`	Возвращает выравнивание по оси x.
`float`	`getAlignmentY()`	Возвращает выравнивание по оси y.
`Color`	`getBackground()`	Получает цвет фона этого компонента.
`int`	`getBaseline(int width, int height)`	Возвращает базовую линию.
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior()`	Возвращает перечисление, указывающее, как изменяется базовая линия компонента при изменении его размера.
`Rectangle`	`getBounds()`	Получает границы этого компонента в виде объекта `Rectangle`.
`Rectangle`	`getBounds(Rectangle rv)`	Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
`ColorModel`	`getColorModel()`	Получает экземпляр `ColorModel`, используемый для отображения компонента на устройстве вывода.
`Component`	`getComponentAt(int x, int y)`	Определяет, содержит ли этот компонент или один из его непосредственных подкомпонентов точку (x, y), и, если содержит, возвращает содержащий ее компонент.
`Component`	`getComponentAt(Point p)`	Возвращает компонент или подкомпонент, содержащий указанную точку.
`ComponentListener[]`	`getComponentListeners()`	Возвращает массив всех прослушивателей компонентов, зарегистрированных для этого компонента.
`ComponentOrientation`	`getComponentOrientation()`	Получает языковую ориентацию, используемую для упорядочения элементов или текста в этом компоненте.
`Cursor`	`getCursor()`	Получает курсор, установленный для компонента.
`DropTarget`	`getDropTarget()`	Получает `DropTarget`, связанный с этим `Component`.
`Container`	`getFocusCycleRootAncestor()`	Возвращает Container, являющийся корнем цикла обхода фокуса для этого цикла обхода фокуса Component.
`FocusListener[]`	`getFocusListeners()`	Возвращает массив всех прослушивателей фокуса, зарегистрированных для этого компонента.
`Set<AWTKeyStroke>`	`getFocusTraversalKeys(int id)`	Возвращает набор клавиш перехода фокуса для указанной операции перехода этого Component.
`boolean`	`getFocusTraversalKeysEnabled()`	Возвращает, включены ли клавиши перехода фокуса для этого Component.
`Font`	`getFont()`	Получает шрифт этого компонента.
`FontMetrics`	`getFontMetrics(Font font)`	Получает метрики указанного шрифта.
`Color`	`getForeground()`	Получает цвет переднего плана этого компонента.
`Graphics`	`getGraphics()`	Создает графический контекст для этого компонента.
`GraphicsConfiguration`	`getGraphicsConfiguration()`	Получает `GraphicsConfiguration`, связанный с этим `Component`.
`int`	`getHeight()`	Возвращает текущую высоту этого компонента.
`HierarchyBoundsListener[]`	`getHierarchyBoundsListeners()`	Возвращает массив всех прослушивателей границ иерархии, зарегистрированных для этого компонента.
`HierarchyListener[]`	`getHierarchyListeners()`	Возвращает массив всех прослушивателей иерархии, зарегистрированных для этого компонента.
`boolean`	`getIgnoreRepaint()`	Возвращает, следует ли игнорировать сообщения о рисовании, полученные от операционной системы.
`InputContext`	`getInputContext()`	Получает контекст ввода, используемый этим компонентом для взаимодействия с методами ввода при вводе текста в компонент.
`InputMethodListener[]`	`getInputMethodListeners()`	Возвращает массив всех прослушивателей методов ввода, зарегистрированных для этого компонента.
`InputMethodRequests`	`getInputMethodRequests()`	Получает обработчик запросов методов ввода, поддерживающий запросы методов ввода для этого компонента.
`KeyListener[]`	`getKeyListeners()`	Возвращает массив всех прослушивателей клавиатуры, зарегистрированных для этого компонента.
`Locale`	`getLocale()`	Получает локаль этого компонента.
`Point`	`getLocation()`	Получает положение этого компонента в виде точки, задающей его верхний левый угол.
`Point`	`getLocation(Point rv)`	Сохраняет начало координат x,y этого компонента в «возвращаемое значение» rv и возвращает rv.
`Point`	`getLocationOnScreen()`	Получает положение этого компонента в виде точки, задающей его верхний левый угол в системе координат экрана.
`Dimension`	`getMaximumSize()`	Получает максимальный размер этого компонента.
`MouseListener[]`	`getMouseListeners()`	Возвращает массив всех прослушивателей мыши, зарегистрированных для этого компонента.
`MouseMotionListener[]`	`getMouseMotionListeners()`	Возвращает массив всех прослушивателей движения мыши, зарегистрированных для этого компонента.
`Point`	`getMousePosition()`	Возвращает положение указателя мыши в системе координат этого `Component`, если `Component` находится непосредственно под указателем мыши; в противном случае возвращает `null`.
`MouseWheelListener[]`	`getMouseWheelListeners()`	Возвращает массив всех прослушивателей колеса мыши, зарегистрированных для этого компонента.
`String`	`getName()`	Получает имя компонента.
`Container`	`getParent()`	Получает родительский компонент этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех прослушивателей изменений свойств, зарегистрированных для этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners(String propertyName)`	Возвращает массив всех прослушивателей, связанных с указанным свойством.
`Dimension`	`getSize()`	Возвращает размер этого компонента в виде объекта `Dimension`.
`Dimension`	`getSize(Dimension rv)`	Сохраняет ширину и высоту этого компонента в «возвращаемое значение» rv и возвращает rv.
`Toolkit`	`getToolkit()`	Получает инструментарий этого компонента.
`final Object`	`getTreeLock()`	Получает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потоков) для операций с деревом компонентов AWT и компоновкой.
`int`	`getWidth()`	Возвращает текущую ширину этого компонента.
`int`	`getX()`	Возвращает текущую координату x начала координат компонента.
`int`	`getY()`	Возвращает текущую координату y начала координат компонента.
`boolean`	`gotFocus(Event evt, Object what)`	Устарело. Начиная с версии JDK 1.1 заменено на processFocusEvent(FocusEvent).
`boolean`	`handleEvent(Event evt)`	Устарело. Начиная с версии JDK 1.1 заменено на processEvent(AWTEvent).
`boolean`	`hasFocus()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`void`	`hide()`	Устарело. Начиная с версии JDK 1.1 заменено на `setVisible(boolean)`.
`boolean`	`imageUpdate(Image img, int infoflags, int x, int y, int w, int h)`	Перерисовывает компонент при изменении изображения.
`boolean`	`inside(int x, int y)`	Устарело. Начиная с версии JDK 1.1 заменено на contains(int, int).
`void`	`invalidate()`	Помечает этот компонент и его предков как недействительные.
`boolean`	`isBackgroundSet()`	Возвращает, был ли явно задан цвет фона для этого Component.
`boolean`	`isCursorSet()`	Возвращает, был ли явно задан курсор для этого Component.
`boolean`	`isDisplayable()`	Определяет, может ли этот компонент отображаться.
`boolean`	`isDoubleBuffered()`	Возвращает true, если этот компонент рисуется в изображение вне экрана («буфер»), которое позднее копируется на экран.
`boolean`	`isEnabled()`	Определяет, включен ли этот компонент.
`boolean`	`isFocusable()`	Возвращает, может ли этот Component получать фокус.
`boolean`	`isFocusCycleRoot(Container container)`	Возвращает, является ли указанный Container корнем цикла обхода фокуса для этого цикла обхода фокуса Component.
`boolean`	`isFocusOwner()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`boolean`	`isFocusTraversable()`	Устарело. Начиная с версии 1.4 заменено на `isFocusable()`.
`boolean`	`isFontSet()`	Возвращает, был ли явно задан шрифт для этого Component.
`boolean`	`isForegroundSet()`	Возвращает, был ли явно задан цвет переднего плана для этого Component.
`boolean`	`isLightweight()`	Легковесный компонент не имеет собственного узла инструментария.
`boolean`	`isMaximumSizeSet()`	Возвращает true, если максимальный размер задан значением, отличным от `null`; в противном случае возвращает false.
`boolean`	`isMinimumSizeSet()`	Возвращает, был ли вызван `setMinimumSize` с ненулевым значением.
`boolean`	`isOpaque()`	Возвращает true, если этот компонент полностью непрозрачен; по умолчанию возвращает false.
`boolean`	`isPreferredSizeSet()`	Возвращает true, если предпочтительный размер задан значением, отличным от `null`; в противном случае возвращает false.
`boolean`	`isShowing()`	Определяет, отображается ли этот компонент на экране.
`boolean`	`isValid()`	Определяет, является ли этот компонент действительным.
`boolean`	`isVisible()`	Определяет, должен ли этот компонент быть видимым, когда видим его родительский компонент.
`boolean`	`keyDown(Event evt, int key)`	Устарело. Начиная с версии JDK 1.1 заменено на processKeyEvent(KeyEvent).
`boolean`	`keyUp(Event evt, int key)`	Устарело. Начиная с версии JDK 1.1 заменено на processKeyEvent(KeyEvent).
`void`	`layout()`	Устарело. Начиная с версии JDK 1.1 заменено на `doLayout()`.
`void`	`list()`	Выводит описание этого компонента в стандартный системный поток вывода `System.out`.
`void`	`list(PrintStream out)`	Выводит описание этого компонента в указанный поток вывода.
`void`	`list(PrintStream out, int indent)`	Выводит список в указанный поток печати, начиная с заданного отступа.
`void`	`list(PrintWriter out)`	Выводит описание в указанный объект записи для печати.
`void`	`list(PrintWriter out, int indent)`	Выводит список в указанный объект записи для печати, начиная с заданного отступа.
`Component`	`locate(int x, int y)`	Устарело. Начиная с версии JDK 1.1 заменено на getComponentAt(int, int).
`Point`	`location()`	Устарело. Начиная с версии JDK 1.1 заменено на `getLocation()`.
`boolean`	`lostFocus(Event evt, Object what)`	Устарело. Начиная с версии JDK 1.1 заменено на processFocusEvent(FocusEvent).
`boolean`	`mouseDown(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseDrag(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1 заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseEnter(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseExit(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseMove(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1 заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseUp(Event evt, int x, int y)`	Устарело. Начиная с версии JDK 1.1 заменено на processMouseEvent(MouseEvent).
`void`	`move(int x, int y)`	Устарело. Начиная с версии JDK 1.1 заменено на `setLocation(int, int)`.
`void`	`nextFocus()`	Устарело. Начиная с версии JDK 1.1 заменено на transferFocus().
`void`	`paint(Graphics g)`	Рисует этот компонент.
`void`	`paintAll(Graphics g)`	Рисует этот компонент и все его подкомпоненты.
`boolean`	`postEvent(Event e)`	Устарело. Начиная с версии JDK 1.1 заменено на dispatchEvent(AWTEvent).
`boolean`	`prepareImage(Image image, int width, int height, ImageObserver observer)`	Подготавливает изображение для отображения на этом компоненте с указанными шириной и высотой.
`boolean`	`prepareImage(Image image, ImageObserver observer)`	Подготавливает изображение для отображения на этом компоненте.
`void`	`print(Graphics g)`	Печатает этот компонент.
`void`	`printAll(Graphics g)`	Печатает этот компонент и все его подкомпоненты.
`protected void`	`processComponentEvent(ComponentEvent e)`	Обрабатывает события компонентов, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `ComponentListener`.
`protected void`	`processFocusEvent(FocusEvent e)`	Обрабатывает события фокуса, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `FocusListener`.
`protected void`	`processHierarchyBoundsEvent(HierarchyEvent e)`	Обрабатывает события границ иерархии, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `HierarchyBoundsListener`.
`protected void`	`processHierarchyEvent(HierarchyEvent e)`	Обрабатывает события иерархии, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `HierarchyListener`.

`protected void`	`processInputMethodEvent(InputMethodEvent e)`	Обрабатывает события метода ввода, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `InputMethodListener`.
`protected void`	`processKeyEvent(KeyEvent e)`	Обрабатывает события клавиатуры, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `KeyListener`.
`protected void`	`processMouseEvent(MouseEvent e)`	Обрабатывает события мыши, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `MouseListener`.
`protected void`	`processMouseMotionEvent(MouseEvent e)`	Обрабатывает события перемещения мыши, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `MouseMotionListener`.
`protected void`	`processMouseWheelEvent(MouseWheelEvent e)`	Обрабатывает события колеса мыши, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `MouseWheelListener`.
`void`	`remove(MenuComponent popup)`	Удаляет указанное всплывающее меню из компонента.
`void`	`removeComponentListener(ComponentListener l)`	Удаляет указанный слушатель компонента, чтобы он больше не получал события компонента от этого компонента.
`void`	`removeFocusListener(FocusListener l)`	Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
`void`	`removeHierarchyBoundsListener(HierarchyBoundsListener l)`	Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
`void`	`removeHierarchyListener(HierarchyListener l)`	Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
`void`	`removeInputMethodListener(InputMethodListener l)`	Удаляет указанный слушатель метода ввода, чтобы он больше не получал события метода ввода от этого компонента.
`void`	`removeKeyListener(KeyListener l)`	Удаляет указанный слушатель клавиатуры, чтобы он больше не получал события клавиатуры от этого компонента.
`void`	`removeMouseListener(MouseListener l)`	Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента.
`void`	`removeMouseMotionListener(MouseMotionListener l)`	Удаляет указанный слушатель перемещения мыши, чтобы он больше не получал события перемещения мыши от этого компонента.
`void`	`removeMouseWheelListener(MouseWheelListener l)`	Удаляет указанный слушатель колеса мыши, чтобы он больше не получал события колеса мыши от этого компонента.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет PropertyChangeListener из списка слушателей.
`void`	`removePropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Удаляет `PropertyChangeListener` из списка слушателей для указанного свойства.
`void`	`repaint()`	Перерисовывает этот компонент.
`void`	`repaint(int x, int y, int width, int height)`	Перерисовывает указанную прямоугольную область этого компонента.
`void`	`repaint(long tm)`	Перерисовывает компонент.
`void`	`repaint(long tm, int x, int y, int width, int height)`	Перерисовывает указанную прямоугольную область этого компонента в течение `tm` миллисекунд.
`void`	`requestFocus()`	Запрашивает передачу фокуса ввода этому компоненту и получение фокуса окном-предком верхнего уровня этого компонента.
`protected boolean`	`requestFocus(boolean temporary)`	Запрашивает передачу фокуса ввода этому `Component` и получение фокуса `Window` предком верхнего уровня этого `Component`.
`protected boolean`	`requestFocus(boolean temporary, FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому `Component` и получение фокуса `Window` предком верхнего уровня этого `Component`.
`void`	`requestFocus(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому компоненту и получение фокуса окном-предком верхнего уровня этого компонента.
`boolean`	`requestFocusInWindow()`	Запрашивает передачу фокуса ввода этому компоненту, если окно-предок верхнего уровня этого компонента уже имеет фокус.
`protected boolean`	`requestFocusInWindow(boolean temporary)`	Запрашивает передачу фокуса ввода этому `Component`, если `Window` предок верхнего уровня этого `Component` уже имеет фокус.
`boolean`	`requestFocusInWindow(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу фокуса ввода этому компоненту, если окно-предок верхнего уровня этого компонента уже имеет фокус.
`void`	`reshape(int x, int y, int width, int height)`	Устарело. Начиная с JDK версии 1.1 заменено на `setBounds(int, int, int, int)`.
`void`	`resize(int width, int height)`	Устарело. Начиная с JDK версии 1.1 заменено на `setSize(int, int)`.
`void`	`resize(Dimension d)`	Устарело. Начиная с JDK версии 1.1 заменено на `setSize(Dimension)`.
`void`	`revalidate()`	Повторно проверяет иерархию компонентов вплоть до ближайшего корня проверки.
`void`	`setBackground(Color c)`	Задаёт цвет фона этого компонента.
`void`	`setBounds(int x, int y, int width, int height)`	Перемещает и изменяет размер этого компонента.
`void`	`setBounds(Rectangle r)`	Перемещает и изменяет размер этого компонента в соответствии с новым ограничивающим прямоугольником `r`.
`void`	`setComponentOrientation(ComponentOrientation o)`	Задаёт языковую ориентацию, используемую для упорядочения элементов или текста внутри этого компонента.
`void`	`setCursor(Cursor cursor)`	Задаёт изображение курсора в соответствии с указанным курсором.
`void`	`setDropTarget(DropTarget dt)`	Связывает `DropTarget` с этим компонентом.
`void`	`setEnabled(boolean b)`	Включает или отключает этот компонент в зависимости от значения параметра `b`.
`void`	`setFocusable(boolean focusable)`	Задаёт возможность получения фокуса этим компонентом в соответствии с указанным значением.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Задаёт клавиши перехода фокуса для указанной операции перехода для этого компонента.
`void`	`setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)`	Задаёт, включены ли клавиши перехода фокуса для этого компонента.
`void`	`setFont(Font f)`	Задаёт шрифт этого компонента.
`void`	`setForeground(Color c)`	Задаёт цвет переднего плана этого компонента.
`void`	`setIgnoreRepaint(boolean ignoreRepaint)`	Задаёт, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
`void`	`setLocale(Locale l)`	Задаёт локаль этого компонента.
`void`	`setLocation(int x, int y)`	Перемещает этот компонент в новое место.
`void`	`setLocation(Point p)`	Перемещает этот компонент в новое место.
`void`	`setMaximumSize(Dimension maximumSize)`	Задаёт максимальный размер этого компонента постоянным значением.
`void`	`setMinimumSize(Dimension minimumSize)`	Задаёт минимальный размер этого компонента постоянным значением.
`void`	`setMixingCutoutShape(Shape shape)`	Задаёт форму отсечения при смешивании для этого лёгковесного компонента.
`void`	`setName(String name)`	Задаёт имя компонента указанной строкой.
`void`	`setPreferredSize(Dimension preferredSize)`	Задаёт предпочтительный размер этого компонента постоянным значением.
`void`	`setSize(int width, int height)`	Изменяет размер этого компонента так, чтобы его ширина составляла `width`, а высота — `height`.
`void`	`setSize(Dimension d)`	Изменяет размер этого компонента так, чтобы его ширина составляла `d.width`, а высота — `d.height`.
`void`	`setVisible(boolean b)`	Показывает или скрывает этот компонент в зависимости от значения параметра `b`.
`void`	`show()`	Устарело. Начиная с JDK версии 1.1 заменено на `setVisible(boolean)`.
`void`	`show(boolean b)`	Устарело. Начиная с JDK версии 1.1 заменено на `setVisible(boolean)`.
`Dimension`	`size()`	Устарело. Начиная с JDK версии 1.1 заменено на `getSize()`.
`String`	`toString()`	Возвращает строковое представление этого компонента и его значений.
`void`	`transferFocus()`	Передаёт фокус следующему компоненту, как если бы этот компонент владел фокусом.
`void`	`transferFocusBackward()`	Передаёт фокус предыдущему компоненту, как если бы этот компонент владел фокусом.
`void`	`transferFocusUpCycle()`	Передаёт фокус на один цикл обхода фокуса вверх.
`void`	`update(Graphics g)`	Обновляет этот компонент.
`void`	`validate()`	Проверяет этот компонент.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова уведомления или прерывания, либо истечения определённого промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова уведомления или прерывания, либо истечения определённого промежутка реального времени.

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

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

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

Возвращает:

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

С:

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

См. также:

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.