Java AWT 事件處理：MouseListener 與 MouseAdapter 實現單擊/雙擊區分

Java AWT 事件處理：MouseListener 與 MouseAdapter 實現單擊/雙擊區分

AWT 元件支援滑鼠事件監聽，通過 MouseListener 介面或適配器 MouseAdapter 可輕鬆實現單擊、雙擊、進入、離開等交互。本文示範按鈕點擊計數與雙擊判定完整代碼。

核心 API

關鍵判定：雙擊識別

button.addMouseListener(new MouseAdapter() {
    @Override
    public void mouseClicked(MouseEvent e) {
        if (e.getClickCount() == 2) {
            System.out.println("偵測到雙擊");
        } else {
            System.out.println("單擊，計數: " + clickCount++);
        }
    }
});

MouseEvent.getClickCount() 返回連續點擊次數（系統級雙擊速度閾值判定）。

完整示例：按鈕單擊/雙擊/Action 對比

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

public class MouseEventDemo {
    public static void main(String[] args) {
        Frame f = new Frame("滑鼠事件示範");
        f.setBounds(300, 200, 300, 200);
        f.setLayout(new FlowLayout());

        Button btn = new Button("點擊測試");
        f.add(btn);

        // ActionEvent：鍵盤空格/Enter 也能觸發，語義更通用
        btn.addActionListener(e -> System.out.println("ActionEvent: 按鈕被激活"));

        // MouseEvent：可區分單雙擊，但鍵盤無法觸發
        btn.addMouseListener(new MouseAdapter() {
            int clickCount = 1;
            @Override public void mouseClicked(MouseEvent e) {
                if (e.getClickCount() == 2) {
                    System.out.println("MouseEvent: 雙擊!");
                } else {
                    System.out.println("MouseEvent: 第 " + clickCount++ + " 次單擊");
                }
            }
        });

        f.addWindowListener(new WindowAdapter() {
            @Override public void windowClosing(WindowEvent e) { System.exit(0); }
        });
        f.setVisible(true);
    }
}

ActionEvent vs MouseEvent 選擇建議

最佳實踐： 按鈕預設用 ActionListener；僅在需要「雙擊編輯」、「畫圖軌跡」等滑鼠專屬交互時加 MouseListener。

遷移提示

Swing 元件（JButton 等）同樣支援上述事件，且提供更豐富的 MouseInputListener（含 MouseMotionListener）。現代專案建議直接使用 Swing/JavaFX。