モジュール java.desktop

パッケージ javax.swing

クラスJComboBox<E>

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JComboBox<E>

型パラメータ:

E - このコンボボックスの要素の型

すべての実装されたインタフェース:

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's Threading Policy」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beansパッケージに追加されました。 XMLEncoderを参照してください。

詳細は、「The Java Tutorial」の「How to Use Combo Boxes」を参照してください。

導入されたバージョン:

1.2

関連項目:

• ComboBoxModel
• DefaultComboBoxModel

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
protected class	JComboBox.AccessibleJComboBox	このクラスはJComboBoxクラスのアクセシビリティ・サポートを実装しています。
static interface	JComboBox.KeySelectionManager	KeySelectionManagerを定義するインタフェースです。

クラスjavax.swing.JComponentで宣言されたネストされたクラス/インタフェース

JComponent.AccessibleJComponent

クラスjava.awt.Containerで宣言されたネストされたクラス/インタフェース

Container.AccessibleAWTContainer

クラスjava.awt.Componentで宣言されたネストされたクラス/インタフェース

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

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected String	actionCommand	このprotectedフィールドは実装固有のものです。
protected ComboBoxModel<E>	dataModel	このprotectedフィールドは実装固有のものです。
protected ComboBoxEditor	editor	このprotectedフィールドは実装固有のものです。
protected boolean	isEditable	このprotectedフィールドは実装固有のものです。
protected JComboBox.KeySelectionManager	keySelectionManager	このprotectedフィールドは実装固有のものです。
protected boolean	lightWeightPopupEnabled	このprotectedフィールドは実装固有のものです。
protected int	maximumRowCount	このprotectedフィールドは実装固有のものです。
protected ListCellRenderer<? super E>	renderer	このprotectedフィールドは実装固有のものです。
protected Object	selectedItemReminder	このprotectedフィールドは実装固有のものです。

クラスjavax.swing.JComponentで宣言されたフィールド

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

クラスjava.awt.Componentで宣言されたフィールド

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェースjava.awt.image.ImageObserverで宣言されているフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
JComboBox()	デフォルトのデータ・モデルでJComboBoxを生成します。
JComboBox(E[] items)	指定された配列に要素を格納するJComboBoxを生成します。
JComboBox(Vector<E> items)	指定されたVectorに要素を格納するJComboBoxを生成します。
JComboBox(ComboBoxModel<E> aModel)	項目を既存のComboBoxModelから取得するJComboBoxを生成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	actionPerformed(ActionEvent e)	このメソッドは実装の副作用としてpublicです。
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)	このメソッドは実装の副作用としてpublicです。
protected PropertyChangeListener	createActionPropertyChangeListener(Action a)	指定されたActionからの変更を待機し、適切なプロパティを更新する役割を担うPropertyChangeListenerを作成して、返します。
protected JComboBox.KeySelectionManager	createDefaultKeySelectionManager()	デフォルトのキー選択マネージャのインスタンスを返します。
protected void	fireActionEvent()	このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。
protected void	fireItemStateChanged(ItemEvent e)	このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。
void	firePopupMenuCanceled()	コンボボックスのポップアップ部分が取り消されたことをPopupMenuListenerに通知します。
void	firePopupMenuWillBecomeInvisible()	コンボボックスのポップアップ部分が不可視状態になったことをPopupMenuListenerに通知します。
void	firePopupMenuWillBecomeVisible()	コンボボックスのポップアップ部分が可視状態になったことをPopupMenuListenerに通知します。
AccessibleContext	getAccessibleContext()	このJComboBoxに関連付けられたAccessibleContextを取得します。
Action	getAction()	このActionEventソースに現在設定されているActionを返します。Actionが設定されていない場合は、nullを返します。
String	getActionCommand()	アクション・リスナーに送られるイベントに含まれているアクション・コマンドを返します。
ActionListener[]	getActionListeners()	addActionListener()を使用してこのJComboBoxに追加されたすべてのActionListenerの配列を返します。
ComboBoxEditor	getEditor()	選択された項目をJComboBoxフィールドでペイントおよび編集するために使用するエディタを返します。
E	getItemAt(int index)	指定されたインデックスのリスト項目を返します。
int	getItemCount()	リスト内の項目の数を返します。
ItemListener[]	getItemListeners()	addItemListener()でこのJComboBoxに追加される、すべてのItemListenerの配列を返します。
JComboBox.KeySelectionManager	getKeySelectionManager()	リストのキー選択マネージャを返します。
int	getMaximumRowCount()	コンボボックスがスクロール・バーを使用しないで表示できる最大の項目数を返します。
ComboBoxModel<E>	getModel()	JComboBoxによって現在使用されているデータ・モデルを返します。
PopupMenuListener[]	getPopupMenuListeners()	addPopupMenuListener()でこのJComboBoxに追加される、すべてのPopupMenuListenerの配列を返します。
E	getPrototypeDisplayValue()	表示高さと表示幅の計算に使用されるオブジェクトである「表示プロトタイプ」値を返します。
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)	このメソッドは実装の副作用としてpublicです。
void	intervalRemoved(ListDataEvent e)	このメソッドは実装の副作用としてpublicです。
boolean	isEditable()	JComboBoxが編集可能な場合はtrueを返します。
boolean	isLightWeightPopupEnabled()	lightWeightPopupEnabledプロパティの値を取得します。
boolean	isPopupVisible()	ポップアップの可視性を判定します。
protected String	paramString()	このJComboBoxの文字列表現を返します。
void	processKeyEvent(KeyEvent e)	Tabキーを探しながら、KeyEventを処理します。
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()	このprotectedメソッドは実装固有のものです。
boolean	selectWithKeyChar(char keyChar)	指定されたキーボードの文字に対応するリスト項目を選択し、その文字に対応する項目がある場合にtrueを返します。
void	setAction(Action a)	このActionEventソースのActionを設定します。
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プロパティを設定します。このプロパティは、JComboBoxの格納先として軽量Componentを使用するか、それともPanelやWindowなどの重量Componentを使用するかどうかについてのヒントを提供します。
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プロパティをリセットします。

