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

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

JavaTM Platform
Standard Ed. 6

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

## java.awt
클래스 Choice

    java.lang.Object
      java.awt.Component
          java.awt.Choice

모든 구현된 인터페이스:
  ImageObserver , ItemSelectable , MenuContainer , Serializable , Accessible

    public class Choice

extends Component
implements ItemSelectable , Accessible

`Choice` 클래스는 선택 범위의 pop-up menu를 나타냅니다. 현재의 선택 범위는, 메뉴의 타이틀로서 표시됩니다.

다음의 코드예에서는, pop-up menu를 생성합니다.

>      Choice ColorChooser = new Choice();
>      ColorChooser.add("Green");
>      ColorChooser.add("Red");
>      ColorChooser.add("Blue");

이 선택 범위 메뉴가 패널에 추가되면(자), 일반적으로 상태에서는 다음과 같이 표시됩니다.

이 그림에서는 `"Green"` 가 현재의 선택 범위입니다. 객체상에서 mouse button를 누르면(자), 현재의 선택 범위가 하이라이트 된 상태로 메뉴가 표시됩니다.

`Choice` 컴퍼넌트의 임의의 사이즈 변경을 네이티브 지원하고 있지 않는 플랫폼이 있어,`setSize()` 또는 `getSize()` 의 동작이 이것에 의해 제한을 받는 경우가 있습니다. 네이티브인 `GUI Choice` 컴퍼넌트의 사이즈는,`Choice` 내에 포함되는 항목의 font size나 길이등의 속성으로 결정되는 경우가 자주 있습니다.

도입된 버젼:
  JDK1. 0
관련 항목:
  직렬화 된 형식

상자의 클래스의 개요
`protected class` | `Choice.AccessibleAWTChoice` 이 클래스는 `Choice` 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.

클래스 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`

생성자 의 개요
`Choice ()` 새로운 선택 범위 메뉴를 작성합니다.

메소드의 개요
`void` | `add (String item)` 이 `Choice` 메뉴에 항목을 추가합니다.
`void` | `addItem (String item)` Java 2 플랫폼 v1. 1 에서는 사용하지 않습니다.
`void` | `addItemListener (ItemListener l)` 지정된 항목 청취자를, 이 `Choice` 메뉴의 항목 이벤트 수신을 위해서(때문에) 추가합니다.
`void` | `addNotify ()` `Choice` 의 피어를 생성합니다.
`int` | `countItems ()` 추천 되고 있지 않습니다. JDK version 1.1 이후는, `getItemCount()` 로 옮겨졌습니다.
`AccessibleContext` | `getAccessibleContext ()` 이 `Choice` 에 관련지을 수 있는 `AccessibleContext` 를 가져옵니다.
`String` | `getItem (int index)` 이 `Choice` 메뉴내의 지정된 인덱스의 캐릭터 라인을 돌려줍니다.
`int` | `getItemCount ()` 이 `Choice` 메뉴내의 항목수를 돌려줍니다.
`ItemListener []` | `getItemListeners ()` 이 선택 범위에 등록되어 모든 항목 청취자의 배열을 돌려줍니다.

`

`<T extends EventListener > T[]`

