java.awt
클래스 MenuItem

java.lang.Object 
  |
  +--java.awt.MenuComponent 
        |
        +--java.awt.MenuItem

모든 구현 인터페이스:

Accessible , Serializable

직계의 기존의 서브 클래스:

CheckboxMenuItem , Menu

public class MenuItem

extends MenuComponent

implements Accessible

메뉴내의 모든 항목은 MenuItem 클래스인가 그 서브 클래스의 1 개에 속하고 있을 필요가 있습니다.

디폴트의 MenuItem 오브젝트는 단순한 label가 붙은 메뉴 항목을 구현화합니다.

도구모음의 이 화상은 5 개의 메뉴 항목을 표시합니다.
최초의 2 개의 항목은 "Basic" 와 "Simple" 라고 하는 label가 붙은 단순한 메뉴 항목입니다. 이하의 2 개의 항목은 separator로, 그 자체가, label "-" 로 작성되는 메뉴 항목입니다. 다음은 "Check" 라고 하는 label가 붙은 CheckboxMenuItem 의 인스턴스입니다. 마지막 메뉴 항목은 "More Examples" 라고 하는 label가 붙은 부메뉴로, 이 부메뉴는 Menu 의 인스턴스입니다.

메뉴 항목이 선택되면(자), AWT 는 메뉴 항목에 액션 이벤트를 보냅니다. 그 이벤트는 ActionEvent 의 인스턴스이므로,processEvent 메소드는 그 이벤트를 조사해, 그것을 processActionEvent 에 건네줍니다. processActionEvent 메소드는 이벤트를, 이 메뉴 항목에 의해 생성된 액션 이벤트의 통지를 대상으로 해 등록하고 있는 모든 ActionListener 오브젝트에 전송 합니다.

다만,Menu 서브 클래스는 이 동작을 오버라이드(override) 해, 그 서브 항목의 1 개가 선택될 때까지 어느 이벤트도 프레임에 보내지 않습니다.

관련 항목:

직렬화 된 형식

중첩된 클래스의 개요

protected class

MenuItem.AccessibleAWTMenuItem 유저 보조 기능의 디폴트 서포트를 제공하는데 사용하는 MenuItem 의 내부 클래스입니다.

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

생성자의 개요

MenuItem ()
하늘 label를 가져, 키보드 쇼트 컷이 없는 새로운 MenuItem 를 구축합니다.

MenuItem (String label)
지정된 label를 가져, 키보드 쇼트 컷이 없는 새로운 MenuItem 를 구축합니다.

MenuItem (String label, MenuShortcut s)
관련하고 있는 키보드 쇼트 컷을 가지는 메뉴 항목을 구축합니다.

메소드의 개요

void	addActionListener (ActionListener l) 이 메뉴 항목으로부터 액션 이벤트를 받는 액션 청취자를 추가합니다.
void	addNotify () 메뉴 항목의 피어를 작성합니다.
void	deleteShortcut () 이 메뉴 항목에 관련한 MenuShortcut 오브젝트가 있으면 삭제합니다.
void	disable () 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 setEnabled(boolean) 를 사용
protected void	disableEvents (long eventsToDisable) 지정된 이벤트 마스크 파라미터로 정의하는 이벤트에 대해, 이 메뉴 항목에의 송신을 불가로 합니다.
void	enable () 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 setEnabled(boolean) 를 사용
void	enable (boolean b) 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 setEnabled(boolean) 를 사용
protected void	enableEvents (long eventsToEnable) 지정된 이벤트 마스크 파라미터로 정의되는 이벤트에 대해, 이 메뉴 항목에의 송신을 가능하게 합니다.
AccessibleContext	getAccessibleContext () 이 MenuItem 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다.
String	getActionCommand () 이 메뉴 항목에 의해 방아쇠 되는 액션 이벤트의 커멘드명을 돌려줍니다.
ActionListener []	getActionListeners () 이 메뉴 항목에 등록된 모든 액션 청취자의 배열을 돌려줍니다.
String	getLabel () 이 메뉴 항목의 label를 돌려줍니다.
EventListener []	getListeners (Class listenerType) 이 MenuItem 에 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다.
MenuShortcut	getShortcut () 이 메뉴 항목에 관련한 MenuShortcut 오브젝트를 돌려줍니다.
boolean	isEnabled () 이 메뉴 항목이 사용 가능하게 되어 있는지 어떤지를 판정합니다.
String	paramString () 이 MenuItem 상태를 나타내는 캐릭터 라인을 돌려줍니다.
protected void	processActionEvent (ActionEvent e) 이 메뉴 항목으로 발생한 액션 이벤트를, 등록된 ActionListener 오브젝트에 디스팟치 하는 것으로써, 이 액션 이벤트를 처리합니다.
protected void	processEvent (AWTEvent e) 이 메뉴 항목의 이벤트를 처리합니다.
void	removeActionListener (ActionListener l) 지정된 액션 청취자를 삭제합니다.
void	setActionCommand (String command) 이 메뉴 항목으로 방아쇠 되는 액션 이벤트의 커멘드명을 설정합니다.
void	setEnabled (boolean b) 이 메뉴 항목을 선택 가능하게 할지 어떨지를 설정합니다.
void	setLabel (String label) 이 메뉴 항목의 label가 지정된 label로 설정합니다.
void	setShortcut (MenuShortcut s) 이 메뉴 항목에 관련한 MenuShortcut 오브젝트를 설정합니다.