クラスjavax.swing.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

クラスjava.awt.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

クラスjava.awt.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

クラスjava.lang.Objectで宣言されたメソッド

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

フィールド詳細

dataModel

protected ComboBoxModel<E> dataModel

このprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。

関連項目:

• getModel()
• setModel(javax.swing.ComboBoxModel<E>)

renderer

protected ListCellRenderer<? super E> renderer

このprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。

関連項目:

• getRenderer()
• setRenderer(javax.swing.ListCellRenderer<? super E>)

editor

protected ComboBoxEditor editor

このprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。

関連項目:

• getEditor()
• setEditor(javax.swing.ComboBoxEditor)

maximumRowCount

protected int maximumRowCount

このprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。

関連項目:

• getMaximumRowCount()
• setMaximumRowCount(int)

isEditable

protected boolean isEditable

このprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。

関連項目:

• isEditable()
• setEditable(boolean)

keySelectionManager

protected JComboBox.KeySelectionManager keySelectionManager

このprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。

関連項目:

• setKeySelectionManager(javax.swing.JComboBox.KeySelectionManager)
• getKeySelectionManager()

actionCommand

protected String actionCommand

このprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。

関連項目:

• setActionCommand(java.lang.String)
• getActionCommand()

lightWeightPopupEnabled

protected boolean lightWeightPopupEnabled

このprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。

関連項目:

• setLightWeightPopupEnabled(boolean)
• isLightWeightPopupEnabled()

selectedItemReminder

protected Object selectedItemReminder

このprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。

コンストラクタの詳細

JComboBox

public JComboBox(ComboBoxModel<E> aModel)

項目を既存のComboBoxModelから取得するJComboBoxを生成します。 ComboBoxModelが提供されるため、このコンストラクタを使用して生成されたコンボボックスは、デフォルトのコンボ・ボックス・モデルを生成せず、挿入、削除、および追加の各メソッドの動作方法に強い影響を与えます。

パラメータ:

aModel - 表示された項目のリストを提供するComboBoxModel

関連項目:

• DefaultComboBoxModel

