java.awt
클래스 MenuItem

java.lang.Object 
  java.awt.MenuComponent 
      java.awt.MenuItem

모든 구현된 인터페이스:

Serializable , Accessible

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

CheckboxMenuItem , Menu

public class MenuItem
extends MenuComponent 
implements Accessible 

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

디폴트의 MenuItem 객체는, 단순한 라벨이 붙은 메뉴 항목을 구현화합니다.

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

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

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

관련 항목:

직렬화 된 형식

상자의 클래스의 개요

protected class

MenuItem.AccessibleAWTMenuItem 접근성?의 디폴트 지원를 제공하는데 사용하는 MenuItem 의 내부 클래스입니다.

클래스 java.awt. MenuComponent 로부터 상속된 상자의 클래스/인터페이스

MenuComponent.AccessibleAWTMenuComponent

생성자 의 개요

MenuItem ()
빈 상태(empty) 라벨을 가져, 키보드 쇼트 컷이 없는 새로운 MenuItem 를 구축합니다.

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

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

메소드의 개요

void	addActionListener (ActionListener l) 이 메뉴 항목으로부터 액션 이벤트를 받는 액션 청취자를 추가합니다.
void	addNotify () 메뉴 항목의 피어를 작성합니다.
void	deleteShortcut () 이 메뉴 항목에 관련한 MenuShortcut 객체가 있으면 삭제합니다.
void	disable () 추천 되고 있지 않습니다. JDK version 1.1 이후는, setEnabled(boolean) 로 옮겨졌습니다.
protected void	disableEvents (long eventsToDisable) 지정된 이벤트 마스크 파라미터로 정의하는 이벤트에 대해, 이 메뉴 항목에의 송신을 불가로 합니다.
void	enable () 추천 되고 있지 않습니다. JDK version 1.1 이후는, setEnabled(boolean) 로 옮겨졌습니다.
void	enable (boolean b) 추천 되고 있지 않습니다. JDK version 1.1 이후는, setEnabled(boolean) 로 옮겨졌습니다.
protected void	enableEvents (long eventsToEnable) 지정된 이벤트 마스크 파라미터로 정의되는 이벤트에 대해, 이 메뉴 항목에의 송신을 가능하게 합니다.
AccessibleContext	getAccessibleContext () 이 MenuItem 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다.
String	getActionCommand () 이 메뉴 항목에 의해 트리거되는 액션 이벤트의 커멘드명을 돌려줍니다.
ActionListener []	getActionListeners () 이 메뉴 항목에 등록된 모든 액션 청취자의 배열을 돌려줍니다.
String	getLabel () 이 메뉴 항목의 라벨을 돌려줍니다.
<T extends EventListener > T[]	getListeners (Class <T> 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) 이 메뉴 항목의 라벨이 지정된 라벨로 설정합니다.
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 

빈 상태(empty) 라벨을 가져, 키보드 쇼트 컷이 없는 새로운 MenuItem 를 구축합니다.

예외:

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

도입된 버젼:

JDK1. 1

관련 항목:

GraphicsEnvironment.isHeadless()

MenuItem

public MenuItem(String  label)
         throws HeadlessException 

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

파라미터:

label - 이 메뉴 항목의 라벨

예외:

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

도입된 버젼:

JDK1. 0

관련 항목:

GraphicsEnvironment.isHeadless()

MenuItem

public MenuItem(String  label,
                MenuShortcut  s)
         throws HeadlessException 

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

파라미터:

label - 이 메뉴 항목의 라벨

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

예외:

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

도입된 버젼:

JDK1. 1

관련 항목:

GraphicsEnvironment.isHeadless()

메소드의 상세

addNotify

public void addNotify()

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

getLabel

public String  getLabel()

이 메뉴 항목의 라벨을 돌려줍니다.

반환값:

이 메뉴 항목의 라벨. 이 메뉴 항목이 라벨을 가지지 않는 경우는 null

도입된 버젼:

JDK1. 0

관련 항목:

setLabel(java.lang.String)

setLabel

public void setLabel(String  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

@Deprecated 
public void enable()

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

enable

@Deprecated 
public void enable(boolean b)

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

disable

@Deprecated 
public void disable()

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

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

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

파라미터:

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

도입된 버젼:

JDK1. 1

관련 항목:

getActionCommand()

getActionCommand

public String  getActionCommand()

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

도입된 버젼:

JDK1. 1

관련 항목:

setActionCommand(java.lang.String)

addActionListener

public void addActionListener(ActionListener  l)

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

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

l - 액션 청취자

도입된 버젼:

JDK1. 1

관련 항목:

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

removeActionListener

public void removeActionListener(ActionListener  l)

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

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

l - 액션 청취자

도입된 버젼:

JDK1. 1

관련 항목:

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

getActionListeners

public ActionListener [] getActionListeners()

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

반환값:

이 메뉴 항목의 모든 ActionListener, 또는 현재 액션 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

1.4

관련 항목:

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

getListeners

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

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

FooListener.class 라고 하는 클래스 리터럴을 사용해,listenerType 인수를 지정할 수 있습니다. 예를 들어, 다음의 코드를 사용해, 그 항목 청취자의 MenuItem m 를 조회할 수 있습니다. 이러한 청취자가 없는 경우는 빈 상태(empty)의 배열을 돌려줍니다.

파라미터:

listenerType - 요구되는 청취자의 형태. java.util.EventListener 의 하위 인터페이스를 지정

반환값:

이 컴퍼넌트에 FooListener 로서 등록되어 모든 객체의 배열. 이 메뉴 항목의 FooListener, 또는 그러한 청취자가 추가되어 있지 않은 경우는 빈 상태(empty)의 배열

예외:

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

도입된 버젼:

1.3

관련 항목:

getActionListeners()

processEvent

protected void processEvent(AWTEvent  e)

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

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

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

오버라이드(override):

클래스 MenuComponent 내의 processEvent

파라미터:

e - 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent  e)

이 메뉴 항목으로 발생한 액션 이벤트를, 등록된 ActionListener 객체에 발송 하는 것으로써, 이 액션 이벤트를 처리합니다. 이 컴퍼넌트에 대해서 액션 이벤트가 사용 가능하지 않은 한, 이 메소드는 불려 가지 않습니다. 액션 이벤트는, 다음의 어느 쪽인가의 경우에 사용 가능하게 됩니다.

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

　

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

파라미터:

e - 액션 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

ActionEvent , ActionListener , enableEvents(long)

paramString

public String  paramString()

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

오버라이드(override):

클래스 MenuComponent 내의 paramString

반환값:

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

getAccessibleContext

public AccessibleContext  getAccessibleContext()

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

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 MenuComponent 내의 getAccessibleContext

반환값:

이 MenuItem 의 AccessibleContext 로서 기능한다 AccessibleAWTMenuItem

도입된 버젼:

1.3