MenuItem (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## 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

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.