List (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

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
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는 컨테이너로 다음의 스크롤 리스트가 작성됩니다.

Venus,Earth,Java 소프트웨어 및 Mars을 포함한 리스트를 나타낸다. Java 소프트웨어가 선택되고 있다

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를 필요에 따라서 구현해, 이 리스트로부터 이벤트를 받는 새로운 리스너를 등록합니다.

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

도입된 버전 :: JDK1. 0
관련 항목:: ItemEvent, ItemListener, ActionEvent, ActionListener, 직렬화 된 형식

중첩(Nested) 클래스 개요
`protected class`	`List.AccessibleAWTList` 이 클래스는 `List` 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.

클래스 java.awt. Component 로부터 상속된 중첩(Nested) 클래스/인터페이스
`Component.AccessibleAWTComponent, 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 ()
리스트내의 항목을 리턴합니다.





<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 버전 1.1 그 뒤로는 isIndexSelected(int)를 사용합니다.

void makeVisible (int index)
지정된 인덱스에 있는 항목을 표시시킵니다.

Dimension minimumSize ()
추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getMinimumSize()를 사용합니다.

Dimension minimumSize (int rows)
추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getPreferredSize(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.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, 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.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,
 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 버전 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인 경우, 항목은 비어있는 캐릭터 라인 "" 으로서 처리되는; 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 버전 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 버전 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 버전 1.1 그 뒤로는 isMultipleMode()를 사용합니다.

setMultipleMode

public void setMultipleMode(boolean b)

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

파라미터:: b - 복수 선택이 용서되는 경우는 true, 그렇지 않은 경우는 리스트로부터 동시에 선택할 수 있는 항목은 1개 만
도입된 버전 :: JDK1. 1
관련 항목:: isMultipleMode()

setMultipleSelections

@Deprecated 
public void setMultipleSelections(boolean b)

추천하지 않습니다. JDK 버전 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 버전 1.1 그 뒤로는 getPreferredSize(int)를 사용합니다.

getPreferredSize

public Dimension  getPreferredSize()

이 스크롤 리스트의 추천 사이즈를 리턴합니다.

오버라이드(override):: 클래스 Component 내의 getPreferredSize

반환값:: 이 스크롤 리스트를 표시하기 위한 추천 크기
도입된 버전 :: JDK1. 1
관련 항목:: Component.getPreferredSize()

preferredSize

@Deprecated 
public Dimension  preferredSize()

추천하지 않습니다. JDK 버전 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 버전 1.1 그 뒤로는 getPreferredSize(int)를 사용합니다.

getMinimumSize

public Dimension  getMinimumSize()

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

오버라이드(override):: 클래스 Component 내의 getMinimumSize

반환값:: 이 스크롤 리스트를 표시하기 위해서 필요한 최소 크기
도입된 버전 :: JDK1. 1
관련 항목:: Component.getMinimumSize()

minimumSize

@Deprecated 
public Dimension  minimumSize()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getMinimumSize()를 사용합니다.

오버라이드(override):: 클래스 Component 내의 minimumSize

addItemListener

public void addItemListener(ItemListener  l)

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

정의:: 인터페이스 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인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

정의:: 인터페이스 ItemSelectable 내의 removeItemListener

파라미터:: l - 항목 리스너
도입된 버전 :: JDK1. 1
관련 항목:: addItemListener(java.awt.event.ItemListener), getItemListeners(), ItemEvent, ItemListener

getItemListeners

public ItemListener [] getItemListeners()

이 리스트에 등록된 모든 항목 리스너의 배열을 리턴합니다.

반환값:: 이 리스트의 모든 ItemListener, 또는 현재 항목 리스너가 등록되지 않은 경우는 비어있는 배열
도입된 버전 :: 1.4
관련 항목:: addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener), ItemEvent, ItemListener

addActionListener

public void addActionListener(ActionListener  l)

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

리스너 l가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 행해지지 않습니다.

파라미터:: l - 액션 리스너
도입된 버전 :: JDK1. 1
관련 항목:: removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener

removeActionListener

public void removeActionListener(ActionListener  l)

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

파라미터:: l - 액션 리스너
도입된 버전 :: JDK1. 1
관련 항목:: addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener

getActionListeners

public ActionListener [] getActionListeners()

이 리스트에 등록된 모든 액션 리스너의 배열을 리턴합니다.

반환값:: 이 리스트의 모든 ActionListener, 또는 현재 액션 리스너가 등록되지 않은 경우는 비어있는 배열
도입된 버전 :: 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를 조회할 수 있습니다.

ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));

이러한 리스너가 없는 경우는 비어있는 배열을 리턴합니다.

오버라이드(override):: 클래스 Component 내의 getListeners

파라미터:: listenerType - 요구되는 리스너의 형태. java.util.EventListener 하위 인터페이스를 지정
반환값:: 이 리스트의 FooListener로 서 등록된 모든 객체의 배열, 또는 이러한 리스너가 추가되지 않았던 경우는 비어있는 배열
예외:: ClassCastException - listenerType가 java.util.EventListener를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우
도입된 버전 :: 1.3
관련 항목:: getItemListeners()

processEvent

protected void processEvent(AWTEvent  e)

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

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

오버라이드(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인 경우의 동작은 정의되어 있지 않기 때문에 예외가 발생 됩니다.

파라미터:: e - 항목 이벤트
도입된 버전 :: JDK1. 1
관련 항목:: ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), Component.enableEvents(long)

processActionEvent

protected void processActionEvent(ActionEvent  e)

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

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

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

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

파라미터:: 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 버전 1.1 시점에서는 장래적으로 일반 이용될 예정은 없습니다. 이 메서드는 패키지 private 메서드로서만 보관 유지될 예정입니다.

getAccessibleContext

public AccessibleContext  getAccessibleContext()

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

정의:: 인터페이스 Accessible 내의 getAccessibleContext
오버라이드(override):: 클래스 Component 내의 getAccessibleContext

반환값:: 이 List AccessibleContext로 서 기능하는 AccessibleAWTList

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.awt 클래스 List

List

List

List

addNotify

removeNotify

getItemCount

countItems

getItem

getItems

add

addItem

add

addItem

replaceItem

removeAll

clear

remove

remove

delItem

getSelectedIndex

getSelectedIndexes

getSelectedItem

getSelectedItems

getSelectedObjects

select

deselect

isIndexSelected

isSelected

getRows

isMultipleMode

allowsMultipleSelections

setMultipleMode

setMultipleSelections

getVisibleIndex

makeVisible

getPreferredSize

preferredSize

getPreferredSize

preferredSize

getMinimumSize

minimumSize

getMinimumSize

minimumSize

addItemListener

removeItemListener

getItemListeners

addActionListener

removeActionListener

getActionListeners

getListeners

processEvent

processItemEvent

processActionEvent

paramString

delItems

getAccessibleContext

java.awt
클래스 List