E - このコンボボックスの要素の型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」を参照してください。
| 修飾子と型 | クラス | 説明 |
|---|---|---|
protected class |
JComboBox.AccessibleJComboBox |
このクラスは
JComboBoxクラスのアクセシビリティ・サポートを実装しています。 |
static interface |
JComboBox.KeySelectionManager |
KeySelectionManagerを定義するインタフェースです。 |
JComponent.AccessibleJComponentContainer.AccessibleAWTContainerComponent.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フィールドは実装固有のものです。
|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOWaccessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH| コンストラクタ | 説明 |
|---|---|
JComboBox() |
デフォルトのデータ・モデルで
JComboBoxを生成します。 |
JComboBox(ComboBoxModel<E> aModel) |
項目を既存の
ComboBoxModelから取得するJComboBoxを生成します。 |
JComboBox(E[] items) |
指定された配列に要素を格納する
JComboBoxを生成します。 |
JComboBox(Vector<E> items) |
指定されたVectorに要素を格納する
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() |
|
void |
intervalAdded(ListDataEvent e) |
このメソッドは実装の副作用としてpublicです。
|
void |
intervalRemoved(ListDataEvent e) |
このメソッドは実装の副作用としてpublicです。
|
boolean |
isEditable() |
JComboBoxが編集可能な場合はtrueを返します。 |
boolean |
isLightWeightPopupEnabled() |
lightWeightPopupEnabledプロパティの値を取得します。 |
boolean |
isPopupVisible() |
ポップアップの可視性を判定します。
|
protected String |
paramString() |
この
JComboBoxの文字列表現を返します。 |
protected boolean |
processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed) |
KeyEvent eの結果としてksのキー・バインドを処理するために呼び出されます。 |
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プロパティをリセットします。
|
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, 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, updateadd, 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, validateTreeaction, 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, transferFocusUpCycleprotected ComboBoxModel<E> dataModel
protected ListCellRenderer<? super E> renderer
protected ComboBoxEditor editor
protected int maximumRowCount
protected boolean isEditable
isEditable, setEditable(boolean)protected JComboBox.KeySelectionManager keySelectionManager
protected String actionCommand
protected boolean lightWeightPopupEnabled
protected Object selectedItemReminder
public JComboBox(ComboBoxModel<E> aModel)
ComboBoxModelから取得するJComboBoxを生成します。 ComboBoxModelが提供されるため、このコンストラクタを使用して生成されたコンボボックスは、デフォルトのコンボ・ボックス・モデルを生成せず、挿入、削除、および追加の各メソッドの動作方法に強い影響を与えます。 aModel - 表示された項目のリストを提供するComboBoxModelDefaultComboBoxModelpublic JComboBox(E[] items)
JComboBoxを生成します。 デフォルトでは、配列の最初の項目と、それに伴うデータ・モデルが選択されます。 items - コンボボックスに挿入するオブジェクトの配列DefaultComboBoxModelpublic JComboBox(Vector<E> items)
JComboBoxを生成します。 デフォルトでは、ベクターの最初の項目と、それに伴うデータ・モデルが選択されます。 items - コンボボックスに挿入するベクターの配列DefaultComboBoxModelpublic JComboBox()
JComboBoxを生成します。 デフォルトのデータ・モデルは、オブジェクトの空リストです。 addItemを使用して項目を追加します。 デフォルトでは、データ・モデルの最初の項目が選択されます。 DefaultComboBoxModelprotected void installAncestorListener()
public void setUI(ComboBoxUI ui)
ui - ComboBoxUI L&FオブジェクトUIDefaults.getUI(javax.swing.JComponent)public void updateUI()
updateUI、クラスJComponentJComponent.updateUI()public String getUIClassID()
getUIClassID、クラスJComponentJComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)public ComboBoxUI getUI()
public void setModel(ComboBoxModel<E> aModel)
JComboBoxが項目のリストを取得するために使用するデータ・モデルを設定します。aModel - 表示された項目のリストを提供するComboBoxModelpublic ComboBoxModel<E> getModel()
JComboBoxによって現在使用されているデータ・モデルを返します。ComboBoxModelpublic void setLightWeightPopupEnabled(boolean aFlag)
lightWeightPopupEnabledプロパティを設定します。このプロパティは、JComboBoxの格納先として軽量Componentを使用するか、それともPanelやWindowなどの重量Componentを使用するかどうかについてのヒントを提供します。 軽量と重量のどちらを使用するかを決定するのは、最終的にはJComboBoxです。 軽量ウィンドウは重量ウィンドウよりも効率的ですが、軽量コンポーネントと重量コンポーネントはGUI内でうまく混在しません。 アプリケーションで軽量コンポーネントと重量コンポーネントが混在している場合は、軽量ポップアップを無効にする必要があります。 lightWeightPopupEnabledプロパティのデフォルト値は、ルック・アンド・フィールで他の値が指定されていなければtrueになります。 一部のルック・アンド・フィールでは、このプロパティの値に関係なく常に重量ポップアップが使用されます。
「Mixing Heavy and Light Components」を参照してください。このメソッドはプロパティ変更イベントをトリガーします。
aFlag - trueの場合は軽量ポップアップが要求されるpublic boolean isLightWeightPopupEnabled()
lightWeightPopupEnabledプロパティの値を取得します。lightWeightPopupEnabledプロパティの値setLightWeightPopupEnabled(boolean)public void setEditable(boolean aFlag)
JComboBoxフィールドが編集可能かどうかを指定します。 編集可能なJComboBoxでは、ユーザーはフィールドに入力するか、またはフィールドを初期化するためにリストから項目を選択でき、そのあとにその項目を編集できます。 編集はフィールドに対してだけ可能であり、リスト項目は変更されません。 編集が不可能なJComboBoxは選択された項目をフィールドに表示しますが、その選択は編集できません。 aFlag - boolean値。trueはフィールドが編集可能であることを示すpublic boolean isEditable()
JComboBoxが編集可能な場合はtrueを返します。 デフォルトでは、コンボボックスは編集不可です。 JComboBoxが編集可能な場合はtrue、そうでない場合はfalsepublic void setMaximumRowCount(int count)
JComboBoxが表示する最大の行数を設定します。 モデル内のオブジェクト数がcountより大きい場合は、コンボボックスはスクロール・バーを使用します。 count - スクロール・バーを使用しないでリストに表示できる最大の項目数を指定する整数値public int getMaximumRowCount()
public void setRenderer(ListCellRenderer<? super E> aRenderer)
デフォルトのレンダリングでは文字列またはアイコンが表示されます。 ほかのレンダリングは、グラフィック・イメージおよび複合項目を処理できます。
選択された項目を表示するには、リスト・オブジェクトおよびインデックス -1を渡してaRenderer.getListCellRendererComponentを呼び出します。
aRenderer - 選択された項目を表示するListCellRenderersetEditor(javax.swing.ComboBoxEditor)public ListCellRenderer<? super E> getRenderer()
JComboBoxフィールドで表示するのに使われるレンダラを返します。ListCellRenderer。public void setEditor(ComboBoxEditor anEditor)
JComboBoxフィールドでペイントおよび編集するために使用されるエディタを設定します。 エディタは、受け取るJComboBoxが編集可能な場合だけ使用されます。 編集できない場合は、コンボボックスはレンダリングを使用して選択された項目をレンダリングします。 anEditor - 選択された項目を表示するComboBoxEditorsetRenderer(javax.swing.ListCellRenderer<? super E>)public ComboBoxEditor getEditor()
JComboBoxフィールドでペイントおよび編集するために使用するエディタを返します。ComboBoxEditorpublic void setSelectedItem(Object anObject)
anObjectがリストにある場合、表示領域には選択されたanObjectを表示します。
anObjectがリストになく、コンボボックスが編集不可の場合、現在の選択は変更されません。 コンボボックスが編集可能な場合、選択はanObjectに変更されます。
これによって選択項目が変更される場合は、コンボボックスに追加されるItemListenerに、1つまたは2つのItemEventが通知されます。 現在選択されている項目がある場合、ItemEventがトリガーされ、状態がItemEvent.DESELECTEDに変更されます。 anObjectがリストにあり、現在選択されていない場合は、ItemEventがトリガーされ、状態はItemEvent.SELECTEDに変更されます。
コンボボックスに追加されたActionListenerは、このメソッドが呼び出されるときにActionEventで通知されます。
anObject - 選択するリスト・オブジェクト。選択をクリアする場合はnullを指定public Object getSelectedItem()
コンボボックスが編集可能な場合、この値はaddItem、insertItemAt、またはデータ・コンストラクタではコンボボックスに追加されません。
setSelectedItem(java.lang.Object)public void setSelectedIndex(int anIndex)
anIndexにある項目を選択します。anIndex - 選択するリスト項目を指定する整数値。0はリスト内の最初の項目を指定、-1は選択なしを示すIllegalArgumentException - anIndexが-1より小さい場合、または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が可変データ・モデルを使用する場合にだけ有効です。
警告: 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 - リストに追加する項目MutableComboBoxModelpublic void insertItemAt(E item, int index)
JComboBoxが可変データ・モデルを使用する場合にだけ有効です。 item - リストに追加する項目index - 項目を追加する位置を指定する整数MutableComboBoxModelpublic void removeItem(Object anObject)
JComboBoxが可変データ・モデルを使用する場合にだけ有効です。 anObject - 項目リストから削除するオブジェクトMutableComboBoxModelpublic void removeItemAt(int anIndex)
anIndex位置の項目を削除します。このメソッドはJComboBoxが可変データ・モデルを使用する場合だけ有効です。anIndex - 削除する項目のインデックスを指定する整数値。0はリスト内の最初の項目を示すMutableComboBoxModelpublic 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は選択した項目が変更されると1つまたは2つのItemEventを受信します。
addItemListener、インタフェースItemSelectableaListener - 通知されるItemListenersetSelectedItem(java.lang.Object)public void removeItemListener(ItemListener aListener)
ItemListenerを削除します。removeItemListener、インタフェースItemSelectableaListener - 削除するItemListenerItemEventpublic ItemListener[] getItemListeners()
ItemListenerの配列を返します。ItemListener。リスナーが追加されていない場合は空の配列public void addActionListener(ActionListener l)
ActionListenerを追加します。
ActionListenerは選択が行われたときにActionEventを受信します。 コンボボックスが編集可能な場合は、編集が停止されるとActionEventがトリガーされます。
l - 通知されるActionListenersetSelectedItem(java.lang.Object)public void removeActionListener(ActionListener l)
ActionListenerを削除します。l - 削除するActionListenerpublic ActionListener[] getActionListeners()
ActionListenerの配列を返します。ActionListener。リスナーが追加されていない場合は空の配列public void addPopupMenuListener(PopupMenuListener l)
PopupMenuリスナーを追加します。
Javaのすべての標準ルック・アンド・フィールでは、コンボボックスのポップアップ・リスト部分はJPopupMenuとして実装されます。 カスタムルック・アンド・フィールでは実装形態が異なり、通知を受信しません。
l - 追加するPopupMenuListenerpublic void removePopupMenuListener(PopupMenuListener l)
PopupMenuListenerを削除します。l - 削除するPopupMenuListeneraddPopupMenuListener(javax.swing.event.PopupMenuListener)public PopupMenuListener[] getPopupMenuListeners()
PopupMenuListenerの配列を返します。PopupMenuListener。リスナーが追加されていない場合は空の配列public void firePopupMenuWillBecomeVisible()
PopupMenuListenerに通知します。
このメソッドはpublicですがUI委譲以外からは呼び出さないでください。
addPopupMenuListener(javax.swing.event.PopupMenuListener)public void firePopupMenuWillBecomeInvisible()
PopupMenuListenerに通知します。
このメソッドはpublicですがUI委譲以外からは呼び出さないでください。
addPopupMenuListener(javax.swing.event.PopupMenuListener)public void firePopupMenuCanceled()
PopupMenuListenerに通知します。
このメソッドはpublicですがUI委譲以外からは呼び出さないでください。
addPopupMenuListener(javax.swing.event.PopupMenuListener)public void setActionCommand(String aCommand)
aCommand - アクション・リスナーに送られる「コマンド」を含む文字列。受信するコマンドに応じて、同じリスナーが異なる処理を実行できるpublic String getActionCommand()
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。Action, getAction(), configurePropertiesFromAction(javax.swing.Action), createActionPropertyChangeListener(javax.swing.Action), actionPropertyChanged(javax.swing.Action, java.lang.String)public Action getAction()
ActionEventソースに現在設定されているActionを返します。Actionが設定されていない場合は、nullを返します。ActionEventソースのAction、またはnullAction, setAction(javax.swing.Action)protected void configurePropertiesFromAction(Action a)
Actionのプロパティに一致するように、このコンボボックスにプロパティを設定します。 これによって設定されるプロパティの詳細は、「ActionをサポートするSwingコンポーネント」を参照してください。 a - プロパティを取得するAction、またはnullAction, setAction(javax.swing.Action)protected PropertyChangeListener createActionPropertyChangeListener(Action a)
Actionからの変更を待機し、適切なプロパティを更新する役割を担うPropertyChangeListenerを作成して、返します。
警告: これをサブクラス化する場合、匿名の内部クラスは作成しないでください。 作成すると、コンボボックスの寿命がActionの寿命に拘束されます。
a - コンボボックスのアクションAction, setAction(javax.swing.Action)protected void actionPropertyChanged(Action action, String propertyName)
createActionPropertyChangeListenerから返されるPropertyChangeListenerから呼び出されます。 サブクラスは、通常、これを呼び出す必要はありません。 追加のActionプロパティをサポートするサブクラスは、これとconfigurePropertiesFromActionをオーバーライドする必要があります。
このメソッドによって設定されるプロパティのリストは、「ActionをサポートするSwingコンポーネント」の表を参照してください。
action - このコンボボックスに関連付けられたActionpropertyName - 変更されたプロパティの名前Action, configurePropertiesFromAction(javax.swing.Action)protected void fireItemStateChanged(ItemEvent e)
e - 対象のイベントEventListenerListprotected void fireActionEvent()
EventListenerListprotected void selectedItemChanged()
public Object[] getSelectedObjects()
ItemSelectableとの互換性のために実装されます。 getSelectedObjects、インタフェースItemSelectableObjectsの配列public void actionPerformed(ActionEvent e)
actionPerformed、インタフェースActionListenerpublic void contentsChanged(ListDataEvent e)
contentsChanged、インタフェースListDataListenere - イベント情報をカプセル化するListDataEventpublic void intervalAdded(ListDataEvent e)
intervalAdded、インタフェースListDataListenere - イベント情報をカプセル化するListDataEventpublic void intervalRemoved(ListDataEvent e)
intervalRemoved、インタフェースListDataListenere - イベント情報をカプセル化するListDataEventpublic boolean selectWithKeyChar(char keyChar)
keyChar - 文字。通常はユーザーが押したキーボードのキーpublic void setEnabled(boolean b)
setEnabled、クラスJComponentb - boolean値。trueの場合はコンポーネントは使用可能で、falseの場合は使用不可Component.isEnabled(), Component.isLightweight()public void configureEditor(ComboBoxEditor anEditor, Object anItem)
anEditor - コンボボックスのフィールドにリスト項目を表示し、その編集を可能にするComboBoxEditoranItem - フィールドで表示および編集を行うオブジェクトpublic void processKeyEvent(KeyEvent e)
KeyEventを処理します。 Tabキーが見つかると、ポップアップ・ウィンドウが閉じます。 processKeyEvent、クラスJComponente - 押されたキーボードのキーを含むKeyEventKeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, Component.processEvent(java.awt.AWTEvent), Component.dispatchEvent(java.awt.AWTEvent), Component.addKeyListener(java.awt.event.KeyListener), Component.enableEvents(long), Component.isShowing()protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
KeyEvent eの結果としてksのキー・バインドを処理するために呼び出されます。 このメソッドは適切なInputMap、そのバインディング、ActionMapのアクションを取得して、(アクションが見つかり、コンポーネントが有効な場合)アクションを通知するためにnotifyActionを呼び出します。 processKeyBinding、クラスJComponentks - 照会するKeyStrokee - KeyEventcondition - 次の値のいずれか。
pressed - キーが押されている場合はtruepublic void setKeySelectionManager(JComboBox.KeySelectionManager aManager)
public JComboBox.KeySelectionManager getKeySelectionManager()
KeySelectionManagerpublic int getItemCount()
public E getItemAt(int index)
indexが範囲外の場合、つまりゼロよりも小さいか、サイズ以上の場合は、nullを返します。 index - リスト位置を示す整数値。最初の項目はゼロで始まるnullprotected JComboBox.KeySelectionManager createDefaultKeySelectionManager()
KeySelectionManagersetKeySelectionManager(javax.swing.JComboBox.KeySelectionManager)protected String paramString()
JComboBoxの文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。 返される文字列は空の場合がありますが、nullにはなりません。 paramString、クラスJComponentJComboBoxの文字列表現public AccessibleContext getAccessibleContext()
getAccessibleContext、インタフェースAccessiblegetAccessibleContext、クラスComponent バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。