53、Java高级GUI应用开发：工具提示、文件选择器、颜色选择器与菜单系统

Java高级GUI开发：组件与菜单系统详解

最新推荐文章于 2025-09-08 08:00:00 发布

dapp9builder

最新推荐文章于 2025-09-08 08:00:00 发布

阅读量31

点赞数

CC 4.0 BY-SA版权

分类专栏： Java编程入门：从控制结构到面向对象文章标签： Java GUI开发工具提示

本文链接：https://blog.youkuaiyun.com/dapp9builder/article/details/150522314

Java编程入门：从控制结构到面向对象专栏收录该内容

69 篇文章 ¥499.90

订阅专栏¥69.90

会员秒杀 ¥9.9 重磅福利

超级会员免费看

Java高级GUI应用开发：工具提示、文件选择器、颜色选择器与菜单系统

在Java的GUI应用开发中，为了提升用户体验和功能的完整性，有许多实用的组件和功能可供使用。本文将详细介绍工具提示、文件选择器、颜色选择器以及菜单系统的相关知识和使用方法。

1. 工具提示（Tool Tips）

工具提示是当用户将鼠标光标悬停在组件上时，在一个小框中显示的文本，通常用于简要描述该组件的功能。在Java中，可以使用从 JComponent 类继承的 setToolTipText 方法为组件分配工具提示。该方法的一般格式如下：

void setToolTipText(String text)

其中，作为参数传递的 String 就是将在组件的工具提示中显示的文本。例如，以下代码创建了一个“Exit”按钮并为其分配了工具提示：

JButton exitButton = new JButton("Exit");
exitButton.setToolTipText("Click here to exit.");

2. 文件选择器（File Choosers）

文件选择器是一种专门的对话框，允许用户浏览文件并选择它们。在Java中，可以使用 javax.swing 包中的 JFileChooser 类来显示文件选择器对话框。该类有两个常用的构造函数：
- JFileChooser() ：无参数构造函数，使用默认目录作为所有对话框的起始点。在Windows系统中，默认目录可能是用户账户下的“My Documents”文件夹；在UNIX系统中，是用户的登录目录。
- JFileChooser(String path) ：接受一个包含有效路径的 String 参数，该路径将作为对象对话框的起始点。

JFileChooser 对象可以显示两种预定义的对话框：打开文件对话框和保存文件对话框。
- 显示打开文件对话框 ：使用 showOpenDialog 方法，其一般格式如下：

int showOpenDialog(Component parent)

参数可以是 null 或对组件的引用。如果传递 null ，对话框通常会在屏幕中央显示；如果传递对组件（如 JFrame ）的引用，对话框将显示在该组件上方。
- 显示保存文件对话框 ：使用 showSaveDialog 方法，其一般格式如下：

int showSaveDialog(Component parent)

同样，参数可以是 null 或对组件的引用。 showOpenDialog 和 showSaveDialog 方法都会返回一个整数，用于指示用户关闭对话框时执行的操作。可以将返回值与以下常量进行比较：
- JFileChooser.CANCEL_OPTION ：表示用户点击了“Cancel”按钮。
- JFileChooser.APPROVE_OPTION ：表示用户点击了“Open”或“Save”按钮。
- JFileChooser.ERROR_OPTION ：表示发生了错误，或者用户点击了窗口上的标准关闭按钮来关闭对话框。

如果用户选择了一个文件，可以使用 getSelectedFile 方法来确定所选的文件。该方法返回一个 File 对象，其中包含有关所选文件的数据。可以使用 File 对象的 getPath 方法将路径和文件名作为 String 获取。以下是一个示例：

JFileChooser fileChooser = new JFileChooser();
int status = fileChooser.showOpenDialog(null);
if (status == JFileChooser.APPROVE_OPTION) {
    File selectedFile = fileChooser.getSelectedFile();
    String filename = selectedFile.getPath();
    JOptionPane.showMessageDialog(null, "You selected " + filename);
}

下面是一个关于文件选择器操作流程的mermaid流程图：

graph TD
    A[创建JFileChooser对象] --> B[调用showOpenDialog或showSaveDialog方法]
    B --> C{判断返回值}
    C -- CANCEL_OPTION --> D[用户取消操作]
    C -- APPROVE_OPTION --> E[获取所选文件]
    E --> F[使用getSelectedFile方法获取File对象]
    F --> G[使用getPath方法获取文件路径]
    C -- ERROR_OPTION --> H[处理错误]

