|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
java.lang.Objectjava.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JComboBox
public class JComboBox
버튼, 또는 편집 가능 필드와 드롭 다운 리스트를 조합한 컴퍼넌트입니다. 사용자는 요구에 응해 표시되는 드롭 다운 리스트로부터 값을 선택할 수 있습니다. combobox를 편집 가능하게 하면(자), 편집 가능한 필드를 가지게 되어, 사용자가 값을 자유롭게 입력할 수 있게 됩니다.
경고: Swing 는 thread에 대해서 안전하지는 않습니다. 자세한 것은,「Swing's Threading Policy」를 참조해 주세요.
경고: 이 클래스의 직렬화 된 객체는, 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 지원는, 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK Version 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.BaselineResizeBehavior , 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 가 되어 있습니다만, 이것은 구현의 부작용에 의하는 것입니다. |
protected void |
actionPropertyChanged (Action action,
String propertyName)
관련 액션의 프로퍼티의 변경에 응해 combobox 상태를 갱신합니다. |
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 의 프로퍼티에 일치하도록(듯이), 이 combobox에 프로퍼티을 설정합니다. |
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 ()
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 필드에서 draw 및 편집하기 위해서 사용하는 에디터를 돌려줍니다. |
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 ()
이 컴퍼넌트를 draw 하는 L&F 객체를 돌려줍니다. |
String |
getUIClassID ()
이 컴퍼넌트를 draw 하는 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 필드에서 페인트 및 편집하기 위해서 사용되는 에디터를 설정합니다. |
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 필드의 리스트로부터 선택된 리스트 항목과 항목을 페인트 하는 렌더링을 설정합니다. |
void |
setSelectedIndex (int anIndex)
인덱스 anIndex 에 있는 항목을 선택합니다. |
void |
setSelectedItem (Object anObject)
combobox 표시 영역의 선택된 항목을 인수의 객체로 설정합니다. |
void |
setUI (ComboBoxUI ui)
이 컴퍼넌트를 draw 하는 L&F 객체를 설정합니다. |
void |
showPopup ()
combobox에 pop-up 윈도우를 표시시킵니다. |
void |
updateUI ()
현재의 Look & Feel 로부터의 값에 UI 프로퍼티을 리셋 합니다. |
클래스 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
가 제공되기 (위해)때문에, 이 생성자 을 사용해 생성된 combobox는, 디폴트의 combobox 모델을 생성하지 않고, 삽입, 삭제, 및 추가의 각 메소드의 동작 방법으로 강한 영향을 줍니다.
aModel
- 표시된 항목의 리스트를 제공하는 ComboBoxModel
DefaultComboBoxModel
public JComboBox(Object [] items)
JComboBox
를 생성합니다. 디폴트에서는, 배열의 최초의 항목과 거기에 따르는 데이터 모델이 선택됩니다.
items
- combobox에 삽입하는 객체의 배열DefaultComboBoxModel
public JComboBox(Vector <? > items)
JComboBox
를 생성합니다. 디폴트에서는, 벡터의 최초의 항목과 거기에 따르는 데이터 모델이 선택됩니다.
items
- combobox에 삽입하는 벡터의 배열DefaultComboBoxModel
public JComboBox()
JComboBox
를 생성합니다. 디폴트의 데이터 모델은, 객체의 빈 상태(empty) 리스트입니다. 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
필드에서 페인트 및 편집하기 위해서 사용되는 에디터를 설정합니다. 에디터는, 받는 JComboBox
가 편집 가능한 경우만 사용됩니다. 편집할 수 없는 경우는, combobox는 렌더링을 사용해 선택된 항목을 draw 합니다.
anEditor
- 선택된 항목을 표시하는 ComboBoxEditor
setRenderer(javax.swing.ListCellRenderer)
public ComboBoxEditor getEditor()
JComboBox
필드에서 draw 및 편집하기 위해서 사용하는 에디터를 돌려줍니다.
ComboBoxEditor
public void setSelectedItem(Object anObject)
anObject
가 리스트에 있는 경우, 표시 영역에는 선택된 anObject
를 표시합니다.
anObject
가 리스트에 없고, combobox가 편집 불가의 경우, 현재의 선택은 변경되지 않습니다. combobox가 편집 가능한 경우, 선택은 anObject
로 변경됩니다.
이것에 의해 선택 항목이 변경되는 경우는, combobox에 추가되는 ItemListener
에, 1 개(살) 또는 2 개의 ItemEvent
가 통지됩니다. 현재 선택되고 있는 항목이 있는 경우,ItemEvent
가 트리거되어 상태가 ItemEvent.DESELECTED
로 변경됩니다. anObject
가 리스트에 있어, 현재 선택되어 있지 않은 경우는,ItemEvent
가 트리거되어 상태는 ItemEvent.SELECTED
로 변경됩니다.
combobox에 추가된 ActionListener
는, 이 메소드가 불려 갈 때에 ActionEvent
로 통지됩니다.
anObject
- 선택하는 리스트 객체. 선택을 클리어 하는 경우는 null
를 지정public Object getSelectedItem()
combobox가 편집 가능한 경우, 이 값은 addItem
,insertItemAt
, 또는 데이터 생성자 에서는 combobox에 추가되지 않습니다.
setSelectedItem(java.lang.Object)
public void setSelectedIndex(int anIndex)
anIndex
에 있는 항목을 선택합니다.
anIndex
- 선택하는 리스트 항목을 지정하는 정수치.
0 은 리스트내의 최초의 항목을 지정.
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 개(살) 또는 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
. 청취자가 추가되어 있지 않은 경우는
빈 상태(empty)의 배열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
. 청취자가 추가되어 있지 않은 경우는
빈 상태(empty)의 배열public void addPopupMenuListener(PopupMenuListener l)
PopupMenu
청취자를 추가합니다.
Java 의 모든 표준 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
, 청취자가 추가되어 있지 않은 경우는
빈 상태(empty)의 배열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
와 옮겨집니다만,addActionListener
로 독립해 추가된 ActionListener
에는 영향을 주지 않습니다. Action
가 벌써 ActionEvent
소스에 벌써 등록되어 있는 ActionListener
인 경우는, 재등록되지 않습니다.
Action
를 설정하면(자),「Action
를 지원하는 Swing 컴퍼넌트」로 설명 떠날 수 있어 모든 프로퍼티이 즉시 변경됩니다. 계속되어,Action
의 프로퍼티의 변경에 맞추어, combobox의 프로퍼티이 자동적으로 갱신됩니다.
이 메소드는,Action
의 프로퍼티치를 설정해, 추적하기 위해서, 다른 3 개의 메소드를 사용합니다. combobox의 프로퍼티을 즉시 변경하기 위해서는,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
, 또는 null
Action
,
setAction(javax.swing.Action)
protected void configurePropertiesFromAction(Action a)
Action
의 프로퍼티에 일치하도록(듯이), 이 combobox에 프로퍼티을 설정합니다. 이것에 의해 설정되는 프로퍼티의 자세한 것은,「Action
를 지원하는 Swing 컴퍼넌트」를 참조해 주세요.
a
- 프로퍼티을 취득하는 Action
, 또는 null
Action
,
setAction(javax.swing.Action)
protected PropertyChangeListener createActionPropertyChangeListener(Action a)
Action
로부터의 변경을 대기해, 적절한 프로퍼티을 갱신하는 PropertyChangeListener
를 작성해, 돌려줍니다.
경고: 이것을 서브 클래스화하는 경우, 익명의 내부 클래스는 작성하지 말아 주세요. 작성하면(자), combobox의 수명이 Action
의 수명에 구속됩니다.
a
- combobox의 액션Action
,
setAction(javax.swing.Action)
protected void actionPropertyChanged(Action action, String propertyName)
createActionPropertyChangeListener
로부터 반환되는 PropertyChangeListener
로부터 불려 갑니다. 서브 클래스는, 일반적으로, 이것을 호출할 필요는 없습니다. 추가의 Action
프로퍼티을 지원하는 서브 클래스는, 이것과 configurePropertiesFromAction
를 오버라이드(override) 할 것입니다.
이 메소드에 의해 설정되는 프로퍼티의 리스트는,「Action
를 지원하는 Swing 컴퍼넌트」의 겉(표)를 참조해 주세요.
action
- 이 combobox에 관련지을 수 있었던 Action
propertyName
- 변경된 프로퍼티의 이름Action
,
configurePropertiesFromAction(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
,
KeyboardFocusManager
,
DefaultKeyboardFocusManager
,
Component.processEvent(java.awt.AWTEvent)
,
Component.dispatchEvent(java.awt.AWTEvent)
,
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
의 캐릭터 라인 표현을 돌려줍니다. 이 메소드는 디버그 전용이며, 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,null
로는 되지 않습니다.
JComponent
내의 paramString
JComboBox
의 캐릭터 라인 표현public AccessibleContext getAccessibleContext()
Accessible
내의 getAccessibleContext
JComponent
내의 getAccessibleContext
|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.