java.awt
클래스 List

java.lang.Object 
  java.awt.Component 
      java.awt.List

모든 구현된 인터페이스:

ImageObserver , ItemSelectable , MenuContainer , Serializable , Accessible

public class List
extends Component 
implements ItemSelectable , Accessible 

List 컴퍼넌트는, 텍스트 항목의 스크롤 리스트를 사용자에 대해서 표시합니다. 리스트는, 1 개(살) 또는 복수의 항목을 선택할 수 있도록(듯이) 설정할 수 있습니다.

예를 나타냅니다.

 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 의 경우는, 다음의 스크롤 리스트를 작성합니다.

List 가 복수 선택을 허가하는 경우에, 벌써 선택되고 있는 항목을 클릭하면(자), 선택이 해제됩니다. 전의 예에서는, 새로운 스크롤 리스트의 작성시에 2 번째의 인수가 false 이기 (위해)때문에, 스크롤 리스트로부터 한 번에 선택할 수 있는 항목은 1 개에 한정됩니다. List 가 복수 선택을 허가하지 않는 경우, 항목을 선택하면(자), 다른 선택된 항목의 선택이 해제됩니다.

이 예에 나타나는 리스트는, 가시의 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 를 필요에 따라서 구현해, 이 리스트로부터 이벤트를 받는 새로운 청취자를 등록합니다.

복수 선택의 스크롤 리스트에서는, 그것은 외부의 제스처(gesture) (버튼의 클릭등)를 사용해 액션을 트리거하는데 최적인 사용자 인터페이스라고 보여집니다.

도입된 버젼:

JDK1. 0

관련 항목:

ItemEvent , ItemListener , ActionEvent , ActionListener , 직렬화 된 형식

상자의 클래스의 개요

protected class

List.AccessibleAWTList 이 클래스는 List 클래스용의 접근성?의 지원를 구현하고 있습니다.

