Name

mouseDragged()

Description

The mouseDragged() function is called once every time the mouse moves while a mouse button is pressed. (If a button is not being pressed, mouseMoved() is called instead.)

This function can be called with or without a MouseEvent parameter. When called with the parameter, you get access to additional information about the mouse event, including the exact coordinates, which button is being dragged, and any modifier keys that were held down.

Mouse and keyboard events only work when a program has draw(). Without draw(), the code is only run once and then stops listening for events.

Examples

  • // Drag (click and hold) your mouse across the 
    // image to change the value of the rectangle
    
    int value = 0;
    
    void draw() {
      fill(value);
      rect(25, 25, 50, 50);
    }
    
    void mouseDragged() 
    {
      value = value + 5;
      if (value > 255) {
        value = 0;
      }
    }
    

Syntax

  • mouseDragged()
  • mouseDragged(event)

Parameters

  • event(MouseEvent)the MouseEvent

Return

  • void