Spec-Zone.ru › OpenJDK 27

Класс JComboBox<E>

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JComboBox<E>
Параметры типа:
E - the type of the elements of this combo box
Все реализованные интерфейсы:
ActionListener, ImageObserver, ItemSelectable, MenuContainer, Serializable, EventListener, Accessible, ListDataListener
@JavaBean(defaultProperty="UI", description="A combination of a text field and a drop-down list.") public class JComboBox<E> extends JComponent implements ItemSelectable, ListDataListener, ActionListener, Accessible
Компонент, объединяющий кнопку или редактируемое поле и выпадающий список. Пользователь может выбрать значение из выпадающего списка, который появляется по запросу пользователя. Если сделать раскрывающийся список редактируемым, он будет содержать редактируемое поле, в которое пользователь может ввести значение.

Предупреждение: Swing не является потокобезопасным. Дополнительные сведения см. в разделе Политика работы с потоками в Swing.

Предупреждение: Сериализованные объекты этого класса будут несовместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями с одинаковой версией Swing. Начиная с версии 1.4, поддержка долговременного хранения всех JavaBeans была добавлена в пакет java.beans. См. XMLEncoder.

Дополнительные сведения см. в разделе Использование раскрывающихся списков (How to Use Combo Boxes) в The Java Tutorial.

Начиная с версии:
1.2
См. также:
  • ComboBoxModel
  • DefaultComboBoxModel

Краткое описание вложенных классов

Модификатор и тип Класс Описание
protected class  JComboBox.AccessibleJComboBox
Этот класс реализует поддержку доступности для класса JComboBox.
static interface  JComboBox.KeySelectionManager
Интерфейс, определяющий KeySelectionManager.

Вложенные классы/интерфейсы, объявленные в классе JComponent

JComponent.AccessibleJComponent
Модификатор и тип Класс Описание
class  JComponent.AccessibleJComponent
Внутренний класс JComponent, используемый для обеспечения поддержки доступности по умолчанию.

Вложенные классы/интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer
Модификатор и тип Класс Описание
protected class  Container.AccessibleAWTContainer
Внутренний класс Container, используемый для обеспечения поддержки доступности по умолчанию.

Вложенные классы/интерфейсы, объявленные в классе 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
Внутренний класс для переключения (flipping) буферов на компоненте.

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

Модификатор и тип Поле Описание
protected String actionCommand
Это защищенное поле зависит от реализации.
protected ComboBoxModel<E> dataModel
Это защищенное поле зависит от реализации.
protected ComboBoxEditor editor
Это защищенное поле зависит от реализации.
protected boolean isEditable
Это защищенное поле зависит от реализации.
protected JComboBox.KeySelectionManager keySelectionManager
Это защищенное поле зависит от реализации.
protected boolean lightWeightPopupEnabled
Это защищенное поле зависит от реализации.
protected int maximumRowCount
Это защищенное поле зависит от реализации.
protected ListCellRenderer<? super E> renderer
Это защищенное поле зависит от реализации.
protected Object selectedItemReminder
Это защищенное поле зависит от реализации.

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

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Модификатор и тип Поле Описание
protected EventListenerList listenerList
Список слушателей событий для этого компонента.
static final String TOOL_TIP_TEXT_KEY
Комментарий, отображаемый при наведении курсора на компонент, также известный как «подсказка значения», «всплывающая подсказка» или «всплывающая метка».
protected ComponentUI ui
Делегат внешнего вида и функциональности (look and feel) для этого компонента.
static final int UNDEFINED_CONDITION
Константа, используемая некоторыми API для обозначения того, что условие не определено.
static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
Константа, используемая для registerKeyboardAction, которая означает, что команда должна вызываться, когда принимающий компонент является предком сфокусированного компонента или сам является сфокусированным компонентом.
static final int WHEN_FOCUSED
Константа, используемая для registerKeyboardAction, которая означает, что команда должна вызываться, когда компонент находится в фокусе.
static final int WHEN_IN_FOCUSED_WINDOW
Константа, используемая для registerKeyboardAction, которая означает, что команда должна вызываться, когда принимающий компонент находится в окне, имеющем фокус, или сам является сфокусированным компонентом.

Поля, объявленные в классе 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.

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

Конструктор Описание
JComboBox()
Создает JComboBox с моделью данных по умолчанию.
JComboBox(E[] items)
Создает JComboBox, содержащий элементы указанного массива.
JComboBox(Vector<E> items)
Создает JComboBox, содержащий элементы указанного Vector.
JComboBox(ComboBoxModel<E> aModel)
Создает JComboBox, берущий свои элементы из существующей ComboBoxModel.

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

