Как Записать Слушателю Мыши

События от нажатия мыши уведомляют, когда пользователь использует мышь (или подобное устройство ввода данных), чтобы взаимодействовать с компонентом. События от нажатия мыши происходят, когда курсор вводит или выходит из экранной области компонента и когда пользователь нажимает или отпускает одну из кнопок мыши.

Отслеживание движения курсора включает значительно больше системных издержек чем отслеживание других событий от нажатия мыши. Именно поэтому события движения мыши разделяются на тип слушателя Движения Мыши (см., Как Записать Слушателю Движения Мыши).

Чтобы отследить события колеса мыши, можно зарегистрировать слушателя колеса мыши. См., Как Записать Слушателю Колеса Мыши для получения дополнительной информации.

Если приложение требует обнаружения обоих событий от нажатия мыши и событий движения мыши, используйте MouseInputAdapter class. Этот class реализует MouseInputListener, удобный интерфейс, который реализует MouseListener и MouseMotionListener интерфейсы. Однако, MouseInputListener интерфейс не реализует MouseWheelListener интерфейс.

Альтернативно, используйте соответствующий AWT MouseAdapter class, который реализует MouseListener, MouseMotionListener, и MouseWheelListener интерфейсы.

Следующий пример показывает слушателю мыши. Наверху окна пустая область (реализованный названным class BlankArea). Слушатель мыши прислушивается к событиям оба на BlankArea и на его контейнере, экземпляре MouseEventDemo. Каждый раз, когда событие от нажатия мыши происходит, дескриптивное сообщение выводится на экран под пустой областью. Перемещая курсор сверху пустой области и иногда нажимая кнопки мыши, можно запустить события от нажатия мыши.

Можно найти код демонстрационного примера в MouseEventDemo.java и BlankArea.java. Вот код обработки события от нажатия мыши демонстрационного примера:

public class MouseEventDemo ... implements MouseListener {
        //where initialization occurs:
        //Register for mouse events on blankArea and the panel.
        blankArea.addMouseListener(this);
        addMouseListener(this);
    ...

    public void mousePressed(MouseEvent e) {
       saySomething("Mouse pressed; # of clicks: "
                    + e.getClickCount(), e);
    }

    public void mouseReleased(MouseEvent e) {
       saySomething("Mouse released; # of clicks: "
                    + e.getClickCount(), e);
    }

    public void mouseEntered(MouseEvent e) {
       saySomething("Mouse entered", e);
    }

    public void mouseExited(MouseEvent e) {
       saySomething("Mouse exited", e);
    }

    public void mouseClicked(MouseEvent e) {
       saySomething("Mouse clicked (# of clicks: "
                    + e.getClickCount() + ")", e);
    }

    void saySomething(String eventDescription, MouseEvent e) {
        textArea.append(eventDescription + " detected on "
                        + e.getComponent().getClass().getName()
                        + "." + newline);
    }
}

API Слушателя Мыши

Интерфейс MouseListener

MouseAdapter class (адаптер AWT class) абстрактен. У всех его методов есть пустое тело. Таким образом, разработчик может определить методы для событий, определенных для приложения. Можно также использовать MouseInputAdapter class, который имеет все методы в наличии от MouseListener и MouseMotionListener.

Класс MouseEvent

Класс InputEvent

MouseEvent class наследовал много полезных методов от InputEvent и пары удобных методов от ComponentEvent и AWTEvent классы.

(mouseEvent.getModifiers() & InputEvent.BUTTON3_MASK)
== InputEvent.BUTTON3_MASK

if (event.getModifiersEx() & (BUTTON1_DOWN_MASK |
                              BUTTON2_DOWN_MASK |
                              BUTTON3_DOWN_MASK)
                               == BUTTON1_DOWN_MASK) {
    ...
}

Класс MouseInfo

MouseInfo class обеспечивает методы, чтобы получить информацию о расположении указателя мыши в любое время, в то время как приложение работает.

Примеры Та Мышь Использования Слушатели

Следующая таблица приводит примеры та мышь использования слушатели.