Scilab Function
Last update : 14/12/2005

xclick - attend un appui sur un bouton de la souris

### Calling Sequence

  `[c_i,c_x,c_y,c_w,c_m]=xclick([flag])`

### Parameters

- `c_i` : entier, numéro de bouton
- `c_x,c_y` : scalaire réel, position du pointeur de la souris
- `c_w` : entier, numéro de fenêtre.
- `c_m` : chaîne de caractères, callback de menu
- `flag` : entier. S'il est présent, la queue d'évènements des clics de souris n'est pas vidée préalablement.

### Description

`xclick` attend l'appui sur un bouton de la souris.

Appelée avec 3 arguments en sortie, cette fonction attend qu'un bouton de la souris soit pressé avec le pointeur dans la fenêtre graphique courante.

Avec 4 ou 5 arguments en sortie, l'appui sur un bouton de la souris est attendu dans toutes les fenêtres graphiques.

Les valeurs renvoyées par xclick sont décrites ci-dessous :

  c_i: un entier donnant le numéro du bouton ou de la touche pressé.
    c_i==0:Le bouton gauche a été pressé
    c_i==1: Le bouton central a été pressé
    c_i==2: Le bouton droit a été pressé

    c_i==3: Le bouton gauche a été cliqué
    c_i==4: Le bouton central a été cliqué
    c_i==5: Le bouton droit a été cliqué

    c_i==10: Le bouton gauche a été double-cliqué
    c_i==11: Le bouton central a été double-cliqué
    c_i==12: Le bouton droit a été double-cliqué

    c_i > =32: La touche de code ascii ascii(c_i) a été cliqué
    c_i > =1000+32: La touche de code ascii ascii(c_i-1000) a été cliqué avec la touche CTRL enfoncée.
    c_i==-100: La fenêtre graphique
    c_i==-2: Un menu dynamique a été selectionné
  c_x,c_y: les coordonnées de la position du curseur au moment du clic, à l'échelle graphique courante.
  c_w: le numéro de la fenêtre ou le clic s'est produit.
  c_m: chaîne de caractères associée à un menu dynamique. Si xclick se termine à cause d'un clic sur l'article d'un menu, `c_i`, `c_x`, `c_y,` et `c_w` prennent des valeurs arbitraires

### PROBLÈMES CONNUS

`xclick` peut renvoyer le message "Can't grab the pointer" si la fenêtre graphique courante est iconifiée au moment de l'appel.

### See Also

`locate`, `xgetmouse`,

### Author

J.Ph.C.