javax.swing
クラス JComboBox

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JComboBox

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

ActionListener, ImageObserver, ItemSelectable, MenuContainer, Serializable, EventListener, Accessible, ListDataListener

public class JComboBox
extends JComponent
implements ItemSelectable, ListDataListener, ActionListener, Accessible

ボタン、または編集可能フィールドとドロップダウンリストを組み合わせたコンポーネントです。ユーザは要求に応じて表示されるドロップダウンリストから値を選択できます。コンボボックスを編集可能にすると、編集可能なフィールドを持つようになり、ユーザが値を自由に入力できるようになります。

標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、「JComboBoxのキーの割り当て」を参照してください。

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

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

関連項目:

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.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

protected String	actionCommand この protected フィールドは実装固有のものです。
protected ComboBoxModel	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	renderer この protected フィールドは実装固有のものです。
protected Object	selectedItemReminder この protected フィールドは実装固有のものです。

クラス javax.swing.JComponent から継承されたフィールド

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

クラス java.awt.Component から継承されたフィールド

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(ComboBoxModel aModel)
項目を既存の ComboBoxModel から取得する JComboBox を生成します。

JComboBox(Object[] items)
指定された配列に要素を格納する JComboBox を生成します。

JComboBox(Vector<?> items)
指定された Vector に要素を格納する JComboBox を生成します。

メソッドの概要

void	actionPerformed(ActionEvent e) このメソッドは public になっていますが、これは実装の副作用によるものです。
void	addActionListener(ActionListener l) ActionListener を追加します。
void	addItem(Object anObject) 項目を項目リストに追加します。
void	addItemListener(ItemListener aListener) ItemListener を追加します。
void	addPopupMenuListener(PopupMenuListener l) コンボボックスのポップアップから通知メッセージを受け取る PopupMenu リスナーを追加します。
void	configureEditor(ComboBoxEditor anEditor, Object anItem) 指定された項目でエディタを初期化します。
protected void	configurePropertiesFromAction(Action a) Action インスタンスの値に従って ActionEvent ソースのプロパティを設定するファクトリメソッドです。
void	contentsChanged(ListDataEvent e) このメソッドは public になっていますが、これは実装の副作用によるものです。
protected PropertyChangeListener	createActionPropertyChangeListener(Action a) ActionEvent ソースを 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 を返します。
String	getActionCommand() アクションリスナーに送られるイベントに含まれているアクションコマンドを返します。
ActionListener[]	getActionListeners() addActionListener() でこの JComboBox に追加される、すべての ActionListener の配列を返します。
ComboBoxEditor	getEditor() 選択された項目を JComboBox フィールドで描画および編集するために使用するエディタを返します。
Object	getItemAt(int index) 指定されたインデックスのリスト項目を返します。
int	getItemCount() リスト内の項目の数を返します。
ItemListener[]	getItemListeners() addItemListener() でこの JComboBox に追加される、すべての ItemListener の配列を返します。
JComboBox.KeySelectionManager	getKeySelectionManager() リストのキー選択マネージャを返します。
int	getMaximumRowCount() コンボボックスがスクロールバーを使用しないで表示できる最大の項目数を返します。
ComboBoxModel	getModel() JComboBox によって現在使用されているデータモデルを返します。
PopupMenuListener[]	getPopupMenuListeners() addPopupMenuListener() でこの JComboBox に追加される、すべての PopupMenuListener の配列を返します。
Object	getPrototypeDisplayValue() 表示の高さおよび幅の計算に使用されるオブジェクトである「表示プロトタイプ」値を返します。
ListCellRenderer	getRenderer() 選択された項目を JComboBox フィールドで表示するために使用されるレンダリングを返します。
int	getSelectedIndex() 指定された項目に一致する、リスト内の最初の項目を返します。
Object	getSelectedItem() 現在選択されている項目を返します。
Object[]	getSelectedObjects() 選択されている項目を含む配列を返します。
ComboBoxUI	getUI() このコンポーネントを描画する L&F オブジェクトを返します。
String	getUIClassID() このコンポーネントを描画する L&F クラスの名前を返します。
void	hidePopup() コンボボックスにポップアップウィンドウを閉じさせます。
void	insertItemAt(Object anObject, int index) 項目を項目リストのインデックスで指定された位置に追加します。
protected void	installAncestorListener()
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 位置の項目を削除します。
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 プロパティを設定します。
void	setMaximumRowCount(int count) JComboBox が表示する最大の行数を設定します。
void	setModel(ComboBoxModel aModel) JComboBox が項目のリストを取得するために使用するデータモデルを設定します。
void	setPopupVisible(boolean v) ポップアップの可視性を設定します。
void	setPrototypeDisplayValue(Object prototypeDisplayValue) UI 部分の表示サイズ計算に使用される表示プロトタイプ値を設定します。
void	setRenderer(ListCellRenderer aRenderer) JComboBox フィールドのリストから選択されたリスト項目と項目をペイントするレンダリングを設定します。
void	setSelectedIndex(int anIndex) インデックス anIndex にある項目を選択します。
void	setSelectedItem(Object anObject) コンボボックス表示領域の選択された項目を引数のオブジェクトに設定します。
void	setUI(ComboBoxUI ui) このコンポーネントを描画する L&F オブジェクトを設定します。
void	showPopup() コンボボックスにポップアップウィンドウを表示させます。
void	updateUI() 現在の Look & Feel からの値に UI プロパティをリセットします。

