Выбор класса

java.lang.Object

java.awt.Component

java.awt.Choice

Все реализованные интерфейсы:: ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible

public class Choice extends Component implements ItemSelectable, Accessible

Класс Choice представляет всплывающее меню выбора. Текущий выбор отображается в виде заголовка меню.

Следующий пример кода создает всплывающее меню:

 Choice ColorChooser = new Choice();
 ColorChooser.add("Green");
 ColorChooser.add("Red");
 ColorChooser.add("Blue");

После добавления этого меню выбора на панель, оно отображается в нормальном состоянии следующим образом:

The following text describes the
graphic

На изображении "Green" является текущим выбором. Нажатие на объект мышью вызывает появление меню с выделенным текущим выбором.

Некоторые платформы не поддерживают произвольное изменение размера компонентов Choice, и поведение setSize()/getSize() ограничено такими ограничениями. Размер собственных GUI-компонентов Choice часто ограничен такими атрибутами, как размер шрифта и длина элементов, содержащихся в Choice.

С момента:

1.0

См. также:

Сериализованная форма

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

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

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

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

Конструктор	Описание
`Choice()`	Создает новое меню выбора.

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

Модификатор и тип	Метод	Описание
`void`	`add(String item)`	Добавляет элемент в это меню выбора.
`void`	`addItem(String item)`	Устарело, начиная с Java 2 платформы v1.1.
`void`	`addItemListener(ItemListener l)`	Добавляет указанный обработчик событий элементов для приема событий элементов из этого меню выбора.
`void`	`addNotify()`	Создает виджет-представитель `Choice`.
`int`	`countItems()`	Устарело. С версии JDK 1.1, заменено на `getItemCount()`.
`AccessibleContext`	`getAccessibleContext()`	Получает `AccessibleContext`, связанный с этим объектом `Choice`.
`String`	`getItem(int index)`	Получает строку по указанному индексу в этом меню выбора.
`int`	`getItemCount()`	Возвращает количество элементов в этом меню выбора.
`ItemListener[]`	`getItemListeners()`	Возвращает массив всех обработчиков событий элементов, зарегистрированных на этом выборе.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, в настоящее время зарегистрированных в качестве `FooListener` в этом `Choice`.
`int`	`getSelectedIndex()`	Возвращает индекс текущего выбранного элемента.
`String`	`getSelectedItem()`	Получает представление текущего выбора в виде строки.
`Object[]`	`getSelectedObjects()`	Возвращает массив (длиной 1), содержащий текущий выбранный элемент.
`void`	`insert(String item, int index)`	Вставляет элемент в этот выбор в указанной позиции.
`protected String`	`paramString()`	Возвращает строку, представляющую состояние этого меню выбора.
`protected void`	`processEvent(AWTEvent e)`	Обрабатывает события в этом выборе.
`protected void`	`processItemEvent(ItemEvent e)`	Обрабатывает события элементов, происходящие в этом меню выбора, перенаправляя их любым зарегистрированным объектам `ItemListener`.
`void`	`remove(int position)`	Удаляет элемент из меню выбора по указанной позиции.
`void`	`remove(String item)`	Удаляет первое вхождение `item` из меню выбора `Choice`.
`void`	`removeAll()`	Удаляет все элементы из меню выбора.
`void`	`removeItemListener(ItemListener l)`	Удаляет указанный обработчик событий элементов, чтобы он больше не получал события элементов из этого меню выбора.
`void`	`select(int pos)`	Устанавливает выбранный элемент в этом меню выбора в элемент по указанной позиции.
`void`	`select(String str)`	Устанавливает выбранный элемент в этом меню выбора в элемент, имя которого равно указанной строке.

Методы, объявленные в классе 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, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPreferredSize, 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, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

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

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

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

Выбор

public Choice() throws HeadlessException

Создает новое меню выбора. Изначально в меню нет элементов.

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

Исключения:

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

См. также:

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

addNotify

public void addNotify()

Создаёт компонент-виртуальный объект для Choice. Этот виртуальный объект позволяет изменять внешний вид Choice без изменения его функциональности.

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

addNotify в классе Component

См. также:

Component.getToolkit()

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

add

public void add(String item)

Добавляет элемент в это меню выбора.

Параметры:: item - добавляемый элемент
Исключения:: NullPointerException - если значение элемента равно null
Начиная с версии:: 1.1

addItem

public void addItem(String item)

Устарело с платформы Java 2 v1.1. Используйте метод add вместо него.