Модификатор и тип Метод Описание
void actionPerformed(ActionEvent e)
Этот метод является общедоступным из-за особенностей реализации. Не вызывайте и не переопределяйте его.
protected void actionPropertyChanged(Action action, String propertyName)
Обновляет состояние раскрывающегося списка в ответ на изменения свойств связанного действия.
void addActionListener(ActionListener l)
Добавляет ActionListener.
void addItem(E item)
Добавляет элемент в список элементов.
void addItemListener(ItemListener aListener)
Добавляет ItemListener.
void addPopupMenuListener(PopupMenuListener l)
Добавляет слушатель PopupMenu, который будет получать уведомления от всплывающей части раскрывающегося списка.
void configureEditor(ComboBoxEditor anEditor, Object anItem)
Инициализирует редактор указанным элементом.
protected void configurePropertiesFromAction(Action a)
Задает свойства этого раскрывающегося списка в соответствии со свойствами указанного Action.
void contentsChanged(ListDataEvent e)
Этот метод является общедоступным из-за особенностей реализации. Не вызывайте и не переопределяйте его.
protected PropertyChangeListener createActionPropertyChangeListener(Action a)
Создает и возвращает PropertyChangeListener, который отвечает за отслеживание изменений указанного Action и обновление соответствующих свойств.
protected JComboBox.KeySelectionManager createDefaultKeySelectionManager()
Возвращает экземпляр диспетчера выбора клавишами по умолчанию.
protected void fireActionEvent()
Оповещает всех слушателей, зарегистрировавшихся для получения уведомлений о событиях данного типа.
protected void fireItemStateChanged(ItemEvent e)
Оповещает всех слушателей, зарегистрировавшихся для получения уведомлений о событиях данного типа.
void firePopupMenuCanceled()
Оповещает PopupMenuListener о том, что всплывающая часть раскрывающегося списка была отменена.
void firePopupMenuWillBecomeInvisible()
Оповещает PopupMenuListener о том, что всплывающая часть раскрывающегося списка стала невидимой.
void firePopupMenuWillBecomeVisible()
Оповещает PopupMenuListener о том, что всплывающая часть раскрывающегося списка станет видимой.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JComboBox.
Action getAction()
Возвращает текущее установленное действие Action для этого источника ActionEvent или null, если Action не задано.
String getActionCommand()
Возвращает команду действия, включенную в событие, отправляемое слушателям действий.
ActionListener[] getActionListeners()
Возвращает массив всех ActionListener, добавленных в этот JComboBox с помощью addActionListener().
ComboBoxEditor getEditor()
Возвращает редактор, используемый для отрисовки и редактирования выбранного элемента в поле JComboBox.
E getItemAt(int index)
Возвращает элемент списка по указанному индексу.
int getItemCount()
Возвращает количество элементов в списке.
ItemListener[] getItemListeners()
Возвращает массив всех ItemListener, добавленных в этот JComboBox с помощью addItemListener().
JComboBox.KeySelectionManager getKeySelectionManager()
Возвращает диспетчер выбора клавишами списка.
int getMaximumRowCount()
Возвращает максимальное количество элементов, которое раскрывающийся список может отображать без полосы прокрутки
ComboBoxModel<E> getModel()
Возвращает модель данных, используемую в данный момент компонентом JComboBox.
PopupMenuListener[] getPopupMenuListeners()
Возвращает массив всех PopupMenuListener, добавленных в этот JComboBox с помощью addPopupMenuListener().
E getPrototypeDisplayValue()
Возвращает значение "прототипа отображения" — объект Object, используемый для вычисления высоты и ширины отображения.
ListCellRenderer<? super E> getRenderer()
Возвращает модуль рендеринга, используемый для отображения выбранного элемента в поле JComboBox.
int getSelectedIndex()
Возвращает первый элемент в списке, соответствующий указанному элементу.
Object getSelectedItem()
Возвращает текущий выбранный элемент.
Object[] getSelectedObjects()
Возвращает массив, содержащий выбранный элемент.
ComboBoxUI getUI()
Возвращает объект L&F, отрисовывающий этот компонент.
String getUIClassID()
Возвращает имя класса L&F, который отрисовывает этот компонент.
void hidePopup()
Заставляет раскрывающийся список закрыть свое всплывающее окно.
void insertItemAt(E item, int index)
Вставляет элемент в список элементов по указанному индексу.
protected void installAncestorListener()
Регистрирует слушатель предков, чтобы он получал AncestorEvents при перемещении его самого или любого из его предков, а также при изменении их видимости.
void intervalAdded(ListDataEvent e)
Этот метод является общедоступным из-за особенностей реализации. Не вызывайте и не переопределяйте его.
void intervalRemoved(ListDataEvent e)
Этот метод является общедоступным из-за особенностей реализации. Не вызывайте и не переопределяйте его.
boolean isEditable()
Возвращает true, если JComboBox является редактируемым.
boolean isLightWeightPopupEnabled()
Возвращает значение свойства lightWeightPopupEnabled.
boolean isPopupVisible()
Определяет видимость всплывающего окна.
protected String paramString()
Возвращает строковое представление этого JComboBox.
void processKeyEvent(KeyEvent e)
Обрабатывает KeyEvent в поисках клавиши Tab.
void removeActionListener(ActionListener l)
Удаляет ActionListener.
void removeAllItems()
Удаляет все элементы из списка элементов.
void removeItem(Object anObject)
Удаляет элемент из списка элементов.
void removeItemAt(int anIndex)
Удаляет элемент в позиции anIndex Этот метод работает только в том случае, если JComboBox использует изменяемую модель данных.
void removeItemListener(ItemListener aListener)
Удаляет ItemListener.
void removePopupMenuListener(PopupMenuListener l)
Удаляет PopupMenuListener.
protected void selectedItemChanged()
Этот защищенный метод зависит от реализации.
boolean selectWithKeyChar(char keyChar)
Выбирает элемент списка, соответствующий указанному символу клавиатуры, и возвращает true, если существует элемент, соответствующий этому символу.
void setAction(Action a)
Устанавливает Action для источника ActionEvent.
void setActionCommand(String aCommand)
Устанавливает команду действия, которая должна быть включена в событие, отправляемое слушателям действий.
void setEditable(boolean aFlag)
Определяет, доступно ли для редактирования поле JComboBox.
void setEditor(ComboBoxEditor anEditor)
Устанавливает редактор, используемый для отрисовки и редактирования выбранного элемента в поле JComboBox.
void setEnabled(boolean b)
Включает раскрывающийся список, позволяя выбирать элементы.
void setKeySelectionManager(JComboBox.KeySelectionManager aManager)
Задает объект, преобразующий символ клавиатуры в выбор элемента из списка.
void setLightWeightPopupEnabled(boolean aFlag)
Задает свойство lightWeightPopupEnabled, предоставляющее подсказку о том, следует ли использовать легковесный компонент Component для размещения JComboBox вместо тяжеловесного компонента Component, такого как Panel или Window.
void setMaximumRowCount(int count)
Устанавливает максимальное количество строк, отображаемых JComboBox.
void setModel(ComboBoxModel<E> aModel)
Задает модель данных, которую JComboBox использует для получения списка элементов.
void setPopupVisible(boolean v)
Задает видимость всплывающего окна.
void setPrototypeDisplayValue(E prototypeDisplayValue)
Задает прототипное значение отображения, используемое для вычисления размера области отображения в части пользовательского интерфейса.
void setRenderer(ListCellRenderer<? super E> aRenderer)
Устанавливает модуль рендеринга, отрисовывающий элементы списка и выбранный из списка элемент в поле JComboBox.
void setSelectedIndex(int anIndex)
Выбирает элемент с индексом anIndex.
void setSelectedItem(Object anObject)
Устанавливает выбранный элемент в области отображения раскрывающегося списка равным объекту в аргументе.
void setUI(ComboBoxUI ui)
Устанавливает объект L&F, отрисовывающий этот компонент.
void showPopup()
Заставляет раскрывающийся список отобразить свое всплывающее окно.
void updateUI()
Сбрасывает свойство UI до значения из текущего внешнего вида и функциональности (look and feel).

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

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
Модификатор и тип Метод Описание
void addAncestorListener(AncestorListener listener)
Регистрирует listener для получения AncestorEvents, когда он сам или любой из его предков перемещается либо становится видимым или невидимым.
void addNotify()
Уведомляет этот компонент о том, что у него теперь есть родительский компонент.
void addVetoableChangeListener(VetoableChangeListener listener)
Добавляет VetoableChangeListener в список слушателей.
void computeVisibleRect(Rectangle visibleRect)
Возвращает «прямоугольник видимой области» (visible rect) компонента Component — пересечение видимых прямоугольников для этого компонента и всех его предков.
boolean contains(int x, int y)
Предоставляет делегату UI возможность определить точную форму этого компонента для обработки событий мыши.
JToolTip createToolTip()
Возвращает экземпляр JToolTip, который должен использоваться для отображения всплывающей подсказки.
void disable()
Устарело.
Начиная с версии JDK 1.1, заменено на java.awt.Component.setEnabled(boolean).
void enable()
Устарело.
Начиная с версии JDK 1.1, заменено на java.awt.Component.setEnabled(boolean).
void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Поддержка создания отчетов об изменениях связанных (bound) свойств для свойств типа boolean.
void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка создания отчетов об изменениях связанных (bound) свойств для свойств типа integer.
protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue)
Поддерживает создание отчетов об изменениях ограниченных (constrained) свойств.
ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)
Возвращает объект, который будет выполнять действие, зарегистрированное для данного сочетания клавиш.
final ActionMap getActionMap()
Возвращает ActionMap, используемый для определения того, какое действие Action запускать для конкретной привязки KeyStroke.
float getAlignmentX()
Переопределяет Container.getAlignmentX для возврата выравнивания по горизонтали.
float getAlignmentY()
Переопределяет Container.getAlignmentY для возврата выравнивания по вертикали.
AncestorListener[] getAncestorListeners()
Возвращает массив всех слушателей предков (ancestor listeners), зарегистрированных на этом компоненте.
boolean getAutoscrolls()
Получает свойство autoscrolls.
int getBaseline(int width, int height)
Возвращает базовую линию.
Component.BaselineResizeBehavior getBaselineResizeBehavior()
Возвращает перечисление (enum), указывающее, как базовая линия компонента изменяется при изменении его размера.
Border getBorder()
Возвращает границу этого компонента или null, если граница в данный момент не установлена.
Rectangle getBounds(Rectangle rv)
Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
final Object getClientProperty(Object key)
Возвращает значение свойства с указанным ключом.
protected Graphics getComponentGraphics(Graphics g)
Возвращает графический объект, используемый для отрисовки этого компонента.
JPopupMenu getComponentPopupMenu()
Возвращает JPopupMenu, назначенный для этого компонента.
int getConditionForKeyStroke(KeyStroke aKeyStroke)
Возвращает условие, определяющее, происходит ли зарегистрированное действие в ответ на указанное нажатие клавиши.
int getDebugGraphicsOptions()
Возвращает состояние отладки графики.
static Locale getDefaultLocale()
Возвращает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
FontMetrics getFontMetrics(Font font)
Получает FontMetrics для указанного Font.
Graphics getGraphics()
Возвращает графический контекст этого компонента, который позволяет рисовать на компоненте.
int getHeight()
Возвращает текущую высоту этого компонента.
boolean getInheritsPopupMenu()
Возвращает true, если JPopupMenu должен наследоваться от родителя.
final InputMap getInputMap()
Возвращает InputMap, используемый, когда компонент находится в фокусе.
final InputMap getInputMap(int condition)
Возвращает InputMap, используемый во время condition.
InputVerifier getInputVerifier()
Возвращает верификатор ввода (input verifier) для этого компонента.
Insets getInsets()
Если для этого компонента была установлена граница, возвращает отступы границы; в противном случае вызывает super.getInsets.
Insets getInsets(Insets insets)
Возвращает объект Insets, содержащий значения внутренних отступов этого компонента.
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, зарегистрированных в данный момент как FooListener для этого JComponent.
Point getLocation(Point rv)
Сохраняет начальные координаты x, y этого компонента в «возвращаемое значение» rv и возвращает rv.
Dimension getMaximumSize()
Если максимальный размер был установлен в значение, отличное от null, просто возвращает его.
Dimension getMinimumSize()
Если минимальный размер был установлен в значение, отличное от null, просто возвращает его.
Component getNextFocusableComponent()
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy.
Point getPopupLocation(MouseEvent event)
Возвращает предпочтительное положение для отображения всплывающего меню в системе координат этого компонента.
Dimension getPreferredSize()
Если preferredSize установлен в значение, отличное от null, просто возвращает его.
KeyStroke[] getRegisteredKeyStrokes()
Возвращает KeyStrokes, который будет инициировать зарегистрированные действия.
JRootPane getRootPane()
Возвращает предка типа JRootPane для этого компонента.
Dimension getSize(Dimension rv)
Сохраняет ширину/высоту этого компонента в «возвращаемое значение» rv и возвращает rv.
Point getToolTipLocation(MouseEvent event)
Возвращает положение всплывающей подсказки в системе координат этого компонента.
String getToolTipText()
Возвращает строку всплывающей подсказки, заданную с помощью setToolTipText.
String getToolTipText(MouseEvent event)
Возвращает строку, которая будет использоваться в качестве всплывающей подсказки для события event.
Container getTopLevelAncestor()
Возвращает предка верхнего уровня этого компонента (содержащий Window) или null, если этот компонент не был добавлен ни в один контейнер.
TransferHandler getTransferHandler()
Получает свойство transferHandler.
boolean getVerifyInputWhenFocusTarget()
Возвращает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса до того, как этот компонент запросит фокус.
VetoableChangeListener[] getVetoableChangeListeners()
Возвращает массив всех слушателей вето-изменений (vetoable change listeners), зарегистрированных на этом компоненте.
Rectangle getVisibleRect()
Возвращает «видимый прямоугольник» компонента Component — пересечение видимого прямоугольника этого компонента, new Rectangle(0, 0, getWidth(), getHeight()), и видимых прямоугольников всех его предков.
int getWidth()
Возвращает текущую ширину этого компонента.
int getX()
Возвращает текущую координату x начала этого компонента.
int getY()
Возвращает текущую координату y начала этого компонента.
void grabFocus()
Запрашивает получение фокуса ввода этим Component, а также чтобы предок верхнего уровня этого Component стал сфокусированным Window.
void hide()
Устарело.
boolean isDoubleBuffered()
Возвращает значение, определяющее, должен ли этот компонент использовать буфер для отрисовки.
static boolean isLightweightComponent(Component c)
Возвращает true, если этот компонент является легковесным, то есть если у него нет нативного аналога (peer) в оконной системе.
boolean isManagingFocus()
Устарело.
Начиная с версии 1.4, заменено на Component.setFocusTraversalKeys(int, Set) и Container.setFocusCycleRoot(boolean).
boolean isOpaque()
Возвращает true, если этот компонент полностью непрозрачен.
boolean isOptimizedDrawingEnabled()
Возвращает true, если этот компонент выстраивает свои дочерние элементы мозаикой (tiles) — то есть может гарантировать, что они не будут перекрываться.
final boolean isPaintingForPrint()
Возвращает true, если текущая операция отрисовки на этом компоненте является частью операции print.
protected boolean isPaintingOrigin()
Возвращает true, если отрисовка, инициированная на дочернем компоненте, должна приводить к запуску отрисовки из этого Component или одного из его предков.
boolean isPaintingTile()
Возвращает true, если компонент в данный момент отрисовывает тайл.
boolean isRequestFocusEnabled()
Возвращает true, если этот JComponent должен получить фокус; в противном случае возвращает false.
boolean isValidateRoot()
Если этот метод возвращает true, вызовы revalidate потомками этого компонента приведут к валидации всего дерева, начиная с этого корня.
void paint(Graphics g)
Вызывается Swing для отрисовки компонентов.
protected void paintBorder(Graphics g)
Отрисовывает границу компонента.
protected void paintChildren(Graphics g)
Отрисовывает дочерние элементы этого компонента.
protected void paintComponent(Graphics g)
Вызывает метод paint делегата UI, если делегат UI не равен null.
void paintImmediately(int x, int y, int w, int h)
Немедленно отрисовывает указанную область в этом компоненте и всех его потомках, перекрывающих эту область.
void paintImmediately(Rectangle r)
Отрисовывает указанную область прямо сейчас.
void print(Graphics g)
Вызовите этот метод для вывода компонента на печать в указанный Graphics.
void printAll(Graphics g)
Вызовите этот метод для вывода компонента на печать.
protected void printBorder(Graphics g)
Выводит на печать границу компонента.
protected void printChildren(Graphics g)
Выводит на печать дочерние элементы этого компонента.
protected void printComponent(Graphics g)
Вызывается во время операции печати.
protected void processComponentKeyEvent(KeyEvent e)
Обрабатывает любые события клавиш, которые распознает сам компонент.
protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
Вызывается для обработки привязок клавиш для ks в результате KeyEvent e.
protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, происходящие на этом компоненте, отправляя их любым зарегистрированным объектам MouseListener; полное описание этого метода см. в Component.processMouseEvent(MouseEvent).
protected void processMouseMotionEvent(MouseEvent e)
Обрабатывает события перемещения мыши, такие как MouseEvent.MOUSE_DRAGGED.
final void putClientProperty(Object key, Object value)
Добавляет произвольное «клиентское свойство» типа ключ/значение к этому компоненту.
void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел, для аналогичного поведения используйте комбинацию getActionMap() и getInputMap().
void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел, для аналогичного поведения используйте комбинацию getActionMap() и getInputMap().
void removeAncestorListener(AncestorListener listener)
Отменяет регистрацию listener, чтобы он больше не получал AncestorEvents.
void removeNotify()
Уведомляет этот компонент о том, что у него больше нет родительского компонента.
void removeVetoableChangeListener(VetoableChangeListener listener)
Удаляет VetoableChangeListener из списка слушателей.
void repaint(long tm, int x, int y, int width, int height)
Добавляет указанную область в список «загрязненных» (dirty) областей, если компонент отображается.
void repaint(Rectangle r)
Добавляет указанную область в список «загрязненных» (dirty) областей, если компонент отображается.
boolean requestDefaultFocus()
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
void requestFocus()
Запрашивает, чтобы этот Component получил фокус ввода.
boolean requestFocus(boolean temporary)
Запрашивает, чтобы этот Component получил фокус ввода.
boolean requestFocusInWindow()
Запрашивает, чтобы этот Component получил фокус ввода.
protected boolean requestFocusInWindow(boolean temporary)
Запрашивает, чтобы этот Component получил фокус ввода.
void resetKeyboardActions()
Отменяет регистрацию всех привязок в первом уровне InputMaps и ActionMap.
void reshape(int x, int y, int w, int h)
Устарело.
Начиная с JDK 5, заменено на Component.setBounds(int, int, int, int).
void revalidate()
Поддерживает отложенную автоматическую компоновку.
void scrollRectToVisible(Rectangle aRect)
Пересылает сообщение scrollRectToVisible() родителю JComponent.
final void setActionMap(ActionMap am)
Устанавливает значение ActionMap равным am.
void setAlignmentX(float alignmentX)
Устанавливает горизонтальное выравнивание.
void setAlignmentY(float alignmentY)
Устанавливает вертикальное выравнивание.
void setAutoscrolls(boolean autoscrolls)
Устанавливает свойство autoscrolls.
void setBackground(Color bg)
Устанавливает цвет фона этого компонента.
void setBorder(Border border)
Устанавливает границу этого компонента.
void setComponentPopupMenu(JPopupMenu popup)
Устанавливает JPopupMenu для этого JComponent.
void setDebugGraphicsOptions(int debugOptions)
Включает или отключает диагностическую информацию о каждой графической операции, выполняемой внутри компонента или одного из его потомков.
static void setDefaultLocale(Locale l)
Устанавливает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
void setDoubleBuffered(boolean aFlag)
Определяет, должен ли этот компонент использовать буфер для отрисовки.
void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Устанавливает клавиши обхода фокуса для заданной операции обхода для этого Component.
void setFont(Font font)
Устанавливает шрифт для этого компонента.
void setForeground(Color fg)
Устанавливает цвет переднего плана этого компонента.
void setInheritsPopupMenu(boolean value)
Определяет, должен ли метод getComponentPopupMenu делегировать вызов родителю, если этому компоненту не назначен JPopupMenu.
final void setInputMap(int condition, InputMap map)
Устанавливает InputMap для использования при условии condition в map.
void setInputVerifier(InputVerifier inputVerifier)
Устанавливает верификатор ввода (input verifier) для этого компонента.
void setMaximumSize(Dimension maximumSize)
Устанавливает максимальный размер этого компонента в константное значение.
void setMinimumSize(Dimension minimumSize)
Устанавливает минимальный размер этого компонента в константное значение.
void setNextFocusableComponent(Component aComponent)
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy
void setOpaque(boolean isOpaque)
Если true, компонент отрисовывает каждый пиксель в пределах своих границ.
void setPreferredSize(Dimension preferredSize)
Устанавливает предпочтительный размер этого компонента.
void setRequestFocusEnabled(boolean requestFocusEnabled)
Предоставляет подсказку относительно того, должен ли этот JComponent получить фокус.
void setToolTipText(String text)
Регистрирует текст для отображения во всплывающей подсказке.
void setTransferHandler(TransferHandler newHandler)
Устанавливает TransferHandler, обеспечивающий поддержку передачи данных в этот компонент и из него с помощью вырезания/копирования/вставки и перетаскивания (drag-and-drop).
protected void setUI(ComponentUI newUI)
Устанавливает делегата внешнего вида и поведения (look and feel) для этого компонента.
void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
Задает значение, определяющее, будет ли вызываться верификатор ввода для текущего владельца фокуса до того, как этот компонент запросит фокус.
void setVisible(boolean aFlag)
Делает компонент видимым или невидимым.
void unregisterKeyboardAction(KeyStroke aKeyStroke)
Этот метод устарел.
void update(Graphics g)
Вызывает paint.

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

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
Модификатор и тип Метод Описание
Component add(Component comp)
Добавляет указанный компонент в конец этого контейнера.
Component add(Component comp, int index)
Добавляет указанный компонент в этот контейнер в заданную позицию.
void add(Component comp, Object constraints)
Добавляет указанный компонент в конец этого контейнера.
void add(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер с указанными ограничениями по указанному индексу.
Component add(String name, Component comp)
Добавляет указанный компонент в этот контейнер.
void addContainerListener(ContainerListener l)
Добавляет указанный прослушиватель контейнера для получения событий контейнера от этого контейнера.
protected void addImpl(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер по указанному индексу.
void addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener в список прослушивателей.
void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Добавляет PropertyChangeListener в список прослушивателей для определенного свойства.
void applyComponentOrientation(ComponentOrientation o)
Устанавливает свойство ComponentOrientation этого контейнера и всех содержащихся в нем компонентов.
boolean areFocusTraversalKeysSet(int id)
Возвращает значение, указывающее, был ли явно определен набор (Set) клавиш обхода фокуса для данной операции обхода фокуса для этого контейнера.
int countComponents()
Устарело.
Начиная с версии JDK 1.1 заменено на getComponentCount().
void deliverEvent(Event e)
Устарело.
Начиная с версии JDK 1.1 заменено на dispatchEvent(AWTEvent e)
void doLayout()
Заставляет этот контейнер выполнить компоновку своих компонентов.
Component findComponentAt(int x, int y)
Находит видимый дочерний компонент, содержащий указанную позицию.
Component findComponentAt(Point p)
Находит видимый дочерний компонент, содержащий указанную точку.
Component getComponent(int n)
Получает n-й компонент в этом контейнере.
Component getComponentAt(int x, int y)
Находит компонент, содержащий позицию x,y.
Component getComponentAt(Point p)
Получает компонент, содержащий указанную точку.
int getComponentCount()
Получает количество компонентов в этой панели.
Component[] getComponents()
Получает все компоненты в этом контейнере.
int getComponentZOrder(Component comp)
Возвращает индекс компонента в z-порядке внутри контейнера.
ContainerListener[] getContainerListeners()
Возвращает массив всех прослушивателей контейнера, зарегистрированных для этого контейнера.
Set<AWTKeyStroke> getFocusTraversalKeys(int id)
Возвращает набор (Set) клавиш обхода фокуса для заданной операции обхода для этого контейнера.
FocusTraversalPolicy getFocusTraversalPolicy()
Возвращает политику обхода фокуса, которая будет управлять обходом с клавиатуры дочерних элементов этого контейнера, или null, если этот контейнер не является корнем цикла фокуса.
LayoutManager getLayout()
Получает менеджер компоновки для этого контейнера.
Point getMousePosition(boolean allowChildren)
Возвращает позицию указателя мыши в пространстве координат этого Container, если Container находится под указателем мыши, иначе возвращает null.
Insets insets()
Устарело.
Начиная с версии JDK 1.1 заменено на getInsets().
void invalidate()
Делает контейнер недействительным.
boolean isAncestorOf(Component c)
Проверяет, содержится ли компонент в иерархии компонентов этого контейнера.
boolean isFocusCycleRoot()
Возвращает значение, указывающее, является ли этот контейнер корнем цикла обхода фокуса.
boolean isFocusCycleRoot(Container container)
Возвращает значение, указывающее, является ли указанный контейнер корнем цикла фокуса для цикла обхода фокуса этого контейнера.
final boolean isFocusTraversalPolicyProvider()
Возвращает значение, указывающее, предоставляет ли этот контейнер политику обхода фокуса.
boolean isFocusTraversalPolicySet()
Возвращает значение, указывающее, была ли политика обхода фокуса явно установлена для этого контейнера.
void layout()
Устарело.
Начиная с версии JDK 1.1 заменено на doLayout().
void list(PrintStream out, int indent)
Выводит список этого контейнера в указанный выходной поток.
void list(PrintWriter out, int indent)
Выводит список, начиная с указанного отступа, в указанный модуль записи печати (print writer).
Component locate(int x, int y)
Устарело.
Начиная с версии JDK 1.1 заменено на getComponentAt(int, int).
Dimension minimumSize()
Устарело.
Начиная с версии JDK 1.1 заменено на getMinimumSize().
void paintComponents(Graphics g)
Отрисовывает каждый из компонентов в этом контейнере.
Dimension preferredSize()
Устарело.
Начиная с версии JDK 1.1 заменено на getPreferredSize().
void printComponents(Graphics g)
Печатает каждый из компонентов в этом контейнере.
protected void processContainerEvent(ContainerEvent e)
Обрабатывает события контейнера, происходящие в этом контейнере, отправляя их любым зарегистрированным объектам ContainerListener.
protected void processEvent(AWTEvent e)
Обрабатывает события в этом контейнере.
void remove(int index)
Удаляет компонент, указанный index, из этого контейнера.
void remove(Component comp)
Удаляет указанный компонент из этого контейнера.
void removeAll()
Удаляет все компоненты из этого контейнера.
void removeContainerListener(ContainerListener l)
Удаляет указанный прослушиватель контейнера, чтобы он больше не получал события контейнера от этого контейнера.
void setComponentZOrder(Component comp, int index)
Перемещает указанный компонент на указанный индекс z-порядка в контейнере.
void setFocusCycleRoot(boolean focusCycleRoot)
Устанавливает, является ли этот контейнер корнем цикла обхода фокуса.
void setFocusTraversalPolicy(FocusTraversalPolicy policy)
Устанавливает политику обхода фокуса, которая будет управлять обходом с клавиатуры дочерних элементов этого контейнера, если этот контейнер является корнем цикла фокуса.
final void setFocusTraversalPolicyProvider(boolean provider)
Устанавливает, будет ли этот контейнер использоваться для предоставления политики обхода фокуса.
void setLayout(LayoutManager mgr)
Устанавливает менеджер компоновки для этого контейнера.
void transferFocusDownCycle()
Передает фокус на один цикл обхода фокуса вниз.
void validate()
Проверяет допустимость (validates) этого контейнера и всех его подкомпонентов.
protected void validateTree()
Рекурсивно спускается по дереву контейнеров и повторно вычисляет компоновку для любых поддеревьев, помеченных как требующие этого (помеченных как недействительные).

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
Модификатор и тип Метод Описание
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)
Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента.
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(Point p)
Проверяет, «содержит» ли этот компонент указанную точку, где координаты x и y точки определены относительно системы координат этого компонента.
Image createImage(int width, int height)
Создает закадровое отрисовываемое изображение для использования при двойной буферизации.
Image createImage(ImageProducer producer)
Создает изображение из указанного поставщика изображений.
VolatileImage createVolatileImage(int width, int height)
Создает изменяемое (volatile) закадровое отрисовываемое изображение для использования при двойной буферизации.
VolatileImage createVolatileImage(int width, int height, ImageCapabilities caps)
Создает изменяемое (volatile) закадровое отрисовываемое изображение с заданными возможностями.
protected final void disableEvents(long eventsToDisable)
Отключает доставку этому компоненту событий, определенных указанным параметром маски событий.
final void dispatchEvent(AWTEvent e)
Диспетчеризирует событие этому компоненту или одному из его подкомпонентов.
void enable(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setEnabled(boolean).
protected final void enableEvents(long eventsToEnable)
Включает доставку этому компоненту событий, определенных указанным параметром маски событий.
void enableInputMethods(boolean enable)
Включает или отключает поддержку методов ввода для этого компонента.
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)
Сообщает об изменении связанного свойства.
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.
Color getBackground()
Возвращает цвет фона этого компонента.
Rectangle getBounds()
Возвращает границы этого компонента в виде объекта Rectangle.
ColorModel getColorModel()
Возвращает экземпляр ColorModel, используемый для отображения компонента на устройстве вывода.
ComponentListener[] getComponentListeners()
Возвращает массив всех слушателей компонентов, зарегистрированных для этого компонента.
ComponentOrientation getComponentOrientation()
Возвращает языковую ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
Cursor getCursor()
Возвращает курсор, установленный в компоненте.
DropTarget getDropTarget()
Возвращает DropTarget, связанный с этим Component.
Container getFocusCycleRootAncestor()
Возвращает Container, который является корнем цикла обхода фокуса для этого Component.
FocusListener[] getFocusListeners()
Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
boolean getFocusTraversalKeysEnabled()
Возвращает, включены ли клавиши обхода фокуса для этого Component.
Font getFont()
Возвращает шрифт этого компонента.
Color getForeground()
Возвращает цвет переднего плана этого компонента.
GraphicsConfiguration getGraphicsConfiguration()
Возвращает GraphicsConfiguration, связанный с этим Component.
HierarchyBoundsListener[] getHierarchyBoundsListeners()
Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
HierarchyListener[] getHierarchyListeners()
Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
boolean getIgnoreRepaint()
Возвращает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
InputContext getInputContext()
Возвращает контекст ввода, используемый этим компонентом для взаимодействия с методами ввода при вводе текста в этот компонент.
InputMethodListener[] getInputMethodListeners()
Возвращает массив всех слушателей методов ввода, зарегистрированных для этого компонента.
InputMethodRequests getInputMethodRequests()
Возвращает обработчик запросов метода ввода, который поддерживает запросы от методов ввода для этого компонента.
KeyListener[] getKeyListeners()
Возвращает массив всех слушателей клавиатуры, зарегистрированных для этого компонента.
Locale getLocale()
Возвращает локаль этого компонента.
Point getLocation()
Возвращает положение этого компонента в виде точки, определяющей его левый верхний угол.
Point getLocationOnScreen()
Возвращает положение этого компонента в виде точки, определяющей его левый верхний угол в координатном пространстве экрана.
MouseListener[] getMouseListeners()
Возвращает массив всех слушателей мыши, зарегистрированных для этого компонента.
MouseMotionListener[] getMouseMotionListeners()
Возвращает массив всех слушателей перемещения мыши, зарегистрированных для этого компонента.
Point getMousePosition()
Возвращает положение указателя мыши в координатном пространстве этого Component, если Component находится непосредственно под указателем мыши, в противном случае возвращает null.
MouseWheelListener[] getMouseWheelListeners()
Возвращает массив всех слушателей колесика мыши, зарегистрированных для этого компонента.
String getName()
Возвращает имя компонента.
Container getParent()
Возвращает родительский компонент этого компонента.
PropertyChangeListener[] getPropertyChangeListeners()
Возвращает массив всех слушателей изменения свойств, зарегистрированных для этого компонента.
PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Возвращает массив всех слушателей, связанных с указанным свойством.
Dimension getSize()
Возвращает размер этого компонента в виде объекта Dimension.
Toolkit getToolkit()
Возвращает инструментарий (toolkit) этого компонента.
final Object getTreeLock()
Возвращает объект блокировки этого компонента (объект, владеющий монитором синхронизации потоков) для операций с деревом компонентов AWT и компоновкой.
boolean gotFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
boolean handleEvent(Event evt)
Устарело.
Начиная с версии JDK 1.1, заменено на processEvent(AWTEvent).
boolean hasFocus()
Возвращает true, если этот Component является владельцем фокуса.
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).
boolean isBackgroundSet()
Возвращает, был ли явно задан цвет фона для этого Component.
boolean isCursorSet()
Возвращает, был ли явно задан курсор для этого Component.
boolean isDisplayable()
Определяет, может ли этот компонент отображаться.
boolean isEnabled()
Определяет, включен ли этот компонент.
boolean isFocusable()
Возвращает, может ли этот Component получать фокус.
boolean isFocusOwner()
Возвращает true, если этот Component является владельцем фокуса.
boolean isFocusTraversable()
Устарело.
Начиная с версии 1.4, заменено на isFocusable().
boolean isFontSet()
Возвращает, был ли явно задан шрифт для этого Component.
boolean isForegroundSet()
Возвращает, был ли явно задан цвет переднего плана для этого Component.
boolean isLightweight()
Легковесный компонент не имеет нативного аналога в инструментарии.
boolean isMaximumSizeSet()
Возвращает true, если для максимального размера было задано значение, отличное от null, в противном случае возвращает false.
boolean isMinimumSizeSet()
Возвращает, вызывался ли метод setMinimumSize со значением, отличным от null.
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 list()
Выводит список параметров этого компонента в стандартный системный поток вывода System.out.
void list(PrintStream out)
Выводит список параметров этого компонента в указанный поток вывода.
void list(PrintWriter out)
Выводит список параметров в указанный print writer.
Point location()
Устарело.
Начиная с версии JDK 1.1, заменено на getLocation().
boolean lostFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
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 paintAll(Graphics g)
Отрисовывает этот компонент и все его подкомпоненты.
boolean postEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent).
boolean prepareImage(Image image, int width, int height, ImageObserver observer)
Подготавливает изображение для отрисовки на этом компоненте с указанной шириной и высотой.
boolean prepareImage(Image image, ImageObserver observer)
Подготавливает изображение для отрисовки на этом компоненте.
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 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 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)
Перерисовывает компонент.
protected boolean requestFocus(boolean temporary, FocusEvent.Cause cause)
Запрашивает по причине cause передачу фокуса ввода этому Component, а также чтобы предок верхнего уровня этого Component стал сфокусированным Window.
void requestFocus(FocusEvent.Cause cause)
Запрашивает по причине cause передачу фокуса ввода этому Component, а также чтобы предок верхнего уровня этого Component стал сфокусированным Window.
boolean requestFocusInWindow(FocusEvent.Cause cause)
Запрашивает по причине cause передачу фокуса ввода этому Component, если предок верхнего уровня этого Component уже является сфокусированным Window.
void resize(int width, int height)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(int, int).
void resize(Dimension d)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(Dimension).
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 setFocusable(boolean focusable)
Устанавливает состояние фокусируемости этого Component в указанное значение.
void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
Задает, включены ли клавиши обхода фокуса для этого Component.
void setIgnoreRepaint(boolean ignoreRepaint)
Задает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
void setLocale(Locale l)
Задает локаль этого компонента.
void setLocation(int x, int y)
Перемещает этот компонент на новое местоположение.
void setLocation(Point p)
Перемещает этот компонент на новое местоположение.
void setMixingCutoutShape(Shape shape)
Задает фигуру «выреза смешивания» ('mixing-cutout') для этого легковесного компонента.
void setName(String name)
Задает имя компонента равным указанной строке.
void setSize(int width, int height)
Изменяет размер этого компонента так, чтобы он имел ширину width и высоту height.
void setSize(Dimension d)
Изменяет размер этого компонента так, чтобы он имел ширину d.width и высоту d.height.
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()
Передает фокус следующему компоненту, как если бы этот Component был владельцем фокуса.
void transferFocusBackward()
Передает фокус предыдущему компоненту, как если бы этот Component был владельцем фокуса.
void transferFocusUpCycle()
Передает фокус на один цикл обхода фокуса вверх.

