java.awt

Выбор класса

java.lang. Объект

java.awt. Компонент

java.awt. Выбор

Все Реализованные Интерфейсы:

ImageObserver, ItemSelectable, MenuContainer, Сериализуемый, Доступный

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

С тех пор:

JDK1.0

См. Также:

Сериализированная Форма

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
protected class	Выбор. AccessibleAWTChoice Этот класс реализует поддержку доступности Choice класс.

Вложенные классы/интерфейсы java.awt унаследованный от класса. Компонент

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

Полевая Сводка

Поля java.awt унаследованный от класса. Компонент

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

Методы java.awt унаследованный от класса. Компонент

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, getPeer, 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, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

Выбор

public Choice()
       throws HeadlessException

Создает новое меню выбора. У меню первоначально нет никаких элементов в нем.

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

Броски:

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

См. Также:

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

Деталь метода

addNotify

public void addNotify()

Создает Choice's коллега. Эта коллега позволяет нам изменять вид 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()

Осуждаемый. С версии 1.1 JDK, замененной getItemCount().

getItem

public String getItem(int index)

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

Параметры:

index - индекс, по которому можно начать

См. Также:

getItemCount()

добавить

public void add(String item)

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

Параметры:

item - элемент, который будет добавлен

Броски:

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

С тех пор:

JDK1.1

addItem

public void addItem(String item)

Устаревший с Java 2 платформы v1.1. Пожалуйста, используйте add метод вместо этого.

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

Параметры:

item - элемент, который будет добавлен

Броски:

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

вставить

public void insert(String item,
          int index)

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

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

Параметры:

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

index - позиция, в которой должен быть вставлен элемент

Броски:

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

удалить

public void remove(String item)

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

Параметры:

item - элемент, чтобы удалить из этого Choice меню

Броски:

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

С тех пор:

JDK1.1

удалить

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

выбрать

public void select(int pos)

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

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

Параметры:

pos - positon выбранного пункта

Броски:

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

См. Также:

getSelectedItem(), getSelectedIndex()

выбрать

public void select(String str)

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

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

Параметры:

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

См. Также:

getSelectedItem(), getSelectedIndex()

addItemListener

public void addItemListener(ItemListener l)

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

Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.

Определенный:

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

Параметры:

l - слушатель элемента

С тех пор:

JDK1.1

См. Также:

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

removeItemListener

public void removeItemListener(ItemListener l)

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

Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.

Определенный:

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

Параметры:

l - слушатель элемента

С тех пор:

JDK1.1

См. Также:

addItemListener(java.awt.event.ItemListener), getItemListeners(), ItemEvent, ItemListener

getItemListeners

public ItemListener[] getItemListeners()

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

Возвраты:

весь этот выбор ItemListeners или пустой массив, если никакие слушатели элемента в настоящий момент не регистрируются

С тех пор:

1.4

См. Также:

addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener), ItemEvent, ItemListener

getListeners

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

Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на это Choice. FooListeners регистрируются, используя addFooListener метод.

Можно определить listenerType параметр с литералом класса, такой как FooListener.class. Например, можно запросить a Choice c для его слушателей элемента со следующим кодом:

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

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

Переопределения:

getListeners в классе Component

Параметры:

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

Возвраты:

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

Броски:

ClassCastException - если listenerType не определяет класс или интерфейс, который реализует java.util.EventListener

С тех пор:

1.3

См. Также:

getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

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

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

Переопределения:

processEvent в классе Component

Параметры:

e - событие

С тех пор:

JDK1.1

См. Также:

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

processItemEvent

protected void processItemEvent(ItemEvent e)

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

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

• ItemListener объект регистрируется через addItemListener.
• Через события элемента включают enableEvents.

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

Параметры:

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

С тех пор:

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