Spec-Zone.ru › OpenJDK 27

Класс 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
Модификатор и тип Класс Описание
protected class  Component.AccessibleAWTComponent
Внутренний класс Component, используемый для обеспечения поддержки специальных возможностей по умолчанию.
static enum  Component.BaselineResizeBehavior
Перечисление распространенных способов изменения базовой линии компонента при изменении его размера.
protected class  Component.BltBufferStrategy
Внутренний класс для переноса содержимого внеэкранных поверхностей в компонент.
protected class  Component.FlipBufferStrategy
Внутренний класс для переключения буферов компонента.

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Модификатор и тип Поле Описание
protected AccessibleContext accessibleContext
AccessibleContext, связанный с этим Component.
static final float BOTTOM_ALIGNMENT
Удобная константа для getAlignmentY.
static final float CENTER_ALIGNMENT
Удобная константа для getAlignmentY и getAlignmentX.
static final float LEFT_ALIGNMENT
Удобная константа для getAlignmentX.
static final float RIGHT_ALIGNMENT
Удобная константа для getAlignmentX.
static final float TOP_ALIGNMENT
Удобная константа для getAlignmentY().

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

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Модификатор и тип Поле Описание
static final int ABORT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что создание изображения, за которым велось асинхронное наблюдение, было прервано до завершения.
static final int ALLBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что статическое изображение, ранее отрисованное, теперь готово и может быть отрисовано снова в окончательном виде.
static final int ERROR
Этот флаг в аргументе infoflags метода imageUpdate указывает, что при асинхронном отслеживании изображения произошла ошибка.
static final int FRAMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что стал доступен для повторной отрисовки еще один полный кадр ранее отрисованного многокадрового изображения.
static final int HEIGHT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что высота базового изображения теперь доступна и может быть получена из аргумента height метода обратного вызова imageUpdate.
static final int PROPERTIES
Этот флаг в аргументе infoflags метода imageUpdate указывает, что свойства изображения теперь доступны.
static final int SOMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что стали доступны дополнительные пиксели, необходимые для отрисовки масштабированной версии изображения.
static final int WIDTH
Этот флаг в аргументе infoflags метода imageUpdate указывает, что ширина базового изображения теперь доступна и может быть получена из аргумента width метода обратного вызова imageUpdate.

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

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

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