Методы, объявленные в классе 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()
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет определенное количество реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет определенное количество реального времени.

Подробное описание полей

dataModel

protected ComboBoxModel<E> dataModel
Это защищенное поле зависит от реализации. Не обращайтесь к нему напрямую и не переопределяйте его. Используйте вместо этого методы доступа.
См. также:
  • getModel()
  • setModel(ComboBoxModel)

renderer

protected ListCellRenderer<? super E> renderer
Это защищенное поле зависит от реализации. Не обращайтесь к нему напрямую и не переопределяйте его. Используйте вместо этого методы доступа.
См. также:
  • getRenderer()
  • setRenderer(ListCellRenderer)

editor

protected ComboBoxEditor editor
Это защищенное поле зависит от реализации. Не обращайтесь к нему напрямую и не переопределяйте его. Используйте вместо этого методы доступа.
См. также:
  • getEditor()
  • setEditor(ComboBoxEditor)

maximumRowCount

protected int maximumRowCount
Это защищенное поле зависит от реализации. Не обращайтесь к нему напрямую и не переопределяйте его. Используйте вместо этого методы доступа.
См. также:
  • getMaximumRowCount()
  • setMaximumRowCount(int)

isEditable

protected boolean isEditable
Это защищенное поле зависит от реализации. Не обращайтесь к нему напрямую и не переопределяйте его. Используйте вместо этого методы доступа.
См. также:
  • isEditable()
  • setEditable(boolean)