クラス javax.swing.JComponent から継承されたメソッド

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, 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, transferFocusBackward, 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, 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, hide, 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, transferFocusUpCycle

クラス java.lang.Object から継承されたメソッド

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

フィールドの詳細

dataModel

protected ComboBoxModel dataModel

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

関連項目:

getModel(), setModel(javax.swing.ComboBoxModel)

renderer

protected ListCellRenderer renderer

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

関連項目:

getRenderer(), setRenderer(javax.swing.ListCellRenderer)

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

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

パラメータ:

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

関連項目:

DefaultComboBoxModel

JComboBox

public JComboBox(Object[] items)

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

パラメータ:

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

関連項目:

DefaultComboBoxModel

JComboBox

public JComboBox(Vector<?> items)

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

パラメータ:

items - コンボボックスに挿入するベクタの配列

関連項目:

DefaultComboBoxModel

JComboBox

public JComboBox()

デフォルトのデータモデルで JComboBox を生成します。デフォルトのデータモデルは、オブジェクトの空リストです。addItem を使用して項目を追加します。デフォルトでは、データモデルの最初の項目が選択されます。

関連項目:

DefaultComboBoxModel

メソッドの詳細

installAncestorListener

protected void installAncestorListener()

setUI

public void setUI(ComboBoxUI ui)

このコンポーネントを描画する L&F オブジェクトを設定します。

パラメータ:

ui - ComboBoxUI L&F オブジェクト

関連項目:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

現在の Look & Feel からの値に UI プロパティをリセットします。

オーバーライド:

クラス JComponent 内の updateUI

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

このコンポーネントを描画する L&F クラスの名前を返します。

オーバーライド:

クラス JComponent 内の getUIClassID

戻り値:

文字列「ComboBoxUI」

関連項目:

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

getUI

public ComboBoxUI getUI()

このコンポーネントを描画する L&F オブジェクトを返します。

戻り値:

このコンポーネントを描画する ComboBoxUI オブジェクト

setModel

public void setModel(ComboBoxModel aModel)

JComboBox が項目のリストを取得するために使用するデータモデルを設定します。

パラメータ:

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

getModel

public ComboBoxModel getModel()

JComboBox によって現在使用されているデータモデルを返します。

戻り値:

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

setLightWeightPopupEnabled

public void setLightWeightPopupEnabled(boolean aFlag)

