XSelectInput.3x

Autres langues

Langue: fr

Autres versions - même langue

Version: Release 6.5 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

NOM

XSelectInput - sélection d'événements d'entrée

SYNTAXE

XSelectInput(display, f, masque_événements)

      Display *display;

      Window f;

      long masque_événements;

ARGUMENTS

display
Spécifie la connexion au serveur X.
f
Spécifie la fenêtre pour laquelle on souhaite sélectionner les événements.
masque_événements
Spécifie le masque des événements sélectionnés.

DESCRIPTION

La fonction XSelectInput demande au serveur X de notifier les événements associés au masque d'événements spécifié. Initialement, X ne notifie aucun événement. Les événements sont notifiés relativement à une fenêtre. Si une fenêtre n'est pas intéressée par un événement lié à un périphérique, elle le propage habituellement à l'ancêtre la plus proche qui est intéressée, à moins que que le masque do_not_propagate (NDT. ne_pas_propager) ne l'interdise.

Positionner l'attribut masque d'événements pour une fenêtre, écrase tout appel précédent pour la même fenêtre mais uniquement pour le client qui réalise cet appel. Plusieurs clients peuvent sélectionner les mêmes événements sur la même fenêtre, avec les restrictions suivantes :

Plusieurs clients peuvent sélectionner des événements sur la même fenêtre parce que leur masque d'événements sont distincts. Lorsque X génère un événement, il le notifie à tous les clients intéressés.
Un seul client à la fois peut sélectionner les événements CirculateRequest, ConfigureRequest, ou MapRequest, qui sont associés au masque SubstructureRedirectMask.
Un seul client à la fois peut sélectionner l'événement ResizeRequest, qui est associé au masque ResizeRedirectMask.
Un seul client à la fois peut sélectionner l'événement ButtonPress, qui est associé au masque ButtonPressMask.

Le serveur notifie l'événement à tous les clients intéressés.

XSelectInput peut provoquer une erreur BadWindow.

DIAGNOSTICS

BadWindow
Un argument Window ne désigne pas une fenêtre définie.

VOIR AUSSI

Xlib - C Language X Interface

TRADUCTION

Bertrand Duret, 2002.