Manual do PHP
Anterior |  | Próxima

# ncurses_getmouse

(PHP 4 >= 4.2.0, PHP 5)

ncurses_getmouse -- Reads mouse event

## Descrição

bool ncurses_getmouse ( array &mevent )

Atenção
Esta função é EXPERIMENTAL. Isso quer dizer que o comportamento desta função e seu nome, incluindo TUDO o que está documentado aqui pode mudar em futuras versões do PHP, SEM QUALQUER NOTIFICAÇÃO. Esteja avisado, e use esta função por sua própria conta e risco.

ncurses_getmouse() reads mouse event out of queue.

## Parâmetros

`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

## Valores de retornado

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

## Exemplos

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

## Veja também

ncurses_ungetmouse()

Anterior | Principal | Próxima
ncurses_getmaxyx | Acima | ncurses_getyx