Classe AWT MenuItem

Introdução

A classe MenuBar representa o item real em um menu. Todos os itens em um menu devem derivar da classe MenuItem ou de uma de suas subclasses. Por padrão, ele incorpora um item de menu rotulado simples.

Declaração de classe

A seguir está a declaração para java.awt.MenuItem classe:

public class MenuItem
   extends MenuComponent
      implements Accessible

Construtores de classe

SN Construtor e descrição
1

MenuItem()

Constrói um novo MenuItem com um rótulo vazio e nenhum atalho de teclado.

2

MenuItem(String label)

Constrói um novo MenuItem com o rótulo especificado e sem atalho de teclado.

3

MenuItem(String label, MenuShortcut s)

Crie um item de menu com um atalho de teclado associado.

Métodos de aula

SN Método e Descrição
1

void addActionListener(ActionListener l)

Adiciona o ouvinte de ação especificado para receber eventos de ação deste item de menu.

2

void addNotify()

Cria o par do item de menu.

3

void deleteShortcut()

Exclua qualquer objeto MenuShortcut associado a este item de menu.

4

void disable()

Descontinuada. A partir do JDK versão 1.1, substituído por setEnabled (booleano).

5

protected void disableEvents(long eventsToDisable)

Desativa a entrega de eventos para este item de menu para eventos definidos pelo parâmetro de máscara de evento especificado.

6

void enable()

Descontinuada. A partir do JDK versão 1.1, substituído por setEnabled (booleano).

7

void enable(boolean b)

Descontinuada. A partir do JDK versão 1.1, substituído por setEnabled (booleano).

8

protected void enableEvents(long eventsToEnable)

Ativa a entrega de eventos a este item de menu para eventos a serem definidos pelo parâmetro de máscara de evento especificado.

9

AccessibleContext getAccessibleContext()

Obtém o AccessibleContext associado a este MenuItem.

10

String getActionCommand()

Obtém o nome do comando do evento de ação disparado por este item de menu.

11

ActionListener[] getActionListeners()

Retorna uma matriz de todos os ouvintes de ação registrados neste item de menu.

12

String getLabel()

Obtém o rótulo deste item de menu.

13

EventListener[] getListeners(Class listenerType)

Retorna uma matriz de todos os objetos atualmente registrados como FooListeners neste MenuItem.

14

MenuShortcut getShortcut()

Obtenha o objeto MenuShortcut associado a este item de menu.

15

boolean isEnabled()

Verifica se este item de menu está habilitado.

16

String paramString()

Retorna uma string que representa o estado deste MenuItem.

17

protected void processActionEvent(ActionEvent e)

Processa eventos de ação que ocorrem neste item de menu, despachando-os para quaisquer objetos ActionListener registrados.

18

protected void processEvent(AWTEvent e)

Processa eventos neste item de menu.

19

void removeActionListener(ActionListener l)

Remove o ouvinte de ação especificado para que ele não receba mais eventos de ação deste item de menu.

20

void setActionCommand(String command)

Define o nome do comando do evento de ação que é disparado por este item de menu.

21

void setEnabled(boolean b)

Define se este item de menu pode ou não ser escolhido.

22

void setLabel(String label)

Define o rótulo deste item de menu para o rótulo especificado.

23

void setShortcut(MenuShortcut s)

Defina o objeto MenuShortcut associado a este item de menu.

Métodos herdados

Esta classe herda métodos das seguintes classes:

  • java.awt.MenuComponent

  • java.lang.Object

Exemplo de MenuItem

Crie o seguinte programa java usando qualquer editor de sua escolha em dizer D:/ > AWT > com > tutorialspoint > gui >

AWTMenuDemo.java
package com.tutorialspoint.gui;

import java.awt.*;
import java.awt.event.*;

public class AWTMenuDemo {
   private Frame mainFrame;
   private Label headerLabel;
   private Label statusLabel;
   private Panel controlPanel;

   public AWTMenuDemo(){
      prepareGUI();
   }

   public static void main(String[] args){
      AWTMenuDemo  awtMenuDemo = new AWTMenuDemo();     
      awtMenuDemo.showMenuDemo();
   }