3. 颜色选择器（Color Choosers）

颜色选择器是一种专门的对话框，允许用户从预定义的调色板中选择颜色。在Java中，可以使用 javax.swing 包中的 JColorChooser 类来显示颜色选择器对话框。该类有一个静态方法 showDialog ，其一般格式如下：

Color showDialog(Component parent, String title, Color initial)

第一个参数可以是 null 或对组件的引用。如果传递 null ，对话框通常会在屏幕中央显示；如果传递对组件（如 JFrame ）的引用，对话框将显示在该组件上方。
第二个参数是显示在对话框标题栏中的文本。
第三个参数表示对话框中最初显示为选中状态的颜色。

该方法返回用户选择的颜色。以下是一个示例，该代码允许用户选择一种颜色，并将该颜色分配为面板的背景颜色：

JPanel panel = new JPanel();
Color selectedColor;
selectedColor = JColorChooser.showDialog(null,
                "Select a Background Color", Color.BLUE);
panel.setBackground(selectedColor);

4. 菜单系统（Menus）

在Java中，可以使用一些类来创建下拉菜单系统。菜单系统可以包含菜单项、复选框菜单项、单选按钮菜单项和其他菜单。一个典型的菜单系统通常由以下几个部分组成：
- 菜单栏（Menu Bar） ：位于窗口顶部，标题栏下方，列出一个或多个菜单的名称。
- 菜单（Menu） ：是一个下拉列表，包含多个菜单项。用户可以通过点击菜单栏上的菜单名称来激活菜单。
- 菜单项（Menu Item） ：可以由用户选择，选择菜单项通常会执行某种操作。
- 复选框菜单项（Check Box Menu Item） ：旁边有一个小框，可以选中或取消选中。选中时，框中会出现一个复选标记；取消选中时，框为空。复选框菜单项通常用于打开或关闭某个选项。
- 单选按钮菜单项（Radio Button Menu Item） ：旁边有一个小圆圈，选中时圆圈会被填充，取消选中时为空。单选按钮菜单项也可用于打开或关闭某个选项。当一组单选按钮菜单项通过 ButtonGroup 对象分组时，同一时间只能选择其中一个。
- 子菜单（Submenu） ：是菜单中的菜单。当一个命令是子菜单的名称时，其右侧会出现一个小右箭头。激活子菜单名称会显示子菜单。
- 分隔条（Separator Bar） ：是一个水平条，用于分隔菜单上的项目组。分隔条仅作为视觉辅助工具，用户无法选择。

创建菜单系统通常使用以下类：
| 类名 | 用途 |
| ---- | ---- |
| JMenuItem | 创建常规菜单项，用户选择时会生成一个动作事件。 |
| JCheckBoxMenuItem | 创建复选框菜单项， isSelected 方法可返回该项是否被选中。用户选择时会生成一个动作事件。 |
| JRadioButtonMenuItem | 创建单选按钮菜单项，可通过 ButtonGroup 对象分组，确保同一时间只能选择一个。 isSelected 方法可返回该项是否被选中。用户选择时会生成一个动作事件。 |
| JMenu | 创建菜单，可包含 JMenuItem 、 JCheckBoxMenuItem 、 JRadioButton 组件以及其他 JMenu 组件。 |
| JMenuBar | 创建菜单栏，可包含 JMenu 组件。 |

以下是一个使用菜单系统的示例代码（ MenuWindow.java ）：

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;

/**
 * The MenuWindow class demonstrates a menu system.
 */
public class MenuWindow extends JFrame {
    private JLabel messageLabel;             // Displays a message
    private final int LABEL_WIDTH = 400;     // Label's width
    private final int LABEL_HEIGHT = 200;    // Label's height

    // The following will reference menu components.
    private JMenuBar menuBar;                // The menu bar
    private JMenu fileMenu;                  // The File menu
    private JMenu textMenu;                  // The Text menu
    private JMenuItem exitItem;              // To exit
    private JRadioButtonMenuItem blackItem;  // Makes text black
    private JRadioButtonMenuItem redItem;    // Makes text red
    private JRadioButtonMenuItem blueItem;   // Makes text blue
    private JCheckBoxMenuItem visibleItem;   // Toggle visibility