`

`getListeners (Class <T> listenerType)`
이 `Choice` 에 `FooListener` 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다.

`int` | `getSelectedIndex ()` 현재 선택되고 있는 항목의 인덱스를 돌려줍니다.
`String` | `getSelectedItem ()` 현재 선택되고 있는 캐릭터 라인 표현을 돌려줍니다.
`Object []` | `getSelectedObjects ()` 현재 선택되고 있는 항목을 포함한 배열 (길이 1)을 돌려줍니다.
`void` | `insert (String item, int index)` 이 Choice 의 지정된 위치에 항목을 삽입합니다.
`protected String` | `paramString ()` 이 `Choice` 메뉴 상태를 나타내는 캐릭터 라인을 돌려줍니다.
`protected void` | `processEvent (AWTEvent e)` 이 Choice 의 이벤트를 처리합니다.
`protected void` | `processItemEvent (ItemEvent e)` 이 `Choice` 메뉴로 발생하는 항목 이벤트를, 등록되어 모든 `ItemListener` 객체에 발송 하는 것으로써, 항목 이벤트를 처리합니다.
`void` | `remove (int position)` 선택 메뉴로부터, 지정된 위치에 있는 항목을 삭제합니다.
`void` | `remove (String item)` `item` 의 최초로 표시되는 항목을 `Choice` 메뉴로부터 삭제합니다.
`void` | `removeAll ()` 선택 메뉴로부터 모든 항목을 삭제합니다.
`void` | `removeItemListener (ItemListener l)` 이 `Choice` 메뉴로부터 항목 이벤트를 받지 않게, 지정된 항목 청취자를 삭제합니다.
`void` | `select (int pos)` 이 `Choice` 메뉴의 선택 항목을, 지정된 위치에 있는 항목으로 설정합니다.
`void` | `select (String str)` 이 `Choice` 메뉴의 선택 항목을, 지정된 캐릭터 라인과 이름이 같은 항목으로 설정합니다.

클래스 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 , getMinimumSize , getMouseListeners , getMouseMotionListeners , getMousePosition , getMouseWheelListeners , getName , getParent , getPeer , getPreferredSize , 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 , minimumSize , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paint , paintAll , postEvent , preferredSize , prepareImage , prepareImage , print , printAll , processComponentEvent , processFocusEvent , processHierarchyBoundsEvent , processHierarchyEvent , processInputMethodEvent , processKeyEvent , processMouseEvent , processMouseMotionEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , removeNotify , 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`

생성자 의 상세

### Choice

    public Choice()
           throws HeadlessException

  새로운 선택 범위 메뉴를 작성합니다. 초기 상태에서는, 메뉴에는 항목이 없습니다.

  디폴트에서는,`select` 메소드의 호출로 사용자가 다른 선택을 실시할 때까지, 선택 범위 메뉴에 추가된 최초의 항목이 선택 항목이 됩니다.

  예외:
    `HeadlessException` - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우
  관련 항목:
    `GraphicsEnvironment.isHeadless()` , `select(int)` , `select(java.lang.String)`

메소드의 상세

### addNotify

    public void addNotify()

  `Choice` 의 피어를 생성합니다. 이 피어에 의해,`Choice` 의 기능을 변경하지 않고 그 외관을 변경할 수가 있습니다.

  오버라이드(override):
    클래스 `Component` 내의 `addNotify`
  관련 항목:
    `Toolkit.createChoice(java.awt.Choice)` , `Component.getToolkit()`

### getItemCount

    public int getItemCount()

  이 `Choice` 메뉴내의 항목수를 돌려줍니다.

  반환값:
    이 `Choice` 메뉴내의 항목수
  도입된 버젼:
    JDK1. 1
  관련 항목:
    `getItem(int)`

### countItems

    @Deprecated
    public int countItems()

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

### getItem

    public String  getItem(int index)

  이 `Choice` 메뉴내의 지정된 인덱스의 캐릭터 라인을 돌려줍니다.

  파라미터:
    `index` - 개시를 나타내는 인덱스
  관련 항목:
    `getItemCount()`

### add

    public void add(String  item)

  이 `Choice` 메뉴에 항목을 추가합니다.

  파라미터:
    `item` - 추가되는 항목
  예외:
    `NullPointerException` - 항목의 값이 `null` 의 경우
  도입된 버젼:
    JDK1. 1

### addItem

    public void addItem(String  item)

  Java 2 플랫폼 v1. 1 에서는 사용하지 않습니다. 대신에 `add` 메소드를 사용해 주세요.

  이 `Choice` 메뉴에 항목을 추가합니다.

  파라미터:
    `item` - 추가되는 항목
  예외:
    `NullPointerException` - 그 항목의 값이 `null` 의 경우