클래스 java.awt. MenuComponent 에서 상속받은 메소드

dispatchEvent , getFont , getName , getParent , getPeer , getTreeLock , postEvent , removeNotify , setFont , setName , toString

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

생성자의 상세

MenuItem

public MenuItem()
         throws HeadlessException 

하늘 label를 가져, 키보드 쇼트 컷이 없는 새로운 MenuItem 를 구축합니다.

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

도입된 버젼:

JDK1. 1

관련 항목:

GraphicsEnvironment.isHeadless()

MenuItem

public MenuItem(String  label)
         throws HeadlessException 

지정된 label를 가져, 키보드 쇼트 컷이 없는 새로운 MenuItem 을 구축합니다. 다만, label에서의 "-" 의 사용은 메뉴 항목간의 separator를 나타내기 위해서(때문에) 예약됩니다. 디폴트에서는 separator를 제외한 모든 메뉴 항목이 사용 가능합니다.

파라미터:

label - 이 메뉴 항목의 label

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

도입된 버젼:

JDK1. 0

관련 항목:

GraphicsEnvironment.isHeadless()

MenuItem

public MenuItem(String  label,
                MenuShortcut  s)
         throws HeadlessException 

관련하고 있는 키보드 쇼트 컷을 가지는 메뉴 항목을 구축합니다. 다만, label에서의 "-" 의 사용은 메뉴 항목간의 separator를 나타내기 위해서(때문에) 예약됩니다. 디폴트에서는 separator를 제외한 모든 메뉴 항목이 사용 가능합니다.

파라미터:

label - 이 메뉴 항목의 label

s - 이 메뉴 항목에 관련한 MenuShortcut 의 인스턴스

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

도입된 버젼:

JDK1. 1

관련 항목:

GraphicsEnvironment.isHeadless()

메소드의 상세

addNotify

public void addNotify()

메뉴 항목의 피어를 작성합니다. 피어를 사용하면(자), 피어의 기능성을 바꾸지 않고 , 메뉴 항목의 외관을 변경할 수가 있습니다.

getLabel

public String  getLabel()

이 메뉴 항목의 label를 돌려줍니다.

반환값:

이 메뉴 항목의 label. 이 메뉴 항목이 label를 가지지 않는 경우는 null

도입된 버젼:

JDK1. 0

관련 항목:

setLabel(java.lang.String)

setLabel

public void setLabel(String  label)

이 메뉴 항목의 label가 지정된 label로 설정합니다.

파라미터:

label - 새로운 label. label가 없는 경우는 null

도입된 버젼:

JDK1. 0

관련 항목:

getLabel()

isEnabled

public boolean isEnabled()

이 메뉴 항목이 사용 가능하게 되어 있는지 어떤지를 판정합니다.

도입된 버젼:

JDK1. 0