    /**
     * Constructor
     */
    public MenuWindow() {
        // Set the title.
        setTitle("Example Menu System");

        // Specify an action for the close button.
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

        // Create the messageLabel label.
        messageLabel = new JLabel("Use the Text menu to " +
                "change my color and make me invisible.",
                SwingConstants.CENTER);

        // Set the label's preferred size.
        messageLabel.setPreferredSize(
                new Dimension(LABEL_WIDTH, LABEL_HEIGHT));

        // Set the label's foreground color.
        messageLabel.setForeground(Color.BLACK);

        // Add the label to the content pane.
        add(messageLabel);

        // Build the menu bar.
        buildMenuBar();

        // Pack and display the window.
        pack();
        setVisible(true);
    }

    /**
     * The buildMenuBar method builds the menu bar.
     */
    private void buildMenuBar() {
        // Create the menu bar.
        menuBar = new JMenuBar();

        // Create the file and text menus.
        buildFileMenu();
        buildTextMenu();

        // Add the file and text menus to the menu bar.
        menuBar.add(fileMenu);
        menuBar.add(textMenu);

        // Set the window's menu bar.
        setJMenuBar(menuBar);
    }

    /**
     * The buildFileMenu method builds the File menu
     * and returns a reference to its JMenu object.
     */
    private void buildFileMenu() {
        // Create an Exit menu item.
        exitItem = new JMenuItem("Exit");
        exitItem.setMnemonic(KeyEvent.VK_X);
        exitItem.addActionListener(new ExitListener());

        // Create a JMenu object for the File menu.
        fileMenu = new JMenu("File");
        fileMenu.setMnemonic(KeyEvent.VK_F);

        // Add the Exit menu item to the File menu.
        fileMenu.add(exitItem);
    }

    /**
     * The buildTextMenu method builds the Text menu
     * and returns a reference to its JMenu object.
     */
    private void buildTextMenu() {
        // Create the radio button menu items to change
        // the color of the text. Add an action listener
        // to each one.
        blackItem = new JRadioButtonMenuItem("Black", true);
        blackItem.setMnemonic(KeyEvent.VK_B);
        blackItem.addActionListener(new ColorListener());

        redItem = new JRadioButtonMenuItem("Red");
        redItem.setMnemonic(KeyEvent.VK_R);
        redItem.addActionListener(new ColorListener());

        blueItem = new JRadioButtonMenuItem("Blue");
        blueItem.setMnemonic(KeyEvent.VK_U);
        blueItem.addActionListener(new ColorListener());

        // Create a button group for the radio button items.
        ButtonGroup group = new ButtonGroup();
        group.add(blackItem);
        group.add(redItem);
        group.add(blueItem);

        // Create a check box menu item to make the text
        // visible or invisible.
        visibleItem = new JCheckBoxMenuItem("Visible", true);
        visibleItem.setMnemonic(KeyEvent.VK_V);
        visibleItem.addActionListener(new VisibleListener());

        // Create a JMenu object for the Text menu.
        textMenu = new JMenu("Text");
        textMenu.setMnemonic(KeyEvent.VK_T);

        // Add the menu items to the Text menu.
        textMenu.add(blackItem);
        textMenu.add(redItem);
        textMenu.add(blueItem);
        textMenu.addSeparator();    // Add a separator bar.
        textMenu.add(visibleItem);
    }

    /**
     * Private inner class that handles the event that
     * is generated when the user selects Exit from
     * the File menu.
     */
    private class ExitListener implements ActionListener {
        public void actionPerformed(ActionEvent e) {
            System.exit(0);
        }
    }

    /**
     * Private inner class that handles the event that
     * is generated when the user selects a color from
     * the Text menu.
     */
    private class ColorListener implements ActionListener {
        public void actionPerformed(ActionEvent e) {
            if (blackItem.isSelected())
                messageLabel.setForeground(Color.BLACK);
            else if (redItem.isSelected())
                messageLabel.setForeground(Color.RED);
            else if (blueItem.isSelected())
                messageLabel.setForeground(Color.BLUE);
        }
    }

    /**
     * Private inner class that handles the event that
     * is generated when the user selects Visible from
     * the Text menu.
     */
    private class VisibleListener implements ActionListener {
        public void actionPerformed(ActionEvent e) {
            if (visibleItem.isSelected())
                messageLabel.setVisible(true);
            else
                messageLabel.setVisible(false);
        }
    }

    /**
     * The main method creates an instance of the
     * MenuWindow class, which causes it to display
     * its window.
     */
    public static void main(String[] args) {
        MenuWindow mw = new MenuWindow();
    }
}

