Feeds: Artikel; Kommentare

PHP Dokumentation: Function ncurses-getmouse

12. Januar 2010 von werner

ncurses_getmouse

(PHP 4 >= 4.2.0, PHP 5 < 5.3.0, PECL ncurses >= 1.0.0)

ncurses_getmouse — Reads mouse event

Beschreibung

bool ncurses_getmouse ( array &$mevent )

Warnung

Diese Funktion istEXPERIMENTELL. Das Verhalten, der Funktionsname und allesAndere, was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohneAnkündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion aufeigenes Risiko.

ncurses_getmouse() reads mouse event out of queue.

Parameter-Liste

mevent

Event options will be delivered in this parameter 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

Rückgabewerte

Returns FALSE if a mouse event is actually visible in the given window, otherwise returns TRUE.

Beispiele

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;