PHP Handbuch
Zurück |  | Nach vorne

# ncurses_getmouse

(PHP 4 >= 4.2.0, PHP 5)

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
`<?php 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_getmaxyx | Nach oben | ncurses_getyx