Forum und email
ncurses_getmouse

ncurses_getmouse

(PHP 4 >= 4.2.0, PHP 5)

ncurses_getmouse -- Reads mouse event

Opis

bool ncurses_getmouse ( array &mevent )

Ostrzeżenie

Ta funkcja jest w stadium EKSPERYMENTALNYM. Oznacza to, że zachowanie funkcji, jej nazwa, w zasadzie wszystko udokumentowane tutaj może zostać zmienione w przyszłych wersjach PHP bez wcześniejszego uprzedzenia. Używaj tej funkcji na własne ryzyko.

ncurses_getmouse() reads mouse event out of queue.

Parametry

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

Zwracane wartości

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

Przykłady

Przykład 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:
    
/* .... */
}
?>

Patrz także

ncurses_ungetmouse()