PHP Handbuch
Zurück |  | Nach vorne

# ncurses_getmouse

(PHP 4 >= 4.2.0)

ncurses_getmouse -- Reads mouse event

## Description

bool ncurses_getmouse ( array mevent)

Warnung
Diese Funktion ist EXPERIMENTELL. Das Verhalten, der Funktionsname und alles Andere was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf eigenes Risiko.

ncurses_getmouse() reads mouse event out of queue. Function ncurses_getmouse() will return ;`FALSE` if a mouse event is actually visible in the given window, otherwise it will return `TRUE`. Event options will be delivered in parameter `mevent`, which has to be an array, passed by reference (see example below). On success an associative array with following keys will be delivered:

- "id" : Id to distinguish multiple devices

- "x" : screen relative x-position in character cells

- "y" : screen relative y-position in character cells

- "z" : currently not supported

- "mmask" : Mouse action

Beispiel 1. ncurses_getmouse() example
    switch (ncurses_getch){
      case NCURSES_KEY_MOUSE:
        if (!ncurses_getmouse(&$mevent)){
          if ($mevent["mmask"] & NCURSES_MOUSE_BUTTON1_PRESSED){
            $mouse_x = $mevent["x"]; // Save mouse position
            $mouse_y = $mevent["y"];
          }
        }
      break;

      default:
        ....
    }

See also: ncurses_ungetmouse()

Zurück | Zum Anfang | Nach vorne
ncurses_getch | Nach oben | ncurses_halfdelay