keySelectionManager

protected JComboBox.KeySelectionManager keySelectionManager
Это защищенное поле зависит от реализации. Не обращайтесь к нему напрямую и не переопределяйте его. Используйте вместо этого методы доступа.
См. также:
  • setKeySelectionManager(JComboBox.KeySelectionManager)
  • getKeySelectionManager()

actionCommand

protected String actionCommand
Это защищенное поле зависит от реализации. Не обращайтесь к нему напрямую и не переопределяйте его. Используйте вместо этого методы доступа.
См. также:
  • setActionCommand(String)
  • getActionCommand()

lightWeightPopupEnabled

protected boolean lightWeightPopupEnabled
Это защищенное поле зависит от реализации. Не обращайтесь к нему напрямую и не переопределяйте его. Используйте вместо этого методы доступа.
См. также:
  • setLightWeightPopupEnabled(boolean)
  • isLightWeightPopupEnabled()

selectedItemReminder

protected Object selectedItemReminder
Это защищенное поле зависит от реализации. Не обращайтесь к нему напрямую и не переопределяйте его.

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

JComboBox

public JComboBox(ComboBoxModel<E> aModel)
Создает JComboBox, который берет свои элементы из существующей ComboBoxModel. Поскольку ComboBoxModel предоставлена, раскрывающийся список, созданный с помощью этого конструктора, не создает модель раскрывающегося списка по умолчанию, что может повлиять на поведение методов вставки, удаления и добавления.
Параметры:
aModel - ComboBoxModel, предоставляющая отображаемый список элементов
См. также:
  • DefaultComboBoxModel