Добавляет элемент в это меню выбора.

Параметры:: item - добавляемый элемент
Исключения:: NullPointerException - если значение элемента равно null

insert

public void insert(String item, int index)

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

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

Параметры:: item - добавляемый элемент; index - позиция вставки элемента
Исключения:: IllegalArgumentException - если индекс меньше 0

remove

public void remove(String item)

Удаляет первое вхождение item из меню выбора. Если удаляемый элемент является текущим выбранным элементом, то первым элементом в меню выбора становится выбранный элемент. В противном случае, текущий выбранный элемент остается выбранным (и индекс выбранного элемента обновляется соответственно).

Параметры:: item - удаляемый элемент из меню выбора
Исключения:: IllegalArgumentException - если элемент не существует в меню выбора
Начиная с версии:: 1.1

remove

public void remove(int position)

Удаляет элемент из меню выбора по указанной позиции. Если удаляемый элемент является текущим выбранным элементом, то первым элементом в меню выбора становится выбранный элемент. В противном случае, текущий выбранный элемент остается выбранным (и индекс выбранного элемента обновляется соответственно).

Параметры:: position - позиция элемента
Исключения:: IndexOutOfBoundsException - если указанная позиция находится вне границ
Начиная с версии:: 1.1

removeAll

public void removeAll()

Удаляет все элементы из меню выбора.

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

1.1

См. также:

remove(java.lang.String)

getSelectedItem

public String getSelectedItem()

Возвращает строковое представление текущего выбора.

Возвращает:

строковое представление текущего выбранного элемента в этом меню выбора

См. также:

getSelectedIndex()

getSelectedObjects

public Object[] getSelectedObjects()

Возвращает массив (длины 1) содержащий текущий выбранный элемент. Если в этом меню выбора нет элементов, возвращает null.

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

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

Возвращает:

список выбранных объектов, или null

См. также:

ItemSelectable

getSelectedIndex

public int getSelectedIndex()

Возвращает индекс текущего выбранного элемента. Если ничего не выбрано, возвращает -1.

Возвращает:

индекс текущего выбранного элемента, или -1, если ничего не выбрано

См. также:

getSelectedItem()

select

public void select(int pos)

Устанавливает выбранный элемент в этом меню выбора на элемент по указанной позиции.

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

Параметры:

pos - позиция выбранного элемента

Исключения:

IllegalArgumentException - если указанная позиция больше количества элементов или меньше нуля

См. также:

getSelectedItem()
getSelectedIndex()

select

public void select(String str)

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

Параметры:

str - указанная строка

См. также:

getSelectedItem()
getSelectedIndex()

addItemListener

public void addItemListener(ItemListener l)

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

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

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

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

Параметры:

l - обработчик событий выбора

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

1.1

См. также:

removeItemListener(java.awt.event.ItemListener)
getItemListeners()
select(int)
ItemEvent
ItemListener

removeItemListener

public void removeItemListener(ItemListener l)

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

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

Specified by:

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

Parameters:

l - слушатель событий выбора

Since:

1.1

See Also:

addItemListener(java.awt.event.ItemListener)
getItemListeners()
ItemEvent
ItemListener

getItemListeners

public ItemListener[] getItemListeners()

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

Returns:

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

Since:

1.4

See Also:

addItemListener(java.awt.event.ItemListener)
removeItemListener(java.awt.event.ItemListener)
ItemEvent
ItemListener

getListeners

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

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

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

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

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

Overrides:

getListeners в классе Component

Type Parameters:

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

Parameters:

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

Returns:

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

Throws:

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

Since:

1.3

See Also:

getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

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

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

Overrides:

processEvent в классе Component

Parameters:

e - событие

Since:

1.1

See Also:

ItemEvent
processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent e)

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

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

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

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

Parameters:

e - событие выбора

Since:

1.1

See Also:

paramString

protected String paramString()

Возвращает строку, представляющую состояние этого Choice меню. Этот метод предназначен только для отладки, и содержание и формат возвращаемой строки могут различаться в различных реализациях. Возвращаемая строка может быть пустой, но не null.

Overrides:: paramString в классе Component
Returns:: строка параметров этого Choice меню

getAccessibleContext

public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext , связанный с этим Choice. Для компонентов Choice, AccessibleContext представлен в виде AccessibleAWTChoice. Если необходимо, создается новый экземпляр AccessibleAWTChoice.

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Returns:: AccessibleAWTChoice, который служит AccessibleContext для этого Choice
Since:: 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/Choice.html