JavaTM 2
Platform
Std.  Ed.  v1. 4.0

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)
          이 MenuItemFooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다.
 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)
MenuItemFooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다. FooListeneraddFooListener 메소드를 사용해 등록됩니다.

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 개가 발생했을 때에 사용 가능하게 됩니다.

이벤트 파라미터가 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

JavaTM 2
Platform
Std.  Ed.  v1. 4.0

버그의 보고와 기능의 리퀘스트
이외의 API 레퍼런스 및 개발자용 문서에 대해서는 Java 2 SDK SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.