JComboBox

public JComboBox(E[] items)
Создает JComboBox, содержащий элементы из указанного массива. По умолчанию выбирается первый элемент массива (и, следовательно, модели данных).
Параметры:
items - массив объектов для вставки в раскрывающийся список
См. также:
  • DefaultComboBoxModel

JComboBox

public JComboBox(Vector<E> items)
Создает JComboBox, содержащий элементы из указанного Vector. По умолчанию выбирается первый элемент вектора (и, следовательно, модели данных).
Параметры:
items - массив векторов для вставки в раскрывающийся список
См. также:
  • DefaultComboBoxModel

JComboBox

public JComboBox()
Создает JComboBox с моделью данных по умолчанию. Модель данных по умолчанию представляет собой пустой список объектов. Используйте addItem для добавления элементов. По умолчанию выбирается первый элемент модели данных.
См. также:
  • DefaultComboBoxModel

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

installAncestorListener

protected void installAncestorListener()
Регистрирует слушателя предка, чтобы он получал AncestorEvents, когда сам компонент или любой из его предков перемещается, становится видимым или невидимым. События также отправляются, когда компонент или его предки добавляются или удаляются из иерархии включения.

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") public void setUI(ComboBoxUI ui)
Устанавливает объект L&F, который отрисовывает этот компонент.
Параметры:
ui - объект L&F ComboBoxUI
См. также:
  • UIDefaults.getUI(JComponent)

