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

bool ncurses_getmouse ( array &$mevent )

Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et, concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS ! Soyez-en conscient, et utilisez cette fonction à 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

add a note User Contributed Notes
ncurses_getmouse

m dot quinton at gmail dot com
26-Sep-2005 11:05


a working example with mouse, 3 windows  (need to be completed, but it works) ...



<?php



error_reporting(E_ALL);



function win($w, $h, $x, $y, $txt){

    // now lets create a small window

    $win = ncurses_newwin($w, $h, $x, $y);

    // border our small window.

    ncurses_wborder($win,0,0, 0,0, 0,0, 0,0);

    # ncurses_wrefresh($win);// paint both windows

    ncurses_refresh();// paint both windows



    // move into the small window and write a string

    ncurses_mvwaddstr($win, 0, 1, " $txt ");

    ncurses_mvwaddstr($win, 1, 1, "($w, $h, $x, $y)");



    // show our handiwork and refresh our small window

    ncurses_wrefresh($win);



    return $win;

}



// Initialie ncurses

$ncurse = ncurses_init();

// A full screen window



$win0 = win(0, 0, 0, 0, 'win0');

$win1 = win(10, 30, 7, 25, 'win1');

$win2 = win(10, 30, 20, 25, 'win2');

$info = win(15, 20, 2, 2, 'info');



// Draw everything so far

// ncurses_refresh();



$newmask = NCURSES_BUTTON1_CLICKED + NCURSES_BUTTON1_RELEASED;

# $newmask = NCURSES_ALL_MOUSE_EVENTS;



$mask = ncurses_mousemask($newmask, &$oldmask);

$events = array();



while(1){



    ncurses_wmove($info, 1,1);

    $ch = ncurses_getch();



    ncurses_wclear($info);

    ncurses_refresh();// paint both windows

    ncurses_wborder($info,0,0, 0,0, 0,0, 0,0);

    ncurses_refresh();// paint both windows

    ncurses_mvwaddstr($win, 0, 1, " info ");

    ncurses_refresh();// paint both windows



    switch($ch){



    case NCURSES_KEY_MOUSE:



        if(ncurses_getmouse($mevent)){

            $events[] = $mevent;



            ncurses_mvwaddstr($info, 2, 1, " mouse event   ");

            ncurses_mvwaddstr($info, 3, 1, " ({$mevent['x']}/{$mevent['y']}) ");

            ncurses_mvwaddstr($info, 4, 1, " ({$mevent['mmask']}) ");



            ncurses_wrefresh($info);

        }

        break;



    case chr('q'):

        break 2;



    default:



        if($ch > 0x40)

            $txt = chr($ch) . " $ch ";

        else

            $txt = '.' . " $ch";



        ncurses_mvwaddstr($info, 1, 1, " $txt   ");

        ncurses_wrefresh($info);



    }



    if(chr($ch) == 'q')

        break;

}



ncurses_end();// clean up our screen



print_r($events);



?>

add a note

ncurses_getyx

ncurses_getmaxyx

Last updated: Fri, 14 Aug 2009