JComboBox

public JComboBox(E[] items)

指定された配列に要素を格納するJComboBoxを生成します。 デフォルトでは、配列の最初の項目と、それに伴うデータ・モデルが選択されます。

パラメータ:

items - コンボボックスに挿入するオブジェクトの配列

関連項目:

• DefaultComboBoxModel

JComboBox

public JComboBox(Vector<E> items)

指定されたVectorに要素を格納するJComboBoxを生成します。 デフォルトでは、ベクターの最初の項目と、それに伴うデータ・モデルが選択されます。

パラメータ:

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 - ComboBoxUI L&Fオブジェクト

関連項目:

• UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

現在のルック・アンド・フィールからの値にUIプロパティをリセットします。

オーバーライド:

updateUI、クラスJComponent

関連項目:

• JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

このコンポーネントをレンダリングするL&Fクラスの名前を返します。

オーバーライド:

getUIClassID、クラスJComponent

戻り値:

文字列「ComboBoxUI」

関連項目:

• JComponent.getUIClassID()
• UIDefaults.getUI(javax.swing.JComponent)

getUI

public ComboBoxUI getUI()

このコンポーネントをレンダリングするL&Fオブジェクトを返します。

オーバーライド:

クラスJComponentのgetUI

戻り値:

このコンポーネントをレンダリングする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プロパティを設定します。このプロパティは、JComboBoxの格納先として軽量Componentを使用するか、それともPanelやWindowなどの重量Componentを使用するかどうかについてのヒントを提供します。 軽量と重量のどちらを使用するかを決定するのは、最終的にはJComboBoxです。 軽量ウィンドウは重量ウィンドウよりも効率的ですが、軽量コンポーネントと重量コンポーネントはGUI内でうまく混在しません。 アプリケーションで軽量コンポーネントと重量コンポーネントが混在している場合は、軽量ポップアップを無効にする必要があります。 lightWeightPopupEnabledプロパティのデフォルト値は、ルック・アンド・フィールで他の値が指定されていなければtrueになります。 一部のルック・アンド・フィールでは、このプロパティの値に関係なく常に重量ポップアップが使用されます。

「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 - boolean値。trueはフィールドが編集可能であることを示す

isEditable

public boolean isEditable()

JComboBoxが編集可能な場合はtrueを返します。 デフォルトでは、コンボボックスは編集不可です。

戻り値:

JComboBoxが編集可能な場合はtrue、そうでない場合は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が編集不可能な場合に使用されます。 編集可能な場合、選択された項目のレンダリングと編集にはエディタが使用されます。

デフォルトのレンダリングでは文字列またはアイコンが表示されます。 ほかのレンダリングは、グラフィック・イメージおよび複合項目を処理できます。

選択された項目を表示するには、リスト・オブジェクトおよびインデックス -1を渡してaRenderer.getListCellRendererComponentを呼び出します。

パラメータ:

aRenderer - 選択された項目を表示するListCellRenderer

関連項目:

