ncurses_mousemask
(PHP 4 >= 4.2.0, PHP 5, PECL ncurses:1.0.0)
ncurses_mousemask — Establece opciones del mouse
Descripción
Esta función es EXPERIMENTAL. Esto significa que el comportamiento de esta función, el nombre de esta función y en definitiva TODO lo documentado sobre esta función, puede cambiar en una futura version de PHP SIN AVISO. La advertencia queda hecha, y utilizar esta extensión queda bajo su propia responsabilidad.
Establece los eventos del mouse a ser reportados. Por omisión, ningún evento del mouse será reportado.
Los eventos del mouse son representados por NCURSES_KEY_MOUSE en la secuencia de entrada ncurses_wgetch(). Para leer los datos del evento y recuperar el evento de la cola, llame a ncurses_getmouse().
Lista de parámetros
- nueva_mascara
-
Las opciones de máscara del mouse pueden definirse con las siguientes constantes predefinidas:
NCURSES_BUTTON1_PRESSED
NCURSES_BUTTON1_RELEASED
NCURSES_BUTTON1_CLICKED
NCURSES_BUTTON1_DOUBLE_CLICKED
NCURSES_BUTTON1_TRIPLE_CLICKED
NCURSES_BUTTON2_PRESSED
NCURSES_BUTTON2_RELEASED
NCURSES_BUTTON2_CLICKED
NCURSES_BUTTON2_DOUBLE_CLICKED
NCURSES_BUTTON2_TRIPLE_CLICKED
NCURSES_BUTTON3_PRESSED
NCURSES_BUTTON3_RELEASED
NCURSES_BUTTON3_CLICKED
NCURSES_BUTTON3_DOUBLE_CLICKED
NCURSES_BUTTON3_TRIPLE_CLICKED
NCURSES_BUTTON4_PRESSED
NCURSES_BUTTON4_RELEASED
NCURSES_BUTTON4_CLICKED
NCURSES_BUTTON4_DOUBLE_CLICKED
NCURSES_BUTTON4_TRIPLE_CLICKED
NCURSES_BUTTON_SHIFT>
NCURSES_BUTTON_CTRL
NCURSES_BUTTON_ALT
NCURSES_ALL_MOUSE_EVENTS
NCURSES_REPORT_MOUSE_POSITION
Como efecto secundario, definir una máscara del mouse como cero en nueva_mascara deshabilita el puntero del mouse. Definir un valor distinto de cero habilita el puntero del mouse.
- vieja_mascara
-
Esta variable recibirá el valor previo de la máscara de eventos del mouse.
Valores retornados
Devuelve una máscara para indicar cúales de los eventos especificados en el parámetro nueva_mascara pueden ser reportados. En caso de un total fracaso, devuelve 0.
Ejemplos
Example#1 Ejemplo de ncurses_mousemask()
<?php
$nueva_mascara = NCURSES_BUTTON1_CLICKED + NCURSES_BUTTON1_RELEASED;
$mascara = ncurses_mousemask($nueva_mascara, &$vieja_mascara);
if ($mascara & $nueva_mascara){
printf("Todas las opciones del mouse especificadas serán soportadas\n");
}
?>