클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스

Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , 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 version 1.1 이후는, isMultipleMode() 로 옮겨졌습니다.
void	clear () 추천 되고 있지 않습니다. JDK version 1.1 이후는, removeAll() 로 옮겨졌습니다.
int	countItems () 추천 되고 있지 않습니다. JDK version 1.1 이후는, getItemCount() 로 옮겨졌습니다.
void	delItem (int position) 추천 되고 있지 않습니다. remove(String) 와 remove(int) 로 옮겨졌습니다.
void	delItems (int start, int end) 추천 되고 있지 않습니다. JDK version 1.1 이후는, 일반 이용될 예정은 없습니다. 이 메소드는, 패키지 private 메소드로서 만 보관 유지될 예정입니다.
void	deselect (int index) 지정된 인덱스에 있는 항목을 선택 해제합니다.
AccessibleContext	getAccessibleContext () 이 List 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다.
ActionListener []	getActionListeners () 이 리스트에 등록된 모든 액션 청취자의 배열을 돌려줍니다.
String	getItem (int index) 지정하는 인덱스에 대응하는 항목을 돌려줍니다.
int	getItemCount () 리스트내의 항목의 수를 돌려줍니다.
ItemListener []	getItemListeners () 이 리스트에 등록된 모든 항목 청취자의 배열을 돌려줍니다.
String []	getItems () 리스트내의 항목을 돌려줍니다.
<T extends EventListener > T[]	getListeners (Class <T> 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 () 이 스크롤 리스트의 선택되고 있는 항목을 Object 의 배열로 가져옵니다.
int	getVisibleIndex () makeVisible 메소드에 의해 마지막에 표시된 항목의 인덱스를 돌려줍니다.
boolean	isIndexSelected (int index) 이 스크롤 리스트로 지정된 항목이 선택되고 있는지 어떤지를 판정합니다.
boolean	isMultipleMode () 이 리스트가 복수 선택을 허락할지 어떨지를 판정합니다.
boolean	isSelected (int index) 추천 되고 있지 않습니다. JDK version 1.1 이후는, isIndexSelected(int) 로 옮겨졌습니다.
void	makeVisible (int index) 지정된 인덱스에 있는 항목을 표시시킵니다.
Dimension	minimumSize () 추천 되고 있지 않습니다. JDK version 1.1 이후는, getMinimumSize() 로 옮겨졌습니다.
Dimension	minimumSize (int rows) 추천 되고 있지 않습니다. JDK version 1.1 이후는, getMinimumSize(int) 로 옮겨졌습니다.
protected String	paramString () 이 스크롤 리스트 상태를 표현하고 있는 파라미터 캐릭터 라인을 돌려줍니다.
Dimension	preferredSize () 추천 되고 있지 않습니다. JDK version 1.1 이후는, getPreferredSize() 로 옮겨졌습니다.
Dimension	preferredSize (int rows) 추천 되고 있지 않습니다. JDK version 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 version 1.1 이후는, setMultipleMode(boolean) 로 옮겨졌습니다.

클래스 java.awt. Component 로부터 상속된 메소드

action , add , addComponentListener , addFocusListener , addHierarchyBoundsListener , addHierarchyListener , addInputMethodListener , addKeyListener , addMouseListener , addMouseMotionListener , addMouseWheelListener , addPropertyChangeListener , addPropertyChangeListener , applyComponentOrientation , areFocusTraversalKeysSet , bounds , checkImage , checkImage , coalesceEvents , contains , contains , createImage , createImage , createVolatileImage , createVolatileImage , deliverEvent , disable , disableEvents , dispatchEvent , doLayout , enable , enable , enableEvents , enableInputMethods , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , getAlignmentX , getAlignmentY , getBackground , getBaseline , getBaselineResizeBehavior , getBounds , getBounds , getColorModel , getComponentAt , getComponentAt , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeys , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphics , getGraphicsConfiguration , getHeight , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocation , getLocationOnScreen , getMaximumSize , getMouseListeners , getMouseMotionListeners , getMousePosition , getMouseWheelListeners , getName , getParent , getPeer , getPropertyChangeListeners , getPropertyChangeListeners , getSize , getSize , getToolkit , getTreeLock , getWidth , getX , getY , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , invalidate , isBackgroundSet , isCursorSet , isDisplayable , isDoubleBuffered , isEnabled , isFocusable , isFocusCycleRoot , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , isMaximumSizeSet , isMinimumSizeSet , isOpaque , isPreferredSizeSet , isShowing , isValid , isVisible , keyDown , keyUp , layout , list , list , list , list , list , locate , location , lostFocus , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paint , paintAll , postEvent , prepareImage , prepareImage , print , printAll , processComponentEvent , processFocusEvent , processHierarchyBoundsEvent , processHierarchyEvent , processInputMethodEvent , processKeyEvent , processMouseEvent , processMouseMotionEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , removePropertyChangeListener , removePropertyChangeListener , repaint , repaint , repaint , repaint , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , reshape , resize , resize , setBackground , setBounds , setBounds , setComponentOrientation , setCursor , setDropTarget , setEnabled , setFocusable , setFocusTraversalKeys , setFocusTraversalKeysEnabled , setFont , setForeground , setIgnoreRepaint , setLocale , setLocation , setLocation , setMaximumSize , setMinimumSize , setName , setPreferredSize , setSize , setSize , setVisible , show , show , size , toString , transferFocus , transferFocusBackward , transferFocusUpCycle , update , validate

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

생성자 의 상세

List

public List()
     throws HeadlessException 

새로운 스크롤 리스트를 작성합니다. 디폴트에서는, 4 행이 표시되고 있어 복수의 선택은 할 수 없습니다. 이것은 List(0, false) 의 편리한 메소드인 것에 주의해 주세요. 또, 리스트에 표시되는 행수는, 작성 후로 변경할 수 없는 것도 주의해 주세요.

예외:

HeadlessException - GraphicsEnvironment.isHeadless()의 경우 true 를 돌려주는

관련 항목:

GraphicsEnvironment.isHeadless()

List

public List(int rows)
     throws HeadlessException 

지정된 표시행의 수에 의해 초기화된 새로운 스크롤 리스트를 작성합니다. 디폴트에서는, 복수의 선택은 할 수 없습니다. 이것은 List(rows, false) 의 편리한 메소드인 것에 주의해 주세요. 또, 리스트에 표시되는 행수는 작성 후로 변경할 수 없는 것에도 주의해 주세요.

파라미터:

rows - 표시되는 항목의 수

예외:

HeadlessException - GraphicsEnvironment.isHeadless()의 경우 true 를 돌려주는

도입된 버젼:

JDK1. 1

관련 항목:

GraphicsEnvironment.isHeadless()

List

public List(int rows,
            boolean multipleMode)
     throws HeadlessException 

지정된 행수를 표시하도록(듯이) 초기화된 새로운 스크롤 리스트를 작성합니다. 행수 0 이 지정되었을 경우, 리스트는 디폴트의 4 행으로 작성되는 것에 주의해 주세요. 또, 리스트에 표시되는 행수는 작성 후로 변경할 수 없는 것에도 주의해 주세요. multipleMode 의 값이 true 의 경우, 사용자는 리스트로부터 복수의 항목을 선택할 수 있습니다. false 의 경우, 한 번에 1 항목만 선택할 수 있습니다.

파라미터:

rows - 표시되는 항목의 수

multipleMode - true 의 경우, 복수 선택이 허가된다. 그렇지 않은 경우, 리스트로부터 동시에 선택할 수 있는 항목은 1 개만

예외:

HeadlessException - GraphicsEnvironment.isHeadless()의 경우 true 를 돌려주는

관련 항목:

GraphicsEnvironment.isHeadless()

메소드의 상세

addNotify

public void addNotify()

리스트의 피어를 작성합니다. 피어를 사용하면(자), 그 기능성을 변경하지 않고 로 외관을 변경할 수가 있습니다.

오버라이드(override):

클래스 Component 내의 addNotify

관련 항목:

Component.isDisplayable() , Component.removeNotify()

removeNotify

public void removeNotify()

이 리스트의 피어를 삭제합니다. 피어를 사용하면(자), 그 기능성을 변경하지 않고 로 외관을 변경할 수가 있습니다.

오버라이드(override):

클래스 Component 내의 removeNotify

관련 항목:

Component.isDisplayable() , Component.addNotify()

getItemCount

public int getItemCount()

리스트내의 항목의 수를 돌려줍니다.

반환값:

리스트내의 항목의 수

도입된 버젼:

JDK1. 1

관련 항목:

getItem(int)

countItems

@Deprecated 
public int countItems()

추천 되고 있지 않습니다. JDK version 1.1 이후는, getItemCount() 로 옮겨졌습니다.

getItem

public String  getItem(int index)

지정하는 인덱스에 대응하는 항목을 돌려줍니다.

파라미터:

index - 항목의 위치

반환값:

지정된 인덱스에 관련지을 수 있었다 항목

관련 항목:

getItemCount()

getItems

public String [] getItems()

리스트내의 항목을 돌려줍니다.

반환값:

리스트의 항목을 포함하는 캐릭터 라인의 배열

도입된 버젼:

JDK1. 1

관련 항목:

select(int) , deselect(int) , isIndexSelected(int)

add

public void add(String  item)

지정된 항목을 스크롤 리스트의 말미에 추가합니다.

파라미터:

item - 추가되는 항목

도입된 버젼:

JDK1. 1

addItem

@Deprecated 
public void addItem(String  item)

추천 되고 있지 않습니다. add(String) 를 사용

add

public void add(String  item,
                int index)

지정된 항목을, 인덱스로 지정된 위치에서 스크롤 리스트에 추가합니다. 인덱스는 제로로부터 시작됩니다. 인덱스의 값이 제로보다 작은 경우, 또는 리스트내의 항목수이상의 경우는, 그 항목은 리스트의 말미에 추가됩니다.

파라미터:

item - 추가되는 항목. 이 파라미터가 null 의 경우, 항목은 빈 상태(empty)의 캐릭터 라인 "" 으로서 다루어지는

index - 항목을 추가하는 위치

도입된 버젼:

JDK1. 1

addItem

@Deprecated 
public void addItem(String  item,
                               int index)

추천 되고 있지 않습니다. add(String, int) 를 사용

replaceItem

public void replaceItem(String  newValue,
                        int index)

스크롤 리스트내의 지정된 인덱스에 있는 항목을 새로운 캐릭터 라인으로 옮겨놓습니다.

파라미터:

newValue - 기존의 항목을 옮겨놓는 새로운 캐릭터 라인

index - 옮겨놓는 항목의 위치

예외:

ArrayIndexOutOfBoundsException - index 가 범위외에 있는 경우

removeAll

public void removeAll()

이 리스트로부터 모든 항목을 삭제합니다.

도입된 버젼:

JDK1. 1

관련 항목:

remove(java.lang.String) , delItems(int, int)

clear

@Deprecated 
public void clear()

추천 되고 있지 않습니다. JDK version 1.1 이후는, removeAll() 로 옮겨졌습니다.

remove

public void remove(String  item)

리스트중의 같은 항목의 쳐 최초로 출현한 것을 삭제합니다. 지정된 항목이 선택되고 있어 그것이 리스트내에서 유일 선택된 항목인 경우, 리스트의 선택은 없어집니다.

파라미터:

item - 리스트로부터 삭제되는 항목

예외:

IllegalArgumentException - 그 항목이 리스트에 존재하지 않는 경우

도입된 버젼:

JDK1. 1

remove

public void remove(int position)

지정된 위치에 있는 항목을 이 스크롤 리스트로부터 삭제합니다. 지정된 위치의 항목이 선택되고 있어 그것이 리스트내에서 유일 선택된 항목인 경우, 리스트의 선택은 없어집니다.

파라미터:

position - 삭제되는 항목의 인덱스

예외:

ArrayIndexOutOfBoundsException - position 가 0 미만의 경우 또는 getItemCount()-1 보다 큰 경우

도입된 버젼:

JDK1. 1

관련 항목:

add(String, int)

delItem

@Deprecated 
public void delItem(int position)

추천 되고 있지 않습니다. remove(String) 와 remove(int) 로 옮겨졌습니다.

getSelectedIndex

public int getSelectedIndex()

리스트로 선택되고 있는 항목의 인덱스를 돌려줍니다.

반환값:

선택된 항목의 인덱스. 항목이 선택되어 있지 않은 경우, 또는 복수의 항목이 선택되었을 경우는, -1 하지만 반환되는

관련 항목:

select(int) , deselect(int) , isIndexSelected(int)

getSelectedIndexes

public int[] getSelectedIndexes()

리스트로 선택되고 있는 인덱스를 돌려줍니다.

반환값:

이 스크롤 리스트로 선택되고 있는 인덱스의 배열. 항목이 선택되어 있지 않은 경우는, 길이 제로의 배열이 반환되는

관련 항목:

select(int) , deselect(int) , isIndexSelected(int)

getSelectedItem

public String  getSelectedItem()

이 스크롤 리스트로 선택되고 있는 항목을 돌려줍니다.

반환값:

리스트로 선택되고 있는 항목. 항목이 선택되어 있지 않은 경우, 또는 복수의 항목이 선택되었을 경우는, null 가 반환되는

관련 항목:

select(int) , deselect(int) , isIndexSelected(int)

getSelectedItems

public String [] getSelectedItems()

이 스크롤 리스트로 선택되고 있는 항목을 돌려줍니다.

반환값:

이 스크롤 리스트로 선택되고 있는 항목의 배열. 항목이 선택되어 있지 않은 경우는, 길이 제로의 배열이 반환되는

관련 항목:

select(int) , deselect(int) , isIndexSelected(int)

getSelectedObjects

public Object [] getSelectedObjects()

이 스크롤 리스트의 선택되고 있는 항목을 Object 의 배열로 가져옵니다.

정의:

인터페이스 ItemSelectable 내의 getSelectedObjects

반환값:

이 스크롤 리스트의 선택되고 있는 항목을 나타낸다 Object 의 배열. 항목이 선택되어 있지 않은 경우는, 길이 제로의 배열이 반환되는

관련 항목:

getSelectedItems() , ItemSelectable

select

public void select(int index)

스크롤 리스트의 지정된 인덱스에 있는 항목을 선택합니다.

범위외의 파라미터를 건네주는 것은 무효이며, 특정할 수 없는 동작이 발생합니다. 　

이 메소드는, 주로 이 컴퍼넌트내의 항목을 초기 상태로 선택하기 위해서 사용됩니다. 이 메소드를 프로그램에 의해 호출하는 경우는,ItemEvent 를 트리거하지 않습니다. ItemEvent 를 트리거하는 유일한 방법은 사용자의 조작입니다.

파라미터:

index - 선택하는 항목의 위치

관련 항목:

getSelectedItem() , deselect(int) , isIndexSelected(int)

deselect

public void deselect(int index)

지정된 인덱스에 있는 항목을 선택 해제합니다.

범위외의 파라미터를 건네주는 것은 무효이며, 특정할 수 없는 동작이 발생합니다.

지정된 인덱스의 항목이 선택되어 있지 않은 경우, 조작은 무시됩니다.

파라미터:

index - 선택을 해제하는 항목의 위치

관련 항목:

select(int) , getSelectedItem() , isIndexSelected(int)

isIndexSelected

public boolean isIndexSelected(int index)

이 스크롤 리스트로 지정된 항목이 선택되고 있는지 어떤지를 판정합니다.

파라미터:

index - 체크 대상의 항목

반환값:

지정된 항목이 선택되고 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

JDK1. 1

관련 항목:

select(int) , deselect(int)

isSelected

@Deprecated 
public boolean isSelected(int index)

추천 되고 있지 않습니다. JDK version 1.1 이후는, isIndexSelected(int) 로 옮겨졌습니다.

getRows

public int getRows()

리스트의 표시행의 수를 돌려줍니다. List 가 작성되면(자), 이 수는 변경할 수 없는 것에 주의해 주세요.

반환값:

이 스크롤 리스트의 표시행의 수

isMultipleMode

public boolean isMultipleMode()

이 리스트가 복수 선택을 허락할지 어떨지를 판정합니다.

반환값:

이 리스트로 복수 선택이 허가되고 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

JDK1. 1

관련 항목:

setMultipleMode(boolean)

allowsMultipleSelections

@Deprecated 
public boolean allowsMultipleSelections()

추천 되고 있지 않습니다. JDK version 1.1 이후는, isMultipleMode() 로 옮겨졌습니다.

setMultipleMode

public void setMultipleMode(boolean b)

이 리스트가 복수 선택을 허락할지 어떨지를 판정하는 플래그를 설정합니다. 선택 모드가 복수 선택으로부터 단일 선택으로 변경되면(자), 선택된 항목은 다음과 같이 변경됩니다. 선택된 항목에 위치 커서가 있는 경우, 그 항목만이 선택된 채로 있습니다. 선택된 항목에 위치 커서가 없는 경우, 모든 항목이 선택 해제됩니다.

파라미터:

b - true 의 경우는 복수 선택이 허가된다. 그렇지 않은 경우는 리스트로부터 동시에 선택할 수 있는 항목은 1 개(살)만

도입된 버젼:

JDK1. 1

관련 항목:

isMultipleMode()

setMultipleSelections

@Deprecated 
public void setMultipleSelections(boolean b)

추천 되고 있지 않습니다. JDK version 1.1 이후는, setMultipleMode(boolean) 로 옮겨졌습니다.

getVisibleIndex

public int getVisibleIndex()

makeVisible 메소드에 의해 마지막에 표시된 항목의 인덱스를 돌려줍니다.

반환값:

마지막에 표시된 항목의 인덱스

관련 항목:

makeVisible(int)

makeVisible

public void makeVisible(int index)

지정된 인덱스에 있는 항목을 표시시킵니다.

파라미터:

index - 항목의 위치

관련 항목:

getVisibleIndex()

getPreferredSize

public Dimension  getPreferredSize(int rows)

지정된 행수를 가지는 리스트의 추천 치수를 돌려줍니다.

파라미터:

rows - 리스트의 행수

반환값:

지정된 행수를 표시해야 한다고 하는 조건의 아래에서, 이 스크롤 리스트를 표시하기 위한 추천 치수

도입된 버젼:

JDK1. 1

관련 항목:

Component.getPreferredSize()

preferredSize

@Deprecated 
public Dimension  preferredSize(int rows)

추천 되고 있지 않습니다. JDK version 1.1 이후는, getPreferredSize(int) 로 옮겨졌습니다.

getPreferredSize

public Dimension  getPreferredSize()

이 스크롤 리스트의 추천 사이즈를 돌려줍니다.

오버라이드(override):

클래스 Component 내의 getPreferredSize

반환값:

이 스크롤 리스트를 표시하기 위한 추천 치수

도입된 버젼:

JDK1. 1

관련 항목:

Component.getPreferredSize()

preferredSize

@Deprecated 
public Dimension  preferredSize()

추천 되고 있지 않습니다. JDK version 1.1 이후는, getPreferredSize() 로 옮겨졌습니다.

오버라이드(override):

클래스 Component 내의 preferredSize

getMinimumSize

public Dimension  getMinimumSize(int rows)

지정된 행수를 가지는 리스트의 최소 치수를 돌려줍니다.

파라미터:

rows - 리스트의 행수

반환값:

지정된 행수를 표시해야 한다고 하는 조건의 아래에서, 이 스크롤 리스트를 표시하기 위한 최소 치수

도입된 버젼:

JDK1. 1

관련 항목:

Component.getMinimumSize()

minimumSize

@Deprecated 
public Dimension  minimumSize(int rows)

추천 되고 있지 않습니다. JDK version 1.1 이후는, getMinimumSize(int) 로 옮겨졌습니다.

getMinimumSize

public Dimension  getMinimumSize()

이 스크롤 리스트의 최소 사이즈를 지정합니다.

오버라이드(override):

클래스 Component 내의 getMinimumSize

반환값:

이 스크롤 리스트를 표시하기 위해서 필요한 최소 치수

도입된 버젼:

JDK1. 1

관련 항목:

Component.getMinimumSize()

minimumSize

@Deprecated 
public Dimension  minimumSize()

추천 되고 있지 않습니다. JDK version 1.1 이후는, getMinimumSize() 로 옮겨졌습니다.

오버라이드(override):

클래스 Component 내의 minimumSize

addItemListener

public void addItemListener(ItemListener  l)

지정된 항목 청취자를 추가해, 리스트로부터 항목 이벤트를 받습니다. 항목 이벤트는 사용자 입력에 응답해 송신됩니다만,select 또는 deselect 의 호출에는 응답하지 않습니다. 청취자 l 가 null 의 경우, 예외는 throw 되지 않고, 처리도 실행되지 않습니다. 　

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

정의:

인터페이스 ItemSelectable 내의 addItemListener

파라미터:

l - 항목 청취자

도입된 버젼:

JDK1. 1

관련 항목:

removeItemListener(java.awt.event.ItemListener) , getItemListeners() , select(int) , deselect(int) , ItemEvent , ItemListener

removeItemListener

public void removeItemListener(ItemListener  l)

지정된 항목 청취자를 삭제해, 그것이 이 리스트로부터 항목 이벤트를 받지 않게 합니다. 청취자 l 가 null 의 경우, 예외는 throw 되지 않고, 처리도 실행되지 않습니다. 　

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

정의:

인터페이스 ItemSelectable 내의 removeItemListener

파라미터:

l - 항목 청취자

도입된 버젼:

JDK1. 1

관련 항목:

addItemListener(java.awt.event.ItemListener) , getItemListeners() , ItemEvent , ItemListener

getItemListeners

public ItemListener [] getItemListeners()

이 리스트에 등록된 모든 항목 청취자의 배열을 돌려줍니다.

반환값:

이 리스트의 모든 ItemListener, 또는 현재 항목 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

1.4

관련 항목:

addItemListener(java.awt.event.ItemListener) , removeItemListener(java.awt.event.ItemListener) , ItemEvent , ItemListener

addActionListener

public void addActionListener(ActionListener  l)

이 리스트로부터 액션 이벤트를 받기 위해서(때문에), 지정된 액션 청취자를 추가합니다. 사용자가 리스트 항목을 더블 클릭 하는지, 또는 리스트에 키보드 포커스가 있는 경우에 Enter 키를 누르면(자), 액션 이벤트가 발생합니다.

청취자 l 가 null 의 경우, 예외는 throw 되지 않고, 처리도 실행되지 않습니다. 　

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

l - 액션 청취자

도입된 버젼:

JDK1. 1

관련 항목:

removeActionListener(java.awt.event.ActionListener) , getActionListeners() , ActionEvent , ActionListener

removeActionListener

public void removeActionListener(ActionListener  l)

지정된 액션 청취자를 삭제해, 그것이 이 리스트로부터 액션 이벤트를 받지 않게 합니다. 사용자가 리스트 항목을 더블 클릭 하면(자), 액션 이벤트가 발생합니다. 청취자 l 가 null 의 경우, 예외는 throw 되지 않고, 처리도 실행되지 않습니다. 　

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

l - 액션 청취자

도입된 버젼:

JDK1. 1

관련 항목:

addActionListener(java.awt.event.ActionListener) , getActionListeners() , ActionEvent , ActionListener

getActionListeners

public ActionListener [] getActionListeners()

이 리스트에 등록된 모든 액션 청취자의 배열을 돌려줍니다.

반환값:

이 리스트의 모든 ActionListener, 또는 현재 액션 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

1.4

관련 항목:

addActionListener(java.awt.event.ActionListener) , removeActionListener(java.awt.event.ActionListener) , ActionEvent , ActionListener

getListeners

public <T extends EventListener > T[] getListeners(Class <T> listenerType)

이 List 에 FooListener 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다. FooListener 는,addFooListener 메소드를 사용해 등록합니다.

FooListener.class 라고 하는 클래스 리터럴을 사용해,listenerType 인수를 지정할 수 있습니다. 예를 들어, 다음의 코드를 사용해, 그 항목 청취자의 List l 를 조회할 수 있습니다. 이러한 청취자가 없는 경우는 빈 상태(empty)의 배열을 돌려줍니다.

오버라이드(override):

클래스 Component 내의 getListeners

파라미터:

listenerType - 요구되는 청취자의 형태. java.util.EventListener 의 하위 인터페이스를 지정

반환값:

이 컴퍼넌트에 FooListener 로서 등록되어 모든 객체의 배열. 이 리스트의 FooListener, 또는 그러한 청취자가 추가되어 있지 않은 경우는 빈 상태(empty)의 배열

예외:

ClassCastException - listenerType 가 java.util.EventListener 를 구현한다 클래스 또는 인터페이스를 지정하지 않는 경우

도입된 버젼:

1.3

관련 항목:

getItemListeners()

processEvent

protected void processEvent(AWTEvent  e)

이 스크롤 리스트의 이벤트를 처리합니다. 이벤트가 ItemEvent 의 인스턴스의 경우는,processItemEvent 메소드를 호출합니다. 이벤트가 ActionEvent 의 인스턴스의 경우는,processActionEvent 를 호출합니다. 이벤트가 항목 이벤트나 액션 이벤트가 아닌 경우는, 슈퍼 클래스에서 processEvent 를 호출합니다. 　

이벤트 파라미터가 null 의 경우의 동작은 정의되어 있지 않기 때문에 예외가 throw 됩니다.

오버라이드(override):

클래스 Component 내의 processEvent

파라미터:

e - 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

ActionEvent , ItemEvent , processActionEvent(java.awt.event.ActionEvent) , processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent  e)

