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.