Класс 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");

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

Текст ниже описывает
графическое изображение

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

Некоторые платформы не поддерживают произвольное изменение размеров компонентов Choice и поведение setSize()/getSize() ограничено этими ограничениями. Размер компонентов 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()`	Возвращает `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

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

Choice

public Choice() throws HeadlessException

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

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

Изначает исключение:

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

См. также:

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

addNotify

public void addNotify()

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

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

addNotify в классе Component

См. также:

getItemCount

public int getItemCount()

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

Возвращает:

количество элементов в этом меню выбора

С:

1.1

См. также:

countItems

@Deprecated public int countItems()

Устарело.

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

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

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

getItem

public String getItem(int index)

Получает строку по указанному индексу в этом меню выбора.

Параметры:

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

Возвращает:

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

См. также:

add

public void add(String item)

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

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

addItem

public void addItem(String item)

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

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

Параметры:: 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 из меню выбора. Если удаляемый элемент является текущим выбранным элементом, то первым элементом меню выбора становится выбранным. В противном случае, текущий выбранный элемент остаётся выбранным (и индекс выбранного элемента обновляется соответствующим образом).

Параметры:: item - элемент для удаления из этого меню выбора
Изначает исключение:: 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)

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

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

Параметры:

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

Изначает исключение:

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

См. также:

select

public void select(String str)

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

Параметры:

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

См. также:

addItemListener

public void addItemListener(ItemListener l)

Добавляет указанного слушателя событий выбора, чтобы получать события выбора из этого меню выбора. События выбора отправляются в ответ на пользовательский ввод, но не в ответ на вызовы 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()

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

Возвращает:

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

С:

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.

Параметры:

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, 2023, 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/21/docs/api/java.desktop/java/awt/Choice.html