List (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## 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

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.