updateUI

public void updateUI()
Сбрасывает свойство UI на значение из текущего внешнего вида (look and feel).
Переопределяет:
updateUI в классе JComponent
См. также:
  • JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает имя класса L&F, который отрисовывает этот компонент.
Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "ComboBoxUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(JComponent)

getUI

public ComboBoxUI getUI()
Возвращает объект L&F, который отрисовывает этот компонент.
Переопределяет:
getUI в классе JComponent
Возвращает:
объект ComboBoxUI, который отрисовывает этот компонент

setModel

@BeanProperty(description="Model that the combo box uses to get data to display.") public void setModel(ComboBoxModel<E> aModel)
Устанавливает модель данных, которую JComboBox использует для получения списка элементов.
Параметры:
aModel - ComboBoxModel, предоставляющая отображаемый список элементов

getModel

public ComboBoxModel<E> getModel()
Возвращает модель данных, используемую в данный момент компонентом JComboBox.
Возвращает:
ComboBoxModel, предоставляющую отображаемый список элементов

setLightWeightPopupEnabled

@BeanProperty(expert=true, description="Set to <code>false</code> to require heavyweight popups.") public void setLightWeightPopupEnabled(boolean aFlag)
Устанавливает свойство lightWeightPopupEnabled, которое указывает, следует ли использовать легковесный (lightweight) Component для размещения JComboBox, в отличие от тяжеловесного (heavyweight) Component, такого как Panel или Window. Решение об использовании легковесного или тяжеловесного компонента в конечном итоге остается за JComboBox. Легковесные окна более эффективны, чем тяжеловесные, но легковесные и тяжеловесные компоненты плохо сочетаются в GUI. Если ваше приложение совмещает легковесные и тяжеловесные компоненты, вам следует отключить легковесные всплывающие окна. Значением по умолчанию для свойства lightWeightPopupEnabled является true, если иное не указано стилем оформления (look and feel). Некоторые стили оформления всегда используют тяжеловесные всплывающие окна, независимо от значения этого свойства.

См. статью Mixing Heavy and Light Components. Этот метод инициирует событие изменения свойства.

Параметры:
aFlag - если true, предпочтительны легковесные всплывающие окна

isLightWeightPopupEnabled

public boolean isLightWeightPopupEnabled()
Получает значение свойства lightWeightPopupEnabled.
Возвращает:
значение свойства lightWeightPopupEnabled
См. также:
  • setLightWeightPopupEnabled(boolean)

setEditable

@BeanProperty(preferred=true, description="If true, the user can type a new value in the combo box.") public void setEditable(boolean aFlag)
Определяет, доступно ли для редактирования поле JComboBox. Редактируемый JComboBox позволяет пользователю вводить текст в поле или выбирать элемент из списка для инициализации поля, после чего его можно отредактировать. (Редактирование влияет только на само поле, элемент списка остается неизменным.) Недоступный для редактирования JComboBox отображает выбранный элемент в поле, но выбор изменить нельзя.
Параметры:
aFlag - логическое значение, где true указывает, что поле доступно для редактирования

isEditable

public boolean isEditable()
Возвращает true, если JComboBox доступен для редактирования. По умолчанию раскрывающийся список не редактируется.
Возвращает:
true, если JComboBox редактируемый, иначе false

setMaximumRowCount

@BeanProperty(preferred=true, description="The maximum number of rows the popup should have") public void setMaximumRowCount(int count)
Задает максимальное количество строк, отображаемых JComboBox. Если количество объектов в модели больше count, раскрывающийся список использует полосу прокрутки.
Параметры:
count - целое число, задающее максимальное количество элементов для отображения в списке перед использованием полосы прокрутки

getMaximumRowCount

public int getMaximumRowCount()
Возвращает максимальное количество элементов, которое раскрывающийся список может отображать без полосы прокрутки
Возвращает:
целое число, задающее максимальное количество элементов, отображаемых в списке перед использованием полосы прокрутки

setRenderer

@BeanProperty(expert=true, description="The renderer that paints the item selected in the list.") public void setRenderer(ListCellRenderer<? super E> aRenderer)
Задает средство отрисовки (рендерер), которое отображает элементы списка и элемент, выбранный из списка в поле JComboBox. Средство отрисовки используется, если JComboBox недоступен для редактирования. Если он доступен для редактирования, для отрисовки и редактирования выбранного элемента используется редактор.

Средство отрисовки по умолчанию отображает строку или значок. Другие средства отрисовки могут обрабатывать графические изображения и составные элементы.

Для отображения выбранного элемента вызывается aRenderer.getListCellRendererComponent с передачей объекта списка и индекса -1.

Параметры:
aRenderer - ListCellRenderer, отображающий выбранный элемент
См. также:
  • setEditor(ComboBoxEditor)

getRenderer

public ListCellRenderer<? super E> getRenderer()
Возвращает средство отрисовки, используемое для отображения выбранного элемента в поле JComboBox.
Возвращает:
ListCellRenderer, отображающий выбранный элемент.

setEditor

@BeanProperty(expert=true, description="The editor that combo box uses to edit the current value") public void setEditor(ComboBoxEditor anEditor)
Задает редактор, используемый для отрисовки и редактирования выбранного элемента в поле JComboBox. Редактор используется только в том случае, если принимающий JComboBox доступен для редактирования. Если редактирование запрещено, раскрывающийся список использует средство отрисовки для отображения выбранного элемента.
Параметры:
anEditor - ComboBoxEditor, отображающий выбранный элемент
См. также:
  • setRenderer(ListCellRenderer)

getEditor

public ComboBoxEditor getEditor()
Возвращает редактор, используемый для отрисовки и редактирования выбранного элемента в поле JComboBox.
Возвращает:
ComboBoxEditor, отображающий выбранный элемент

setSelectedItem

@BeanProperty(bound=false, preferred=true, description="Sets the selected item in the JComboBox.") public void setSelectedItem(Object anObject)
Устанавливает выбранный элемент в области отображения раскрывающегося списка в объект, переданный в аргументе. Если anObject находится в списке, в области отображения показывается выбранный anObject.

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

Если это приводит к изменению выбранного элемента, добавленные в раскрывающийся список ItemListener будут уведомлены одним или двумя ItemEvent. Если в данный момент есть выбранный элемент, будет вызвано событие ItemEvent, и изменение состояния будет равно ItemEvent.DESELECTED. Если anObject находится в списке и в данный момент не выбран, будет вызвано событие ItemEvent, а изменение состояния будет равно ItemEvent.SELECTED.

Добавленные в раскрывающийся список ActionListener будут уведомлены с помощью ActionEvent при вызове этого метода.

Параметры:
anObject - объект списка для выбора; используйте null для очистки выбора

getSelectedItem

public Object getSelectedItem()
Возвращает текущий выбранный элемент.

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

Возвращает:
текущий выбранный Object
См. также:
  • setSelectedItem(Object)