이 리스트로 발생하는 항목 이벤트를, 등록된 ItemListener 객체에 발송 하는 것으로써, 항목 이벤트를 처리합니다.

항목 이벤트가 이 컴퍼넌트용으로 사용 가능하게 되지 않은 한, 이 메소드는 불려 가지 않습니다. 항목 이벤트는, 이하의 항목의 1 개가 발생했을 때에 사용 가능하게 됩니다.

• ItemListener 객체가 addItemListener 를 사용해 등록된다
• enableEvents 에 의해 항목 이벤트가 사용 가능하게 되어 있다

　

이벤트 파라미터가 null 의 경우의 동작은 정의되어 있지 않기 때문에 예외가 throw 됩니다.

파라미터:

e - 항목 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

ItemEvent , ItemListener , addItemListener(java.awt.event.ItemListener) , Component.enableEvents(long)

processActionEvent

protected void processActionEvent(ActionEvent  e)

이 컴퍼넌트로 발생하는 액션 이벤트를, 등록된 ActionListener 객체에 발송 하는 것으로써, 액션 이벤트를 처리합니다.

이 컴퍼넌트에 대해서 액션 이벤트가 사용 가능하지 않은 한, 이 메소드는 불려 가지 않습니다. 액션 이벤트는, 다음의 어느 쪽인가의 경우에 사용 가능하게 됩니다.

