JavaにおけるMouseListenerとMouseMotionListenerの違いを徹底解説

Javaでマウスイベントを処理する際、マウスが静止している状態（クリックや押下など）のイベントにはMouseListenerインターフェースを実装し、マウスが動いている状態（移動やドラッグ）のイベントにはMouseMotionListenerインターフェースを実装します。両者の違いを理解しておくと、目的に応じた適切なリスナーを選択できるようになります。

MouseListenerとは

MouseEventは、ソースオブジェクト上でマウスボタン（左ボタンまたは右ボタン）を押したとき、離したとき、クリックした（押してから離す一連の動作）ときに発生します。また、マウスポインタがソースオブジェクト上に入った（enter）とき、およびオブジェクトから出た（exit）ときにも発生します。

MouseListenerインターフェースは、以下の5つの抽象メソッドを宣言しています。

構文

public void mouseClicked(MouseEvent evt)
public void mousePressed(MouseEvent evt)
public void mouseReleased(MouseEvent evt)
public void mouseEntered(MouseEvent evt)
public void mouseExited(MouseEvent evt)

各メソッドの役割

• mouseClicked：ボタンが押されて離された（クリック完了）ときに呼ばれる
• mousePressed：ボタンが押された瞬間に呼ばれる
• mouseReleased：ボタンが離された瞬間に呼ばれる
• mouseEntered：ポインタがコンポーネントの領域に入ったときに呼ばれる
• mouseExited：ポインタがコンポーネントの領域から出たときに呼ばれる

コード例

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

public class MouseListenerTest extends JFrame implements MouseListener {
   private JTextField tfMouseX, tfMouseY;

   public MouseListenerTest() {
      setLayout(new FlowLayout());
      add(new Label("X-Click: "));
      tfMouseX = new JTextField(10);
      tfMouseX.setEditable(false);
      add(tfMouseX);

      add(new Label("Y-Click: "));
      tfMouseY = new JTextField(10);
      tfMouseY.setEditable(false);
      add(tfMouseY);

      addMouseListener(this);

      setTitle("MouseListener Test");
      setLocationRelativeTo(null);
      setSize(350, 100);
      setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
      setVisible(true);
   }

   public static void main(String[] args) {
      new MouseListenerTest();
   }

   @Override
   public void mouseClicked(MouseEvent evt) {
      tfMouseX.setText(evt.getX() + "");
      tfMouseY.setText(evt.getY() + "");
   }

   // コンパイルを通すために空の実装を用意
   @Override public void mousePressed(MouseEvent evt) { }
   @Override public void mouseReleased(MouseEvent evt) { }
   @Override public void mouseEntered(MouseEvent evt) { }
   @Override public void mouseExited(MouseEvent evt) { }
}

実行結果

MouseMotionListenerとは

ソースオブジェクト上でマウスポインタを移動させたりドラッグしたりした場合にも、MouseEventが発生します。ただし、これらのイベント（mouse-move／mouse-drag）を処理するには、MouseMotionListenerを使用する必要があります。

MouseMotionListenerインターフェースは、以下の2つの抽象メソッドを宣言しています。

構文

public void mouseDragged(MouseEvent e)
public void mouseMoved(MouseEvent e)

各メソッドの役割

• mouseDragged：ボタンを押しながらマウスをドラッグしている間、継続的に呼ばれる
• mouseMoved：ボタンを押さずにマウスを移動している間、継続的に呼ばれる

コード例

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

public class MouseMotionListenerTest extends JFrame implements MouseListener, MouseMotionListener {
   private JTextField tfMouseClickX, tfMouseClickY;
   private JTextField tfMousePositionX, tfMousePositionY;

   public MouseMotionListenerTest() {
      setLayout(new FlowLayout());
      add(new Label("X-Click: "));
      tfMouseClickX = new JTextField(10);
      tfMouseClickX.setEditable(false);
      add(tfMouseClickX);

      add(new Label("Y-Click: "));
      tfMouseClickY = new JTextField(10);
      tfMouseClickY.setEditable(false);
      add(tfMouseClickY);

      add(new JLabel("X-Position: "));
      tfMousePositionX = new JTextField(10);
      tfMousePositionX.setEditable(false);
      add(tfMousePositionX);

      add(new JLabel("Y-Position: "));
      tfMousePositionY = new JTextField(10);
      tfMousePositionY.setEditable(false);
      add(tfMousePositionY);

      addMouseListener(this);
      addMouseMotionListener(this);

      setTitle("MouseMotionListener Test");
      setSize(400, 120);
      setLocationRelativeTo(null);
      setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
      setVisible(true);
   }

   public static void main(String[] args) {
      new MouseMotionListenerTest();
   }

   @Override
   public void mouseClicked(MouseEvent evt) {
      tfMouseClickX.setText(evt.getX() + "");
      tfMouseClickY.setText(evt.getY() + "");
   }

   // コンパイルを通すために空の実装を用意
   @Override public void mousePressed(MouseEvent evt) { }
   @Override public void mouseReleased(MouseEvent evt) { }
   @Override public void mouseEntered(MouseEvent evt) { }
   @Override public void mouseExited(MouseEvent evt) { }

   @Override
   public void mouseMoved(MouseEvent evt) {
      tfMousePositionX.setText(evt.getX() + "");
      tfMousePositionY.setText(evt.getY() + "");
   }

   // コンパイルを通すために空の実装を用意
   @Override public void mouseDragged(MouseEvent evt) { }
}

実行結果

両者の違いまとめ

このように、MouseListenerは「押す・離す・クリックする・入る・出る」といった静的なマウス操作を扱い、MouseMotionListenerは「移動・ドラッグ」といった動的なマウス操作を扱います。両者は排他的なものではなく、上記の例のように同時に実装することも可能です。用途に応じて適切に使い分けることで、より直感的で操作性の高いGUIアプリケーションを構築できます。