setSelectedIndex

@BeanProperty(bound=false, preferred=true, description="The item at index is selected.") public void setSelectedIndex(int anIndex)
Выбирает элемент с индексом anIndex.
Параметры:
anIndex - целое число, задающее элемент списка для выбора, где 0 указывает на первый элемент списка, а -1 указывает на отсутствие выбора
Исключения:
IllegalArgumentException - если anIndex < -1 или anIndex больше либо равно размеру

getSelectedIndex

public int getSelectedIndex()
Возвращает первый элемент в списке, соответствующий заданному элементу. Результат не всегда определен, если JComboBox разрешает выбирать элементы, отсутствующие в списке. Возвращает -1, если выбранный элемент отсутствует или если пользователь указал элемент, которого нет в списке.
Возвращает:
целое число, задающее текущий выбранный элемент списка, где 0 указывает на первый элемент в списке; или -1, если ни один элемент не выбран или если текущий выбранный элемент отсутствует в списке

getPrototypeDisplayValue

public E getPrototypeDisplayValue()
Возвращает эталонное отображаемое значение ("prototypical display") — объект, используемый для вычисления высоты и ширины области отображения.
Возвращает:
значение свойства prototypeDisplayValue
С какого года/версии:
1.4
См. также:
  • setPrototypeDisplayValue(E)

setPrototypeDisplayValue

@BeanProperty(visualUpdate=true, description="The display prototype value, used to compute display width and height.") public void setPrototypeDisplayValue(E prototypeDisplayValue)
Устанавливает эталонное отображаемое значение, используемое для вычисления размера области отображения для части UI.

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

Параметры:
prototypeDisplayValue - эталонное отображаемое значение
С какого года/версии:
1.4
См. также:
  • getPrototypeDisplayValue()

addItem

public void addItem(E item)
Добавляет элемент в список элементов. Этот метод работает только в том случае, если JComboBox использует изменяемую модель данных.

Предупреждение: При добавлении дублирующихся объектов String могут возникнуть проблемы с фокусом и навигацией с помощью клавиатуры. В качестве обходного пути добавляйте новые объекты вместо объектов String и убедитесь, что метод toString() определен. Например:

  comboBox.addItem(makeObj("Item 1"));
  comboBox.addItem(makeObj("Item 1"));
  ...
  private Object makeObj(final String item)  {
    return new Object() { public String toString() { return item; } };
  }
Параметры:
item - элемент для добавления в список
См. также:
  • MutableComboBoxModel

insertItemAt

public void insertItemAt(E item, int index)
Вставляет элемент в список элементов по указанному индексу. Этот метод работает только в том случае, если JComboBox использует изменяемую модель данных.
Параметры:
item - элемент для добавления в список
index - целое число, указывающее позицию, в которую нужно добавить элемент
См. также:
  • MutableComboBoxModel

removeItem

public void removeItem(Object anObject)
Удаляет элемент из списка элементов. Этот метод работает только в том случае, если JComboBox использует изменяемую модель данных.
Параметры:
anObject - объект для удаления из списка элементов
См. также:
  • MutableComboBoxModel

removeItemAt

public void removeItemAt(int anIndex)
Удаляет элемент в позиции anIndex. Этот метод работает только в том случае, если JComboBox использует изменяемую модель данных.
Параметры:
anIndex - int, указывающий индекс удаляемого элемента, где 0 обозначает первый элемент в списке
См. также:
  • MutableComboBoxModel

removeAllItems

public void removeAllItems()
Удаляет все элементы из списка элементов.

showPopup

public void showPopup()
Приводит к отображению всплывающего окна раскрывающегося списка.
См. также:
  • setPopupVisible(boolean)

hidePopup

public void hidePopup()
Приводит к закрытию всплывающего окна раскрывающегося списка.
См. также:
  • setPopupVisible(boolean)

setPopupVisible

public void setPopupVisible(boolean v)
Задает видимость всплывающего окна.
Параметры:
v - если true, показывает всплывающее окно, иначе скрывает его.

isPopupVisible

public boolean isPopupVisible()
Определяет видимость всплывающего окна.
Возвращает:
true, если всплывающее окно видимо, в противном случае возвращает false

addItemListener

public void addItemListener(ItemListener aListener)
Добавляет ItemListener.

aListener получит одно или два события ItemEvent при изменении выбранного элемента.

Определено в:
addItemListener в интерфейсе ItemSelectable
Параметры:
aListener - ItemListener, который должен быть уведомлен
См. также:
  • setSelectedItem(Object)

removeItemListener

public void removeItemListener(ItemListener aListener)
Удаляет ItemListener.
Определено в:
removeItemListener в интерфейсе ItemSelectable
Параметры:
aListener - удаляемый ItemListener
См. также:
  • ItemEvent

getItemListeners

@BeanProperty(bound=false) public ItemListener[] getItemListeners()
Возвращает массив всех объектов ItemListener, добавленных в этот JComboBox с помощью addItemListener().
Возвращает:
все добавленные ItemListener или пустой массив, если слушатели не были добавлены
С какого года/версии:
1.4

addActionListener

public void addActionListener(ActionListener l)
Добавляет ActionListener.

ActionListener получит ActionEvent при совершении выбора. Если раскрывающийся список доступен для редактирования, событие ActionEvent будет отправлено после завершения редактирования.

Параметры:
l - ActionListener, который должен быть уведомлен
См. также:
  • setSelectedItem(Object)

removeActionListener

public void removeActionListener(ActionListener l)
Удаляет ActionListener.
Параметры:
l - удаляемый ActionListener

getActionListeners

@BeanProperty(bound=false) public ActionListener[] getActionListeners()
Возвращает массив всех объектов ActionListener, добавленных в этот JComboBox с помощью addActionListener().
Возвращает:
все добавленные ActionListener или пустой массив, если слушатели не были добавлены
С какого года/версии:
1.4

addPopupMenuListener

public void addPopupMenuListener(PopupMenuListener l)
Добавляет слушатель PopupMenu, который будет прослушивать уведомления от всплывающей части раскрывающегося списка.

Во всех стандартных стилях оформления, поставляемых с Java, всплывающая часть списка в раскрывающемся списке реализована как JPopupMenu. Пользовательский стиль оформления может не реализовывать это таким образом и, следовательно, не будет получать уведомления.

Параметры:
l - добавляемый PopupMenuListener
С какого года/версии:
1.4

removePopupMenuListener

public void removePopupMenuListener(PopupMenuListener l)
Удаляет PopupMenuListener.
Параметры:
l - удаляемый PopupMenuListener
С какого года/версии:
1.4
См. также:
  • addPopupMenuListener(PopupMenuListener)

getPopupMenuListeners

@BeanProperty(bound=false) public PopupMenuListener[] getPopupMenuListeners()
Возвращает массив всех слушателей PopupMenuListener, добавленных к этому JComboBox с помощью addPopupMenuListener().
Returns:
все добавленные слушатели PopupMenuListener или пустой массив, если слушатели не были добавлены
Since:
1.4

firePopupMenuWillBecomeVisible

public void firePopupMenuWillBecomeVisible()
Уведомляет слушателей PopupMenuListener о том, что всплывающая часть раскрывающегося списка станет видимой.

Этот метод является публичным, но не должен вызываться кем-либо, кроме делегата пользовательского интерфейса (UI delegate).

Since:
1.4
See Also:
  • addPopupMenuListener(PopupMenuListener)

firePopupMenuWillBecomeInvisible

public void firePopupMenuWillBecomeInvisible()
Уведомляет слушателей PopupMenuListener о том, что всплывающая часть раскрывающегося списка стала невидимой.

Этот метод является публичным, но не должен вызываться кем-либо, кроме делегата пользовательского интерфейса (UI delegate).

Since:
1.4
See Also:
  • addPopupMenuListener(PopupMenuListener)

firePopupMenuCanceled

public void firePopupMenuCanceled()
Уведомляет слушателей PopupMenuListener о том, что отображение всплывающей части раскрывающегося списка было отменено.

Этот метод является публичным, но не должен вызываться кем-либо, кроме делегата пользовательского интерфейса (UI delegate).

Since:
1.4
See Also:
  • addPopupMenuListener(PopupMenuListener)

setActionCommand

public void setActionCommand(String aCommand)
Задает команду действия, которая должна включаться в событие, отправляемое слушателям действий.
Parameters:
aCommand - строка, содержащая «команду», которая отправляется слушателям действий; один и тот же слушатель может выполнять различные действия в зависимости от полученной команды

getActionCommand

public String getActionCommand()
Возвращает команду действия, которая включается в событие, отправляемое слушателям действий.
Returns:
строка, содержащая «команду», которая отправляется слушателям действий.

setAction