在这个示例中， MenuWindow 类展示了一个菜单系统。窗口有一个菜单栏，包含“File”和“Text”两个菜单。当用户打开“Text”菜单时，可以使用单选按钮菜单项选择颜色，标签的颜色将随之改变。“Text”菜单还包含一个“Visible”复选框菜单项，选中时标签可见，取消选中时标签不可见。

通过以上介绍，我们了解了Java中工具提示、文件选择器、颜色选择器和菜单系统的使用方法。这些组件和功能可以帮助我们开发出更加丰富和易用的GUI应用程序。

Java高级GUI应用开发：工具提示、文件选择器、颜色选择器与菜单系统

5. `MenuWindow` 类详细解析

接下来，我们对 MenuWindow 类的代码进行更详细的解析，深入了解菜单系统的构建过程。

5.1 标签的创建与设置

在 MenuWindow 类的构造函数中，首先创建了一个 JLabel 组件 messageLabel ，用于显示提示信息。代码如下：

messageLabel = new JLabel("Use the Text menu to " +
        "change my color and make me invisible.",
        SwingConstants.CENTER);

这里通过 SwingConstants.CENTER 将文本在标签中居中显示。

然后，使用 setPreferredSize 方法设置标签的首选大小：

messageLabel.setPreferredSize(
        new Dimension(LABEL_WIDTH, LABEL_HEIGHT));

setPreferredSize 方法接受一个 Dimension 对象作为参数，该对象指定了组件的宽度和高度。在这个例子中， LABEL_WIDTH 和 LABEL_HEIGHT 分别为400和200，即标签的首选大小为400像素宽、200像素高。需要注意的是，这只影响标签组件的大小，不影响显示文本的大小。

最后，将标签添加到内容面板中：

add(messageLabel);

5.2 菜单栏的构建

在构造函数中调用了 buildMenuBar 方法来构建菜单栏：

buildMenuBar();

buildMenuBar 方法的具体实现如下：

private void buildMenuBar() {
    // Create the menu bar.
    menuBar = new JMenuBar();

    // Create the file and text menus.
    buildFileMenu();
    buildTextMenu();

    // Add the file and text menus to the menu bar.
    menuBar.add(fileMenu);
    menuBar.add(textMenu);

    // Set the window's menu bar.
    setJMenuBar(menuBar);
}

首先创建一个 JMenuBar 组件 menuBar ，它作为 JMenu 组件的容器。
然后分别调用 buildFileMenu 和 buildTextMenu 方法来创建“File”和“Text”菜单。
接着将这两个菜单添加到菜单栏中。
最后使用 setJMenuBar 方法将菜单栏设置到窗口中。

5.3 “File”菜单的构建

buildFileMenu 方法用于创建“File”菜单，代码如下：

private void buildFileMenu() {
    // Create an Exit menu item.
    exitItem = new JMenuItem("Exit");
    exitItem.setMnemonic(KeyEvent.VK_X);
    exitItem.addActionListener(new ExitListener());

    // Create a JMenu object for the File menu.
    fileMenu = new JMenu("File");
    fileMenu.setMnemonic(KeyEvent.VK_F);

    // Add the Exit menu item to the File menu.
    fileMenu.add(exitItem);
}

创建一个 JMenuItem 组件 exitItem ，表示“Exit”菜单项，并为其设置了 x 键作为助记符。
为 exitItem 添加了一个 ExitListener 监听器，当用户选择该菜单项时，会触发 ExitListener 的 actionPerformed 方法，使应用程序结束。
创建一个 JMenu 对象 fileMenu 表示“File”菜单，并为其设置了 F 键作为助记符。
将 exitItem 添加到 fileMenu 中。

5.4 “Text”菜单的构建

buildTextMenu 方法用于创建“Text”菜单，代码如下：

graph TD
    A[创建单选按钮菜单项] --> B[设置助记符和监听器]
    B --> C[创建按钮组并添加菜单项]
    C --> D[创建复选框菜单项]
    D --> E[设置助记符和监听器]
    E --> F[创建JMenu对象表示Text菜单]
    F --> G[添加菜单项和分隔条]