• setEditor(javax.swing.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(javax.swing.ListCellRenderer<? super E>)

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に、1つまたは2つのItemEventが通知されます。 現在選択されている項目がある場合、ItemEventがトリガーされ、状態がItemEvent.DESELECTEDに変更されます。 anObjectがリストにあり、現在選択されていない場合は、ItemEventがトリガーされ、状態はItemEvent.SELECTEDに変更されます。

コンボボックスに追加されたActionListenerは、このメソッドが呼び出されるときにActionEventで通知されます。

パラメータ:

anObject - 選択するリスト・オブジェクト。選択をクリアする場合はnullを指定

getSelectedItem

public Object getSelectedItem()

現在選択されている項目を返します。

コンボボックスが編集可能な場合、この値はaddItem、insertItemAt、またはデータ・コンストラクタではコンボボックスに追加されません。

戻り値:

現在選択されているオブジェクト

関連項目:

• setSelectedItem(java.lang.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()

表示高さと表示幅の計算に使用されるオブジェクトである「表示プロトタイプ」値を返します。

戻り値:

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 - 削除する項目のインデックスを指定する整数値。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は選択した項目が変更されると1つまたは2つのItemEventを受信します。

定義:

addItemListener、インタフェースItemSelectable

パラメータ:

aListener - 通知されるItemListener

関連項目:

• setSelectedItem(java.lang.Object)

removeItemListener

public void removeItemListener(ItemListener aListener)

ItemListenerを削除します。

定義:

removeItemListener、インタフェースItemSelectable

パラメータ:

aListener - 削除するItemListener

関連項目:

• ItemEvent

getItemListeners

@BeanProperty(bound=false) public ItemListener[] getItemListeners()

addItemListener()でこのJComboBoxに追加される、すべてのItemListenerの配列を返します。

戻り値:

追加されたすべてのItemListener。リスナーが追加されていない場合は空の配列

導入されたバージョン:

1.4

addActionListener

public void addActionListener(ActionListener l)

ActionListenerを追加します。

ActionListenerは選択が行われたときにActionEventを受信します。 コンボボックスが編集可能な場合は、編集が停止されるとActionEventがトリガーされます。

パラメータ:

l - 通知されるActionListener

関連項目:

• setSelectedItem(java.lang.Object)

removeActionListener

public void removeActionListener(ActionListener l)

ActionListenerを削除します。

パラメータ:

l - 削除するActionListener

getActionListeners

@BeanProperty(bound=false) public ActionListener[] getActionListeners()

addActionListener()を使用してこのJComboBoxに追加されたすべてのActionListenerの配列を返します。

戻り値:

追加されたすべての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(javax.swing.event.PopupMenuListener)

getPopupMenuListeners

@BeanProperty(bound=false) public PopupMenuListener[] getPopupMenuListeners()

addPopupMenuListener()でこのJComboBoxに追加される、すべてのPopupMenuListenerの配列を返します。

戻り値:

追加されたすべてのPopupMenuListener。リスナーが追加されていない場合は空の配列

導入されたバージョン:

1.4

firePopupMenuWillBecomeVisible

public void firePopupMenuWillBecomeVisible()

コンボボックスのポップアップ部分が可視状態になったことをPopupMenuListenerに通知します。

このメソッドはpublicですがUI委譲以外からは呼び出さないでください。

導入されたバージョン:

1.4

関連項目:

• addPopupMenuListener(javax.swing.event.PopupMenuListener)

firePopupMenuWillBecomeInvisible

public void firePopupMenuWillBecomeInvisible()

コンボボックスのポップアップ部分が不可視状態になったことをPopupMenuListenerに通知します。

このメソッドはpublicですがUI委譲以外からは呼び出さないでください。

導入されたバージョン:

1.4

関連項目:

• addPopupMenuListener(javax.swing.event.PopupMenuListener)

firePopupMenuCanceled

public void firePopupMenuCanceled()

コンボボックスのポップアップ部分が取り消されたことをPopupMenuListenerに通知します。

このメソッドはpublicですがUI委譲以外からは呼び出さないでください。

導入されたバージョン:

1.4

関連項目:

• addPopupMenuListener(javax.swing.event.PopupMenuListener)

setActionCommand

public void setActionCommand(String aCommand)

アクション・リスナーに送られるイベントに含まれなければならないアクション・コマンドを設定します。

パラメータ:

aCommand - アクション・リスナーに送られる「コマンド」を含む文字列。受信するコマンドに応じて、同じリスナーが異なる処理を実行できる

getActionCommand

public String getActionCommand()

アクション・リスナーに送られるイベントに含まれているアクション・コマンドを返します。

戻り値:

アクション・リスナーに送られる「コマンド」を含む文字列。

setAction

@BeanProperty(visualUpdate=true, description="the Action instance connected with this ActionEvent source") public void setAction(Action a)

このActionEventソースのActionを設定します。 新しいActionは設定済みのActionと置き換わりますが、ActionListenersで独立して追加されたaddActionListenerには影響しません。 ActionがすでにActionEventソースにすでに登録されているActionListenerである場合は、再登録されません。

Actionを設定すると、「ActionをサポートするSwingコンポーネント」で説明されているすべてのプロパティがすぐに変更されます。 続いて、Actionのプロパティの変更に合わせて、コンボボックスのプロパティが自動的に更新されます。

このメソッドは、Actionのプロパティ値を設定し、追跡するために、ほかの3つのメソッドを使用します。 コンボボックスのプロパティをただちに変更するためには、configurePropertiesFromActionメソッドを使用します。 Actionのプロパティ値の変更を追跡するために、このメソッドはcreateActionPropertyChangeListenerから返されるPropertyChangeListenerを登録します。 デフォルトのPropertyChangeListenerは、Actionのプロパティに変更があると、actionPropertyChangedメソッドを呼び出します。

パラメータ:

a - JComboBoxのAction、またはnull。

導入されたバージョン:

1.3

関連項目:

• Action
• getAction()
• configurePropertiesFromAction(javax.swing.Action)
• createActionPropertyChangeListener(javax.swing.Action)
• actionPropertyChanged(javax.swing.Action, java.lang.String)

getAction

public Action getAction()

このActionEventソースに現在設定されているActionを返します。Actionが設定されていない場合は、nullを返します。

戻り値:

このActionEventソースのAction、またはnull

導入されたバージョン:

1.3

関連項目:

• Action
• setAction(javax.swing.Action)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)

指定されたActionのプロパティに一致するように、このコンボボックスにプロパティを設定します。 これによって設定されるプロパティの詳細は、「ActionをサポートするSwingコンポーネント」を参照してください。

パラメータ:

a - プロパティを取得するAction、またはnull

導入されたバージョン:

1.3

関連項目:

• Action
• setAction(javax.swing.Action)

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)

