|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 모든 클래스 | ||||||||||
개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 |
java.lang.Object | +--java.awt.Component | +--java.awt.List
List
컴퍼넌트는 텍스트 항목의 스크롤 리스트를 유저에 대해서 표시합니다. 리스트는 1 kr 또는 복수의 항목을 선택할 수 있게 설정할 수 있습니다.
예를 나타냅니다. 코드 . . .
List lst = new List(4, false); lst.add("Mercury"); lst.add("Venus"); lst.add("Earth"); lst.add("JavaSoft"); lst.add("Mars"); lst.add("Jupiter"); lst.add("Saturn"); lst.add("Uranus"); lst.add("Neptune"); lst.add("Pluto"); cnt.add(lst);
컨테이너가 cnt
의 경우는 다음의 스크롤 리스트를 작성합니다.
선택되어 있지 않은 항목을 클릭하면(자) 선택되어 선택 끝난 항목을 클릭하면(자) 선택 해제됩니다. 상기의 예에서는 새로운 스크롤 리스트를 작성할 때의 2 번째의 인수가 false
이므로, 동시에 선택할 수 있는 항목은 1 개 뿐입니다. 어느 항목을 선택하면(자), 그 밖에 선택 끝난 항목이 있으면 자동적으로 선택 해제됩니다.
이 예에 나타나는 리스트는 가시의 4 행으로 작성되었던 것에 주의해 주세요. 리스트가 작성되면(자), 표시행의 수는 변경할 수 없습니다. 디폴트의 List
는 lst = new List()
가 list = new List(4, false)
와 동등하게 되도록(듯이) 4 행으로 작성됩니다.
Java 1. 1 으로부터, Abstract Window Toolkit (AWT)는 List
오브젝트에 거기서 발생하는 모든 마우스, 키보드, 포커스 이벤트를 보냅니다. 하위 호환성을 위해서(때문에) 낡은 AWT 이벤트 모델이 보관 유지되고 있습니다만, 그것을 사용하는 것은 추천 되지 않습니다.
유저에 의해 항목이 선택 또는 선택 해제될 때는 AWT 는 ItemEvent
의 인스턴스를 리스트에 보냅니다. 유저가 스크롤 리스트의 항목을 더블 클릭 하면(자), AWT 는 항목 이벤트에 이어 ActionEvent
의 인스턴스를 리스트에 보냅니다. AWT 는 동시에, 리스트내의 항목이 선택되고 있는 동안에 Return 키가 밀리면(자) 액션 이벤트를 생성합니다.
유저가 선택했는지 또는 액티브화한 이 리스트내의 항목에 근거해 어플리케이션이 특정의 액션을 실행하려고 하는 경우는 ItemListener
또는 ActionListener
를 필요에 따라서 구현해, 이 리스트로부터 이벤트를 받는 새로운 청취자를 등록합니다.
복수 선택의 스크롤 리스트에서는 그것은 외부의 제스추어 (버튼의 클릭등)를 사용해 액션을 방아쇠 하는데 최적인 유저 인터페이스라고 보여집니다.
ItemEvent
,
ItemListener
,
ActionEvent
,
ActionListener
,
직렬화 된 형식 중첩된 클래스의 개요 | |
protected class |
List.AccessibleAWTList
이 클래스는 List 클래스용의 유저 보조 기능의 서포트를 구현하고 있습니다. |
클래스 java.awt. Component 을 상속받은 중첩된 클래스 |
Component.BltBufferStrategy , Component.FlipBufferStrategy |
필드의 개요 |
클래스 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 |
생성자의 개요 | |
List ()
새로운 스크롤 리스트를 작성합니다. |
|
List (int rows)
지정된 표시행의 수에 의해 초기화된 새로운 스크롤 리스트를 작성합니다. |
|
List (int rows,
boolean multipleMode)
지정된 행수를 표시하도록(듯이) 초기화된 새로운 스크롤 리스트를 작성합니다. |
메소드의 개요 | |
void |
add (String item)
지정된 항목을 스크롤 리스트의 말미에 추가합니다. |
void |
add (String item,
int index)
지정된 항목을, 인덱스로 지정된 위치에서 스크롤 리스트에 추가합니다. |
void |
addActionListener (ActionListener l)
이 리스트로부터 액션 이벤트를 받기 위해서(때문에), 지정된 액션 청취자를 추가합니다. |
void |
addItem (String item)
추천 되고 있지 않습니다. add(String) 를 사용 |
void |
addItem (String item,
int index)
추천 되고 있지 않습니다. add(String, int) 를 사용 |
void |
addItemListener (ItemListener l)
지정된 항목 청취자를 추가해, 리스트로부터 항목 이벤트를 받습니다. |
void |
addNotify ()
리스트의 피어를 작성합니다. |
boolean |
allowsMultipleSelections ()
추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 isMultipleMode() 를 사용 |
void |
clear ()
추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 removeAll() 를 사용 |
int |
countItems ()
추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getItemCount() 를 사용 |
void |
delItem (int position)
추천 되고 있지 않습니다. remove(String) 및 remove(int) 를 사용 |
void |
delItems (int start,
int end)
추천 되고 있지 않습니다. JDK 버젼 1.1 의 시점에서는 장래적으로 일반 이용될 예정은 없습니다. 이 메소드는 패키지 private 메소드로서만 보관 유지될 예정입니다. |
void |
deselect (int index)
지정된 인덱스에 있는 항목을 선택 해제합니다. |
AccessibleContext |
getAccessibleContext ()
이 List 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다. |
ActionListener [] |
getActionListeners ()
이 리스트에 등록된 모든 액션 청취자의 배열을 돌려줍니다. |
String |
getItem (int index)
지정하는 인덱스에 대응하는 항목을 돌려줍니다. |
int |
getItemCount ()
리스트내의 항목의 수를 돌려줍니다. |
ItemListener [] |
getItemListeners ()
이 리스트에 등록된 모든 항목 청취자의 배열을 돌려줍니다. |
String [] |
getItems ()
리스트내의 항목을 돌려줍니다. |
EventListener [] |
getListeners (Class listenerType)
이 List 에 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다. |
Dimension |
getMinimumSize ()
이 스크롤 리스트의 최소 사이즈를 지정합니다. |
Dimension |
getMinimumSize (int rows)
지정된 행수를 가지는 리스트의 최소 치수를 돌려줍니다. |
Dimension |
getPreferredSize ()
이 스크롤 리스트의 추천 사이즈를 돌려줍니다. |
Dimension |
getPreferredSize (int rows)
지정된 행수를 가지는 리스트의 추천 치수를 돌려줍니다. |
int |
getRows ()
리스트의 표시행의 수를 돌려줍니다. |
int |
getSelectedIndex ()
리스트로 선택되고 있는 항목의 인덱스를 돌려줍니다. |
int[] |
getSelectedIndexes ()
리스트로 선택되고 있는 인덱스를 돌려줍니다. |
String |
getSelectedItem ()
이 스크롤 리스트로 선택되고 있는 항목을 돌려줍니다. |
String [] |
getSelectedItems ()
이 스크롤 리스트로 선택되고 있는 항목을 돌려줍니다. |
Object [] |
getSelectedObjects ()
리스트중의 선택되고 있는 항목을 오브젝트의 배열로 돌려줍니다. |
int |
getVisibleIndex ()
makeVisible 메소드에 의해 마지막에 표시된 항목의 인덱스를 돌려줍니다. |
boolean |
isIndexSelected (int index)
이 스크롤 리스트로 지정된 항목이 선택되고 있는지 어떤지를 판정합니다. |
boolean |
isMultipleMode ()
이 리스트가 복수 선택을 허락할지 어떨지를 판정합니다. |
boolean |
isSelected (int index)
추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 isIndexSelected(int) 를 사용 |
void |
makeVisible (int index)
지정된 인덱스에 있는 항목을 표시시킵니다. |
Dimension |
minimumSize ()
추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getMinimumSize() 를 사용 |
Dimension |
minimumSize (int rows)
추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getMinimumSize(int) 를 사용 |
protected String |
paramString ()
이 스크롤 리스트 상태를 표현하고 있는 파라미터 캐릭터 라인을 돌려줍니다. |
Dimension |
preferredSize ()
추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getPreferredSize() 를 사용 |
Dimension |
preferredSize (int rows)
추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getPreferredSize(int) 를 사용 |
protected void |
processActionEvent (ActionEvent e)
이 컴퍼넌트로 발생하는 액션 이벤트를, 등록된 ActionListener 오브젝트에 디스팟치 하는 것으로써, 액션 이벤트를 처리합니다.
|
protected void |
processEvent (AWTEvent e)
이 스크롤 리스트의 이벤트를 처리합니다. |
protected void |
processItemEvent (ItemEvent e)
이 리스트로 발생하는 항목 이벤트를, 등록된 ItemListener 오브젝트에 디스팟치 하는 것으로써, 항목 이벤트를 처리합니다.
|
void |
remove (int position)
지정된 위치에 있는 항목을 이 스크롤 리스트로부터 삭제합니다. |
void |
remove (String item)
리스트중의 같은 항목의 쳐 최초로 출현한 것을 삭제합니다. |
void |
removeActionListener (ActionListener l)
지정된 액션 청취자를 삭제해, 그것이 이 리스트로부터 액션 이벤트를 받지 않게 합니다. |
void |
removeAll ()
이 리스트로부터 모든 항목을 삭제합니다. |
void |
removeItemListener (ItemListener l)
지정된 항목 청취자를 삭제해, 그것이 이 리스트로부터 항목 이벤트를 받지 않게 합니다. |
void |
removeNotify ()
이 리스트의 피어를 삭제합니다. |
void |
replaceItem (String newValue,
int index)
스크롤 리스트내의 지정된 인덱스에 있는 항목을 새로운 캐릭터 라인으로 옮겨놓습니다. |
void |
select (int index)
스크롤 리스트의 지정된 인덱스에 있는 항목을 선택합니다. |
void |
setMultipleMode (boolean b)
이 리스트가 복수 선택을 허락할지 어떨지를 판정하는 플래그를 설정합니다. |
void |
setMultipleSelections (boolean b)
추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 setMultipleMode(boolean) 를 사용 |
클래스 java.lang. Object 에서 상속받은 메소드 |
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait |
생성자의 상세 |
public List() throws HeadlessException
List(0, false)
의 간이 메소드인 것에 주의해 냄새가 나다. 또, 리스트에 표시되는 행수는 작성 후로 변경할 수 없는 것도 주의해 주세요.
HeadlessException
- GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우GraphicsEnvironment.isHeadless()
public List(int rows) throws HeadlessException
List(rows, false)
의 간이 메소드인 것에 주의해 냄새가 나다. 또, 리스트에 표시되는 행수는 작성 후로 변경할 수 없는 것도 주의해 주세요.
rows
- 표시되는 항목의 수
HeadlessException
- GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우GraphicsEnvironment.isHeadless()
public List(int rows, boolean multipleMode) throws HeadlessException
multipleMode
의 값이 true
의 경우, 유저는 리스트로부터 복수의 항목을 선택할 수 있습니다. false
의 경우, 한 번에 1 항목만 선택할 수 있습니다.
rows
- 표시되는 항목의 수multipleMode
- true
의 경우는 복수 선택이 가능, 그렇지 않은 경우는 선택할 수 있는 항목수는 한 번에 1 kr만
HeadlessException
- GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우GraphicsEnvironment.isHeadless()
메소드의 상세 |
public void addNotify()
Component
내의 addNotify
Component.isDisplayable()
,
Component.removeNotify()
public void removeNotify()
Component
내의 removeNotify
Component.isDisplayable()
,
Component.addNotify()
public int getItemCount()
getItem(int)
public int countItems()
getItemCount()
를 사용
public String getItem(int index)
index
- 항목의 위치
getItemCount()
public String [] getItems()
select(int)
,
deselect(int)
,
isIndexSelected(int)
public void add(String item)
item
- 추가되는 항목public void addItem(String item)
add(String)
를 사용
public void add(String item, int index)
item
- 추가되는 항목. 이 파라미터가 null
의 경우, 항목은 하늘의 캐릭터 라인 ""
으로서 처리되는index
- 항목을 추가하는 위치public void addItem(String item, int index)
add(String, int)
를 사용
public void replaceItem(String newValue, int index)
newValue
- 기존의 항목을 옮겨놓는 새로운 캐릭터 라인index
- 옮겨놓는 항목의 위치
ArrayIndexOutOfBoundsException
- index
가 범위외에 있는 경우public void removeAll()
remove(java.lang.String)
,
delItems(int, int)
public void clear()
removeAll()
를 사용
public void remove(String item)
item
- 리스트로부터 삭제되는 항목
IllegalArgumentException
- 그 항목이 리스트에 존재하지 않는 경우public void remove(int position)
position
- 삭제되는 항목의 인덱스
ArrayIndexOutOfBoundsException
- position
가 0 보다 작은지 getItemCount()-1
보다 큰 경우add(String, int)
public void delItem(int position)
remove(String)
및 remove(int)
를 사용
public int getSelectedIndex()
-1
select(int)
,
deselect(int)
,
isIndexSelected(int)
public int[] getSelectedIndexes()
select(int)
,
deselect(int)
,
isIndexSelected(int)
public String getSelectedItem()
null
select(int)
,
deselect(int)
,
isIndexSelected(int)
public String [] getSelectedItems()
select(int)
,
deselect(int)
,
isIndexSelected(int)
public Object [] getSelectedObjects()
ItemSelectable
내의 getSelectedObjects
ItemSelectable
public void select(int index)
이 메소드는 주로 이 컴퍼넌트내의 항목을 초기 상태로 선택하기 위해서 사용됩니다. 이 메소드를 프로그램에 의해 호출하는 경우는 ItemEvent
를 방아쇠 하지 않습니다. ItemEvent
를 방아쇠 하는 유일한 방법은 유저의 조작입니다.
index
- 선택하는 항목의 위치getSelectedItem()
,
deselect(int)
,
isIndexSelected(int)
public void deselect(int index)
지정된 인덱스에 있는 항목이 선택되어 있지 않은 경우나, 인덱스가 범위외에 있는 경우에는 조작은 무시됩니다.
index
- 선택을 해제하는 항목의 위치select(int)
,
getSelectedItem()
,
isIndexSelected(int)
public boolean isIndexSelected(int index)
index
- 체크 대상의 항목
true
, 그렇지 않은 경우는 false
select(int)
,
deselect(int)
public boolean isSelected(int index)
isIndexSelected(int)
를 사용
public int getRows()
List
가 작성되면(자), 이 수는 변경할 수 없는 것에 주의해 주세요.
public boolean isMultipleMode()
true
, 그렇지 않은 경우는 false
setMultipleMode(boolean)
public boolean allowsMultipleSelections()
isMultipleMode()
를 사용
public void setMultipleMode(boolean b)
b
- 복수 선택이 용서되는 경우는 true
, 그렇지 않은 경우는 리스트로부터 동시에 선택할 수 있는 항목은 1 개만isMultipleMode()
public void setMultipleSelections(boolean b)
setMultipleMode(boolean)
를 사용
public int getVisibleIndex()
makeVisible
메소드에 의해 마지막에 표시된 항목의 인덱스를 돌려줍니다.
makeVisible(int)
public void makeVisible(int index)
index
- 항목의 위치getVisibleIndex()
public Dimension getPreferredSize(int rows)
rows
- 리스트의 행수
Component.getPreferredSize()
public Dimension preferredSize(int rows)
getPreferredSize(int)
를 사용
public Dimension getPreferredSize()
Component
내의 getPreferredSize
Component.getPreferredSize()
public Dimension preferredSize()
getPreferredSize()
를 사용
Component
내의 preferredSize
public Dimension getMinimumSize(int rows)
rows
- 리스트의 행수
Component.getMinimumSize()
public Dimension minimumSize(int rows)
getMinimumSize(int)
를 사용
public Dimension getMinimumSize()
Component
내의 getMinimumSize
Component.getMinimumSize()
public Dimension minimumSize()
getMinimumSize()
를 사용
Component
내의 minimumSize
public void addItemListener(ItemListener l)
select
또는 deselect
의 호출에는 응답하지 않습니다. 청취자 l
가 null
의 경우, 예외는 슬로우 되지 않고 처리도 실행되지 않습니다.
ItemSelectable
내의 addItemListener
l
- 항목 청취자removeItemListener(java.awt.event.ItemListener)
,
getItemListeners()
,
select(int)
,
deselect(int)
,
ItemEvent
,
ItemListener
public void removeItemListener(ItemListener l)
l
가 null
의 경우, 예외는 슬로우 되지 않고 처리도 실행되지 않습니다.
ItemSelectable
내의 removeItemListener
l
- 항목 청취자addItemListener(java.awt.event.ItemListener)
,
getItemListeners()
,
ItemEvent
,
ItemListener
public ItemListener [] getItemListeners()
ItemListener
, 또는 현재 항목 청취자가 등록되지 않은 경우는 하늘의 배열addItemListener(java.awt.event.ItemListener)
,
removeItemListener(java.awt.event.ItemListener)
,
ItemEvent
,
ItemListener
public void addActionListener(ActionListener l)
l
가 null
의 경우, 예외는 슬로우 되지 않고 처리도 실행되지 않습니다.
l
- 액션 청취자removeActionListener(java.awt.event.ActionListener)
,
getActionListeners()
,
ActionEvent
,
ActionListener
public void removeActionListener(ActionListener l)
l
가 null
의 경우, 예외는 슬로우 되지 않고 처리도 실행되지 않습니다.
l
- 액션 청취자addActionListener(java.awt.event.ActionListener)
,
getActionListeners()
,
ActionEvent
,
ActionListener
public ActionListener [] getActionListeners()
ActionListener
, 또는 현재 액션 청취자가 등록되지 않은 경우는 하늘의 배열addActionListener(java.awt.event.ActionListener)
,
removeActionListener(java.awt.event.ActionListener)
,
ActionEvent
,
ActionListener
public EventListener [] getListeners(Class listenerType)
List
에 FooListener
로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다. FooListener
는 addFooListener
메소드를 사용해 등록됩니다.
FooListener.class
등의 클래스 리터럴을 가지는 listenerType
인수를 지정할 수 있습니다. 예를 들어, 다음의 코드를 사용해, 그 항목 청취자의 List
l
를 조회할 수 있습니다.
ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));이러한 청취자가 존재하지 않는 경우, 이 메소드는 하늘의 배열을 돌려줍니다.
Component
내의 getListeners
listenerType
- 요구된 청취자의 형태. 이 파라미터는 java.util.EventListener
로부터 파생하는 인터페이스를 지정한다
FooListener
로서 등록된 모든 오브젝트의 배열, 또는 이러한 청취자가 추가되지 않았던 경우는 하늘의 배열
ClassCastException
- listenerType
가,java.util.EventListener
를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우getItemListeners()
protected void processEvent(AWTEvent e)
ItemEvent
의 인스턴스의 경우는 processItemEvent
메소드를 호출합니다. 이벤트가 ActionEvent
의 인스턴스의 경우는 processActionEvent
를 호출합니다. 이벤트가 항목 이벤트나 액션 이벤트가 아닌 경우는 슈퍼 클래스에서 processEvent
를 호출합니다.
이벤트 파라미터가 null
의 경우, 동작이 지정되지 않고 예외가 발생하는 것에 주의해 주세요.
Component
내의 processEvent
e
- 이벤트ActionEvent
,
ItemEvent
,
processActionEvent(java.awt.event.ActionEvent)
,
processItemEvent(java.awt.event.ItemEvent)
protected void processItemEvent(ItemEvent e)
ItemListener
오브젝트에 디스팟치 하는 것으로써, 항목 이벤트를 처리합니다.
항목 이벤트가 이 컴퍼넌트용으로 사용 가능하게 되지 않은 한, 이 메소드는 불려 가지 않습니다. 항목 이벤트는 이하의 항목의 1 개가 발생했을 때에 사용 가능하게 됩니다.
ItemListener
오브젝트가 addItemListener
를 사용해 등록된다
enableEvents
에 의해 항목 이벤트가 사용 가능하게 되어 있다
이벤트 파라미터가 null
의 경우, 동작이 지정되지 않고 예외가 발생하는 것에 주의해 주세요.
e
- 항목 이벤트ItemEvent
,
ItemListener
,
addItemListener(java.awt.event.ItemListener)
,
Component.enableEvents(long)
protected void processActionEvent(ActionEvent e)
ActionListener
오브젝트에 디스팟치 하는 것으로써, 액션 이벤트를 처리합니다.
이 컴퍼넌트에 대해서 액션 이벤트가 사용 가능하지 않은 한, 이 메소드는 불려 가지 않습니다. 액션 이벤트는 다음의 어느 쪽인가의 경우에 사용 가능하게 됩니다.
ActionListener
오브젝트가 addActionListener
에 의해 등록되어 있다
enableEvents
에 의해 액션 이벤트가 사용 가능하게 되어 있다
이벤트 파라미터가 null
의 경우, 동작이 지정되지 않고 예외가 발생하는 것에 주의해 주세요.
e
- 액션 이벤트ActionEvent
,
ActionListener
,
addActionListener(java.awt.event.ActionListener)
,
Component.enableEvents(long)
protected String paramString()
Component
내의 paramString
public void delItems(int start, int end)
public AccessibleContext getAccessibleContext()
List
에 관련지을 수 있었던 AccessibleContext
를 돌려줍니다. 리스트의 경우,AccessibleContext
는 AccessibleAWTList
의 형식을 취합니다. 필요에 따라서, 새로운 AccessibleAWTList
인스턴스가 작성됩니다.
Accessible
내의 getAccessibleContext
Component
내의 getAccessibleContext
List
의 AccessibleContext
로서 기능하는 AccessibleAWTList
|
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.