lightWeightPopupEnabled プロパティを設定します。このプロパティは、JComboBox の格納先として軽量 Component を使用するか、それとも Panel や Window などの重量 Component を使用するかどうかについてのヒントを提供します。どちらを使用するかを決定するのは、最終的には JComboBox です。軽量ウィンドウは重量ウィンドウよりも効率的ですが、GUI での軽量コンポーネントと重量コンポーネントの混合はあまり良いことではありません。アプリケーションで両方のコンポーネントが使われている場合、軽量ポップアップを無効化します。lightWeightPopupEnabled プロパティのデフォルト値は、Look & Feel で他の値が指定されていなければ true になります。一部の Look & Feel ではこのプロパティの値に関係なく常に重量ポップアップが使用されます。

「The Swing Connection」の「Mixing Heavy and Light Components」を参照してください。このメソッドはプロパティ変更イベントをトリガします。

パラメータ:

aFlag - true の場合は軽量ポップアップが要求されます。

isLightWeightPopupEnabled

public boolean isLightWeightPopupEnabled()

lightWeightPopupEnabled プロパティの値を返します。

戻り値:

lightWeightPopupEnabled プロパティの値

関連項目:

setLightWeightPopupEnabled(boolean)

setEditable

public void setEditable(boolean aFlag)

JComboBox フィールドが編集可能かどうかを指定します。編集可能な JComboBox では、ユーザはフィールドに入力するか、またはフィールドを初期化するためにリストから項目を選択でき、そのあとにその項目を編集できます。編集はフィールドに対してだけ可能であり、リスト項目は変更されません。編集が不可能な JComboBox は選択された項目をフィールドに表示しますが、その選択は編集できません。

パラメータ:

aFlag - boolean 値。true はフィールドが編集可能であることを示す

isEditable

public boolean isEditable()

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

戻り値:

JComboBox が編集可能な場合は true、そうでない場合は false

setMaximumRowCount

public void setMaximumRowCount(int count)

JComboBox が表示する最大の行数を設定します。モデル内のオブジェクト数が count より大きい場合は、コンボボックスはスクロールバーを使用します。

パラメータ:

count - スクロールバーを使用しないでリストに表示できる最大の項目数を指定する整数値

getMaximumRowCount

public int getMaximumRowCount()

コンボボックスがスクロールバーを使用しないで表示できる最大の項目数を返します。

戻り値:

スクロールバーを使用しないでリストに表示される最大の項目数を指定する整数値

setRenderer

public void setRenderer(ListCellRenderer aRenderer)

JComboBox フィールドのリストから選択されたリスト項目と項目をペイントするレンダリングを設定します。レンダリングは、JComboBox が編集不可能な場合に使用されます。編集可能な場合は、エディタを使用して選択された項目の描画および編集にエディタが使用されます。

デフォルトのレンダリングでは文字列またはアイコンが表示されます。他のレンダリングではグラフィックイメージと複合アイテムを使用できます。

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

パラメータ:

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

関連項目:

setEditor(javax.swing.ComboBoxEditor)

getRenderer

public ListCellRenderer getRenderer()

選択された項目を JComboBox フィールドで表示するために使用されるレンダリングを返します。

戻り値:

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

setEditor

public void setEditor(ComboBoxEditor anEditor)

選択された項目を JComboBox フィールドでペイントおよび編集するために使用されるエディタを設定します。エディタは、受け取る JComboBox が編集可能な場合だけ使用されます。編集できない場合は、コンボボックスはレンダリングを使用して選択された項目を描画します。

パラメータ:

anEditor - 選択された項目を表示する ComboBoxEditor

関連項目:

setRenderer(javax.swing.ListCellRenderer)

getEditor

public ComboBoxEditor getEditor()

選択された項目を JComboBox フィールドで描画および編集するために使用するエディタを返します。

戻り値:

選択された項目を表示する ComboBoxEditor

setSelectedItem

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

public void setSelectedIndex(int anIndex)

インデックス anIndex にある項目を選択します。

パラメータ:

anIndex - 選択するリスト項目を指定する整数値。0 はリスト内の最初の項目を指定。-1 は選択しないことを示す

例外:

IllegalArgumentException - anIndex が -1 より小さい場合、あるいは anIndex がサイズに等しいかそれより大きい場合

getSelectedIndex

public int getSelectedIndex()

指定された項目に一致する、リスト内の最初の項目を返します。JComboBox がリストにない項目の選択を許可する場合、その結果が常に定義されるとは限りません。項目が選択されていない場合、またはユーザがリストにない項目を指定した場合は、-1 が返されます。

戻り値:

現在選択されているリスト項目を指定する整数値。0 はリスト内の最初の項目を示す。項目が選択されていない場合、または現在選択されている項目がリストにない場合は -1 を返す

getPrototypeDisplayValue

public Object getPrototypeDisplayValue()

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

戻り値:

prototypeDisplayValue プロパティの値

導入されたバージョン:

1.4

関連項目:

setPrototypeDisplayValue(java.lang.Object)

setPrototypeDisplayValue

public void setPrototypeDisplayValue(Object prototypeDisplayValue)

UI 部分の表示サイズ計算に使用される表示プロトタイプ値を設定します。

表示プロトタイプ値が指定されると、その値を使用してレンダリングが設定され、コンボボックスの適切なサイズが計算されます。コンボボックスに大量のデータが表示される場合は、適切な表示サイズ値の指定が有効になります。表示プロトタイプ値が指定されていない場合、レンダリングでモデルごとに値を指定して適切サイズを計算しなければならず、相対的に処理ステップが多くなります。

パラメータ:

prototypeDisplayValue - @see #getPrototypeDisplayValue

導入されたバージョン:

1.4

addItem

public void addItem(Object anObject)

項目を項目リストに追加します。このメソッドは 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; } };
   }
 

パラメータ:

anObject - リストに追加する Object

関連項目:

MutableComboBoxModel

insertItemAt

public void insertItemAt(Object anObject,
                         int index)

項目を項目リストのインデックスで指定された位置に追加します。このメソッドは JComboBox が可変データモデルを使用する場合にだけ有効です。

パラメータ:

anObject - リストに追加する Object

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)

ポップアップの可視性を設定します。

isPopupVisible

public boolean isPopupVisible()

ポップアップの可視性を判定します。

戻り値:

ポップアップが可視の場合は true、そうでない場合は false

addItemListener

public void addItemListener(ItemListener aListener)

ItemListener を追加します。

aListener は選択した項目が変更されると 1 つまたは 2 つの ItemEvent を受信します。

定義:

インタフェース ItemSelectable 内の addItemListener

パラメータ:

aListener - 通知される ItemListener

関連項目:

setSelectedItem(java.lang.Object)

removeItemListener

public void removeItemListener(ItemListener aListener)

ItemListener を削除します。

定義:

インタフェース ItemSelectable 内の removeItemListener

パラメータ:

aListener - 削除される ItemListener

関連項目:

ItemEvent

getItemListeners

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

public ActionListener[] getActionListeners()

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

戻り値:

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

導入されたバージョン:

1.4

addPopupMenuListener

public void addPopupMenuListener(PopupMenuListener l)

コンボボックスのポップアップから通知メッセージを受け取る PopupMenu リスナーを追加します。

Java 2 のすべての標準 Look & Feel では、コンボボックスのポップアップリスト部分は JPopupMenu として実装されます。カスタム Look & Feel では実装形態が異なり、通知を受信しません。

パラメータ:

l - 追加する PopupMenuListener

導入されたバージョン:

1.4

removePopupMenuListener

public void removePopupMenuListener(PopupMenuListener l)

PopupMenuListener を削除します。

パラメータ:

l - 削除する PopupMenuListener

導入されたバージョン:

1.4

関連項目:

addPopupMenuListener(javax.swing.event.PopupMenuListener)

getPopupMenuListeners

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

public void setAction(Action a)

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

