Класс 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, поэтому поведение setSize()/getSize() ограничено этими возможностями. Размеры компонентов графического интерфейса Choice часто ограничены такими параметрами, как размер шрифта и длина элементов, содержащихся в Choice.

Начиная с:

1.0

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`Choice.AccessibleAWTChoice`	Этот класс реализует поддержку специальных возможностей для класса `Choice`.

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

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

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

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

Модификатор и тип	Метод	Описание
`void`	`add(String item)`	Добавляет элемент в это меню `Choice`.
`void`	`addItem(String item)`	Устарел начиная с платформы Java 2 версии 1.1.
`void`	`addItemListener(ItemListener l)`	Добавляет указанный прослушиватель элементов для получения событий элементов из этого меню `Choice`.
`void`	`addNotify()`	Создает пира `Choice`.
`int`	`countItems()`	Устарел. Начиная с JDK версии 1.1 заменен на `getItemCount()`.
`AccessibleContext`	`getAccessibleContext()`	Возвращает `AccessibleContext`, связанный с этим `Choice`.
`String`	`getItem(int index)`	Возвращает строку по указанному индексу в этом меню `Choice`.
`int`	`getItemCount()`	Возвращает количество элементов в этом меню `Choice`.
`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()`	Возвращает строку, представляющую состояние этого меню `Choice`.
`protected void`	`processEvent(AWTEvent e)`	Обрабатывает события этого меню вариантов.
`protected void`	`processItemEvent(ItemEvent e)`	Обрабатывает события элементов, возникающие в этом меню `Choice`, передавая их всем зарегистрированным объектам `ItemListener`.
`void`	`remove(int position)`	Удаляет элемент из меню вариантов в указанной позиции.
`void`	`remove(String item)`	Удаляет первое вхождение `item` из меню `Choice`.
`void`	`removeAll()`	Удаляет все элементы из меню вариантов.
`void`	`removeItemListener(ItemListener l)`	Удаляет указанный прослушиватель элементов, чтобы он больше не получал события элементов из этого меню `Choice`.
`void`	`select(int pos)`	Устанавливает в этом меню `Choice` выбранный элемент, находящийся в указанной позиции.
`void`	`select(String str)`	Устанавливает в этом меню `Choice` выбранный элемент, имя которого совпадает с указанной строкой.

Методы, объявленные в классе 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

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

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

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

Choice

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 версии 1.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.

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

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

Параметры:

l — прослушиватель элементов

Начиная с:

1.1

См. также:

removeItemListener

public void removeItemListener(ItemListener l)

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

Подробные сведения о модели потоков AWT см. в разделе Проблемы многопоточности AWT.

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

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

Параметры:

l — прослушиватель элементов

Начиная с:

1.1

См. также:

getItemListeners

public ItemListener[] getItemListeners()

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

Возвращает:

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

Начиная с:

1.4

См. также:

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

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

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

getListeners в классе Component

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

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

Параметры:

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

Возвращает:

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

Выбрасывает:

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

Начиная с:

1.3

См. также:

processEvent

protected void processEvent(AWTEvent e)

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

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

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

processEvent в классе Component

Параметры:

e — событие

Начиная с:

1.1

См. также:

processItemEvent

protected void processItemEvent(ItemEvent e)

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

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

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

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

Параметры:

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

Начиная с:

1.1

См. также:

paramString

protected String paramString()

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

Переопределяет:: paramString в классе Component
Возвращает:: строку параметров этого меню Choice

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: объект AccessibleAWTChoice, который служит AccessibleContext этого Choice
Начиная с:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/Choice.html