.ds xT X Toolkit Intrinsics - C Language Interface .ds xW Athena X Widgets - C Language X Toolkit Interface .ds xL Xlib - C Language X Interface .ds xC Inter-Client Communication Conventions Manual .na .de Ds .nf .ft 1 .. .de De .ce 0 .if
(BD .DF .nr BD 0 .in
(OIu .if
(TM .ls 2
(DDu .fi .. .de FD
 
  .KS .TA .5i 3i .ta .5i 3i .nf .. .de FN .fi .KE

Nom

XMapWindow, XMapRaised, XMapSubwindows - affichage de fenêtres

Syntaxe

XMapWindow^(^display, f^) Display *display^; Window f^;
 
  XMapRaised^(^display, f^) Display *display^; Window f^;
 
  XMapSubwindows^(^display, f^) Display *display^; Window f^;

Arguments

display 1i

Spécifie la connexion au serveur X.

f 1i

Spécifie la fenêtre.

Description

La fonction .ZN XMapWindow affiche la fenêtre et toutes ses fenêtres filles qui ont fait l'objet d'une requête d'affichage. Demander l'affichage d'une fenêtre qui est descendante d'une fenêtre non affichée ne l'affiche pas. En revanche, elle sera affichée lorsque son ancêtre le sera également. Une telle fenêtre est dite non « visualisable ». Lorsque toutes les fenêtres ancêtres sont affichées, la fenêtre devient « visualisable » et est visible sur l'écran si elle n'est pas masquée par une autre fenêtre. Cette fonction n'a aucun effet si la fenêtre est déjà affichée.
 
  Si l'attribut override-redirect de la fenêtre vaut .ZN False et si un autre client a sélectionné .ZN SubstructureRedirectMask sur la fenêtre parente, alors le serveur X génère un événement .ZN MapRequest et la fonction .ZN XMapWindow n'affiche pas la fenêtre. Sinon, la fenêtre est affichée et le serveur X génère un événement .ZN MapNotify .
 
  Si la fenêtre devient « visualisable » et qu'aucun contenu n'est mémorisé, le serveur X remplit la fenêtre avec son arrière-plan. Si l'arrière-plan de la fenêtre est indéfini, le contenu existant de l'écran n'est pas modifié et le serveur X génère zéro ou plusieurs événements .ZN Expose . Si le contenu a été conservé pendant que la fenêtre n'était pas affichée (backing_store vaut Always), aucun événement .ZN Expose n'est généré. Si le contenu est à présent conservé (backing_store vaut WhenMapped), une requête d'exposition pour toute la fenêtre est toujours générée. Sinon, des requêtes d'exposition sont générées pour les seules parties visibles. Un remplissage et des requêtes d'exposition similaires ont lieu pour toute fenêtre descendante nouvellement « visualisable ».
 
  .IN "XMapWindow" Si la fenêtre est de classe .ZN InputOutput , .ZN XMapWindow génère des événements .ZN Expose sur chaque fenêtre de classe .ZN InputOutput dont elle provoque l'affichage. Si le client affiche et dessine la fenêtre, puis commence à traiter les événements, la fenêtre est dessinée deux fois. Pour éviter cela, il faut solliciter les événements .ZN Expose puis afficher la fenêtre, ainsi le client traite les événements d'entrée comme d'habitude. La liste des événements inclut l'événement .ZN Expose pour chaque fenêtre qui est apparue sur l'écran. La réponse normale à un événement .ZN Expose devrait être de dessiner la fenêtre. Cette méthode induit habituellement un programme plus simple et des interactions correctes avec les gestionnaires de fenêtres.
 
  .ZN XMapWindow peut générer une erreur .ZN BadWindow .
 
  La fonction .ZN XMapRaised est similaire à la fonction .ZN XMapWindow dans la mesure où elle affiche la fenêtre et toutes ses descendantes qui on fait l'objet d'une requête d'affichage. Cependant, elle élève également la fenêtre spécifiée au sommet de la pile.
 
  .ZN XMapRaised peut générer une erreur .ZN BadWindow .
 
  La fonction .ZN XMapSubwindows .IN "XMapSubwindows" affiche les fenêtres filles d'une fenêtre spécifiée dans l'ordre inverse d'empilement (de haut en bas). Le serveur X génère un événement .ZN Expose sur chaque fenêtre nouvellement affichée et visible. Cette méthode est plus performante que d'afficher plusieurs fenêtres une par une parce que le serveur réalise la majorité du traitement une seule fois, pour l'ensemble des fenêtres, plutôt que pour chacune d'entre elles.
 
  .ZN XMapSubwindows peut générer une erreur .ZN BadWindow .

Diagnostiques

.ZN BadWindow La valeur d'un argument Window ne désigne pas une fenêtre définie.

Voir aussi

XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWindow(3X11), XDestroyWindow(3X11), XRaiseWindow(3X11), XUnmapWindow(3X11) *(xL

Traduction

Bertrand Duret, 2001