java.awt
클래스 Choice

java.lang.Object 
  |
  +--java.awt.Component 
        |
        +--java.awt.Choice

모든 구현 인터페이스:

Accessible , ImageObserver , ItemSelectable , MenuContainer , Serializable

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");
 

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

이 그림에서는 녹색의 개소 가 현재의 선택 범위입니다. 오브젝트상에서 mouse button를 누르면(자), 현재의 선택 범위가 하이라이트 된 상태로 메뉴가 표시됩니다.

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

도입된 버젼:

JDK1. 0

관련 항목:

직렬화 된 형식

중첩된 클래스의 개요

protected class

Choice.AccessibleAWTChoice 이 클래스는 Choice 클래스용의 유저 보조 기능의 서포트를 구현하고 있습니다.

클래스 java.awt. Component 을 상속받은 중첩된 클래스

Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

클래스 java.awt. Component 에서 상속받은 필드

BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT

인터페이스 java.awt.image. ImageObserver 에서 상속받은 필드

ABORT , ALLBITS , ERROR , FRAMEBITS , HEIGHT , PROPERTIES , SOMEBITS , WIDTH

생성자의 개요

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 버젼 1.1 이후는 getItemCount() 를 사용
AccessibleContext	getAccessibleContext () 이 Choice 에 관련지을 수 있는 AccessibleContext 를 취득합니다.
String	getItem (int index) 이 Choice 메뉴내의 지정된 인덱스의 캐릭터 라인을 돌려줍니다.
int	getItemCount () 이 Choice 메뉴내의 항목수를 돌려줍니다.
ItemListener []	getItemListeners () 이 선택 범위에 등록되어 모든 항목 청취자의 배열을 돌려줍니다.
EventListener []	getListeners (Class listenerType) 이 Choice 에 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다.
int	getSelectedIndex () 현재 선택되고 있는 항목의 인덱스를 돌려줍니다.
String	getSelectedItem () 현재 선택되고 있는 캐릭터 라인 표현을 돌려줍니다.
Object []	getSelectedObjects () 현재 선택되고 있는 항목을 포함한 배열 (길이 1)을 돌려줍니다.
void	insert (String item, int index) 항목을 이 선택 범위의 지정된 위치에 삽입합니다.
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 , 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 , getMinimumSize , getMouseListeners , getMouseMotionListeners , 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 , isOpaque , 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 , setName , 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

public int countItems()

추천 되고 있지 않습니다. JDK 버젼 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)

항목을 이 선택 범위의 지정된 위치에 삽입합니다. 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()

현재 선택되고 있는 항목의 인덱스를 돌려줍니다.

관련 항목:

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 의 경우, 예외는 슬로우 되지 않고 처리도 실행되지 않습니다.

정의:

인터페이스 ItemSelectable 내의 addItemListener

파라미터:

l - 항목 청취자

도입된 버젼:

JDK1. 1

관련 항목:

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

removeItemListener

public void removeItemListener(ItemListener  l)

이 Choice 메뉴로부터 항목 이벤트를 받지 않게, 지정된 항목 청취자를 삭제합니다. 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

getListeners

public EventListener [] getListeners(Class  listenerType)

이 Choice 에 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다. 이 FooListener 는 addFooListener 메소드로 등록된 것입니다.

listenerType 인수는 FooListener.class 와 같은 클래스 리터럴로 지정할 수 있습니다. 예를 들어, 이 항목 청취자에 대한 Choice c 의 조회는 다음의 코드로 실시합니다.

ItemListener[] ils = (ItemListener[])(c.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)

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

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

오버라이드(override):

클래스 Component 내의 processEvent

파라미터:

e - 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

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

processItemEvent

protected void processItemEvent(ItemEvent  e)

이 Choice 메뉴로 발생하는 항목 이벤트를, 등록되어 모든 ItemListener 오브젝트에 디스팟치 하는 것으로써, 항목 이벤트를 처리합니다.

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

• ItemListener 오브젝트가 addItemListener 를 사용해 등록된다
• enableEvents 에 의해 항목 이벤트가 사용 가능하게 된다

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

파라미터:

e - 항목 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

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

paramString

protected String  paramString()

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

오버라이드(override):

클래스 Component 내의 paramString

반환값:

이 Choice 메뉴의 파라미터 캐릭터 라인

getAccessibleContext

public AccessibleContext  getAccessibleContext()

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

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 Component 내의 getAccessibleContext

반환값:

이 Choice 의 AccessibleContext 로서 기능하는 AccessibleAWTChoice