### insert

    public void insert(String  item,
                       int index)

  이 Choice 의 지정된 위치에 항목을 삽입합니다. index 이후의 항목은 1 개씩 후에 이동됩니다. `index` 의 값이 이 선택 범위의 항목수이상의 경우,`item` 는 이 선택 범위의 마지막에 추가됩니다.

  항목이 선택 범위에 추가되는 최초의 항목인 경우, 이 항목이 선택됩니다. 최초의 항목이 아닌 경우, 선택되는 항목이 이동되는 항목의 경우는, 선택 범위의 최초의 항목이 선택됩니다. 이동되는 항목이 아닌 경우는, 그 항목이 그대로 선택됩니다. 삽입되는 항목. ``

  파라미터:
    `item` - 삽입되는 항목. `null` 는 지정 불가
    `index` - 항목이 삽입되는 위치
  예외:
    `IllegalArgumentException` - 인덱스가 제로보다 작은 경우

### remove

    public void remove(String  item)

  `item` 의 최초로 표시되는 항목을 `Choice` 메뉴로부터 삭제합니다. 현재 선택되고 있는 항목이 삭제 대상의 경우, 선택 범위의 최초의 항목이 선택 항목이 됩니다. 삭제 대상으로 되어 있지 않은 경우, 현재의 항목이 그대로 선택됩니다 (선택된 인덱스가 필요에 따라서 갱신됩니다).

  파라미터:
    `item` - 이 `Choice` 메뉴로부터 삭제되는 항목
  예외:
    `IllegalArgumentException` - 선택 메뉴에 항목이 없는 경우
  도입된 버젼:
    JDK1. 1

### remove

    public void remove(int position)

  선택 메뉴로부터, 지정된 위치에 있는 항목을 삭제합니다. 현재 선택되고 있는 항목이 삭제 대상의 경우, 선택 범위의 최초의 항목이 선택 항목이 됩니다. 삭제 대상으로 되어 있지 않은 경우, 현재의 항목이 그대로 선택됩니다 (선택된 인덱스가 필요에 따라서 갱신됩니다).

  파라미터:
    `position` - 항목의 위치
  예외:
    `IndexOutOfBoundsException` - 지정되었다 위치가 범위외인 경우
  도입된 버젼:
    JDK1. 1

### removeAll

    public void removeAll()

  선택 메뉴로부터 모든 항목을 삭제합니다.

  도입된 버젼:
    JDK1. 1
  관련 항목:
    `remove(java.lang.String)`

### getSelectedItem

    public String  getSelectedItem()

  현재 선택되고 있는 캐릭터 라인 표현을 돌려줍니다.

  반환값:
    이 선택 메뉴로 현재 선택되고 있는 항목의 캐릭터 라인 표현
  관련 항목:
    `getSelectedIndex()`

### getSelectedObjects

    public Object [] getSelectedObjects()

  현재 선택되고 있는 항목을 포함한 배열 (길이 1)을 돌려줍니다. 선택되고 있는 항목이 없는 경우는,`null` 를 돌려줍니다.

  정의:
    인터페이스 `ItemSelectable` 내의 `getSelectedObjects`
  관련 항목:
    `ItemSelectable`

### getSelectedIndex

    public int getSelectedIndex()

  현재 선택되고 있는 항목의 인덱스를 돌려줍니다. 아무것도 선택되어 있지 않은 경우는 -1 을 돌려줍니다.

  반환값:
    현재 선택되고 있는 항목의 인덱스, 또는 아무것도 선택되어 있지 않은 경우는 -1
  관련 항목:
    `getSelectedItem()`

### select

    public void select(int pos)

  이 `Choice` 메뉴의 선택 항목을, 지정된 위치에 있는 항목으로 설정합니다.

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

  파라미터:
    `pos` - 선택 항목의 위치
  예외:
    `IllegalArgumentException` - 지정되었다 위치가 항목의 수보다 큰지, 제로보다 작은 경우
  관련 항목:
    `getSelectedItem()` , `getSelectedIndex()`