   private void prepareGUI(){
      mainFrame = new Frame("Java AWT Examples");
      mainFrame.setSize(400,400);
      mainFrame.setLayout(new GridLayout(3, 1));
      mainFrame.addWindowListener(new WindowAdapter() {
         public void windowClosing(WindowEvent windowEvent){
            System.exit(0);
         }        
      });    
      headerLabel = new Label();
      headerLabel.setAlignment(Label.CENTER);
      statusLabel = new Label();        
      statusLabel.setAlignment(Label.CENTER);
      statusLabel.setSize(350,100);

      controlPanel = new Panel();
      controlPanel.setLayout(new FlowLayout());

      mainFrame.add(headerLabel);
      mainFrame.add(controlPanel);
      mainFrame.add(statusLabel);
      mainFrame.setVisible(true);  
   }

   private void showMenuDemo(){
      //create a menu bar
      final MenuBar menuBar = new MenuBar();

      //create menus
      Menu fileMenu = new Menu("File");
      Menu editMenu = new Menu("Edit"); 
      final Menu aboutMenu = new Menu("About");

      //create menu items
      MenuItem newMenuItem = 
         new MenuItem("New",new MenuShortcut(KeyEvent.VK_N));
      newMenuItem.setActionCommand("New");

      MenuItem openMenuItem = new MenuItem("Open");
      openMenuItem.setActionCommand("Open");

      MenuItem saveMenuItem = new MenuItem("Save");
      saveMenuItem.setActionCommand("Save");

      MenuItem exitMenuItem = new MenuItem("Exit");
      exitMenuItem.setActionCommand("Exit");

      MenuItem cutMenuItem = new MenuItem("Cut");
      cutMenuItem.setActionCommand("Cut");

      MenuItem copyMenuItem = new MenuItem("Copy");
      copyMenuItem.setActionCommand("Copy");

      MenuItem pasteMenuItem = new MenuItem("Paste");
      pasteMenuItem.setActionCommand("Paste");
   
      MenuItemListener menuItemListener = new MenuItemListener();

      newMenuItem.addActionListener(menuItemListener);
      openMenuItem.addActionListener(menuItemListener);
      saveMenuItem.addActionListener(menuItemListener);
      exitMenuItem.addActionListener(menuItemListener);
      cutMenuItem.addActionListener(menuItemListener);
      copyMenuItem.addActionListener(menuItemListener);
      pasteMenuItem.addActionListener(menuItemListener);

      final CheckboxMenuItem showWindowMenu = 
         new CheckboxMenuItem("Show About", true);
      showWindowMenu.addItemListener(new ItemListener() {
         public void itemStateChanged(ItemEvent e) {
            if(showWindowMenu.getState()){
               menuBar.add(aboutMenu);
            }else{
               menuBar.remove(aboutMenu);
            }
         }
      });

      //add menu items to menus
      fileMenu.add(newMenuItem);
      fileMenu.add(openMenuItem);
      fileMenu.add(saveMenuItem);
      fileMenu.addSeparator();
      fileMenu.add(showWindowMenu);
      fileMenu.addSeparator();
      fileMenu.add(exitMenuItem);

      editMenu.add(cutMenuItem);
      editMenu.add(copyMenuItem);
      editMenu.add(pasteMenuItem);

      //add menu to menubar
      menuBar.add(fileMenu);
      menuBar.add(editMenu);
      menuBar.add(aboutMenu);

      //add menubar to the frame
      mainFrame.setMenuBar(menuBar);
      mainFrame.setVisible(true);  
}

   class MenuItemListener implements ActionListener {
      public void actionPerformed(ActionEvent e) {            
         statusLabel.setText(e.getActionCommand() 
            + " MenuItem clicked.");
      }    
   }
}

Compile o programa usando o prompt de comando. Vamos paraD:/ > AWT e digite o seguinte comando.

D:\AWT>javac com\tutorialspoint\gui\AWTMenuDemo.java

Se nenhum erro ocorrer, significa que a compilação foi bem-sucedida. Execute o programa usando o seguinte comando.

D:\AWT>java com.tutorialspoint.gui.AWTMenuDemo

Verifique a seguinte saída. (Clique no menu Arquivo. Selecione qualquer item do menu.)