Класс Choice

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, и поведение Choice ограничено такими ограничениями. Размер нативных 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 platform v1.1.
`void`	`addItemListener(ItemListener l)`	Добавляет указанный обработчик событий элементов для получения событий элементов из этого меню выбора.
`void`	`addNotify()`	Создает виджет-представителя компонента Choice.
`int`	`countItems()`	Устарело. Начиная с JDK версии 1.1, заменено на `getItemCount()`.
`AccessibleContext`	`getAccessibleContext()`	Возвращает ассоциированный с этим компонентом Choice виджет.
`String`	`getItem(int index)`	Возвращает строку по указанному индексу в этом меню выбора.
`int`	`getItemCount()`	Возвращает количество элементов в этом меню выбора.
`ItemListener[]`	`getItemListeners()`	Возвращает массив всех обработчиков событий элементов, зарегистрированных в этом меню выбора.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, в настоящее время зарегистрированных как слушатели событий элемента в этом компоненте.
`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)`	Обрабатывает события элементов, происходящие в этом меню выбора, распределяя их между любыми зарегистрированными обработчиками событий.
`void`	`remove(int position)`	Удаляет элемент из меню выбора по указанной позиции.
`void`	`remove(String item)`	Удаляет первое вхождение элемента из меню выбора.
`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

См. также:

getItemCount

public int getItemCount()

Возвращает количество элементов в этом меню Choice.

Возвращает:

количество элементов в этом меню Choice

С:

1.1

См. также:

countItems

@Deprecated public int countItems()

Устаревший.

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

Возвращает количество элементов в этом меню Choice.

Возвращает:: количество элементов в этом меню Choice

getItem

public String getItem(int index)

Возвращает строку по указанному индексу в этом меню Choice.

Параметры:

index - индекс, с которого начать

Возвращает:

элемент по указанному индексу

См. также:

add

public void add(String item)

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

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

addItem

public void addItem(String item)

Устаревший метод, начиная с Java 2 platform v1.1. Используйте метод add вместо него.

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

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

insert

public void insert(String item, int index)

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

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

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

remove

public void remove(String item)

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

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

remove

public void remove(int position)

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

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

removeAll

public void removeAll()

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

С:

1.1

См. также:

getSelectedItem

public String getSelectedItem()

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

Возвращает:

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

См. также:

getSelectedObjects

public Object[] getSelectedObjects()

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

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

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

Возвращает:

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

См. также:

getSelectedIndex

public int getSelectedIndex()

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

Возвращает:

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

См. также:

select

public void select(int pos)

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

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

Параметры:

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

Исключения:

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

См. также:

select

public void select(String str)

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

Параметры:

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

См. также:

addItemListener

public void addItemListener(ItemListener l)

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

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

Specified by:

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

Parameters:

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

Since:

1.1

See Also:

removeItemListener

public void removeItemListener(ItemListener l)

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

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

Specified by:

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

Parameters:

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

Since:

1.1

See Also:

getItemListeners

public ItemListener[] getItemListeners()

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

Returns:

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

Since:

1.4

See Also:

getListeners

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

Возвращает массив всех объектов, в настоящее время зарегистрированных в качестве FooListener на этом Choice. FooListener регистрируются с помощью метода 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:

processEvent

protected void processEvent(AWTEvent e)

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

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

Overrides:

processEvent в классе Component

Parameters:

e - событие

Since:

1.1

See Also:

processItemEvent

protected void processItemEvent(ItemEvent e)

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

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

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

Parameters:

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

Since:

1.1

See Also:

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

Получает связанный с этим Choice AccessibleContext. Для компонентов Choice AccessibleContext имеет вид AccessibleAWTChoice. Новый экземпляр AccessibleAWTChoice создается при необходимости.

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Returns:: объект AccessibleAWTChoice, выступающий в качестве AccessibleContext этого Choice
Since:: 1.3

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Choice.html