Classe AWT CheckboxMenuItem

Introdução

A classe CheckboxMenuItem representa uma caixa de seleção que pode ser incluída em um menu. Selecionar a caixa de seleção no menu altera o estado do controle deon para off ou de off para on.

Declaração de classe

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

public class CheckboxMenuItem
   extends MenuItem
      implements ItemSelectable, Accessible

Construtores de classe

SN Construtor e descrição
1

CheckboxMenuItem()

Crie um item de menu de caixa de seleção com um rótulo vazio.

2

CheckboxMenuItem(label)

Crie um item de menu de caixa de seleção com o rótulo especificado.

3

CheckboxMenuItem(label, boolean state)

Crie um item de menu de caixa de seleção com o rótulo e estado especificados.

Métodos de aula

SN Método e Descrição
1

void addItemListener(ItemListener l)

Adiciona o ouvinte de item especificado para receber eventos de item deste item de menu da caixa de seleção.

2

void addNotify()

Cria o par do item da caixa de seleção.

3

AccessibleContext getAccessibleContext()

Obtém o AccessibleContext associado a este CheckboxMenuItem.

4

ItemListener[] getItemListeners()

Retorna uma matriz de todos os ouvintes de item registrados neste item de menu da caixa de seleção.

5

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

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

6

Object[] getSelectedObjects()

Retorna uma matriz (comprimento 1) contendo o rótulo do item de menu da caixa de seleção ou nulo se a caixa de seleção não estiver selecionada.

7

boolean getState()

Determina se o estado deste item de menu da caixa de seleção é "ligado" ou "desligado".

8

param()

Retorna um representando o estado deste CheckBoxMenuItem.

9

protected void processEvent(AWTEvent e)

Processa eventos neste item de menu da caixa de seleção.

10

protected void processItemEvent(ItemEvent e)

Processa eventos de item que ocorrem neste item de menu da caixa de seleção, despachando-os para quaisquer objetos ItemListener registrados.

11

void removeItemListener(ItemListener l)

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

12

void setState(boolean b)

Define este item de menu da caixa de seleção para o estado especificado.

Métodos herdados

Esta classe herda métodos das seguintes classes:

  • java.awt.MenuItem

  • java.awt.MenuComponent

  • java.lang.Object

Exemplo de CheckboxMenuItem

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(

[] 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. Desmarque o item de menu "Mostrar Sobre".)