- 型パラメータ:
E
- このコンボボックスの要素の型
- すべての実装されたインタフェース:
ActionListener
,ImageObserver
,ItemSelectable
,MenuContainer
,Serializable
,EventListener
,Accessible
,ListDataListener
警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beans
パッケージに追加されました。 XMLEncoder
を参照してください。
詳細は、「The Java Tutorial」の「How to Use Combo Boxes」を参照してください。
- 導入されたバージョン:
- 1.2
- 関連項目:
-
ネストされたクラスのサマリー
修飾子と型クラス説明protected class
このクラスはJComboBox
クラスのアクセシビリティ・サポートを実装しています。static interface
KeySelectionManager
を定義するインタフェースです。クラス javax.swing.JComponentで宣言されたネストされたクラス/インタフェース
JComponent.AccessibleJComponent
クラス java.awt.Containerで宣言されたネストされたクラス/インタフェース
Container.AccessibleAWTContainer
クラス java.awt.Componentで宣言されたネストされたクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
フィールドのサマリー
修飾子と型フィールド説明protected String
このprotectedフィールドは実装固有のものです。protected ComboBoxModel<E>
このprotectedフィールドは実装固有のものです。protected ComboBoxEditor
このprotectedフィールドは実装固有のものです。protected boolean
このprotectedフィールドは実装固有のものです。protected JComboBox.KeySelectionManager
このprotectedフィールドは実装固有のものです。protected boolean
このprotectedフィールドは実装固有のものです。protected int
このprotectedフィールドは実装固有のものです。protected ListCellRenderer<? super E>
このprotectedフィールドは実装固有のものです。protected Object
この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
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明void
このメソッドは実装の副作用としてpublicです。protected void
actionPropertyChanged
(Action action, String propertyName) 関連アクションのプロパティの変更に応じてコンボボックスの状態を更新します。void
ActionListener
を追加します。void
項目を項目リストに追加します。void
addItemListener
(ItemListener aListener) ItemListener
を追加します。void
コンボボックスのポップアップから通知メッセージを受け取るPopupMenu
リスナーを追加します。void
configureEditor
(ComboBoxEditor anEditor, Object anItem) 指定された項目でエディタを初期化します。protected void
指定されたAction
のプロパティに一致するように、このコンボボックスにプロパティを設定します。void
このメソッドは実装の副作用としてpublicです。protected PropertyChangeListener
指定されたAction
からの変更を待機し、適切なプロパティを更新する役割を担うPropertyChangeListener
を作成して、返します。protected JComboBox.KeySelectionManager
デフォルトのキー選択マネージャのインスタンスを返します。protected void
このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。protected void
このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。void
コンボボックスのポップアップ部分が取り消されたことをPopupMenuListener
に通知します。void
コンボボックスのポップアップ部分が不可視状態になったことをPopupMenuListener
に通知します。void
コンボボックスのポップアップ部分が可視状態になったことをPopupMenuListener
に通知します。このJComboBoxに関連付けられたAccessibleContextを取得します。このActionEvent
ソースに現在設定されているAction
を返します。Action
が設定されていない場合は、null
を返します。アクション・リスナーに送られるイベントに含まれているアクション・コマンドを返します。addActionListener()を使用してこのJComboBoxに追加されたすべてのActionListener
の配列を返します。選択された項目をJComboBox
フィールドでペイントおよび編集するために使用するエディタを返します。getItemAt
(int index) 指定されたインデックスのリスト項目を返します。int
リスト内の項目の数を返します。addItemListener()でこのJComboBoxに追加される、すべてのItemListener
の配列を返します。リストのキー選択マネージャを返します。int
コンボボックスがスクロール・バーを使用しないで表示できる最大の項目数を返します。getModel()
JComboBox
によって現在使用されているデータ・モデルを返します。addPopupMenuListener()でこのJComboBoxに追加される、すべてのPopupMenuListener
の配列を返します。表示高さと表示幅の計算に使用されるオブジェクトである「表示プロトタイプ」値を返します。ListCellRenderer<? super E>
選択された項目をJComboBox
フィールドで表示するのに使われるレンダラを返します。int
指定された項目に一致する、リスト内の最初の項目を返します。現在選択されている項目を返します。Object[]
選択されている項目を含む配列を返します。getUI()
このコンポーネントをレンダリングするL&Fオブジェクトを返します。このコンポーネントをレンダリングするL&Fクラスの名前を返します。void
コンボボックスにポップアップ・ウィンドウを閉じさせます。void
insertItemAt
(E item, int index) 項目を項目リストのインデックスで指定された位置に追加します。protected void
祖先のリスナーを登録して、祖先が移動したとき、または可視または不可視になったときにAncestorEvents
を受け取るようにします。void
このメソッドは実装の副作用としてpublicです。void
このメソッドは実装の副作用としてpublicです。boolean
JComboBox
が編集可能な場合はtrueを返します。boolean
lightWeightPopupEnabled
プロパティの値を取得します。boolean
ポップアップの可視性を判定します。protected String
このJComboBox
の文字列表現を返します。void
Tabキーを探しながら、KeyEvent
を処理します。void
ActionListener
を削除します。void
項目リストからすべての項目を削除します。void
removeItem
(Object anObject) 項目を項目リストから削除します。void
removeItemAt
(int anIndex) anIndex
位置の項目を削除します。このメソッドはJComboBox
が可変データ・モデルを使用する場合だけ有効です。void
removeItemListener
(ItemListener aListener) ItemListener
を削除します。void
PopupMenuListener
を削除します。protected void
このprotectedメソッドは実装固有のものです。boolean
selectWithKeyChar
(char keyChar) 指定されたキーボードの文字に対応するリスト項目を選択し、その文字に対応する項目がある場合にtrueを返します。void
このActionEvent
ソースのAction
を設定します。void
setActionCommand
(String aCommand) アクション・リスナーに送られるイベントに含まれなければならないアクション・コマンドを設定します。void
setEditable
(boolean aFlag) JComboBox
フィールドが編集可能かどうかを指定します。void
setEditor
(ComboBoxEditor anEditor) 選択された項目をJComboBox
フィールドでペイントおよび編集するために使用されるエディタを設定します。void
setEnabled
(boolean b) 項目を選択できるようにコンボボックスを有効にします。void
キーボードの文字をリストの選択に変換するオブジェクトを設定します。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
コンボボックスにポップアップ・ウィンドウを表示させます。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
-
フィールド詳細
-
dataModel
protected ComboBoxModel<E> dataModelこのprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。 -
renderer
protected ListCellRenderer<? super E> rendererこのprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。 -
editor
protected ComboBoxEditor editorこのprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。 -
maximumRowCount
protected int maximumRowCountこのprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。 -
isEditable
protected boolean isEditableこのprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。 -
keySelectionManager
protected JComboBox.KeySelectionManager keySelectionManagerこのprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。 -
actionCommand
protected String actionCommandこのprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。 -
lightWeightPopupEnabled
protected boolean lightWeightPopupEnabledこのprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。 アクセス用のメソッドを代わりに使用します。 -
selectedItemReminder
protected Object selectedItemReminderこのprotectedフィールドは実装固有のものです。 直接のアクセスやオーバーライドはしないでください。
-
-
コンストラクタの詳細
-
JComboBox
public JComboBox(ComboBoxModel<E> aModel) 項目を既存のComboBoxModel
から取得するJComboBox
を生成します。ComboBoxModel
が提供されるため、このコンストラクタを使用して生成されたコンボボックスは、デフォルトのコンボ・ボックス・モデルを生成せず、挿入、削除、および追加の各メソッドの動作方法に強い影響を与えます。- パラメータ:
aModel
- 表示された項目のリストを提供するComboBoxModel
- 関連項目:
-
JComboBox
public JComboBox(E[] items) 指定された配列に要素を格納するJComboBox
を生成します。 デフォルトでは、配列の最初の項目と、それに伴うデータ・モデルが選択されます。- パラメータ:
items
- コンボボックスに挿入するオブジェクトの配列- 関連項目:
-
JComboBox
指定されたVectorに要素を格納するJComboBox
を生成します。 デフォルトでは、ベクターの最初の項目と、それに伴うデータ・モデルが選択されます。- パラメータ:
items
- コンボボックスに挿入するベクターの配列- 関連項目:
-
JComboBox
public JComboBox()デフォルトのデータ・モデルでJComboBox
を生成します。 デフォルトのデータ・モデルは、オブジェクトの空リストです。addItem
を使用して項目を追加します。 デフォルトでは、データ・モデルの最初の項目が選択されます。- 関連項目:
-
-
メソッドの詳細
-
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オブジェクト- 関連項目:
-
updateUI
public void updateUI()現在のルック・アンド・フィールからの値にUIプロパティをリセットします。- オーバーライド:
updateUI
、クラスJComponent
- 関連項目:
-
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()このコンポーネントをレンダリングするL&Fクラスの名前を返します。- オーバーライド:
getUIClassID
、クラスJComponent
- 戻り値:
- 文字列「ComboBoxUI」
- 関連項目:
-
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
プロパティの値- 関連項目:
-
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
- 関連項目:
-
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
- 関連項目:
-
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
、またはデータ・コンストラクタではコンボボックスに追加されません。- 戻り値:
- 現在選択されているオブジェクト
- 関連項目:
-
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
@BeanProperty(visualUpdate=true, description="The display prototype value, used to compute display width and height.") public void setPrototypeDisplayValue(E prototypeDisplayValue) UI部分の表示サイズ計算に使用される表示プロトタイプ値を設定します。表示プロトタイプ値が指定されると、その値を使用してレンダリングが設定され、コンボボックスの適切なサイズが計算されます。 コンボボックスに大量のデータが表示される場合は、適切な表示サイズ値の指定が有効になります。 表示プロトタイプ値が指定されていない場合、レンダリングでモデルごとに値を指定して適切なサイズを計算しなければならず、相対的に処理ステップが多くなります。
- パラメータ:
prototypeDisplayValue
- プロト型表示値- 導入されたバージョン:
- 1.4
- 関連項目:
-
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
- リストに追加する項目- 関連項目:
-
insertItemAt
public void insertItemAt(E item, int index) 項目を項目リストのインデックスで指定された位置に追加します。 このメソッドはJComboBox
が可変データ・モデルを使用する場合にだけ有効です。- パラメータ:
item
- リストに追加する項目index
- 項目を追加する位置を指定する整数- 関連項目:
-
removeItem
public void removeItem(Object anObject) 項目を項目リストから削除します。 このメソッドはJComboBox
が可変データ・モデルを使用する場合にだけ有効です。- パラメータ:
anObject
- 項目リストから削除するオブジェクト- 関連項目:
-
removeItemAt
public void removeItemAt(int anIndex) anIndex
位置の項目を削除します。このメソッドはJComboBox
が可変データ・モデルを使用する場合だけ有効です。- パラメータ:
anIndex
- 削除する項目のインデックスを指定する整数値。0はリスト内の最初の項目を示す- 関連項目:
-
removeAllItems
public void removeAllItems()項目リストからすべての項目を削除します。 -
showPopup
public void showPopup()コンボボックスにポップアップ・ウィンドウを表示させます。- 関連項目:
-
hidePopup
public void hidePopup()コンボボックスにポップアップ・ウィンドウを閉じさせます。- 関連項目:
-
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
- 関連項目:
-
removeItemListener
public void removeItemListener(ItemListener aListener) ItemListener
を削除します。- 定義:
removeItemListener
、インタフェースItemSelectable
- パラメータ:
aListener
- 削除するItemListener
- 関連項目:
-
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
- 関連項目:
-
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
- 関連項目:
-
getPopupMenuListeners
@BeanProperty(bound=false) public PopupMenuListener[] getPopupMenuListeners()addPopupMenuListener()でこのJComboBoxに追加される、すべてのPopupMenuListener
の配列を返します。- 戻り値:
- 追加されたすべての
PopupMenuListener
。リスナーが追加されていない場合は空の配列 - 導入されたバージョン:
- 1.4
-
firePopupMenuWillBecomeVisible
public void firePopupMenuWillBecomeVisible()コンボボックスのポップアップ部分が可視状態になったことをPopupMenuListener
に通知します。このメソッドはpublicですがUI委譲以外からは呼び出さないでください。
- 導入されたバージョン:
- 1.4
- 関連項目:
-
firePopupMenuWillBecomeInvisible
public void firePopupMenuWillBecomeInvisible()コンボボックスのポップアップ部分が不可視状態になったことをPopupMenuListener
に通知します。このメソッドはpublicですがUI委譲以外からは呼び出さないでください。
- 導入されたバージョン:
- 1.4
- 関連項目:
-
firePopupMenuCanceled
public void firePopupMenuCanceled()コンボボックスのポップアップ部分が取り消されたことをPopupMenuListener
に通知します。このメソッドはpublicですがUI委譲以外からは呼び出さないでください。
- 導入されたバージョン:
- 1.4
- 関連項目:
-
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
- 関連項目:
-
getAction
public Action getAction()このActionEvent
ソースに現在設定されているAction
を返します。Action
が設定されていない場合は、null
を返します。- 戻り値:
- この
ActionEvent
ソースのAction
、またはnull
- 導入されたバージョン:
- 1.3
- 関連項目:
-
configurePropertiesFromAction
protected void configurePropertiesFromAction(Action a) 指定されたAction
のプロパティに一致するように、このコンボボックスにプロパティを設定します。 これによって設定されるプロパティの詳細は、「Action
をサポートするSwingコンポーネント」を参照してください。- パラメータ:
a
- プロパティを取得するAction
、またはnull
- 導入されたバージョン:
- 1.3
- 関連項目:
-
createActionPropertyChangeListener
protected PropertyChangeListener createActionPropertyChangeListener(Action a) 指定されたAction
からの変更を待機し、適切なプロパティを更新する役割を担うPropertyChangeListener
を作成して、返します。警告: これをサブクラス化する場合、匿名の内部クラスは作成しないでください。 作成すると、コンボボックスの寿命が
Action
の寿命に拘束されます。- パラメータ:
a
- コンボボックスのアクション- 戻り値:
PropertyChangeListener
- 導入されたバージョン:
- 1.3
- 関連項目:
-
actionPropertyChanged
関連アクションのプロパティの変更に応じてコンボボックスの状態を更新します。 このメソッドは、createActionPropertyChangeListener
から返されるPropertyChangeListener
から呼び出されます。 サブクラスは、通常、これを呼び出す必要はありません。 追加のAction
プロパティをサポートするサブクラスは、これとconfigurePropertiesFromAction
をオーバーライドする必要があります。このメソッドによって設定されるプロパティのリストは、「
Action
をサポートするSwingコンポーネント」の表を参照してください。- パラメータ:
action
- このコンボボックスに関連付けられたAction
propertyName
- 変更されたプロパティの名前- 導入されたバージョン:
- 1.6
- 関連項目:
-
fireItemStateChanged
protected void fireItemStateChanged(ItemEvent e) このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。- パラメータ:
e
- 対象のイベント- 関連項目:
-
fireActionEvent
protected void fireActionEvent()このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。- 関連項目:
-
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の場合は使用不可- 関連項目:
-
configureEditor
public void configureEditor(ComboBoxEditor anEditor, Object anItem) 指定された項目でエディタを初期化します。- パラメータ:
anEditor
- コンボボックスのフィールドにリスト項目を表示し、その編集を可能にするComboBoxEditor
anItem
- フィールドで表示および編集を行うオブジェクト
-
processKeyEvent
public void processKeyEvent(KeyEvent e) Tabキーを探しながら、KeyEvent
を処理します。 Tabキーが見つかると、ポップアップ・ウィンドウが閉じます。- オーバーライド:
processKeyEvent
、クラスJComponent
- パラメータ:
e
- 押されたキーボードのキーを含むKeyEvent
- 関連項目:
-
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
- 関連項目:
-
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
-