ncurses_getmouse

(PHP 4 >= 4.2.0, PHP 5)

ncurses_getmouse -- Reads mouse event

Beskrivelse

bool ncurses_getmouse ( array &mevent )

Advarsel

Denne funktion er EKSPERIMENTABEL. Virkemåden af denne funktion, navnet på funktionen, og andet ellers dokumenteret om denne funktion, ændres muligvis uden advarsel i en fremtidig version af PHP. Brug af denne funktion er på ejet ansvar.

ncurses_getmouse() reads mouse event out of queue.

Parameterliste

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

Returneringsværdier

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

Eksempler

Eksempel 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:
    
/* .... */
}
?>

Se også

ncurses_ungetmouse()