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개가 선택될 때까지 어느 이벤트도 프레임에 보내지 않습니다.

관련 항목:

직렬화 된 형식

중첩(Nested) 클래스 개요

protected class

MenuItem.AccessibleAWTMenuItem 사용자 보조 기능의 디폴트 지원를 제공하는데 사용하는 MenuItem 내부 클래스입니다.

클래스 java.awt. MenuComponent 로부터 상속된 중첩(Nested) 클래스/인터페이스

MenuComponent.AccessibleAWTMenuComponent

생성자 개요

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

MenuItem (String 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 () 이 메뉴 항목의 라벨을 리턴합니다.
<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 

빈 라벨을 가져, 키보드 쇼트 컷이 없는 새로운 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 버전 1.1 그 뒤로는 setEnabled(boolean)를 사용합니다.

enable

@Deprecated 
public void enable(boolean b)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setEnabled(boolean)를 사용합니다.

disable

@Deprecated 
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)

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

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

파라미터:

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 <T extends EventListener > T[] getListeners(Class <T> 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