Java Applet 事件處理精講 (四)：滑鼠鍵盤事件完整 API 與互動範例

前言：事件驅動模型是 GUI 的靈魂

Applet (AWT 1.0/1.1 事件模型) 採用事件委派模型：事件源 (組件) 產生事件對象 → 註冊的監聽器接收處理。雖然現代 Swing/JavaFX 統一為 java.awt.event 套件，但理解 AWT 早期 Event 類與 handleEvent()、mouseDown() 等舊版事件處理方法，有助於閱讀舊代碼、把握事件傳遞本質。

一、滑鼠事件完整清單 (舊版 API)

所有方法回傳 boolean：true 表示已處理，阻止向上傳遞；false 繼續傳遞給父容器。

注意：AWT 1.0 單鍵滑鼠模型，不區分左右鍵；Event 對象封裝座標、修飾鍵 (Shift/Ctrl/Meta)、點擊次數等。

二、鍵盤事件完整清單 (舊版 API)

Event 類預定義虛擬鍵碼常量

字母數字鍵直接用 ASCII 碼 (如 'A', '1')；key 參數為 int，字符需轉型 (char)key。

三、互動範例精選

範例 1：滑鼠點哪兒，字串現哪兒

public class FollowMouse extends Applet {
    int cx = 50, cy = 50;  // 初始座標

    public boolean mouseDown(Event e, int x, int y) {
        cx = x; cy = y;     // 更新座標
        repaint();          // 排程重繪
        return true;        // 事件已處理
    }

    public void paint(Graphics g) {
        g.drawString("在哪兒按滑鼠，我就在哪出現！", cx, cy);
    }
}

流程：初始 paint() 顯示預設位置 → 用戶點擊 → mouseDown() 更新座標 → repaint() 觸發新 paint() → 字串跳轉至點擊處。

範例 2：滑鼠進入/離開顯示不同訊息

public class MouseMood extends Applet {
    String msg = "";

    public boolean mouseEnter(Event e, int x, int y) {
        msg = "你進來了，真討厭！拿開！拿開！！";
        repaint(); return true;
    }

    public boolean mouseExit(Event e, int x, int y) {
        msg = "你把滑鼠移開了，別走嘛！為什麼不移進來？";
        repaint(); return true;
    }

    public void paint(Graphics g) {
        g.drawString(msg, 4, 20);
    }
}

範例 3：鍵盤控制字符移動 (方向鍵/功能鍵/普通鍵)

public class KeyMover extends Applet {
    char pressKey = 0;
    int outX = 5, outY = 15;

    public boolean keyDown(Event e, int key) {
        switch (key) {
            case Event.UP:    outY--; break;
            case Event.DOWN:  outY++; break;
            case Event.LEFT:  outX--; break;
            case Event.RIGHT: outX++; break;
            case Event.HOME:  outX = 5; outY = 15; break;
            case Event.END:   outX = 5; outY = size().height - 15; break;
            case Event.PGUP:  outY -= 5; break;
            case Event.PGDN:  outY += 15; break;
            default:          pressKey = (char) key; break;  // 普通字符
        }
        repaint(); return true;
    }

    public void paint(Graphics g) {
        if (pressKey != 0)
            g.drawString("你按下了：" + pressKey + " 鍵", outX, outY);
    }
}

前置條件：Applet 區域必須先獲得焦點 (滑鼠點一下) 才能接收鍵盤事件。

四、從舊版 API 到現代事件模型 (AWT 1.1+ / Swing / JavaFX)

現代寫法對照 (Swing 範例)

// 滑鼠點擊 -> 彈出座標
component.addMouseListener(new MouseAdapter() {
    @Override public void mousePressed(MouseEvent e) {
        System.out.println("Clicked at: " + e.getPoint());
    }
});

// 鍵盤輸入 -> 顯示字符
component.addKeyListener(new KeyAdapter() {
    @Override public void keyTyped(KeyEvent e) {
        System.out.println("Typed: " + e.getKeyChar());
    }
});

五、避坑與最佳實踐

• 高頻事件節流：mouseMove/mouseDrag 極高頻，避免在內部執行複雜計算/IO；必要時用標誌位+定時器批次處理。
• 焦點管理：鍵盤事件僅送達擁有焦點的組件；確保 setFocusable(true)、requestFocusInWindow()。
• 座標轉換：跨組件繪製/碰撞檢測時，用 SwingUtilities.convertPoint() 統一座標空間。
• 事件消費：現代模型用 consume() 阻止預設行為 (如 JTextField 吞噬特定按鍵)；舊版回傳 true。
• 棄用警告：Event 類及 handleEvent() 等方法標註 @Deprecated，新代碼請勿使用。