NOM¶

XMapEvent, XMappingEvent - Structure des événements MapNotify et MappingNotify

STRUCTURES¶

La structure des événements MapNotify contient :

typedef struct {
	int type;
	unsigned long serial;
	Bool send_event;
	Display *display;
	Window event;
	Window window;
	Bool override_redirect;
} XMapEvent;

À la réception de cet événement, les membres de la structure sont positionnés de la façon suivante.

Le champ type est renseigné avec la valeur de la constante dont le nom correspond au type d'événement, et qui l'identifie de manière unique. Par exemple, lorsque le serveur X notifie un événement GraphicsExpose à une application cliente, il émet une structure XGraphicsExposeEvent avec le champ type positionné à la valeur GraphicsExpose. Le champ display contient un pointeur sur le display sur lequel l'événement est apparu. Le champ send_event vaut True si l'événement provient d'une requête SendEvent du protocole. Le champ serial contient le numéro de série issu du protocole, mais étendu à partir des 16 bits les moins signifiants à une valeur codée sur 32 bits. Le champ window contient l'identifiant de la fenêtre le plus pertinent pour les répartiteurs des boîtes à outils graphiques (NDT : afin de transmettre l'événement à la fenêtre concernée).

Le champ event contient l'identifiant de la fenêtre qui a été affichée ou sa fenêtre parente, selon que StructureNotify ou SubstructureNotify a été sélectionné. Le champ window est renseigné avec la fenêtre qui a été affichée. Le champ override_redirect contient la valeur de l'attribut override-redirect de la fenêtre (NDT: outrepasser la redirection). Les gestionnaires de fenêtres devraient ignorer cette fenêtre si l'attribut override-redirect vaut True, car ces événements sont habituellement générés par des fenêtres jaillissantes (NDT: popups), qui outrepassent le contrôle des structures.

La structure des événements MappingNotify contient :

typedef struct {
	int type;
	unsigned long serial;
	Bool send_event;
	Display *display;
	Window window;
	int request;
	int first_keycode;
	int count;
} XMappingEvent;

À la réception de cet événement, les champs de la structure sont positionnés de la façon suivante.

Le champ type est renseigné avec la valeur de la constante dont le nom correspond au type d'événement, et qui l'identifie de manière unique. Par exemple, lorsque le serveur X notifie un événement GraphicsExpose à une application cliente, il émet une structure XGraphicsExposeEvent avec le champ type positionné à la valeur GraphicsExpose. Le champ display contient un pointeur sur le display sur lequel l'événement est apparu. Le champ send_event vaut True si l'événement provient d'une requête SendEvent du protocole. Le champ serial contient le numéro de série issu du protocole, mais étendu à partir des 16 bits les moins signifiants à une valeur codée sur 32 bits. Le champ window contient l'identifiant de la fenêtre le plus pertinent pour les répartiteurs des boîtes à outils graphiques (NDT : afin de transmettre l'événement à la fenêtre concernée).

Le champ request est renseigné pour indiquer le type de changement de configuration opérée et peut prendre pour valeur MappingModifier, MappingKeyboard, MappingPointer. S'il vaut MappingModifier, la configuration des touches de modification a changé. S'il vaut MappingKeyboard, la configuration du clavier a changé. S'il vaut MappingPointer, la configuration des boutons du pointeur a changé. Les membres first_keycode et count sont positionnés uniquement si le champ request vaut MappingKeyboard. Le nombre first_keycode représente le premier numéro dans la partie qui a fait l'objet de la configuration, et count représente le nombre de codes de touches modifiés.

VOIR AUSSI¶

XAnyEvent(3X11), XButtonEvent(3X11), XCreateWindowEvent(3X11), XCirculateEvent(3X11), XCirculateRequestEvent(3X11), XColormapEvent(3X11), XConfigureEvent(3X11), XConfigureRequestEvent(3X11), XCrossingEvent(3X11), XDestroyWindowEvent(3X11), XErrorEvent(3X11), XExposeEvent(3X11), XFocusChangeEvent(3X11), XGraphicsExposeEvent(3X11), XGravityEvent(3X11), XKeymapEvent(3X11), XMapRequestEvent(3X11), XPropertyEvent(3X11), XReparentEvent(3X11), XResizeRequestEvent(3X11), XSelectionClearEvent(3X11), XSelectionEvent(3X11), XSelectionRequestEvent(3X11), XUnmapEvent(3X11), XVisibilityEvent(3X11)
Xlib - C Language X Interface

TRADUCTION¶

Bertrand Duret, 2002.