Swing JCheckboxMenuItem類

JCheckboxMenuItem類表示可以包含在選單中的核取方塊。選中選單中的核取方塊可將控制元件的狀態從開啟更改為關閉或從關閉更改為開啟。

類宣告

以下是javax.swing.JCheckBoxMenuItem類的宣告 -

public class JCheckBoxMenuItem
   extends JMenuItem
      implements SwingConstants, Accessible

類建構函式

編號	建構函式	描述
1	`JCheckboxMenuItem()`	建立一個最初未選中的核取方塊選單項，不設定文字或圖示。
2	`JCheckboxMenuItem(Action a)`	建立一個選單項，其屬性取自提供的`Action`。
3	`JCheckboxMenuItem(Icon icon)`	使用圖示建立最初未選中的核取方塊選單項。
4	`JCheckboxMenuItem(String text)`	使用文字建立最初未選中的核取方塊選單項。
5	`JCheckboxMenuItem(String text, boolean b)`	建立具有指定文字和選擇狀態的核取方塊選單項。
6	`JCheckboxMenuItem(String text, Icon icon)`	使用指定的文字和圖示建立最初未選中的核取方塊選單項。
7	`JCheckboxMenuItem(String text, Icon icon, boolean b)`	建立具有指定文字，圖示和選擇狀態的核取方塊選單項。

類方法

編號	類方法	描述
1	`AccessibleContext getAccessibleContext()`	獲取與此`JCheckBoxMenuItem`關聯的`AccessibleContext`。
2	`Object[] getSelectedObjects()`	返回包含核取方塊選單項標籤的陣列(長度為`1`)，如果未選中該核取方塊，則返回`null`。
3	`boolean getState()`	返回項的選定狀態。
4	`String getUIClassID()`	返回呈現此元件的L＆F類的名稱。
5	`protected String paramString()`	返回此`JCheckBoxMenuItem`的字串表示形式。
6	`void setState(boolean b)`	設定專案的選定狀態。

方法繼承

該類繼承以下類中的方法 -

javax.swing.JMenuItem
javax.swing.JAbstractButton
javax.swing.JComponent
java.awt.Container
java.awt.Component
java.lang.Object

JCheckboxMenuItem範例

使用編輯器建立以下Java程式：JCheckboxMenuItemDemo.java

package com.yiibai.menu;

import javax.swing.*;

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

public class JCheckboxMenuItemDemo {
    private JFrame mainFrame;
    private JLabel headerLabel;
    private JLabel statusLabel;
    private JPanel controlPanel;

    public JCheckboxMenuItemDemo() {
        prepareGUI();
    }

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

    private void prepareGUI() {
        mainFrame = new JFrame("Java SWING JCheckboxMenuItemDemo(tw511.com)");
        mainFrame.setSize(400, 400);
        mainFrame.setLayout(new GridLayout(3, 1));

        headerLabel = new JLabel("", JLabel.CENTER);
        statusLabel = new JLabel("", JLabel.CENTER);
        statusLabel.setSize(350, 100);

        mainFrame.addWindowListener(new WindowAdapter() {
            public void windowClosing(WindowEvent windowEvent) {
                System.exit(0);
            }
        });
        controlPanel = new JPanel();
        controlPanel.setLayout(new FlowLayout());

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

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

        // create menus
        JMenu fileMenu = new JMenu("檔案");
        JMenu editMenu = new JMenu("編輯");
        final JMenu aboutMenu = new JMenu("關於");
        final JMenu linkMenu = new JMenu("連結");

        // create menu items
        JMenuItem newMenuItem = new JMenuItem("新建");
        newMenuItem.setMnemonic(KeyEvent.VK_N);
        newMenuItem.setActionCommand("New");

        JMenuItem openMenuItem = new JMenuItem("開啟");
        openMenuItem.setActionCommand("Open");

        JMenuItem saveMenuItem = new JMenuItem("儲存");
        saveMenuItem.setActionCommand("Save");

        JMenuItem exitMenuItem = new JMenuItem("退出");
        exitMenuItem.setActionCommand("Exit");

        JMenuItem cutMenuItem = new JMenuItem("剪下");
        cutMenuItem.setActionCommand("Cut");

        JMenuItem copyMenuItem = new JMenuItem("複製");
        copyMenuItem.setActionCommand("Copy");

        JMenuItem pasteMenuItem = new JMenuItem("貼上");
        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 JCheckBoxMenuItem showWindowMenu = new JCheckBoxMenuItem("顯示關於", true);
        showWindowMenu.addItemListener(new ItemListener() {
            public void itemStateChanged(ItemEvent e) {

                if (showWindowMenu.getState()) {
                    menuBar.add(aboutMenu);
                } else {
                    menuBar.remove(aboutMenu);
                }
            }
        });
        final JRadioButtonMenuItem showLinksMenu = new JRadioButtonMenuItem("顯示連結", true);

        showLinksMenu.addItemListener(new ItemListener() {
            public void itemStateChanged(ItemEvent e) {

                if (menuBar.getMenu(3) != null) {
                    menuBar.remove(linkMenu);
                    mainFrame.repaint();
                } else {
                    menuBar.add(linkMenu);
                    mainFrame.repaint();
                }
            }
        });
        // add menu items to menus
        fileMenu.add(newMenuItem);
        fileMenu.add(openMenuItem);
        fileMenu.add(saveMenuItem);
        fileMenu.addSeparator();
        fileMenu.add(showWindowMenu);
        fileMenu.addSeparator();
        fileMenu.add(showLinksMenu);
        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);
        menuBar.add(linkMenu);

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

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

執行上面範例程式碼，得到以下結果：

JCheckboxMenuItem