### select

    public void select(String  str)

  이 `Choice` 메뉴의 선택 항목을, 지정된 캐릭터 라인과 이름이 같은 항목으로 설정합니다. 지정된 캐릭터 라인과 같은 이름의 항목이 다수 있는 경우는, 인덱스치가 가장 작은 항목이 선택됩니다.

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

  파라미터:
    `str` - 지정된 캐릭터 라인
  관련 항목:
    `getSelectedItem()` , `getSelectedIndex()`

### addItemListener

    public void addItemListener(ItemListener  l)

  지정된 항목 청취자를, 이 `Choice` 메뉴의 항목 이벤트 수신을 위해서(때문에) 추가합니다. 항목 이벤트는 `select` 의 호출은 아니고, 사용자의 입력에 반응해 청취자에게 송신됩니다. l 가 `null` 의 경우, 예외는 throw 되지 않고, 처리도 실행되지 않습니다.

  thread 모델의 자세한 것은,「AWT Threading Issues」를 참조해 주세요.

  정의:
    인터페이스 `ItemSelectable` 내의 `addItemListener`
  파라미터:
    `l` - 항목 청취자
  도입된 버젼:
    JDK1. 1
  관련 항목:
    `removeItemListener(java.awt.event.ItemListener)` , `getItemListeners()` , `select(int)` , `ItemEvent` , `ItemListener`

### removeItemListener

    public void removeItemListener(ItemListener  l)

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

  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`

### getListeners

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

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

  `FooListener.class` 라고 하는 클래스 리터럴을 사용해,`listenerType` 인수를 지정할 수 있습니다. 예를 들어, 이 항목 청취자에 대한 `Choice` `c` 의 조회는 다음의 코드로 실시합니다. 이러한 청취자가 없는 경우는 빈 상태(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)

  이 Choice 의 이벤트를 처리합니다. 이벤트가 `ItemEvent` 의 인스턴스인 경우는,`processItemEvent` 메소드를 호출합니다. 그렇지 않은 경우는, 슈퍼 클래스의 `processEvent` 메소드를 호출합니다.

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

  오버라이드(override):
    클래스 `Component` 내의 `processEvent`
  파라미터:
    `e` - 이벤트
  도입된 버젼:
    JDK1. 1
  관련 항목:
    `ItemEvent` , `processItemEvent(java.awt.event.ItemEvent)`

### processItemEvent

    protected void processItemEvent(ItemEvent  e)

  이 `Choice` 메뉴로 발생하는 항목 이벤트를, 등록되어 모든 `ItemListener` 객체에 발송 하는 것으로써, 항목 이벤트를 처리합니다.

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

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

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

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

### paramString

    protected String  paramString()

  이 `Choice` 메뉴 상태를 나타내는 캐릭터 라인을 돌려줍니다. 이 메소드는 디버그 전용이며, 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,`null` 로는 되지 않습니다.

  오버라이드(override):
    클래스 `Component` 내의 `paramString`
  반환값:
    이 `Choice` 메뉴의 파라미터 캐릭터 라인

### getAccessibleContext

    public AccessibleContext  getAccessibleContext()

  이 `Choice` 에 관련지을 수 있는 `AccessibleContext` 를 가져옵니다. `AccessibleContext` 는 `Choice` 의 폼을 `AccessibleAWTChoice` 로부터 가져옵니다. 필요한 경우는 새로운 `AccessibleAWTChoice` 인스턴스를 생성합니다.

  정의:
    인터페이스 `Accessible` 내의 `getAccessibleContext`
  오버라이드(override):
    클래스 `Component` 내의 `getAccessibleContext`
  반환값:
    이 `Choice` 의 `AccessibleContext` 로서 기능하는 `AccessibleAWTChoice`
  도입된 버젼:
    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 도 참조해 주세요.