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