Класс Choice

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

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

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

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

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

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

Конструкторы

Choice

public Choice()
       throws HeadlessException

Исключения:

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

См. также:

GraphicsEnvironment.isHeadless(), select(int), select(java.lang.String)

Методы

addNotify

public void addNotify()

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

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

addNotify в классе Component

См. также:

Toolkit.createChoice(java.awt.Choice), Component.getToolkit()

getItemCount

public int getItemCount()

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

Возвращает:

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

С момента:

JDK1.1

См. также:

getItem(int)

countItems

@Deprecated
public int countItems()

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

getItem

public String getItem(int index)

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

Параметры:

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

См. также:

getItemCount()

add

public void add(String item)

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

Параметры:

item - добавляемый элемент

Исключения:

NullPointerException - если значение элемента равно null

С момента:

JDK1.1

addItem

public void addItem(String item)

Параметры:

item - добавляемый элемент

Исключения:

NullPointerException - если значение элемента равно null

insert

public void insert(String item,
                   int index)

Параметры:

item - элемент, который не null должен быть вставлен

index - позиция, в которую необходимо вставить элемент

Исключения:

IllegalArgumentException - если индекс меньше 0

remove

public void remove(String item)

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

Параметры:

item - элемент для удаления из этого Choice меню

Исключения:

IllegalArgumentException - если элемент не существует в меню выбора

С момента:

JDK1.1

remove

public void remove(int position)

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

Параметры:

position - позиция элемента

Исключения:

IndexOutOfBoundsException - если указанная позиция находится за пределами допустимого диапазона

С момента:

JDK1.1

removeAll

public void removeAll()

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

С момента:

JDK1.1

См. также:

remove(java.lang.String)

getSelectedItem

public String getSelectedItem()

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

Возвращает:

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

См. также:

getSelectedIndex()

getSelectedObjects

public Object[] getSelectedObjects()

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

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

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

См. также:

ItemSelectable

getSelectedIndex

public int getSelectedIndex()

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

Возвращает:

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

См. также:

getSelectedItem()

select

public void select(int pos)

Параметры:

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

Исключения:

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

См. также:

getSelectedItem(), getSelectedIndex()

select

public void select(String str)

Параметры:

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

См. также:

getSelectedItem(), getSelectedIndex()

addItemListener

public void addItemListener(ItemListener l)

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

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

Параметры:

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

С момента:

JDK1.1

См. также:

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

removeItemListener

public void removeItemListener(ItemListener l)

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

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

Параметры:

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

С момента:

JDK1.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)

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

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

getListeners в классе Component

Параметры:

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

Возвращает:

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

Исключения:

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

С тех пор:

1.3

См. также:

getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

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

processEvent в классе Component

Параметры:

e - событие

С тех пор:

JDK1.1

См. также:

ItemEvent, processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent e)

Параметры:

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

С тех пор:

JDK1.1

См. также:

ItemEvent, ItemListener, addItemListener(ItemListener), Component.enableEvents(long)

paramString

protected String paramString()

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

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

paramString в классе Component

Возвращает:

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

getAccessibleContext в интерфейсе Accessible

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

getAccessibleContext в классе Component

Возвращает:

AccessibleAWTChoice, который служит AccessibleContext для этого Choice

С тех пор:

1.3