|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 모든 클래스 | ||||||||||
개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JComboBox
버튼, 또는 편집 가능 필드와 드롭 다운 리스트를 조합한 컴퍼넌트입니다. 유저는 요구에 응해 표시되는 드롭 다운 리스트로부터 값을 선택할 수 있습니다. combobox를 편집 가능하게 하면(자), 편집 가능한 필드를 가지게 되어, 유저가 값을 자유롭게 입력할 수 있게 됩니다.
표준의 Look & Feel (L&F) 표현으로 이 컴퍼넌트가 사용하는 키보드의 키에 대해서는 「JComboBox
의 키의 할당」을 참조해 주세요.
경고:
이 클래스의 직렬화 오브젝트는 향후 릴리스 되는 Swing 와의 호환성은 없습니다. 현재 서포트되고 있는 직렬화는 단기간의 보관, 또는 같은 버젼의 Swing 가 가동하고 있는 어플리케이션간의 RMI 에 적절하고 있습니다. 1.4 로부터는 모든 JavaBeansTM 의 장기간의 보관이 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 을 상속받은 중첩된 클래스 |
|
클래스 java.awt. Container 을 상속받은 중첩된 클래스 |
|
클래스 java.awt. Component 을 상속받은 중첩된 클래스 |
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)
combobox의 pop-up로부터 통지 메세지를 받아들이는 PopupMenu 청취자를 추가합니다.
|
void |
configureEditor (ComboBoxEditor anEditor,
Object anItem)
지정된 항목으로 에디터를 초기화합니다. |
protected void |
configurePropertiesFromAction (Action a)
Action 인스턴스의 값에 따라 ActionEvent 소스의 프로퍼티를 설정하는 팩토리 메소드입니다. |
void |
contentsChanged (ListDataEvent e)
이 메소드는 public 가 되어 있습니다만, 이것은 구현의 부작용에 의하는 것입니다. |
protected PropertyChangeListener |
createActionPropertyChangeListener (Action a)
프로퍼티가 Action 인스턴스를 변경했을 때에 ActionEvent 소스의 갱신에 사용하는 PropertyChangeListener 를 생성하는 팩토리 메소드입니다. |
protected JComboBox.KeySelectionManager |
createDefaultKeySelectionManager ()
디폴트의 키 선택 매니저의 인스턴스를 돌려줍니다. |
protected void |
fireActionEvent ()
이 이벤트 타입으로 통지를 등록한 모든 청취자에게 통지합니다. |
protected void |
fireItemStateChanged (ItemEvent e)
이 이벤트 타입으로 통지를 등록한 모든 청취자에게 통지합니다. |
void |
firePopupMenuCanceled ()
combobox의 pop-up 부분이 삭제된 것을 PopupMenuListener 에 통지합니다.
|
void |
firePopupMenuWillBecomeInvisible ()
combobox의 pop-up 부분이 불가시 상태가 된 것을 PopupMenuListener 에 통지합니다.
|
void |
firePopupMenuWillBecomeVisible ()
combobox의 pop-up 부분이 가시 상태가 된 것을 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 ()
combobox가 스크롤 바를 사용하지 않고 표시할 수 있는 최대의 항목수를 돌려줍니다. |
ComboBoxModel |
getModel ()
JComboBox 에 의해 현재 사용되고 있는 데이터 모델을 돌려줍니다. |
PopupMenuListener [] |
getPopupMenuListeners ()
addPopupMenuListener()로 이 JComboBox 에 추가되는 모든 PopupMenuListener 의 배열을 돌려줍니다. |
Object |
getPrototypeDisplayValue ()
표시 높이와 표시폭의 계산에 사용되는 오브젝트인 「표시 prototype」치를 돌려줍니다. |
ListCellRenderer |
getRenderer ()
선택된 항목을 JComboBox 필드에서 표시하는데 사용되는 렌더링을 돌려줍니다. |
int |
getSelectedIndex ()
지정된 항목에 일치하는 리스트내의 최초의 항목을 돌려줍니다. |
Object |
getSelectedItem ()
현재 선택되고 있는 항목을 돌려줍니다. |
Object [] |
getSelectedObjects ()
선택되고 있는 항목을 포함한 배열을 돌려줍니다. |
ComboBoxUI |
getUI ()
이 컴퍼넌트를 표현 하는 L&F 오브젝트를 돌려줍니다. |
String |
getUIClassID ()
이 컴퍼넌트를 표현 하는 L&F 클래스의 이름을 돌려줍니다. |
void |
hidePopup ()
combobox에 pop-up 윈도우를 닫게 합니다. |
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 ()
pop-up의 가시성을 판정합니다. |
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 필드에서 paint 및 편집하기 위해서 사용되는 에디터를 설정합니다. |
void |
setEnabled (boolean b)
항목을 선택할 수 있게 combobox를 유효하게 합니다. |
void |
setKeySelectionManager (JComboBox.KeySelectionManager aManager)
키보드의 캐릭터를 리스트의 선택으로 변환하는 오브젝트를 설정합니다. |
void |
setLightWeightPopupEnabled (boolean aFlag)
lightWeightPopupEnabled 프로퍼티를 설정합니다. |
void |
setMaximumRowCount (int count)
JComboBox 가 표시하는 최대의 행수를 설정합니다. |
void |
setModel (ComboBoxModel aModel)
JComboBox 가 항목의 리스트를 취득하기 위해서 사용하는 데이터 모델을 설정합니다. |
void |
setPopupVisible (boolean v)
pop-up의 가시성을 설정합니다. |
void |
setPrototypeDisplayValue (Object prototypeDisplayValue)
UI 부분의 표시 사이즈 계산에 사용되는 표시 prototype치를 설정합니다. |
void |
setRenderer (ListCellRenderer aRenderer)
JComboBox 필드의 리스트로부터 선택된 리스트 항목과 항목을 paint 하는 렌더링을 설정합니다. |
void |
setSelectedIndex (int anIndex)
인덱스 anIndex 에 있는 항목을 선택합니다. |
void |
setSelectedItem (Object anObject)
combobox 표시 area의 선택된 항목을 인수의 오브젝트로 설정합니다. |
void |
setUI (ComboBoxUI ui)
이 컴퍼넌트를 표현 하는 L&F 오브젝트를 설정합니다. |
void |
showPopup ()
combobox에 pop-up 윈도우를 표시시킵니다. |
void |
updateUI ()
현재의 Look & Feel 로부터의 값으로 UI 프로퍼티를 리셋트 합니다. |
클래스 java.awt. Container 에서 상속받은 메소드 |
add , add , add , add , add , addContainerListener , addImpl , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setFocusCycleRoot , setFocusTraversalKeys , setFocusTraversalPolicy , setLayout , transferFocusBackward , transferFocusDownCycle , validate , validateTree |
클래스 java.lang. Object 에서 상속받은 메소드 |
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait |
필드의 상세 |
protected ComboBoxModel dataModel
getModel()
,
setModel(javax.swing.ComboBoxModel)
protected ListCellRenderer renderer
getRenderer()
,
setRenderer(javax.swing.ListCellRenderer)
protected ComboBoxEditor editor
getEditor()
,
setEditor(javax.swing.ComboBoxEditor)
protected int maximumRowCount
getMaximumRowCount()
,
setMaximumRowCount(int)
protected boolean isEditable
isEditable
,
setEditable(boolean)
protected JComboBox.KeySelectionManager keySelectionManager
setKeySelectionManager(javax.swing.JComboBox.KeySelectionManager)
,
getKeySelectionManager()
protected String actionCommand
setActionCommand(java.lang.String)
,
getActionCommand()
protected boolean lightWeightPopupEnabled
setLightWeightPopupEnabled(boolean)
,
isLightWeightPopupEnabled()
protected Object selectedItemReminder
생성자의 상세 |
public JComboBox(ComboBoxModel aModel)
ComboBoxModel
로부터 취득하는 JComboBox
를 생성합니다. ComboBoxModel
가 제공되기 (위해)때문에, 이 constructor를 사용해 생성된 combobox는 디폴트의 combobox 모델을 생성하지 않고 삽입, 삭제, 및 추가의 각 메소드의 동작 방법으로 강한 영향을 줍니다.
aModel
- 표시된 항목의 리스트를 제공하는 ComboBoxModel
DefaultComboBoxModel
public JComboBox(Object [] items)
JComboBox
를 생성합니다. 디폴트에서는 배열의 최초의 항목과 거기에 따르는 데이터 모델이 선택됩니다.
items
- combobox에 삽입하는 오브젝트의 배열DefaultComboBoxModel
public JComboBox(Vector items)
JComboBox
를 생성합니다. 디폴트에서는 벡터의 최초의 항목과 거기에 따르는 데이터 모델이 선택됩니다.
items
- combobox에 삽입하는 벡터의 배열DefaultComboBoxModel
public JComboBox()
JComboBox
를 생성합니다. 디폴트의 데이터 모델은 오브젝트의 하늘 리스트입니다. addItem
를 사용해 항목을 추가합니다. 디폴트에서는 데이터 모델의 최초의 항목이 선택됩니다.
DefaultComboBoxModel
메소드의 상세 |
protected void installAncestorListener()
public void setUI(ComboBoxUI ui)
ui
- ComboBoxUI
L&F 오브젝트UIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
JComponent
내의 updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
내의 getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public ComboBoxUI getUI()
public void setModel(ComboBoxModel aModel)
JComboBox
가 항목의 리스트를 취득하기 위해서 사용하는 데이터 모델을 설정합니다.
aModel
- 표시된 항목의 리스트를 제공하는 ComboBoxModel
public ComboBoxModel getModel()
JComboBox
에 의해 현재 사용되고 있는 데이터 모델을 돌려줍니다.
ComboBoxModel
public void setLightWeightPopupEnabled(boolean aFlag)
lightWeightPopupEnabled
프로퍼티를 설정합니다. 이 프로퍼티는 JComboBox
의 저장처로서 경량 Component
를 사용하는지 그렇지 않으면 Panel
나 Window
등의 중량 Component
를 사용할지 어떨지에 대한 힌트를 제공합니다. 어느 쪽을 사용할까를 결정하는 것은 최종적으로는 JComboBox
입니다. 경량 윈도우는 중량 윈도우보다 효율적입니다만, GUI 에서의 경량 컴퍼넌트와 중량 컴퍼넌트의 혼합은 너무 좋은 일이 아닙니다. 어플리케이션으로 양쪽 모두의 컴퍼넌트가 사용되고 있는 경우, 경량 pop-up를 무효화합니다. lightWeightPopupEnabled
프로퍼티의 디폴트 값은 Look & Feel 로 다른 값이 지정되어 있지 않으면 true
가 됩니다. 일부의 Look & Feel 에서는 이 프로퍼티의 값에 관계없이 항상 중량 pop-up가 사용됩니다.
The Swing Connection 의 Mixing Heavy and Light Components 를 참조해 주세요. 이 메소드는 프로퍼티 변경 이벤트를 방아쇠 합니다.
aFlag
- true
의 경우는 경량 pop-up가 요구됩니다. public boolean isLightWeightPopupEnabled()
lightWeightPopupEnabled
프로퍼티의 값을 돌려줍니다.
lightWeightPopupEnabled
프로퍼티의 값setLightWeightPopupEnabled(boolean)
public void setEditable(boolean aFlag)
JComboBox
필드가 편집 가능한가 어떤가를 지정합니다. 편집 가능한 JComboBox
에서는 유저는 필드에 입력하는지 또는 필드를 초기화하기 위해서 리스트로부터 항목을 선택할 수 있어 그 후에 그 항목을 편집할 수 있습니다. 편집은 필드에 대해서만 가능하고, 리스트 항목은 변경되지 않습니다. 편집이 불가능한 JComboBox
는 선택된 항목을 필드에 표시합니다만, 그 선택은 편집할 수 없습니다.
aFlag
- boolean 치. true 는 필드가 편집 가능한 것을 나타낸다public boolean isEditable()
JComboBox
가 편집 가능한 경우는 true 를 돌려줍니다. 디폴트에서는 combobox는 편집 불가입니다.
JComboBox
가 편집 가능한 경우는 true, 그렇지 않은 경우는 falsepublic void setMaximumRowCount(int count)
JComboBox
가 표시하는 최대의 행수를 설정합니다. 모델내의 오브젝트수가 count 보다 큰 경우는 combobox는 스크롤 바를 사용합니다.
count
- 스크롤 바를 사용하지 않고 리스트에 표시할 수 있는 최대의 항목수를 지정하는 정수치public int getMaximumRowCount()
public void setRenderer(ListCellRenderer aRenderer)
디폴트의 렌더링에서는 캐릭터 라인 또는 아이콘이 표시됩니다. 다른 렌더링에서는 그래픽 이미지와 복합 아이템을 사용할 수 있습니다.
선택된 항목을 표시하려면 , 리스트 오브젝트 및 인덱스 -1 를 건네주어 aRenderer.getListCellRendererComponent
를 호출합니다.
aRenderer
- 선택된 항목을 표시하는 ListCellRenderer
setEditor(javax.swing.ComboBoxEditor)
public ListCellRenderer getRenderer()
JComboBox
필드에서 표시하는데 사용되는 렌더링을 돌려줍니다.
ListCellRenderer
public void setEditor(ComboBoxEditor anEditor)
JComboBox
필드에서 paint 및 편집하기 위해서 사용되는 에디터를 설정합니다. 에디터는 받는 JComboBox
가 편집 가능한 경우만 사용됩니다. 편집할 수 없는 경우는 combobox는 렌더링을 사용해 선택된 항목을 표현 합니다.
anEditor
- 선택된 항목을 표시하는 ComboBoxEditor
setRenderer(javax.swing.ListCellRenderer)
public ComboBoxEditor getEditor()
JComboBox
필드에서 표현 및 편집하기 위해서 사용하는 에디터를 돌려줍니다.
ComboBoxEditor
public void setSelectedItem(Object anObject)
anObject
가 리스트에 있는 경우, 표시 area에는 선택된 anObject
를 표시합니다.
anObject
가 리스트에 없고 , combobox가 편집 불가의 경우, 현재의 선택은 변경되지 않습니다. combobox가 편집 가능한 경우, 선택은 anObject
로 변경됩니다.
이것에 의해 선택 항목이 변경되는 경우는 combobox에 추가되는 ItemListener
에, 1 kr 또는 2 개의 ItemEvent
가 통지됩니다. 현재 선택되고 있는 항목이 있는 경우,ItemEvent
가 방아쇠 되어 상태가 ItemEvent.DESELECTED
로 변경됩니다. anObject
가 리스트에 있어, 현재 선택되어 있지 않은 경우는 ItemEvent
가 방아쇠 되어 상태는 ItemEvent.SELECTED
로 변경됩니다.
combobox에 추가된 ActionListener
는 이 메소드가 불려 갈 때에 ActionEvent
로 통지됩니다.
anObject
- 선택하는 리스트 오브젝트. 선택을 클리어 하는 경우는 null
를 지정public Object getSelectedItem()
combobox가 편집 가능한 경우, 이 값은 addItem
,insertItemAt
, 또는 데이터 constructor 에서는 combobox에 추가되지 않습니다.
setSelectedItem(java.lang.Object)
public void setSelectedIndex(int anIndex)
anIndex
에 있는 항목을 선택합니다.
anIndex
- 선택하는 리스트 항목을 지정하는 정수치. 0 은 리스트내의 최초의 항목을 지정. -1 (은)는 선택하지 않는 것을 나타낸다
IllegalArgumentException
- anIndex
가 -1 보다 작은 경우, 혹은 anIndex
가 사이즈에 동일한가 그것보다 큰 경우public int getSelectedIndex()
JComboBox
가 리스트에 없는 항목의 선택을 허가하는 경우, 그 결과가 항상 정의된다고는 할 수 없습니다. 항목이 선택되어 있지 않은 경우, 또는 유저가 리스트에 없는 항목을 지정했을 경우는 -1 이 돌려주어집니다.
public Object getPrototypeDisplayValue()
prototypeDisplayValue
프로퍼티의 값setPrototypeDisplayValue(java.lang.Object)
public void setPrototypeDisplayValue(Object prototypeDisplayValue)
표시 prototype치가 지정되면(자), 그 값을 사용해 렌더링이 설정되어 combobox의 적절한 사이즈가 계산됩니다. combobox에 대량의 데이터가 표시되는 경우는 적절한 표시 사이즈치의 지정이 유효하게 됩니다. 표시 prototype치가 지정되어 있지 않은 경우, 렌더링으로 모델 마다 값을 지정해 적절 사이즈를 계산하지 않으면 안되어, 상대적으로 처리 스텝이 많아집니다.
prototypeDisplayValue
- getPrototypeDisplayValue()
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
- 리스트에 추가하는 ObjectMutableComboBoxModel
public void insertItemAt(Object anObject, int index)
JComboBox
가 가변 데이터 모델을 사용하는 경우에만 유효합니다.
anObject
- 리스트에 추가하는 Object
index
- 항목을 추가하는 위치를 지정하는 정수치MutableComboBoxModel
public void removeItem(Object anObject)
JComboBox
가 가변 데이터 모델을 사용하는 경우에만 유효합니다.
anObject
- 항목 리스트로부터 삭제하는 오브젝트MutableComboBoxModel
public void removeItemAt(int anIndex)
anIndex
위치의 항목을 삭제합니다. 이 메소드는 JComboBox
가 가변 데이터 모델을 사용하는 경우에만 유효합니다.
anIndex
- 삭제하는 항목의 인덱스를 지정하는 정수치. 0 은 리스트내의 최초의 항목을 나타내는MutableComboBoxModel
public void removeAllItems()
public void showPopup()
setPopupVisible(boolean)
public void hidePopup()
setPopupVisible(boolean)
public void setPopupVisible(boolean v)
public boolean isPopupVisible()
public void addItemListener(ItemListener aListener)
ItemListener
를 추가합니다.
aListener
는 선택한 항목이 변경되면(자) 1 kr 또는 2 개의 ItemEvent
를 수신합니다.
ItemSelectable
내의 addItemListener
aListener
- 통지되는 ItemListener
setSelectedItem(java.lang.Object)
public void removeItemListener(ItemListener aListener)
ItemListener
를 삭제합니다.
ItemSelectable
내의 removeItemListener
aListener
- 삭제되는 ItemListener
ItemEvent
public ItemListener [] getItemListeners()
ItemListener
의 배열을 돌려줍니다.
ItemListener
. 청취자가 추가되어 있지 않은 경우는 하늘의 배열public void addActionListener(ActionListener l)
ActionListener
를 추가합니다.
ActionListener
는 선택을 했을 때에 ActionEvent
를 수신합니다. combobox가 편집 가능한 경우는 편집이 정지되면(자) ActionEvent
가 방아쇠 됩니다.
l
- 통지되는 ActionListener
setSelectedItem(java.lang.Object)
public void removeActionListener(ActionListener l)
ActionListener
를 삭제합니다.
l
- 삭제되는 ActionListener
public ActionListener [] getActionListeners()
ActionListener
의 배열을 돌려줍니다.
ActionListener
. 청취자가 추가되어 있지 않은 경우는 하늘의 배열public void addPopupMenuListener(PopupMenuListener l)
PopupMenu
청취자를 추가합니다.
Java 2 의 모든 표준 Look & Feel 에서는 combobox의 pop-up 리스트 부분은 JPopupMenu
로서 구현됩니다. 커스텀 Look & Feel 에서는 구현 형태가 달라, 통지를 수신하지 않습니다.
l
- 추가하는 PopupMenuListener
public void removePopupMenuListener(PopupMenuListener l)
PopupMenuListener
를 삭제합니다.
l
- 삭제하는 PopupMenuListener
addPopupMenuListener(javax.swing.event.PopupMenuListener)
public PopupMenuListener [] getPopupMenuListeners()
PopupMenuListener
의 배열을 돌려줍니다.
PopupMenuListener
. 청취자가 추가되어 있지 않은 경우는 하늘의 배열public void firePopupMenuWillBecomeVisible()
PopupMenuListener
에 통지합니다.
이 메소드는 public 입니다만 UI delegate 이외로부터는 호출하지 말아 주세요.
addPopupMenuListener(javax.swing.event.PopupMenuListener)
public void firePopupMenuWillBecomeInvisible()
PopupMenuListener
에 통지합니다.
이 메소드는 public 입니다만 UI delegate 이외로부터는 호출하지 말아 주세요.
addPopupMenuListener(javax.swing.event.PopupMenuListener)
public void firePopupMenuCanceled()
PopupMenuListener
에 통지합니다.
이 메소드는 public 입니다만 UI delegate 이외로부터는 호출하지 말아 주세요.
addPopupMenuListener(javax.swing.event.PopupMenuListener)
public void setActionCommand(String aCommand)
aCommand
- 액션 청취자에게 보내지는 「커멘드」를 포함한 캐릭터 라인. 청취자는 수신하는 커멘드에 응해 다른 처리를 실행할 수 있다public String getActionCommand()
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
Action
,
getAction()
,
configurePropertiesFromAction(javax.swing.Action)
,
createActionPropertyChangeListener(javax.swing.Action)
public Action getAction()
ActionEvent
소스에 현재 설정되어 있는 Action
를 돌려줍니다. Action
가 설정되어 있지 않은 경우는 null
가 돌려주어집니다.
ActionEvent
소스의 Action
, 또는 null
Action
,
setAction(javax.swing.Action)
protected void configurePropertiesFromAction(Action a)
Action
인스턴스의 값에 따라 ActionEvent
소스의 프로퍼티를 설정하는 팩토리 메소드입니다. 설정되는 프로퍼티는 서브 클래스에 의해 다릅니다. 디폴트에서는 설정되는 프로퍼티는 Enabled
및 ToolTipText
입니다.
a
- 프로퍼티를 취득하는 Action
, 또는 null
Action
,
setAction(javax.swing.Action)
protected PropertyChangeListener createActionPropertyChangeListener(Action a)
Action
인스턴스를 변경했을 때에 ActionEvent
소스의 갱신에 사용하는 PropertyChangeListener
를 생성하는 팩토리 메소드입니다. 서브 클래스가 최신 상태로 보관 유지할 필요가 있는 프로퍼티세트가 디폴트 프로퍼티 (Text, Icon, Enabled, ToolTipText)와 다른 경우는 독자적인 PropertyChangeListener
를 제공하기 위해서 이 메소드를 오버라이드(override) 할 수 있습니다. PropertyChangeListeners
가 ActionEvent
소스에의 강참조를 보관 유지하지 않게 해 주세요. 강참조가 있는 경우,ActionEvent
소스와 그 포함 관계의 계층의 가베지 콜렉션을 방해할 가능성이 있습니다.
Action
,
setAction(javax.swing.Action)
protected void fireItemStateChanged(ItemEvent e)
e
- 대상의 이벤트EventListenerList
protected void fireActionEvent()
EventListenerList
protected void selectedItemChanged()
public Object [] getSelectedObjects()
ItemSelectable
와의 호환성을 위해서(때문에) 구현됩니다.
ItemSelectable
내의 getSelectedObjects
Object
의 배열public void actionPerformed(ActionEvent e)
ActionListener
내의 actionPerformed
public void contentsChanged(ListDataEvent e)
ListDataListener
내의 contentsChanged
e
- 이벤트 정보를 캡슐화하는 ListDataEvent
public void intervalAdded(ListDataEvent e)
ListDataListener
내의 intervalAdded
e
- 이벤트 정보를 캡슐화하는 ListDataEvent
public void intervalRemoved(ListDataEvent e)
ListDataListener
내의 intervalRemoved
e
- 이벤트 정보를 캡슐화하는 ListDataEvent
public boolean selectWithKeyChar(char keyChar)
keyChar
- 캐릭터. 통상은 유저가 누른 키보드의 키public void setEnabled(boolean b)
JComponent
내의 setEnabled
b
- boolean 치. true 의 경우는 컴퍼넌트는 사용 가능해, false 의 경우는 사용 불가Component.isEnabled()
,
Component.isLightweight()
public void configureEditor(ComboBoxEditor anEditor, Object anItem)
anEditor
- combobox의 필드에 리스트 항목을 표시해, 그 편집을 가능하게 하는 ComboBoxEditor
anItem
- 필드에서 표시 및 편집을 실시하는 오브젝트public void processKeyEvent(KeyEvent e)
KeyEvent
를 처리합니다. Tab 키가 발견되면(자), pop-up 윈도우가 닫습니다.
JComponent
내의 processKeyEvent
e
- 밀린 키보드의 키를 포함한 KeyEvent
KeyEvent
,
KeyListener
,
Component.addKeyListener(java.awt.event.KeyListener)
,
Component.enableEvents(long)
,
Component.isShowing()
public void setKeySelectionManager(JComboBox.KeySelectionManager aManager)
public JComboBox.KeySelectionManager getKeySelectionManager()
KeySelectionManager
public int getItemCount()
public Object getItemAt(int index)
index
가 범위외의 경우, 즉 제로보다 작은지 사이즈 이상의 경우는 null
를 돌려줍니다.
index
- 리스트 위치를 나타내는 정수치. 최초의 항목은 제로로 시작된다
Object
. 범위외의 경우는 null
protected JComboBox.KeySelectionManager createDefaultKeySelectionManager()
KeySelectionManager
setKeySelectionManager(javax.swing.JComboBox.KeySelectionManager)
protected String paramString()
JComboBox
의 캐릭터 라인 표현을 돌려줍니다. 이 메소드는 디버그 전용이며, 돌려주어지는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 돌려주어지는 캐릭터 라인은 비었을 경우가 있습니다만,null
로는 되지 않습니다.
JComponent
내의 paramString
JComboBox
의 캐릭터 라인 표현public AccessibleContext getAccessibleContext()
Accessible
내의 getAccessibleContext
JComponent
내의 getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 모든 클래스 | ||||||||||
개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 |
Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.