Класс 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 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 из меню выбора.
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
См. также:
GraphicsEnvironment.isHeadless(), select(int), select(java.lang.String)

Методы

addNotify

public void addNotify()

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

Переопределяет:
addNotify в классе Component
См. также:
Component.getToolkit()

getItemCount

public int getItemCount()

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

Возвращает:
количество элементов в этом Choice меню
С момента:
1.1
См. также:
getItem(int)

countItems

@Deprecated
public int countItems()
Устаревшее.
С версии JDK 1.1, заменено на getItemCount().

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

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

getItem

public String getItem(int index)

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

Параметры:
index - индекс начала
Возвращает:
элемент по указанному индексу
См. также:
getItemCount()

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
См. также:
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)

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

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

Параметры:
pos - позиция выбранного элемента
Исключения:
IllegalArgumentException - если указанная позиция больше или равна количеству элементов, или меньше нуля
См. также:
getSelectedItem(), getSelectedIndex()

select

public void select(String str)

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

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

Параметры:
str - указанная строка
См. также:
getSelectedItem(), getSelectedIndex()

addItemListener

public void addItemListener(ItemListener l)

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

См. AWT Threading Issues для получения подробной информации о модели потоков 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.

Определяет:
removeItemListener в интерфейсе ItemSelectable
Параметры:
l - обработчик событий выбора
С момента:
1.1
См. также:
addItemListener(java.awt.event.ItemListener), getItemListeners(), ItemEvent, ItemListener

getItemListeners

public ItemListener[] getItemListeners()

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

Возвращает:
все обработчики событий выбора этого списка или пустой массив, если обработчики событий выбора не зарегистрированы
С момента:
1.4
См. также:
addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener), ItemEvent, ItemListener

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
См. также:
getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

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

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

Переопределяет:
processEvent в классе Component
Параметры:
e - событие
С:
1.1
См. также:
ItemEvent, processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent e)

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

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

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

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

Параметры:
e - событие элемента
С:
1.1
См. также:
ItemEvent, ItemListener, addItemListener(ItemListener), Component.enableEvents(long)

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

Spec-Zone .ru
спецификации, руководства, описания, API