指定されたActionからの変更を待機し、適切なプロパティを更新する役割を担うPropertyChangeListenerを作成して、返します。

警告: これをサブクラス化する場合、匿名の内部クラスは作成しないでください。 作成すると、コンボボックスの寿命がActionの寿命に拘束されます。

パラメータ:

a - コンボボックスのアクション

戻り値:

the PropertyChangeListener

導入されたバージョン:

1.3

関連項目:

• Action
• setAction(javax.swing.Action)

actionPropertyChanged

protected void actionPropertyChanged(Action action, String propertyName)

関連アクションのプロパティの変更に応じてコンボボックスの状態を更新します。 このメソッドは、createActionPropertyChangeListenerから返されるPropertyChangeListenerから呼び出されます。 サブクラスは、通常、これを呼び出す必要はありません。 追加のActionプロパティをサポートするサブクラスは、これとconfigurePropertiesFromActionをオーバーライドする必要があります。

このメソッドによって設定されるプロパティのリストは、「ActionをサポートするSwingコンポーネント」の表を参照してください。

パラメータ:

action - このコンボボックスに関連付けられたAction

propertyName - 変更されたプロパティの名前

導入されたバージョン:

1.6

関連項目:

• Action
• configurePropertiesFromAction(javax.swing.Action)

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)

このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。

パラメータ:

e - 対象のイベント

関連項目:

• EventListenerList

fireActionEvent

protected void fireActionEvent()

このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。

関連項目:

• EventListenerList

selectedItemChanged

protected void selectedItemChanged()

このprotectedメソッドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。

getSelectedObjects

@BeanProperty(bound=false) public Object[] getSelectedObjects()

選択されている項目を含む配列を返します。 このメソッドは、ItemSelectableとの互換性のために実装されます。

定義:

getSelectedObjects、インタフェースItemSelectable

戻り値:

1つの要素(選択されている項目)を含むObjectsの配列

actionPerformed

public void actionPerformed(ActionEvent e)

このメソッドはpublicになっていますが、これは実装の副作用によるものです。呼び出したり、オーバーライドしたりしないでください。

定義:

actionPerformed、インタフェースActionListener

パラメータ:

e - 処理されるイベント

contentsChanged

public void contentsChanged(ListDataEvent e)

このメソッドはpublicになっていますが、これは実装の副作用によるものです。呼び出したり、オーバーライドしたりしないでください。

定義:

contentsChanged、インタフェースListDataListener

パラメータ:

e - イベント情報をカプセル化するListDataEvent

intervalAdded

