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

관련 항목:

직렬화 된 형식

중첩(Nested) 클래스 개요

protected class

Choice.AccessibleAWTChoice 이 클래스는 Choice 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.

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

생성자 개요

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 () 이 선택 범위에 등록되어 모든 항목 리스너의 배열을 리턴합니다.
<T extends EventListener > T[]	getListeners (Class <T> 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, 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, 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 버전 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()

현재 선택되고 있는 항목의 인덱스를 리턴합니다. 아무것도 선택되어 있지 않은 경우는 -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인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

정의:

인터페이스 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 <T extends EventListener > T[] getListeners(Class <T> 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 객체에 디스패치 하는 것으로써, 항목 이벤트를 처리합니다.

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

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

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

파라미터:

e - 항목 이벤트

도입된 버전 :

JDK1. 1

관련 항목:

ItemEvent, ItemListener, addItemListener(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