Lit les événements souris

# ncurses_getmouse

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

ncurses_getmouse — Lit les événements souris

### Description

ncurses_getmouse ( array `&$mevent` ) : bool
Avertissement

Cette fonction est EXPERIMENTALE. Le comportement de cette fonction, son nom, et toute la documentation autour de cette fonction peut changer sans préavis dans une prochaine version de PHP. Cette fonction doit être utilisée à vos risques et périls.

ncurses_getmouse() lit les événements souris placés dans la queue.

### Liste de paramètres

`mevent`

  Les options d'événements seront placées dans ce paramètre, qui doit être un tableau, passé par référence (voir l'exemple ci-dessous).

  En cas de succès, un tableau associatif, contenant les clés suivantes, sera délivré :

  - "id" : Identifiant permettant de distinguer plusieurs périphériques

  - "x" : Position à l'écran, en abscisse relative, et comptée en caractères

  - "y" : Position à l'écran, en ordonnée relative, et comptée en caractères

  - "z" : Actuellement non supporté

  - "mmask" : Action de souris

### Valeurs de retour

Retourne `FALSE` si un événement de souris est actuellement visible dans la fenêtre fournie, `TRUE` sinon.

### Exemples

Exemple #1 Exemple avec 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"]; // Sauve la position de la souris
$mouse_y = $mevent["y"];
}
}
break;
default:
/* .... */
}
?>`

### Voir aussi

- ncurses_ungetmouse() - Ajoute un événement souris dans la queue