ncurses_getmouse

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

ncurses_getmouse — Lee los eventos del ratón

Descripción

ncurses_getmouse ( array &$mevent ) : bool
Advertencia

Esta función ha sido declarada EXPERIMENTAL. Su funcionamiento, nombre y la documentación que le acompaña puede cambiar sin previo aviso en futuras versiones de PHP. Utilícela bajo su propia responsabilidad.

ncurses_getmouse() lee los eventos del ratón de la cola.

Parámetros

mevent

Las opciones del evento serán distribuidas en este parámetro que ha de ser un array, pasado por referencia (véase el ejemplo de abajo).

En caso de éxito será distribuido un array con las siguientes claves:

  • "id" : Id para distinguir múltiples dispositivos

  • "x" : posición x relativa a la pantalla en las celdas de caracteres

  • "y" : posición y relativa a la pantalla en las celdas de caracteres

  • "z" : actualmente no soportado

  • "mmask" : Acción del ratón

Valores devueltos

Devuelve FALSE si un evento de ratón está realmente visible en la ventana dada, de otro modo devuelve TRUE.

Ejemplos

Ejemplo #1 Ejemplo de ncurses_getmouse()

<?php
switch (ncurses_getch()){
  case NCURSES_KEY_MOUSE:
    if (!ncurses_getmouse($mevent)){
      if ($mevent["mmask"] & NCURSES_MOUSE_BUTTON1_PRESSED){
        $mouse_x = $mevent["x"]; // Guardar la posición del ratón
        $mouse_y = $mevent["y"];
      }
    }
  break;

  default:
    /* .... */
}
?>

Ver también