public void intervalAdded(ListDataEvent e)

このメソッドはpublicになっていますが、これは実装の副作用によるものです。呼び出したり、オーバーライドしたりしないでください。

定義:

intervalAdded、インタフェースListDataListener

パラメータ:

e - イベント情報をカプセル化するListDataEvent

intervalRemoved

public void intervalRemoved(ListDataEvent e)

このメソッドはpublicになっていますが、これは実装の副作用によるものです。呼び出したり、オーバーライドしたりしないでください。

定義:

intervalRemoved、インタフェースListDataListener

パラメータ:

e - イベント情報をカプセル化するListDataEvent

selectWithKeyChar

public boolean selectWithKeyChar(char keyChar)

指定されたキーボードの文字に対応するリスト項目を選択し、その文字に対応する項目がある場合にtrueを返します。 そうでない場合はfalseが返されます。

パラメータ:

keyChar - 文字。通常はユーザーが押したキーボードのキー

戻り値:

true:その文字に対応するアイテムがある場合。 それ以外の場合はfalseを戻します。

setEnabled

@BeanProperty(preferred=true, description="The enabled state of the component.") public void setEnabled(boolean b)

項目を選択できるようにコンボボックスを有効にします。 コンボボックスが無効の場合は項目を選択できず、値をフィールドに入力できません(編集可能な場合)。

オーバーライド:

setEnabled、クラスJComponent

パラメータ:

b - boolean値。trueの場合はコンポーネントは使用可能で、falseの場合は使用不可

関連項目:

• Component.isEnabled()
• Component.isLightweight()

configureEditor

public void configureEditor(ComboBoxEditor anEditor, Object anItem)

指定された項目でエディタを初期化します。

パラメータ:

anEditor - コンボボックスのフィールドにリスト項目を表示し、その編集を可能にするComboBoxEditor

anItem - フィールドで表示および編集を行うオブジェクト

processKeyEvent

public void processKeyEvent(KeyEvent e)

Tabキーを探しながら、KeyEventを処理します。 Tabキーが見つかると、ポップアップ・ウィンドウが閉じます。

オーバーライド:

processKeyEvent、クラス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()

setKeySelectionManager

@BeanProperty(bound=false, expert=true, description="The objects that changes the selection when a key is pressed.") public void setKeySelectionManager(JComboBox.KeySelectionManager aManager)

キーボードの文字をリストの選択に変換するオブジェクトを設定します。 通常、最初の文字が一致するものの内で最初に選択されたものが選択された項目になります。

パラメータ:

aManager - キー選択マネージャ

getKeySelectionManager

public JComboBox.KeySelectionManager getKeySelectionManager()

リストのキー選択マネージャを返します。

戻り値:

現在使用されているKeySelectionManager

getItemCount

@BeanProperty(bound=false) public int getItemCount()

リスト内の項目の数を返します。

戻り値:

リスト内の項目数を示す整数値

getItemAt

public E getItemAt(int index)

指定されたインデックスのリスト項目を返します。 indexが範囲外の場合、つまりゼロよりも小さいか、サイズ以上の場合は、nullを返します。

パラメータ:

index - リスト位置を示す整数値。最初の項目はゼロで始まる

戻り値:

そのリスト位置の項目。範囲外の場合はnull

createDefaultKeySelectionManager

protected JComboBox.KeySelectionManager createDefaultKeySelectionManager()

デフォルトのキー選択マネージャのインスタンスを返します。

戻り値:

リストが現在使用しているKeySelectionManager

関連項目:

• setKeySelectionManager(javax.swing.JComboBox.KeySelectionManager)

paramString

protected String paramString()

このJComboBoxの文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。

オーバーライド:

paramString、クラスJComponent

戻り値:

このJComboBoxの文字列表現

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

このJComboBoxに関連付けられたAccessibleContextを取得します。 コンボボックスの場合、AccessibleContextはAccessibleJComboBoxの形式を取ります。 必要に応じて新規のAccessibleJComboBoxインスタンスが生成されます。

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスComponent

戻り値:

このJComboBoxのAccessibleContextとして機能するAccessibleJComboBox