.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

XRaiseWindow, XLowerWindow, XCirculateSubwindows, XCirculateSubwindowsUp, XCirculateSubwindowsDown, XRestackWindows - modifie l'ordre d'empilement des fenêtres

Syntaxe

XRaiseWindow^(^display, f^) Display *display^; Window f^;
 
  XLowerWindow^(^display, f^) Display *display^; Window f^;
 
  XCirculateSubwindows^(^display, f^, direction^) Display *display^; Window f^; int direction^;
 
  XCirculateSubwindowsUp^(^display, f^) Display *display^; Window f^;
 
  XCirculateSubwindowsDown^(^display, f^) Display *display^; Window f^;
 
  XRestackWindows^(^display, fenêtres^, ^nfenêtres^); Display *display^; Window fenêtres^[]; int nfenêtres^;

Arguments

direction 1i

Spécifie la direction (haut ou bas) dans laquelle on veut faire circuler la fenêtre. La valeur doit être .ZN RaiseLowest ou .ZN LowerHighest .

display 1i

Spécifie la connexion au serveur X.

f 1i

Spécifie la fenêtre.

fenêtres 1i

Spécifie un tableau contenant les fenêtres à réordonner.

nfenêtres 1i

Spécifie le nombre de fenêtre à réordonner.

Description

La fonction .ZN XRaiseWindow élève la fenêtre spécifiée au sommet de la pile de telle sorte qu'aucune de ses soeurs ne la masque. Si les fenêtres sont vues comme des feuilles de papier se chevauchant sur un bureau, alors élever une fenêtre est analogue à déplacer la feuille au sommet de la pile tout en gardant constantes ses coordonnées x et y sur le bureau. Élever une fenêtre peut provoquer la génération d'événements .ZN Expose pour la fenêtre et pour toute fenêtre fille affichée qui se trouvait précédemment masquée.
 
  Si l'attribut override-redirect de la fenêtre est .ZN False et si un client a sélectionné .ZN SubstructureRedirectMask sur la fenêtre parente, le serveur X génère un événement .ZN ConfigureRequest , et aucune autre action n'a lieu. Sinon la fenêtre est élevée.
 
  .ZN XRaiseWindow peut générer une erreur .ZN BadWindow .
 
  La fonction .ZN XLowerWindow abaisse la fenêtre spécifiée au bas de la pile de telle sorte qu'elle ne masque aucune fenêtre soeur. Si les fenêtres sont vues comme des feuilles de papier se chevauchant sur un bureau, alors abaisser une fenêtre est analogue à déplacer la feuille au bas de la pile tout en gardant constantes ses coordonnées x et y sur le bureau. Abaisser une fenêtre affichée génère des événements .ZN Expose sur toute fenêtre précédemment masquée.
 
  Si l'attribut override-redirect de la fenêtre est .ZN False et si un client a sélectionné .ZN SubstructureRedirectMask sur la fenêtre parente, le serveur X génère un événement .ZN ConfigureRequest , et aucune autre action n'a lieu. Sinon la fenêtre est abaissée au bas de la pile.
 
  .ZN XLowerWindow peut générer une erreur .ZN BadWindow .
 
  La fonction .ZN XCirculateSubwindows provoque la rotation des fenêtres filles de la fenêtre spécifiée, dans la direction spécifiée. Si l'on spécifie .ZN RaiseLowest , .ZN XCirculateSubwindows élève au sommet de la pile la fenêtre fille affichée qui est la plus basse (s'il en est) et qui est recouverte par une autre fenêtre fille. Si l'on spécifie .ZN LowerHighest , .ZN XCirculateSubwindows abaisse au bas de la pile la fenêtre fille affichée qui est la plus haute (s'il en est) et qui recouvre une autre fenêtre fille. Le traitement des expositions est réalisé sur toute fenêtre précédemment masquée. Si un autre client a sélectionné .ZN SubstructureRedirectMask sur la fenêtre spécifiée, le serveur X génère un événement .ZN CirculateRequest , et aucun autre traitement n'a lieu. Si la position dans la pile d'une fenêtre fille est effectivement modifiée, le serveur X génère un événement .ZN CirculateNotify .
 
  .ZN XCirculateSubwindows peut générer les erreurs .ZN BadValue et .ZN BadWindow .
 
  La fonction .ZN XCirculateSubwindowsUp élève la fenêtre fille affichée qui est la plus basse et qui est masquée partiellement ou complètement par une autre fenêtre fille. Les fenêtres filles complètement visibles ne sont pas affectées. Cette fonction est un raccourci pour .ZN XCirculateSubwindows avec .ZN RaiseLowest spécifié.
 
  .ZN XCirculateSubwindowsUp peut générer une erreur .ZN BadWindow .
 
  La fonction .ZN XCirculateSubwindowsDown abaisse la fenêtre fille affichée qui est la plus haute et qui cache partiellement ou complètement une autre fenêtre fille. Cette fonction est un raccourcis pour .ZN XCirculateSubwindows avec .ZN LowerHighest spécifié.
 
  .ZN XCirculateSubwindowsDown peut générer une erreur .ZN BadWindow .
 
  La fonction .ZN XRestackWindows détermine l'empilement des fenêtres selon un ordre spécifié, du haut vers le bas. L'ordre d'empilement de la première fenêtre référencée dans le tableau n'est pas affecté, en revanche toutes les autres fenêtres référencées dans le tableau sont empilées sous la première fenêtre, dans l'ordre où elles apparaissent dans le tableau. L'ordre d'empilement des autres fenêtres n'est pas modifié. Pour chaque fenêtre référencée dans le tableau qui n'est pas une fille de la fenêtre spécifiée, une erreur .ZN BadMatch est générée.
 
  Si l'attribut override-redirect d'une fenêtre est .ZN False et que d'autres clients ont sélectionné .ZN SubstructureRedirectMask sur la fenêtre parente, le serveur X génère des événements .ZN ConfigureRequest pour chaque fenêtre dont le flag override-redirect n'est pas positionné, et aucun autre traitement n'est exécuté. Sinon, l'empilement des fenêtres est redéfini de haut en bas.
 
  .ZN XRestackWindows peut générer une erreur .ZN BadWindow .

Diagnostiques

.ZN BadValue Une valeur numérique est hors des limites acceptée par la requête. Sauf précision contraire, toutes les valeurs permises par le type d'un argument sont acceptées par une requête. Un argument défini par une énumération de valeurs peut générer cette erreur.

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

Voir aussi

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

Traduction

Bertrand Duret, 2002.