@BeanProperty(visualUpdate=true, description="the Action instance connected with this ActionEvent source") public void setAction(Action a)
Устанавливает Action для источника ActionEvent. Новое действие Action заменяет любое ранее установленное Action, но не влияет на слушатели ActionListeners, добавленные независимо с помощью addActionListener. Если Action уже является зарегистрированным ActionListener для источника ActionEvent, оно повторно не регистрируется.

Установка Action приводит к немедленному изменению всех свойств, описанных в разделе Компоненты Swing, поддерживающие Action. Впоследствии свойства раскрывающегося списка автоматически обновляются по мере изменения свойств Action.

Этот метод использует три других метода для установки и отслеживания значений свойств Action. Он использует метод configurePropertiesFromAction для немедленного изменения свойств раскрывающегося списка. Для отслеживания изменений значений свойств в Action этот метод регистрирует PropertyChangeListener, возвращаемый методом createActionPropertyChangeListener. Стандартный PropertyChangeListener вызывает метод actionPropertyChanged при изменении свойства в Action.

Parameters:
a - Action для JComboBox или null.
Since:
1.3
See Also:
  • Action
  • getAction()
  • configurePropertiesFromAction(Action)
  • createActionPropertyChangeListener(Action)
  • actionPropertyChanged(Action, String)

getAction

public Action getAction()
Возвращает текущее установленное действие Action для этого источника ActionEvent или null, если Action не задано.
Returns:
действие Action для этого источника ActionEvent; или null
Since:
1.3
See Also:
  • Action
  • setAction(Action)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)
Настраивает свойства этого раскрывающегося списка в соответствии со свойствами указанного Action. Подробнее о том, какие свойства устанавливаются, см. в разделе Компоненты Swing, поддерживающие Action.
Parameters:
a - Action, из которого берутся свойства, или null
Since:
1.3
See Also:
  • Action
  • setAction(Action)

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)
Создает и возвращает PropertyChangeListener, который отвечает за прослушивание изменений в указанном Action и обновление соответствующих свойств.

Предупреждение: при создании подкласса не создавайте анонимный внутренний класс. В противном случае время жизни раскрывающегося списка будет привязано к времени жизни Action.

Parameters:
a - действие раскрывающегося списка
Returns:
PropertyChangeListener
Since:
1.3
See Also:
  • Action
  • setAction(Action)

actionPropertyChanged

protected void actionPropertyChanged(Action action, String propertyName)
Обновляет состояние раскрывающегося списка в ответ на изменения свойств в связанном действии. Этот метод вызывается из PropertyChangeListener, возвращаемого методом createActionPropertyChangeListener. Подклассам обычно не требуется вызывать этот метод. Подклассы, поддерживающие дополнительные свойства Action, должны переопределять этот метод и метод configurePropertiesFromAction.

Список свойств, устанавливаемых этим методом, см. в таблице раздела Компоненты Swing, поддерживающие Action.

Parameters:
action - Action, связанное с этим раскрывающимся списком
propertyName - имя изменившегося свойства
Since:
1.6
See Also:
  • Action
  • configurePropertiesFromAction(Action)

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)
Оповещает всех слушателей, зарегистрировавших интерес к получению уведомлений об этом типе события.
Parameters:
e - интересующее событие
See Also:
  • EventListenerList

fireActionEvent

protected void fireActionEvent()
Оповещает всех слушателей, зарегистрировавших интерес к получению уведомлений об этом типе события.
See Also:
  • EventListenerList

selectedItemChanged

protected void selectedItemChanged()
Этот защищенный метод зависит от реализации. Не обращайтесь к нему напрямую и не переопределяйте его.

getSelectedObjects

@BeanProperty(bound=false) public Object[] getSelectedObjects()
Возвращает массив, содержащий выбранный элемент. Этот метод реализован для совместимости с ItemSelectable.
Specified by:
getSelectedObjects в интерфейсе ItemSelectable
Returns:
массив Objects, содержащий один элемент — выбранный элемент

actionPerformed

public void actionPerformed(ActionEvent e)
Этот метод является публичным как побочный эффект реализации. Не вызывайте и не переопределяйте его.
Specified by:
actionPerformed в интерфейсе ActionListener
Parameters:
e - обрабатываемое событие

contentsChanged

public void contentsChanged(ListDataEvent e)
Этот метод является публичным как побочный эффект реализации. Не вызывайте и не переопределяйте его.
Specified by:
contentsChanged в интерфейсе ListDataListener
Parameters:
e - ListDataEvent, инкапсулирующий информацию о событии

intervalAdded

public void intervalAdded(ListDataEvent e)
Этот метод является публичным как побочный эффект реализации. Не вызывайте и не переопределяйте его.
Specified by:
intervalAdded в интерфейсе ListDataListener
Parameters:
e - ListDataEvent, инкапсулирующий информацию о событии

intervalRemoved

public void intervalRemoved(ListDataEvent e)
Этот метод является публичным как побочный эффект реализации. Не вызывайте и не переопределяйте его.
Specified by:
intervalRemoved в интерфейсе ListDataListener
Parameters:
e - ListDataEvent, инкапсулирующий информацию о событии

selectWithKeyChar

public boolean selectWithKeyChar(char keyChar)
Выбирает элемент списка, соответствующий указанному символу клавиатуры, и возвращает true, если элемент, соответствующий этому символу, существует. В противном случае возвращает false.
Parameters:
keyChar - символ типа char, обычно клавиша на клавиатуре, введенная пользователем
Returns:
true, если существует элемент, соответствующий этому символу. В противном случае возвращает false.

setEnabled

@BeanProperty(preferred=true, description="The enabled state of the component.") public void setEnabled(boolean b)
Включает раскрывающийся список, позволяя выбирать элементы. Если раскрывающийся список отключен, элементы выбирать нельзя, а значения нельзя вводить в его поле (если оно редактируемое).
Overrides:
setEnabled в классе JComponent
Parameters:
b - логическое значение: true включает компонент, а false отключает его
See Also:
  • Component.isEnabled()
  • Component.isLightweight()

configureEditor

public void configureEditor(ComboBoxEditor anEditor, Object anItem)
Инициализирует редактор указанным элементом.
Parameters:
anEditor - ComboBoxEditor, который отображает элемент списка в поле раскрывающегося списка и позволяет его редактировать
anItem - объект для отображения и редактирования в поле

processKeyEvent

public void processKeyEvent(KeyEvent e)
Обрабатывает события KeyEvent, выполняя поиск клавиши Tab. Если клавиша Tab обнаружена, всплывающее окно закрывается.
Overrides:
processKeyEvent в классе JComponent
Parameters:
e - KeyEvent, содержащий нажатую клавишу клавиатуры
See Also:
  • KeyEvent
  • KeyListener
  • KeyboardFocusManager
  • DefaultKeyboardFocusManager
  • Component.processEvent(AWTEvent)
  • Component.dispatchEvent(AWTEvent)
  • Component.addKeyListener(KeyListener)
  • Component.enableEvents(long)
  • Component.isShowing()

setKeySelectionManager

@BeanProperty(bound=false, expert=true, description="The objects that changes the selection when a key is pressed.") public void setKeySelectionManager(JComboBox.KeySelectionManager aManager)
Устанавливает объект, который преобразует символ клавиатуры в выбор элемента списка. Как правило, выбранным становится первый элемент с совпадающим первым символом.
Parameters:
aManager - менеджер выбора по клавише

getKeySelectionManager

public JComboBox.KeySelectionManager getKeySelectionManager()
Возвращает менеджер выбора по клавише для списка.
Returns:
используемый в данный момент KeySelectionManager

getItemCount

@BeanProperty(bound=false) public int getItemCount()
Возвращает количество элементов в списке.
Returns:
целое число, равное количеству элементов в списке

getItemAt

public E getItemAt(int index)
Возвращает элемент списка по указанному индексу. Если index находится вне диапазона (меньше нуля или больше либо равен размеру списка), возвращается null.
Parameters:
index - целое число, указывающее позицию в списке, где первый элемент имеет индекс ноль
Returns:
элемент в указанной позиции списка или null, если индекс вне диапазона

createDefaultKeySelectionManager

protected JComboBox.KeySelectionManager createDefaultKeySelectionManager()
Возвращает экземпляр стандартного менеджера выбора по клавише.
Returns:
KeySelectionManager, используемый в данный момент списком
See Also:
  • setKeySelectionManager(JComboBox.KeySelectionManager)

paramString

protected String paramString()
Возвращает строковое представление этого JComboBox. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться в зависимости от реализации. Возвращаемая строка может быть пустой, но не может быть null.
Overrides:
paramString в классе JComponent
Returns:
строковое представление этого JComboBox

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JComboBox. Для раскрывающихся списков AccessibleContext имеет форму AccessibleJComboBox. При необходимости создается новый экземпляр AccessibleJComboBox.
Specified by:
getAccessibleContext в интерфейсе Accessible
Overrides:
getAccessibleContext в классе Component
Returns:
AccessibleJComboBox, который выступает в качестве AccessibleContext этого JComboBox

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по 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