Action を設定すると、ActionEvent ソースのプロパティが、Action の値からただちに設定され (configurePropertiesFromAction メソッドで実行)、続いて createActionPropertyChangeListener メソッドが作成した PropertyChangeListener により、Action のプロパティの変更に従って更新されます。

パラメータ:

a - JComboBox の Action、または null

導入されたバージョン:

1.3

関連項目:

Action, getAction(), configurePropertiesFromAction(javax.swing.Action), createActionPropertyChangeListener(javax.swing.Action)

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 インスタンスの値に従って ActionEvent ソースのプロパティを設定するファクトリメソッドです。設定されるプロパティはサブクラスによって異なります。デフォルトでは、設定されるプロパティは Enabled および ToolTipText です。

パラメータ:

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

導入されたバージョン:

1.3

関連項目:

Action, setAction(javax.swing.Action)

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)

ActionEvent ソースを Action インスタンスのプロパティの変更に従って更新するために使用する PropertyChangeListener を生成するファクトリメソッドです。最新の状態で保持する必要のあるプロパティのセットがデフォルトプロパティ (Text、Icon、Enabled、ToolTipText) と異なる場合は、独自の PropertyChangeListener を提供するためにサブクラスがこのメソッドをオーバーライドすることがあります。 PropertyChangeListener は ActionEvent ソースへの強参照を保持しないようにする必要があります。これは、ActionEvent ソースのガベージコレクションおよびすべての包含関係の階層のコンポーネントを妨害する可能性があるからです。

導入されたバージョン:

1.3

関連項目:

Action, setAction(javax.swing.Action)

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)

通知の配信対象を、指定されたイベント型で登録したすべてのリスナーに通知します。

パラメータ:

e - 対象のイベント

関連項目:

EventListenerList

fireActionEvent

protected void fireActionEvent()

通知の配信対象を、指定されたイベント型で登録したすべてのリスナーに通知します。

関連項目:

EventListenerList

selectedItemChanged

protected void selectedItemChanged()

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

getSelectedObjects

public Object[] getSelectedObjects()

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

定義:

インタフェース ItemSelectable 内の getSelectedObjects

戻り値:

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

actionPerformed

public void actionPerformed(ActionEvent e)

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

定義:

インタフェース ActionListener 内の actionPerformed

contentsChanged

public void contentsChanged(ListDataEvent e)

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

定義:

インタフェース ListDataListener 内の contentsChanged

パラメータ:

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

intervalAdded

public void intervalAdded(ListDataEvent e)

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

定義:

インタフェース ListDataListener 内の intervalAdded

パラメータ:

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

intervalRemoved

public void intervalRemoved(ListDataEvent e)

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

定義:

インタフェース ListDataListener 内の intervalRemoved

パラメータ:

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

selectWithKeyChar

public boolean selectWithKeyChar(char keyChar)

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

パラメータ:

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

setEnabled

public void setEnabled(boolean b)

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

オーバーライド:

クラス JComponent 内の setEnabled

パラメータ:

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 キーが見つかると、ポップアップウィンドウが閉じます。

オーバーライド:

クラス JComponent 内の processKeyEvent

パラメータ:

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

public void setKeySelectionManager(JComboBox.KeySelectionManager aManager)

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

getKeySelectionManager

public JComboBox.KeySelectionManager getKeySelectionManager()

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

戻り値:

現在使用されている KeySelectionManager

getItemCount

public int getItemCount()

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

戻り値:

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

getItemAt

public Object getItemAt(int index)

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

パラメータ:

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

戻り値:

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

createDefaultKeySelectionManager

protected JComboBox.KeySelectionManager createDefaultKeySelectionManager()

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

戻り値:

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

関連項目:

setKeySelectionManager(javax.swing.JComboBox.KeySelectionManager)

paramString

protected String paramString()

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

オーバーライド:

クラス JComponent 内の paramString

戻り値:

この JComboBox の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス JComponent 内の getAccessibleContext

戻り値:

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