• ActionListener 객체가 addActionListener 에 의해 등록되어 있다
• enableEvents 에 의해 액션 이벤트가 사용 가능하게 되어 있다

　

이벤트 파라미터가 null 의 경우의 동작은 정의되어 있지 않기 때문에 예외가 throw 됩니다.

파라미터:

e - 액션 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

ActionEvent , ActionListener , addActionListener(java.awt.event.ActionListener) , Component.enableEvents(long)

paramString

protected String  paramString()

이 스크롤 리스트 상태를 표현하고 있는 파라미터 캐릭터 라인을 돌려줍니다. 이 캐릭터 라인은 디버그 시에 편리합니다.

오버라이드(override):

클래스 Component 내의 paramString

반환값:

이 스크롤 리스트의 파라미터의 캐릭터 라인

delItems

@Deprecated 
public void delItems(int start,
                                int end)

추천 되고 있지 않습니다. JDK version 1.1 이후는, 일반 이용될 예정은 없습니다. 이 메소드는, 패키지 private 메소드로서 만 보관 유지될 예정입니다.

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 List 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다. 리스트의 경우,AccessibleContext 는 AccessibleAWTList 의 형식을 취합니다. 필요에 따라서, 새로운 AccessibleAWTList 인스턴스가 작성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 Component 내의 getAccessibleContext

반환값:

이 List 의 AccessibleContext 로서 기능한다 AccessibleAWTList

도입된 버젼:

1.3