Spec-Zone .ru
спецификации, руководства, описания, API
|
E
- тип элементов этого поля комбинированного спискаpublic class JComboBox<E> extends JComponent implements ItemSelectable, ListDataListener, ActionListener, Accessible
Предупреждение: Swing не ориентирован на многопотоковое исполнение. Для получения дополнительной информации см., что Swing Распараллеливает Политику.
Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего JavaBeansTM была добавлена к java.beans
пакет. Пожалуйста, см. XMLEncoder
.
См.
ComboBoxModel
, DefaultComboBoxModel
Модификатор и Тип | Класс и Описание |
---|---|
protected class |
JComboBox. AccessibleJComboBox
Этот class реализует поддержку доступности
JComboBox class. |
static interface |
JComboBox. KeySelectionManager
Интерфейс, который определяет a
KeySelectionManager . |
JComponent. AccessibleJComponent
Контейнер. AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Модификатор и Тип | Поле и Описание |
---|---|
protected String |
actionCommand
Это защищенное поле является определенной реализацией.
|
protected ComboBoxModel<E> |
модель данных
Это защищенное поле является определенной реализацией.
|
protected ComboBoxEditor |
редактор
Это защищенное поле является определенной реализацией.
|
protected boolean |
isEditable
Это защищенное поле является определенной реализацией.
|
protected JComboBox.KeySelectionManager |
keySelectionManager
Это защищенное поле является определенной реализацией.
|
protected boolean |
lightWeightPopupEnabled
Это защищенное поле является определенной реализацией.
|
protected int |
maximumRowCount
Это защищенное поле является определенной реализацией.
|
protected ListCellRenderer<? super E> |
средство рендеринга
Это защищенное поле является определенной реализацией.
|
protected Object |
selectedItemReminder
Это защищенное поле является определенной реализацией.
|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Конструктор и Описание |
---|
JComboBox()
Создает a
JComboBox с моделью данных значения по умолчанию. |
JComboBox(ComboBoxModel<E> aModel)
Создает a
JComboBox это берет его элементы от существующего ComboBoxModel . |
JComboBox(E[] items)
Создает a
JComboBox это содержит элементы в указанном массиве. |
JComboBox(Vector<E> items)
Создает a
JComboBox это содержит элементы в указанном Векторе. |
Модификатор и Тип | Метод и Описание |
---|---|
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)
Добавляет a
PopupMenu слушатель, который будет слушать уведомления от раскрывающейся части поля комбинированного списка. |
void |
configureEditor(ComboBoxEditor anEditor, Object anItem)
Инициализирует редактора с указанным элементом.
|
protected void |
configurePropertiesFromAction(Action a)
Устанавливает свойства на этом поле комбинированного списка, чтобы соответствовать тем в указанном
Action . |
void |
contentsChanged(ListDataEvent e)
Этот метод общедоступен как побочный эффект реализации.
|
protected PropertyChangeListener |
createActionPropertyChangeListener(Action a)
Создает и возвращает a
PropertyChangeListener это ответственно за прислушивание к изменениям от указанного Action и обновление соответствующих свойств. |
protected JComboBox.KeySelectionManager |
createDefaultKeySelectionManager()
Возвращает экземпляр менеджера по ключевому выбору значения по умолчанию.
|
protected void |
fireActionEvent()
Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
|
protected void |
fireItemStateChanged(ItemEvent e)
Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
|
void |
firePopupMenuCanceled()
Уведомляет
PopupMenuListener s, что раскрывающаяся часть поля комбинированного списка была отменена. |
void |
firePopupMenuWillBecomeInvisible()
Уведомляет
PopupMenuListener s, что раскрывающаяся часть поля комбинированного списка стала невидимой. |
void |
firePopupMenuWillBecomeVisible()
Уведомляет
PopupMenuListener s, что раскрывающаяся часть поля комбинированного списка станет видимой. |
AccessibleContext |
getAccessibleContext()
Связали AccessibleContext с этим JComboBox.
|
Действие |
getAction()
Возвращается в настоящий момент набор
Action для этого ActionEvent источник, или null если нет Action устанавливается. |
Строка |
getActionCommand()
Возвращает команду действия, которая включается в конечном счете отправленная слушателям действия.
|
ActionListener[] |
getActionListeners()
Возвращает массив весь
ActionListener s добавленный к этому JComboBox с addActionListener (). |
ComboBoxEditor |
getEditor()
Возвращает редактора, используемого, чтобы нарисовать и отредактировать выбранный пункт в
JComboBox поле. |
E |
getItemAt(int index)
Возвращается элемент списка в указанном индексируют.
|
int |
getItemCount()
Возвращает число элементов в списке.
|
ItemListener[] |
getItemListeners()
Возвращает массив весь
ItemListener s добавленный к этому JComboBox с addItemListener (). |
JComboBox. KeySelectionManager |
getKeySelectionManager()
Возвращает менеджера по ключевому выбору списка.
|
int |
getMaximumRowCount()
Возвращает максимальное количество элементов, которые поле комбинированного списка может вывести на экран без полосы прокрутки
|
ComboBoxModel<E> |
getModel()
Возвращает модель данных, в настоящий момент используемую
JComboBox . |
PopupMenuListener[] |
getPopupMenuListeners()
Возвращает массив весь
PopupMenuListener s добавленный к этому JComboBox с addPopupMenuListener (). |
E |
getPrototypeDisplayValue()
Возвращает "формирующий прототип дисплей" значение - Объект, используемый для вычисления дисплея height и width.
|
ListCellRenderer<? super E> |
getRenderer()
Возвращает средство рендеринга, используемое, чтобы вывести на экран выбранный пункт в
JComboBox поле. |
int |
getSelectedIndex()
Возвращает первый элемент в списке, который соответствует данный элемент.
|
Объект |
getSelectedItem()
Возвращает текущий выбранный пункт.
|
Объект[] |
getSelectedObjects()
Возвращает массив, содержащий выбранный пункт.
|
ComboBoxUI |
getUI()
Возвращается L&F объект, который представляет этот компонент.
|
Строка |
getUIClassID()
Возвращает имя L&F class, который представляет этот компонент.
|
void |
hidePopup()
Заставляет поле комбинированного списка закрывать свое всплывающее окно.
|
void |
insertItemAt(E item, int index)
Вставляет элемент в список элемента в данном, индексируют.
|
protected void |
installAncestorListener() |
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 s, ища клавишу 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)
Удаляет a
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 такой как a Panel или a Window . |
void |
setMaximumRowCount(int count)
Устанавливает максимальное количество строк
JComboBox дисплеи. |
void |
setModel(ComboBoxModel<E> aModel)
Устанавливает модель данных что
JComboBox использование, чтобы получить список элементов. |
void |
setPopupVisible(boolean v)
Устанавливает видимость раскрывающегося.
|
void |
setPrototypeDisplayValue(E prototypeDisplayValue)
Устанавливает прототипное значение дисплея, используемое, чтобы вычислить размер дисплея для части UI.
|
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 к значению от текущего стили.
|
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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
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
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, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
protected ComboBoxModel<E> dataModel
getModel()
, setModel(javax.swing.ComboBoxModel<E>)
protected ListCellRenderer<? super E> renderer
protected ComboBoxEditor editor
getEditor()
, setEditor(javax.swing.ComboBoxEditor)
protected int maximumRowCount
getMaximumRowCount()
, setMaximumRowCount(int)
protected boolean isEditable
isEditable
, setEditable(boolean)
protected JComboBox.KeySelectionManager keySelectionManager
protected String actionCommand
setActionCommand(java.lang.String)
, getActionCommand()
protected boolean lightWeightPopupEnabled
protected Object selectedItemReminder
public JComboBox(ComboBoxModel<E> aModel)
JComboBox
это берет его элементы от существующего ComboBoxModel
. Начиная с ComboBoxModel
обеспечивается, поле комбинированного списка создало использование этого конструктора, не создает модель поля комбинированного списка значения по умолчанию и может воздействовать, как вставка, удалите и добавьте, что методы ведут себя.aModel
- ComboBoxModel
это обеспечивает выведенный на экран список элементовDefaultComboBoxModel
public JComboBox(E[] items)
JComboBox
это содержит элементы в указанном массиве. По умолчанию первый элемент в массиве (и поэтому модель данных) становится выбранным.items
- массив объектов вставить в поле комбинированного спискаDefaultComboBoxModel
public JComboBox(Vector<E> items)
JComboBox
это содержит элементы в указанном Векторе. По умолчанию первый элемент в векторе (и поэтому модель данных) становится выбранным.items
- массив векторов, чтобы вставить в поле комбинированного спискаDefaultComboBoxModel
public JComboBox()
JComboBox
с моделью данных значения по умолчанию. Модель данных значения по умолчанию является пустым списком объектов. Использовать addItem
добавить элементы. По умолчанию первый элемент в модели данных становится выбранным.DefaultComboBoxModel
protected void installAncestorListener()
public void setUI(ComboBoxUI ui)
ui
- ComboBoxUI
L&F объектUIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
updateUI
в class JComponent
JComponent.updateUI()
public String getUIClassID()
getUIClassID
в class JComponent
JComponent.getUIClassID()
, UIDefaults.getUI(javax.swing.JComponent)
public ComboBoxUI getUI()
public void setModel(ComboBoxModel<E> aModel)
JComboBox
использование, чтобы получить список элементов.aModel
- ComboBoxModel
это обеспечивает выведенный на экран список элементовpublic ComboBoxModel<E> getModel()
JComboBox
.ComboBoxModel
это обеспечивает выведенный на экран список элементовpublic void setLightWeightPopupEnabled(boolean aFlag)
lightWeightPopupEnabled
свойство, которое обеспечивает подсказку относительно действительно ли легкий вес Component
должен использоваться, чтобы содержать JComboBox
, против тяжеловеса Component
такой как a Panel
или a Window
. Решение легкого веса против тяжеловеса в конечном счете до JComboBox
. Легкие окна более эффективны, чем тяжелые окна, но легкие и тяжелые компоненты не смешиваются хорошо в GUI. Если Ваш легкий вес смесей прикладных программ и тяжелые компоненты, следует отключить легкий вес, раскрывается. Значение по умолчанию для lightWeightPopupEnabled
свойство true
, если иначе не определено стилем. Некоторый взгляд и чувства всегда используют тяжеловеса, раскрывается, независимо от того что значение этого свойства. См., что статья
aFlag
- если true
, легкий вес раскрывается, требуютсяpublic boolean isLightWeightPopupEnabled()
lightWeightPopupEnabled
свойство.lightWeightPopupEnabled
свойствоsetLightWeightPopupEnabled(boolean)
public void setEditable(boolean aFlag)
JComboBox
поле доступно для редактирования. Доступное для редактирования JComboBox
позволяет пользователю вводить в поле или выбрал элемент из списка, чтобы инициализировать поле, после которого это может быть отредактировано. (Редактирование влияет только на поле, элемент списка остается неповрежденным.) Не доступный для редактирования JComboBox
выводит на экран выбранный пункт в поле, но выбор не может быть изменен.aFlag
- булево значение, где истина указывает, что поле доступно для редактированияpublic boolean isEditable()
JComboBox
доступно для редактирования. По умолчанию поле комбинированного списка не доступно для редактирования.JComboBox
доступно для редактирования, еще ложенpublic void setMaximumRowCount(int count)
JComboBox
дисплеи. Если число объектов в модели больше чем количество, поле комбинированного списка использует полосу прокрутки.count
- целое число, определяющее максимальное количество элементов, чтобы вывести на экран в списке перед использованием полосы прокруткиpublic int getMaximumRowCount()
public void setRenderer(ListCellRenderer<? super E> aRenderer)
Средство рендеринга значения по умолчанию выводит на экран строку или значок. Другие средства рендеринга могут обработать графические изображения и составить элементы.
Вывести на экран выбранный пункт, aRenderer.getListCellRendererComponent
вызывается, передавая объект списка и индексирование-1.
aRenderer
- ListCellRenderer
это выводит на экран выбранный пунктsetEditor(javax.swing.ComboBoxEditor)
public ListCellRenderer<? super E> getRenderer()
JComboBox
поле.ListCellRenderer
это выводит на экран выбранный пункт.public void setEditor(ComboBoxEditor anEditor)
JComboBox
поле. Редактор используется только если получение JComboBox
доступно для редактирования. Если не доступный для редактирования, поле комбинированного списка использует средство рендеринга, чтобы нарисовать выбранный пункт.anEditor
- ComboBoxEditor
это выводит на экран выбранный пунктsetRenderer(javax.swing.ListCellRenderer<? super E>)
public ComboBoxEditor getEditor()
JComboBox
поле.ComboBoxEditor
это выводит на экран выбранный пунктpublic void setSelectedItem(Object anObject)
anObject
находится в списке, шоу области дисплея anObject
выбранный. Если anObject
не находится в списке, и поле комбинированного списка недоступно для редактирования, это не будет изменять текущий выбор. Для доступных для редактирования полей комбинированного списка выбор изменится на anObject
.
Если это составляет изменение в выбранном пункте, ItemListener
s добавленный к полю комбинированного списка будет уведомлен с один или два ItemEvent
s. Если есть текущий выбранный пункт, ItemEvent
будет запущен и изменение состояния будет ItemEvent.DESELECTED
. Если anObject
находится в списке и в настоящий момент не выбирается тогда ItemEvent
будет запущен и изменение состояния будет ItemEvent.SELECTED
.
ActionListener
s добавленный к полю комбинированного списка будет уведомлен с ActionEvent
когда этот метод вызывают.
anObject
- объект списка выбрать; использовать null
очистить выборpublic Object getSelectedItem()
Если поле комбинированного списка доступно для редактирования, то это значение не могло быть добавлено к полю комбинированного списка с addItem
, insertItemAt
или конструкторы данных.
setSelectedItem(java.lang.Object)
public void setSelectedIndex(int anIndex)
anIndex
.anIndex
- целое число, определяющее элемент списка, чтобы выбрать, где 0 определяет первый элемент в списке и-1, не указывает ни на какой выборIllegalArgumentException
- если anIndex
< -1 or
anIndex
больше чем или равен размеруpublic int getSelectedIndex()
JComboBox
позволяет выбранные пункты, которые не находятся в списке. Возвраты-1, если нет никакого выбранного пункта или если пользователь, определенный элемент, который не находится в списке.public E getPrototypeDisplayValue()
prototypeDisplayValue
свойствоsetPrototypeDisplayValue(E)
public void setPrototypeDisplayValue(E prototypeDisplayValue)
Если прототипное значение дисплея определяется, привилегированный размер поля комбинированного списка вычисляется, конфигурируя средство рендеринга с прототипным значением дисплея и получая его привилегированный размер. Определение привилегированного значения дисплея часто полезно, когда поле комбинированного списка будет выводить на экран большие объемы данных. Если никакое прототипное значение дисплея не было определено, средство рендеринга должно быть сконфигурировано для каждого значения от модели и ее привилегированного полученного размера, который может быть относительно дорогим.
prototypeDisplayValue
- getPrototypeDisplayValue()
public void addItem(E item)
JComboBox
использует изменчивую модель данных. Предупреждение: Фокус и проблемы перемещения с помощью клавиатуры могут возникнуть, если Вы добавляете двойные Строковые объекты. Обходное решение должно добавить новые объекты вместо Строковых объектов и удостовериться, что 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
public void insertItemAt(E item, int index)
JComboBox
использует изменчивую модель данных.item
- элемент, чтобы добавить к спискуindex
- целое число, определяющее позицию, в которой можно добавить элементMutableComboBoxModel
public void removeItem(Object anObject)
JComboBox
использует изменчивую модель данных.anObject
- объект удалить из списка элементаMutableComboBoxModel
public void removeItemAt(int anIndex)
anIndex
Этот метод работает только если JComboBox
использует изменчивую модель данных.anIndex
- интервал, определяющий индексирование элемента, чтобы удалить, где 0 указывает на первый элемент в спискеMutableComboBoxModel
public void removeAllItems()
public void showPopup()
setPopupVisible(boolean)
public void hidePopup()
setPopupVisible(boolean)
public void setPopupVisible(boolean v)
public boolean isPopupVisible()
public void addItemListener(ItemListener aListener)
ItemListener
.
aListener
получит один или два ItemEvent
s, когда выбранный пункт изменяется.
addItemListener
в интерфейсе ItemSelectable
aListener
- ItemListener
это должно быть уведомленоsetSelectedItem(java.lang.Object)
public void removeItemListener(ItemListener aListener)
ItemListener
.removeItemListener
в интерфейсе ItemSelectable
aListener
- ItemListener
удалитьItemEvent
public ItemListener[] getItemListeners()
ItemListener
s добавленный к этому JComboBox с addItemListener ().ItemListener
s добавленный или пустой массив, если никакие слушатели не были добавленыpublic void addActionListener(ActionListener l)
ActionListener
. ActionListener
получит ActionEvent
когда выбор был сделан. Если поле комбинированного списка доступно для редактирования, то ActionEvent
будет запущен, когда редактирование остановилось.
l
- ActionListener
это должно быть уведомленоsetSelectedItem(java.lang.Object)
public void removeActionListener(ActionListener l)
ActionListener
.l
- ActionListener
удалитьpublic ActionListener[] getActionListeners()
ActionListener
s добавленный к этому JComboBox с addActionListener ().ActionListener
s добавленный или пустой массив, если никакие слушатели не были добавленыpublic void addPopupMenuListener(PopupMenuListener l)
PopupMenu
слушатель, который будет слушать уведомления от раскрывающейся части поля комбинированного списка. Для всего стандартного взгляда и чувств, поставленных с Java, раскрывающаяся часть списка поля комбинированного списка реализуется как a JPopupMenu
. Пользовательский стиль, возможно, не реализует это этот путь и не будет поэтому получать уведомление.
l
- PopupMenuListener
добавитьpublic void removePopupMenuListener(PopupMenuListener l)
PopupMenuListener
.l
- PopupMenuListener
удалитьaddPopupMenuListener(javax.swing.event.PopupMenuListener)
public PopupMenuListener[] getPopupMenuListeners()
PopupMenuListener
s добавленный к этому JComboBox с addPopupMenuListener ().PopupMenuListener
s добавленный или пустой массив, если никакие слушатели не были добавленыpublic void firePopupMenuWillBecomeVisible()
PopupMenuListener
s, что раскрывающаяся часть поля комбинированного списка станет видимой. Этот метод общедоступен, но не должен быть вызван ничем кроме делегата UI.
addPopupMenuListener(javax.swing.event.PopupMenuListener)
public void firePopupMenuWillBecomeInvisible()
PopupMenuListener
s, что раскрывающаяся часть поля комбинированного списка стала невидимой. Этот метод общедоступен, но не должен быть вызван ничем кроме делегата UI.
addPopupMenuListener(javax.swing.event.PopupMenuListener)
public void firePopupMenuCanceled()
PopupMenuListener
s, что раскрывающаяся часть поля комбинированного списка была отменена. Этот метод общедоступен, но не должен быть вызван ничем кроме делегата UI.
addPopupMenuListener(javax.swing.event.PopupMenuListener)
public void setActionCommand(String aCommand)
aCommand
- строка, содержащая "команду", которая отправляется слушателям действия; тот же самый слушатель может тогда сделать разные вещи в зависимости от команды, которую это получаетpublic String getActionCommand()
public void setAction(Action a)
Action
для ActionEvent
источник. Новое Action
замены любой ранее набор Action
но не влияет ActionListeners
независимо добавленный с addActionListener
. Если Action
уже зарегистрированный ActionListener
для ActionEvent
источник, это не повторно регистрируется. Установка Action
результаты в непосредственном изменении всех свойств описываются в Компонентной Поддержке Swing Action
. Впоследствии, свойства поля комбинированного списка автоматически обновляются как Action
's изменение свойств.
Этот метод использует три других метода, чтобы установить и помочь отследить Action
's значения свойств. Это использует configurePropertiesFromAction
метод, чтобы сразу изменить свойства поля комбинированного списка. Отслеживать изменения в Action
's значения свойств, этот метод регистрируется PropertyChangeListener
возвращенный createActionPropertyChangeListener
. Значение по умолчанию PropertyChangeListener
вызывает actionPropertyChanged
метод, когда свойство в Action
изменения.
a
- Action
для JComboBox
, или null
.Action
, getAction()
, configurePropertiesFromAction(javax.swing.Action)
, createActionPropertyChangeListener(javax.swing.Action)
, actionPropertyChanged(javax.swing.Action, java.lang.String)
public Action getAction()
Action
для этого ActionEvent
источник, или null
если нет Action
устанавливается.Action
для этого ActionEvent
источник; или null
Action
, setAction(javax.swing.Action)
protected void configurePropertiesFromAction(Action a)
Action
. Обратитесь к Компонентной Поддержке Swing Action
для большего количества деталей, относительно которых свойств это устанавливает.a
- Action
от которого можно получить свойства, или null
Action
, setAction(javax.swing.Action)
protected PropertyChangeListener createActionPropertyChangeListener(Action a)
PropertyChangeListener
это ответственно за прислушивание к изменениям от указанного Action
и обновление соответствующих свойств.
Предупреждение: Если Вы разделяете на подклассы, это не создает анонимный внутренний class. Если Вы сделаете то время жизни поля комбинированного списка будет связано к тому из Action
.
a
- действие поля комбинированного спискаAction
, setAction(javax.swing.Action)
protected void actionPropertyChanged(Action action, String propertyName)
PropertyChangeListener
возвращенный из createActionPropertyChangeListener
. Подклассы не должны обычно вызывать это. Подклассы, которые поддерживают дополнительный Action
свойства должны переопределить это и configurePropertiesFromAction
. Обратитесь к таблице в Компонентной Поддержке Swing Action
для списка свойств этот метод наборы.
action
- Action
связанный с этим полем комбинированного спискаpropertyName
- имя свойства, которое изменилосьAction
, configurePropertiesFromAction(javax.swing.Action)
protected void fireItemStateChanged(ItemEvent e)
e
- мероприятиеEventListenerList
protected void fireActionEvent()
EventListenerList
protected void selectedItemChanged()
public Object[] getSelectedObjects()
ItemSelectable
.getSelectedObjects
в интерфейсе ItemSelectable
Objects
содержа один элемент - выбранный пунктpublic void actionPerformed(ActionEvent e)
actionPerformed
в интерфейсе ActionListener
public void contentsChanged(ListDataEvent e)
contentsChanged
в интерфейсе ListDataListener
e
- a ListDataEvent
инкапсуляция информации о событииpublic void intervalAdded(ListDataEvent e)
intervalAdded
в интерфейсе ListDataListener
e
- a ListDataEvent
инкапсуляция информации о событииpublic void intervalRemoved(ListDataEvent e)
intervalRemoved
в интерфейсе ListDataListener
e
- a ListDataEvent
инкапсуляция информации о событииpublic boolean selectWithKeyChar(char keyChar)
keyChar
- случайная работа, обычно это - клавиша на клавиатуре, введенная пользователемpublic void setEnabled(boolean b)
setEnabled
в class JComponent
b
- булево значение, где истина включает компоненту и лжи, отключает этоComponent.isEnabled()
, Component.isLightweight()
public void configureEditor(ComboBoxEditor anEditor, Object anItem)
anEditor
- ComboBoxEditor
это выводит на экран элемент списка в поле поля комбинированного списка и позволяет этому быть отредактированнымanItem
- объект вывести на экран и отредактировать в полеpublic void processKeyEvent(KeyEvent e)
KeyEvent
s, ища клавишу Tab. Если клавиша Tab находится, всплывающее окно закрывается.processKeyEvent
в class JComponent
e
- KeyEvent
содержа клавишу на клавиатуре, которая была нажатаKeyEvent
, KeyListener
, KeyboardFocusManager
, DefaultKeyboardFocusManager
, Component.processEvent(java.awt.AWTEvent)
, Component.dispatchEvent(java.awt.AWTEvent)
, Component.addKeyListener(java.awt.event.KeyListener)
, Component.enableEvents(long)
, Component.isShowing()
public void setKeySelectionManager(JComboBox.KeySelectionManager aManager)
public JComboBox.KeySelectionManager getKeySelectionManager()
KeySelectionManager
использующийся в настоящее времяpublic int getItemCount()
public E getItemAt(int index)
index
испытывает недостаток диапазона (меньше чем нуль или больше чем или равный размеру), это возвратится null
.index
- целое число, указывающее на позицию списка, где первый элемент запускается в нулеnull
если из диапазонаprotected JComboBox.KeySelectionManager createDefaultKeySelectionManager()
KeySelectionManager
в настоящий момент используемый спискомsetKeySelectionManager(javax.swing.JComboBox.KeySelectionManager)
protected String paramString()
JComboBox
. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенной строки могут измениться между реализациями. Возвращенная строка может быть пустой, но, возможно, не null
.paramString
в class JComponent
JComboBox
public AccessibleContext getAccessibleContext()
getAccessibleContext
в интерфейсе Accessible
getAccessibleContext
в class Component
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92