private void buildTextMenu() {
    // Create the radio button menu items to change
    // the color of the text. Add an action listener
    // to each one.
    blackItem = new JRadioButtonMenuItem("Black", true);
    blackItem.setMnemonic(KeyEvent.VK_B);
    blackItem.addActionListener(new ColorListener());

    redItem = new JRadioButtonMenuItem("Red");
    redItem.setMnemonic(KeyEvent.VK_R);
    redItem.addActionListener(new ColorListener());

    blueItem = new JRadioButtonMenuItem("Blue");
    blueItem.setMnemonic(KeyEvent.VK_U);
    blueItem.addActionListener(new ColorListener());

    // Create a button group for the radio button items.
    ButtonGroup group = new ButtonGroup();
    group.add(blackItem);
    group.add(redItem);
    group.add(blueItem);

    // Create a check box menu item to make the text
    // visible or invisible.
    visibleItem = new JCheckBoxMenuItem("Visible", true);
    visibleItem.setMnemonic(KeyEvent.VK_V);
    visibleItem.addActionListener(new VisibleListener());

    // Create a JMenu object for the Text menu.
    textMenu = new JMenu("Text");
    textMenu.setMnemonic(KeyEvent.VK_T);

    // Add the menu items to the Text menu.
    textMenu.add(blackItem);
    textMenu.add(redItem);
    textMenu.add(blueItem);
    textMenu.addSeparator();    // Add a separator bar.
    textMenu.add(visibleItem);
}

首先创建了三个 JRadioButtonMenuItem 组件 blackItem 、 redItem 和 blueItem ，分别表示“Black”、“Red”和“Blue”菜单项。其中 blackItem 初始被选中，并为每个菜单项设置了助记符和 ColorListener 监听器。
创建一个 ButtonGroup 对象 group ，将三个单选按钮菜单项添加到该组中，确保同一时间只能选择一个。
创建一个 JCheckBoxMenuItem 组件 visibleItem ，表示“Visible”菜单项，初始为选中状态，并为其设置了助记符和 VisibleListener 监听器。
创建一个 JMenu 对象 textMenu 表示“Text”菜单，并为其设置了 T 键作为助记符。
将单选按钮菜单项、分隔条和复选框菜单项依次添加到“Text”菜单中。

5.5 监听器的实现

MenuWindow 类中定义了三个内部类作为监听器： ExitListener 、 ColorListener 和 VisibleListener 。

ExitListener 用于处理“Exit”菜单项的选择事件：

private class ExitListener implements ActionListener {
    public void actionPerformed(ActionEvent e) {
        System.exit(0);
    }
}

当用户选择“Exit”菜单项时，调用 System.exit(0) 方法退出应用程序。

ColorListener 用于处理颜色菜单项的选择事件：

private class ColorListener implements ActionListener {
    public void actionPerformed(ActionEvent e) {
        if (blackItem.isSelected())
            messageLabel.setForeground(Color.BLACK);
        else if (redItem.isSelected())
            messageLabel.setForeground(Color.RED);
        else if (blueItem.isSelected())
            messageLabel.setForeground(Color.BLUE);
    }
}

根据用户选择的颜色菜单项，将 messageLabel 的前景色设置为相应的颜色。

VisibleListener 用于处理“Visible”菜单项的选择事件：

private class VisibleListener implements ActionListener {
    public void actionPerformed(ActionEvent e) {
        if (visibleItem.isSelected())
            messageLabel.setVisible(true);
        else
            messageLabel.setVisible(false);
    }
}

根据“Visible”菜单项的选中状态，设置 messageLabel 的可见性。

6. 总结

Java提供了丰富的组件和功能来开发高级GUI应用程序。工具提示可以为用户提供即时的帮助信息，通过 setToolTipText 方法轻松为组件添加。文件选择器和颜色选择器分别通过 JFileChooser 和 JColorChooser 类实现，方便用户进行文件操作和颜色选择。菜单系统则由 JMenuBar 、 JMenu 、 JMenuItem 等类构建，能够实现复杂的交互功能。

通过深入学习 MenuWindow 类的代码，我们详细了解了菜单系统的构建过程，包括标签的设置、菜单栏的创建、菜单项的添加以及监听器的实现。这些知识将帮助我们开发出更加完善和易用的Java GUI应用程序。

在实际开发中，我们可以根据具体需求对这些组件和功能进行灵活运用和扩展，例如添加更多的菜单项、自定义文件选择器的过滤规则等，以满足不同用户的多样化需求。

希望本文对你理解Java高级GUI应用开发有所帮助，你可以根据这些知识进行实践，不断提升自己的开发能力。