Модификатор и тип Метод Описание
void add(String item)
Добавляет элемент в это меню Choice.
void addItem(String item)
Устарел начиная с платформы Java 2 версии 1.1.
void addItemListener(ItemListener l)
Добавляет указанный прослушиватель элементов для получения событий элементов из этого меню Choice.
void addNotify()
Создает peer-объект 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
Модификатор и тип Метод Описание
boolean action(Event evt, Object what)
Устарело.
Начиная с JDK версии 1.1, следует регистрировать этот компонент как ActionListener компонента, генерирующего события действия.
void add(PopupMenu popup)
Добавляет указанное всплывающее меню к компоненту.
void addComponentListener(ComponentListener l)
Добавляет указанный прослушиватель компонента для получения событий компонента от этого компонента.
void addFocusListener(FocusListener l)
Добавляет указанный прослушиватель фокуса для получения событий фокуса от этого компонента при получении им фокуса ввода.
void addHierarchyBoundsListener(HierarchyBoundsListener l)
Добавляет указанный прослушиватель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
void addHierarchyListener(HierarchyListener l)
Добавляет указанный прослушиватель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
void addInputMethodListener(InputMethodListener l)
Добавляет указанный прослушиватель метода ввода для получения событий метода ввода от этого компонента.
void addKeyListener(KeyListener l)
Добавляет указанный прослушиватель клавиатуры для получения событий клавиатуры от этого компонента.
void addMouseListener(MouseListener l)
Добавляет указанный прослушиватель мыши для получения событий мыши от этого компонента.
void addMouseMotionListener(MouseMotionListener l)
Добавляет указанный прослушиватель перемещения мыши для получения событий перемещения мыши от этого компонента.
void addMouseWheelListener(MouseWheelListener l)
Добавляет указанный прослушиватель колеса мыши для получения событий колеса мыши от этого компонента.
void addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener в список прослушивателей.
void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Добавляет PropertyChangeListener в список прослушивателей для определённого свойства.
void applyComponentOrientation(ComponentOrientation orientation)
Задаёт свойство ComponentOrientation этого компонента и всех содержащихся в нём компонентов.
boolean areFocusTraversalKeysSet(int id)
Возвращает, был ли набор клавиш обхода фокуса для заданной операции обхода фокуса явно определён для этого компонента.
Rectangle bounds()
Устарело.
Начиная с JDK версии 1.1 заменён на getBounds().
int checkImage(Image image, int width, int height, ImageObserver observer)
Возвращает состояние создания экранного представления указанного изображения.
int checkImage(Image image, ImageObserver observer)
Возвращает состояние создания экранного представления указанного изображения.
protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)
При возможности объединяет публикуемое событие с уже существующим событием.
boolean contains(int x, int y)
Проверяет, «содержит» ли этот компонент указанную точку, где x и y заданы относительно системы координат этого компонента.
boolean contains(Point p)
Проверяет, «содержит» ли этот компонент указанную точку, координаты x и y которой заданы относительно системы координат этого компонента.
Image createImage(int width, int height)
Создаёт рисуемое изображение вне экрана для двойной буферизации.
Image createImage(ImageProducer producer)
Создаёт изображение из указанного источника изображений.
VolatileImage createVolatileImage(int width, int height)
Создаёт изменчивое рисуемое изображение вне экрана для двойной буферизации.
VolatileImage createVolatileImage(int width, int height, ImageCapabilities caps)
Создаёт изменчивое рисуемое изображение вне экрана с указанными возможностями.
void deliverEvent(Event e)
Устарело.
Начиная с JDK версии 1.1 заменён на dispatchEvent(AWTEvent e).
void disable()
Устарело.
Начиная с JDK версии 1.1 заменён на setEnabled(boolean).
protected final void disableEvents(long eventsToDisable)
Отключает доставку этому компоненту событий, определённых указанной маской событий.
final void dispatchEvent(AWTEvent e)
Передаёт событие этому компоненту или одному из его подкомпонентов.
void doLayout()
Предлагает менеджеру компоновки выполнить компоновку этого компонента.
void enable()
Устарело.
Начиная с JDK версии 1.1 заменён на setEnabled(boolean).
void enable(boolean b)
Устарело.
Начиная с JDK версии 1.1 заменён на setEnabled(boolean).
protected final void enableEvents(long eventsToEnable)
Включает доставку этому компоненту событий, определённых указанной маской событий.
void enableInputMethods(boolean enable)
Включает или отключает поддержку методов ввода для этого компонента.
protected void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Поддержка уведомления об изменениях связанных свойств типа boolean.
void firePropertyChange(String propertyName, byte oldValue, byte newValue)
Уведомляет об изменении связанного свойства.
void firePropertyChange(String propertyName, char oldValue, char newValue)
Уведомляет об изменении связанного свойства.
void firePropertyChange(String propertyName, double oldValue, double newValue)
Уведомляет об изменении связанного свойства.
void firePropertyChange(String propertyName, float oldValue, float newValue)
Уведомляет об изменении связанного свойства.
protected void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка уведомления об изменениях связанных свойств типа integer.
void firePropertyChange(String propertyName, long oldValue, long newValue)
Уведомляет об изменении связанного свойства.
void firePropertyChange(String propertyName, short oldValue, short newValue)
Уведомляет об изменении связанного свойства.
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
Поддержка уведомления об изменениях связанных свойств типа Object.
float getAlignmentX()
Возвращает выравнивание по оси x.
float getAlignmentY()
Возвращает выравнивание по оси y.
Color getBackground()
Возвращает цвет фона этого компонента.
int getBaseline(int width, int height)
Возвращает базовую линию.
Component.BaselineResizeBehavior getBaselineResizeBehavior()
Возвращает значение перечисления, указывающее, как меняется базовая линия компонента при изменении его размера.
Rectangle getBounds()
Возвращает границы этого компонента в виде объекта Rectangle.
Rectangle getBounds(Rectangle rv)
Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
ColorModel getColorModel()
Получает экземпляр ColorModel, используемый для отображения компонента на устройстве вывода.
Component getComponentAt(int x, int y)
Определяет, содержит ли этот компонент или один из его непосредственных подкомпонентов точку с координатами (x, y), и, если содержит, возвращает содержащий её компонент.
Component getComponentAt(Point p)
Возвращает компонент или подкомпонент, содержащий указанную точку.
ComponentListener[] getComponentListeners()
Возвращает массив всех прослушивателей компонента, зарегистрированных для этого компонента.
ComponentOrientation getComponentOrientation()
Получает языковую ориентацию, используемую для упорядочения элементов или текста внутри этого компонента.
Cursor getCursor()
Получает курсор, установленный для компонента.
DropTarget getDropTarget()
Получает DropTarget, связанный с этим Component.
Container getFocusCycleRootAncestor()
Возвращает Container, являющийся корнем цикла обхода фокуса для этого цикла обхода фокуса компонента.
FocusListener[] getFocusListeners()
Возвращает массив всех прослушивателей фокуса, зарегистрированных для этого компонента.
Set<AWTKeyStroke> getFocusTraversalKeys(int id)
Возвращает набор клавиш обхода фокуса для заданной операции обхода для этого компонента.
boolean getFocusTraversalKeysEnabled()
Возвращает, включён ли обход фокуса с помощью клавиш для этого компонента.
Font getFont()
Получает шрифт этого компонента.
FontMetrics getFontMetrics(Font font)
Получает метрики указанного шрифта.
Color getForeground()
Получает цвет переднего плана этого компонента.
Graphics getGraphics()
Создаёт графический контекст для этого компонента.
GraphicsConfiguration getGraphicsConfiguration()
Получает GraphicsConfiguration, связанный с этим Component.
int getHeight()
Возвращает текущую высоту этого компонента.
HierarchyBoundsListener[] getHierarchyBoundsListeners()
Возвращает массив всех прослушивателей границ иерархии, зарегистрированных для этого компонента.
HierarchyListener[] getHierarchyListeners()
Возвращает массив всех прослушивателей иерархии, зарегистрированных для этого компонента.
boolean getIgnoreRepaint()
Возвращает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
InputContext getInputContext()
Получает контекст ввода, используемый этим компонентом для обработки обмена данными с методами ввода при вводе текста в этот компонент.
InputMethodListener[] getInputMethodListeners()
Возвращает массив всех прослушивателей методов ввода, зарегистрированных для этого компонента.
InputMethodRequests getInputMethodRequests()
Получает обработчик запросов метода ввода, поддерживающий запросы методов ввода для этого компонента.
KeyListener[] getKeyListeners()
Возвращает массив всех прослушивателей клавиатуры, зарегистрированных для этого компонента.
Locale getLocale()
Получает локаль этого компонента.
Point getLocation()
Получает местоположение этого компонента в виде точки, задающей его верхний левый угол.
Point getLocation(Point rv)
Сохраняет начало координат x,y этого компонента в «возвращаемое значение» rv и возвращает rv.
Point getLocationOnScreen()
Возвращает местоположение этого компонента в виде точки, задающей его верхний левый угол в системе координат экрана.
Dimension getMaximumSize()
Возвращает максимальный размер этого компонента.
Dimension getMinimumSize()
Возвращает минимальный размер этого компонента.
MouseListener[] getMouseListeners()
Возвращает массив всех обработчиков мыши, зарегистрированных для этого компонента.
MouseMotionListener[] getMouseMotionListeners()
Возвращает массив всех обработчиков перемещения мыши, зарегистрированных для этого компонента.
Point getMousePosition()
Возвращает положение указателя мыши в системе координат Component, если Component находится непосредственно под указателем мыши; в противном случае возвращает null.
MouseWheelListener[] getMouseWheelListeners()
Возвращает массив всех обработчиков колеса мыши, зарегистрированных для этого компонента.
String getName()
Возвращает имя компонента.
Container getParent()
Возвращает родительский элемент этого компонента.
Dimension getPreferredSize()
Возвращает предпочтительный размер этого компонента.
PropertyChangeListener[] getPropertyChangeListeners()
Возвращает массив всех обработчиков изменения свойств, зарегистрированных для этого компонента.
PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Возвращает массив всех обработчиков, связанных с указанным свойством.
Dimension getSize()
Возвращает размер этого компонента в виде объекта Dimension.
Dimension getSize(Dimension rv)
Сохраняет ширину/высоту этого компонента в «возвращаемое значение» rv и возвращает rv.
Toolkit getToolkit()
Возвращает инструментарий этого компонента.
final Object getTreeLock()
Возвращает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потоков) для операций с деревом компонентов AWT и компоновкой.
int getWidth()
Возвращает текущую ширину этого компонента.
int getX()
Возвращает текущую координату x начала координат компонента.
int getY()
Возвращает текущую координату y начала координат компонента.
boolean gotFocus(Event evt, Object what)
Устарело.
Начиная с JDK версии 1.1 заменено на processFocusEvent(FocusEvent).
boolean handleEvent(Event evt)
Устарело.
Начиная с JDK версии 1.1 заменено на processEvent(AWTEvent).
boolean hasFocus()
Возвращает true, если этот Component является владельцем фокуса.
void hide()
Устарело.
Начиная с JDK версии 1.1 заменено на setVisible(boolean).
boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Перерисовывает компонент при изменении изображения.
boolean inside(int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на contains(int, int).
void invalidate()
Инвалидирует этот компонент и его предков.
boolean isBackgroundSet()
Возвращает значение, указывающее, был ли явно задан цвет фона для этого компонента.
boolean isCursorSet()
Возвращает значение, указывающее, был ли явно задан курсор для этого компонента.
boolean isDisplayable()
Определяет, доступен ли этот компонент для отображения.
boolean isDoubleBuffered()
Возвращает true, если компонент рисуется во внеэкранное изображение («буфер»), которое впоследствии копируется на экран.
boolean isEnabled()
Определяет, включен ли этот компонент.
boolean isFocusable()
Возвращает значение, указывающее, может ли этот компонент получать фокус.
boolean isFocusCycleRoot(Container container)
Возвращает значение, указывающее, является ли указанный контейнер корнем цикла перемещения фокуса для цикла перемещения фокуса этого компонента.
boolean isFocusOwner()
Возвращает true, если этот Component является владельцем фокуса.
boolean isFocusTraversable()
Устарело.
Начиная с версии 1.4 заменено на isFocusable().
boolean isFontSet()
Возвращает значение, указывающее, был ли явно задан шрифт для этого компонента.
boolean isForegroundSet()
Возвращает значение, указывающее, был ли явно задан цвет переднего плана для этого компонента.
boolean isLightweight()
Легковесный компонент не имеет собственного системного компонента-посредника.
boolean isMaximumSizeSet()
Возвращает true, если максимальный размер задан ненулевым значением null; в противном случае возвращает false.
boolean isMinimumSizeSet()
Возвращает значение, указывающее, был ли вызван setMinimumSize с ненулевым значением.
boolean isOpaque()
Возвращает true, если компонент полностью непрозрачен; по умолчанию возвращает false.
boolean isPreferredSizeSet()
Возвращает true, если предпочтительный размер задан ненулевым значением null; в противном случае возвращает false.
boolean isShowing()
Определяет, отображается ли этот компонент на экране.
boolean isValid()
Определяет, является ли этот компонент действительным.
boolean isVisible()
Определяет, должен ли этот компонент быть видимым, когда видим его родительский элемент.
boolean keyDown(Event evt, int key)
Устарело.
Начиная с JDK версии 1.1 заменено на processKeyEvent(KeyEvent).
boolean keyUp(Event evt, int key)
Устарело.
Начиная с JDK версии 1.1 заменено на processKeyEvent(KeyEvent).
void layout()
Устарело.
Начиная с JDK версии 1.1 заменено на doLayout().
void list()
Выводит описание этого компонента в стандартный системный поток вывода System.out.
void list(PrintStream out)
Выводит описание этого компонента в указанный поток вывода.
void list(PrintStream out, int indent)
Выводит список в указанный поток печати, начиная с указанного отступа.
void list(PrintWriter out)
Выводит описание в указанный объект записи.
void list(PrintWriter out, int indent)
Выводит список в указанный объект записи, начиная с указанного отступа.
Component locate(int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на getComponentAt(int, int).
Point location()
Устарело.
Начиная с JDK версии 1.1 заменено на getLocation().
boolean lostFocus(Event evt, Object what)
Устарело.
Начиная с JDK версии 1.1 заменено на processFocusEvent(FocusEvent).
Dimension minimumSize()
Устарело.
Начиная с JDK версии 1.1 заменено на getMinimumSize().
boolean mouseDown(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
boolean mouseDrag(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseMotionEvent(MouseEvent).
boolean mouseEnter(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
boolean mouseExit(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
boolean mouseMove(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseMotionEvent(MouseEvent).
boolean mouseUp(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
void move(int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на setLocation(int, int).
void nextFocus()
Устарело.
Начиная с JDK версии 1.1 заменено на transferFocus().
void paint(Graphics g)
Рисует этот компонент.
void paintAll(Graphics g)
Рисует этот компонент и все его дочерние компоненты.
boolean postEvent(Event e)
Устарело.
Начиная с JDK версии 1.1 заменено на dispatchEvent(AWTEvent).
Dimension preferredSize()
Устарело.
Начиная с JDK версии 1.1 заменено на getPreferredSize().
boolean prepareImage(Image image, int width, int height, ImageObserver observer)
Подготавливает изображение к отображению на этом компоненте с указанными шириной и высотой.
boolean prepareImage(Image image, ImageObserver observer)
Подготавливает изображение к отображению на этом компоненте.
void print(Graphics g)
Печатает этот компонент.
void printAll(Graphics g)
Печатает этот компонент и все его подкомпоненты.
protected void processComponentEvent(ComponentEvent e)
Обрабатывает события компонента, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам ComponentListener.
protected void processFocusEvent(FocusEvent e)
Обрабатывает события фокуса, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам FocusListener.
protected void processHierarchyBoundsEvent(HierarchyEvent e)
Обрабатывает события границ иерархии, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам HierarchyBoundsListener.
protected void processHierarchyEvent(HierarchyEvent e)
Обрабатывает события иерархии, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам HierarchyListener.
protected void processInputMethodEvent(InputMethodEvent e)
Обрабатывает события метода ввода, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам InputMethodListener.
protected void processKeyEvent(KeyEvent e)
Обрабатывает события клавиатуры, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам KeyListener.
protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам MouseListener.
protected void processMouseMotionEvent(MouseEvent e)
Обрабатывает события перемещения мыши, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам MouseMotionListener.
protected void processMouseWheelEvent(MouseWheelEvent e)
Обрабатывает события прокрутки колеса мыши, возникающие в этом компоненте, отправляя их всем зарегистрированным объектам MouseWheelListener.
void remove(MenuComponent popup)
Удаляет указанное всплывающее меню из компонента.
void removeComponentListener(ComponentListener l)
Удаляет указанный обработчик событий компонента, чтобы он больше не получал события компонента от этого компонента.
void removeFocusListener(FocusListener l)
Удаляет указанный обработчик событий фокуса, чтобы он больше не получал события фокуса от этого компонента.
void removeHierarchyBoundsListener(HierarchyBoundsListener l)
Удаляет указанный обработчик событий границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
void removeHierarchyListener(HierarchyListener l)
Удаляет указанный обработчик событий иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
void removeInputMethodListener(InputMethodListener l)
Удаляет указанный обработчик событий метода ввода, чтобы он больше не получал события метода ввода от этого компонента.
void removeKeyListener(KeyListener l)
Удаляет указанный обработчик событий клавиатуры, чтобы он больше не получал события клавиатуры от этого компонента.
void removeMouseListener(MouseListener l)
Удаляет указанный обработчик событий мыши, чтобы он больше не получал события мыши от этого компонента.
void removeMouseMotionListener(MouseMotionListener l)
Удаляет указанный обработчик событий перемещения мыши, чтобы он больше не получал события перемещения мыши от этого компонента.
void removeMouseWheelListener(MouseWheelListener l)
Удаляет указанный обработчик событий колеса мыши, чтобы он больше не получал события колеса мыши от этого компонента.
void removeNotify()
Делает этот Component невидимым, уничтожая его собственный экранный ресурс.
void removePropertyChangeListener(PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка обработчиков.
void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка обработчиков для указанного свойства.
void repaint()
Перерисовывает этот компонент.
void repaint(int x, int y, int width, int height)
Перерисовывает указанный прямоугольный фрагмент этого компонента.
void repaint(long tm)
Перерисовывает компонент.
void repaint(long tm, int x, int y, int width, int height)
Перерисовывает указанный прямоугольный фрагмент этого компонента в течение tm миллисекунд.
void requestFocus()
Запрашивает передачу фокуса ввода этому компоненту и фокуса окну — его предку верхнего уровня.
protected boolean requestFocus(boolean temporary)
Запрашивает передачу фокуса ввода этому Component и фокуса Window — его предку Component верхнего уровня.
protected boolean requestFocus(boolean temporary, FocusEvent.Cause cause)
Запрашивает по причине cause передачу фокуса ввода этому Component и фокуса Window — его предку Component верхнего уровня.
void requestFocus(FocusEvent.Cause cause)
Запрашивает по причине cause передачу фокуса ввода этому компоненту и фокуса окну — его предку верхнего уровня.
boolean requestFocusInWindow()
Запрашивает передачу фокуса ввода этому компоненту, если его предок верхнего уровня уже является окном, которому принадлежит фокус.
protected boolean requestFocusInWindow(boolean temporary)
Запрашивает передачу фокуса ввода этому Component, если его предок Component верхнего уровня уже является Window, которому принадлежит фокус.
boolean requestFocusInWindow(FocusEvent.Cause cause)
Запрашивает по причине cause передачу фокуса ввода этому компоненту, если его предок верхнего уровня уже является окном, которому принадлежит фокус.
void reshape(int x, int y, int width, int height)
Устарело.
Начиная с JDK версии 1.1 заменено на setBounds(int, int, int, int).
void resize(int width, int height)
Устарело.
Начиная с JDK версии 1.1 заменено на setSize(int, int).
void resize(Dimension d)
Устарело.
Начиная с JDK версии 1.1 заменено на setSize(Dimension).
void revalidate()
Повторно проверяет иерархию компонентов вплоть до ближайшего корня проверки.
void setBackground(Color c)
Задает цвет фона этого компонента.
void setBounds(int x, int y, int width, int height)
Перемещает и изменяет размер этого компонента.
void setBounds(Rectangle r)
Перемещает и изменяет размер этого компонента в соответствии с новым ограничивающим прямоугольником r.
void setComponentOrientation(ComponentOrientation o)
Задает зависящую от языка ориентацию, используемую для упорядочения элементов или текста в этом компоненте.
void setCursor(Cursor cursor)
Задает указанное изображение курсора.
void setDropTarget(DropTarget dt)
Связывает DropTarget с этим компонентом.
void setEnabled(boolean b)
Включает или отключает этот компонент в зависимости от значения параметра b.
void setFocusable(boolean focusable)
Задает для компонента возможность получения фокуса указанное значение.
void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Задает клавиши перехода фокуса для указанной операции перехода этого компонента.
void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
Задает, включены ли клавиши перехода фокуса для этого компонента.
void setFont(Font f)
Задает шрифт этого компонента.
void setForeground(Color c)
Задает цвет переднего плана этого компонента.
void setIgnoreRepaint(boolean ignoreRepaint)
Задает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
void setLocale(Locale l)
Задает локаль этого компонента.
void setLocation(int x, int y)
Перемещает этот компонент в новое местоположение.
void setLocation(Point p)
Перемещает этот компонент в новое местоположение.
void setMaximumSize(Dimension maximumSize)
Задает максимальный размер этого компонента постоянным значением.
void setMinimumSize(Dimension minimumSize)
Задает минимальный размер этого компонента постоянным значением.
void setMixingCutoutShape(Shape shape)
Задает форму «mixing-cutout» для этого облегченного компонента.
void setName(String name)
Задает для компонента указанную строку в качестве имени.
void setPreferredSize(Dimension preferredSize)
Задает предпочтительный размер этого компонента постоянным значением.
void setSize(int width, int height)
Изменяет размер этого компонента так, чтобы его ширина составляла width, а высота — height.
void setSize(Dimension d)
Изменяет размер этого компонента так, чтобы его ширина составляла d.width, а высота — d.height.
void setVisible(boolean b)
Показывает или скрывает этот компонент в зависимости от значения параметра b.
void show()
Устарело.
Начиная с JDK версии 1.1 заменено на setVisible(boolean).
void show(boolean b)
Устарело.
Начиная с JDK версии 1.1 заменено на setVisible(boolean).
Dimension size()
Устарело.
Начиная с JDK версии 1.1 заменено на getSize().
String toString()
Возвращает строковое представление этого компонента и его значений.
void transferFocus()
Передает фокус следующему компоненту, как если бы этот компонент владел фокусом.
void transferFocusBackward()
Передает фокус предыдущему компоненту, как если бы этот компонент владел фокусом.
void transferFocusUpCycle()
Передает фокус на один цикл обхода фокуса вверх.
void update(Graphics g)
Обновляет этот компонент.
void validate()
Проверяет этот компонент.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создаёт и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли этот объект какому-либо другому объекту.
protected void finalize()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Финализация устарела и будет удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определённого промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определённого промежутка реального времени.

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

Choice

public Choice() throws HeadlessException
Создает новое меню выбора. Изначально меню не содержит элементов.

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

Выбрасывает исключение:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:
  • GraphicsEnvironment.isHeadless()
  • select(int)
  • select(java.lang.String)

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

addNotify

public void addNotify()
Создает peer для Choice. Этот peer позволяет изменять внешний вид 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)
Устарел начиная с версии 1.1 платформы Java 2. Вместо него используйте метод 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(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 см. в разделе Проблемы многопоточности AWT.

Определено в:
addItemListener в интерфейсе ItemSelectable
Параметры:
l - прослушиватель элементов
Начиная с версии:
1.1
См. также:
  • removeItemListener(ItemListener)
  • getItemListeners()
  • select(int)
  • ItemEvent
  • ItemListener

removeItemListener

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

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

Определено в:
removeItemListener в интерфейсе ItemSelectable
Параметры:
l - прослушиватель элементов
Начиная с версии:
1.1
См. также:
  • addItemListener(ItemListener)
  • getItemListeners()
  • ItemEvent
  • ItemListener

getItemListeners

public ItemListener[] getItemListeners()
Возвращает массив всех прослушивателей элементов, зарегистрированных для этого списка выбора.
Возвращает:
все ItemListener этого списка выбора или пустой массив, если в данный момент не зарегистрировано ни одного прослушивателя элементов
Начиная с версии:
1.4
См. также:
  • addItemListener(ItemListener)
  • removeItemListener(ItemListener)
  • ItemEvent
  • ItemListener

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)
Возвращает массив всех объектов, зарегистрированных в данный момент как FooListeners для этого Choice. FooListeners регистрируются с помощью метода addFooListener.

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

ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));
Если таких слушателей нет, этот метод возвращает пустой массив.
Переопределяет:
getListeners в классе Component
Параметры типа:
T — тип слушателей
Параметры:
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 — событие
С версии:
1.1
См. также:
  • ItemEvent
  • processItemEvent(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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API