관련 항목:

setEnabled(boolean)

setEnabled

public void setEnabled(boolean b)

이 메뉴 항목을 선택 가능하게 할지 어떨지를 설정합니다.

파라미터:

b - true 의 경우는 이 메뉴 항목을 사용 가능하게 해,false 의 경우는 사용 불가로 하는

도입된 버젼:

JDK1. 1

관련 항목:

isEnabled()

enable

public void enable()

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 setEnabled(boolean) 를 사용

enable

public void enable(boolean b)

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 setEnabled(boolean) 를 사용

disable

public void disable()

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 setEnabled(boolean) 를 사용

getShortcut

public MenuShortcut  getShortcut()

이 메뉴 항목에 관련한 MenuShortcut 오브젝트를 돌려줍니다.

반환값:

이 메뉴 항목에 관련한 메뉴 쇼트 컷. 아무것도 지정되어 있지 않은 경우는 null

도입된 버젼:

JDK1. 1

관련 항목:

setShortcut(java.awt.MenuShortcut)

setShortcut

public void setShortcut(MenuShortcut  s)

이 메뉴 항목에 관련한 MenuShortcut 오브젝트를 설정합니다. 메뉴 쇼트 컷이 벌써 이 메뉴 항목에 관련했을 경우는 옮겨놓을 수 있습니다.

파라미터:

s - 이 메뉴 항목에 관련한 메뉴 쇼트 컷

도입된 버젼:

JDK1. 1

관련 항목:

getShortcut()

deleteShortcut

public void deleteShortcut()

이 메뉴 항목에 관련한 MenuShortcut 오브젝트가 있으면 삭제합니다.

도입된 버젼:

JDK1. 1

enableEvents

protected final void enableEvents(long eventsToEnable)

지정된 이벤트 마스크 파라미터로 정의되는 이벤트에 대해, 이 메뉴 항목에의 송신을 가능하게 합니다.

이벤트 타입은 그 타입의 청취자가 그 메뉴 항목에 추가되면(자), 자동적으로 사용 가능하게 됩니다. 이 메소드를 호출할 필요가 있는 것은 MenuItem 의 서브 클래스가, 지정된 이벤트 타입을 processEvent 에 보내는 경우만입니다. 청취자가 등록되어 있을지 어떨지는 이 경우 관계 없습니다.

파라미터:

eventsToEnable - 이벤트 타입을 정의하는 이벤트 마스크

도입된 버젼:

JDK1. 1

관련 항목:

processEvent(java.awt.AWTEvent) , disableEvents(long) , Component.enableEvents(long)

disableEvents

protected final void disableEvents(long eventsToDisable)

지정된 이벤트 마스크 파라미터로 정의하는 이벤트에 대해, 이 메뉴 항목에의 송신을 불가로 합니다.

파라미터:

eventsToDisable - 이벤트 타입을 정의하는 이벤트 마스크

도입된 버젼:

JDK1. 1

관련 항목:

processEvent(java.awt.AWTEvent) , enableEvents(long) , Component.disableEvents(long)

setActionCommand

public void setActionCommand(String  command)

이 메뉴 항목으로 방아쇠 되는 액션 이벤트의 커멘드명을 설정합니다.

디폴트에서는 액션 커멘드는 메뉴 항목의 label로 설정됩니다.

파라미터:

command - 이 메뉴 항목용으로 설정되는 액션 커멘드

도입된 버젼:

JDK1. 1

관련 항목:

getActionCommand()

getActionCommand

public String  getActionCommand()

이 메뉴 항목에 의해 방아쇠 되는 액션 이벤트의 커멘드명을 돌려줍니다.

도입된 버젼:

JDK1. 1

관련 항목:

setActionCommand(java.lang.String)

addActionListener

public void addActionListener(ActionListener  l)

이 메뉴 항목으로부터 액션 이벤트를 받는 액션 청취자를 추가합니다. l 가 null 의 경우, 예외는 슬로우 되지 않고 처리도 실행되지 않습니다.

파라미터:

l - 액션 청취자

도입된 버젼:

JDK1. 1

관련 항목:

removeActionListener(java.awt.event.ActionListener) , getActionListeners() , ActionEvent , ActionListener

removeActionListener

public void removeActionListener(ActionListener  l)

지정된 액션 청취자를 삭제합니다. 이것에 의해 그 청취자는 이후, 이 메뉴 항목으로부터 액션 이벤트를 받지 않습니다. l 가 null 의 경우, 예외는 슬로우 되지 않고 처리도 실행되지 않습니다.

파라미터:

l - 액션 청취자

도입된 버젼:

JDK1. 1

관련 항목:

addActionListener(java.awt.event.ActionListener) , getActionListeners() , ActionEvent , ActionListener

getActionListeners

public ActionListener [] getActionListeners()

이 메뉴 항목에 등록된 모든 액션 청취자의 배열을 돌려줍니다.

반환값:

이 메뉴 항목의 모든 ActionListener, 또는 현재 액션 청취자가 등록되지 않은 경우는 하늘의 배열

도입된 버젼:

1.4

관련 항목:

addActionListener(java.awt.event.ActionListener) , removeActionListener(java.awt.event.ActionListener) , ActionEvent , ActionListener

getListeners

public EventListener [] getListeners(Class  listenerType)

이 MenuItem 에 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다. FooListener 는 addFooListener 메소드를 사용해 등록됩니다.

FooListener.class 등의 클래스 리터럴을 가지는 listenerType 인수를 지정할 수 있습니다. 예를 들어, 다음의 코드를 사용해, 그 항목 청취자의 MenuItem m 를 조회할 수 있습니다.

ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class));

이러한 청취자가 존재하지 않는 경우, 이 메소드는 하늘의 배열을 돌려줍니다.

파라미터:

listenerType - 요구된 청취자의 형태. 이 파라미터는 java.util.EventListener 로부터 파생하는 인터페이스를 지정한다

반환값:

이 메뉴 항목의 FooListener 로서 등록된 모든 오브젝트의 배열, 또는 이러한 청취자가 추가되지 않았던 경우는 하늘의 배열

예외:

ClassCastException - listenerType 가,java.util.EventListener 를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우

도입된 버젼:

1.3

관련 항목:

getActionListeners()

processEvent

protected void processEvent(AWTEvent  e)

이 메뉴 항목의 이벤트를 처리합니다. 이벤트가 ActionEvent 의 인스턴스의 경우,MenuItem 에 의해 정의된 것 외의 메소드인 processActionEvent 를 호출합니다.

현재, 메뉴 항목은 액션 이벤트만을 서포트하고 있습니다.

이벤트 파라미터가 null 의 경우, 동작이 지정되지 않고 예외가 발생하는 것에 주의해 주세요.

오버라이드(override):

클래스 MenuComponent 내의 processEvent

파라미터:

e - 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent  e)

이 메뉴 항목으로 발생한 액션 이벤트를, 등록된 ActionListener 오브젝트에 디스팟치 하는 것으로써, 이 액션 이벤트를 처리합니다. 이 메소드는 액션 이벤트가 이 컴퍼넌트용으로 사용 가능하게 안 되는 한 불려 가지 않습니다. 액션 이벤트는 다음의 항목의 1 개가 발생했을 때에 사용 가능하게 됩니다.

• ActionListener 오브젝트가 addActionListener 에 의해 등록되어 있다
• enableEvents 에 의해 액션 이벤트가 사용 가능하게 되어 있다

이벤트 파라미터가 null 의 경우, 동작이 지정되지 않고 예외가 발생하는 것에 주의해 주세요.

파라미터:

e - 액션 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

ActionEvent , ActionListener , enableEvents(long)

paramString

public String  paramString()

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

오버라이드(override):

클래스 MenuComponent 내의 paramString

반환값:

이 메뉴 항목의 파라미터 캐릭터 라인

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 MenuItem 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다. 도구모음의 경우, AccessibleContext 는 AccessibleAWTMenuItem 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleAWTMenuItem 인스턴스가 작성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 MenuComponent 내의 getAccessibleContext

반환값:

이 MenuItem 의 AccessibleContext 로서 기능하는 AccessibleAWTMenuItem