zion - XReparentWindow
.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
XReparentWindow - modification de la fenêtre parente
Syntaxe
XReparentWindow^(^display, f^, parente^, x^, y^) Display *display^; Window f^; Window parente^; int x^, y^;
Arguments
display 1i
Spécifie la connexion au serveur X. |
parente 1i
Spécifie la fenêtre parente. |
f 1i
Spécifie la fenêtre. .ds Xy de la position relativement à la nouvelle fenêtre parente |
x 1i
.ns |
y 1i
Spécifie les coordonnées x et y *(Xy. |
Description
Si la fenêtre spécifiée est affichée, .ZN XReparentWindow effectue automatiquement une requête .ZN UnmapWindow sur celle-ci. .ZN XReparentWindow supprime ensuite la fenêtre de sa position courante dans la hiérarchie, et l'insère comme fille de la fenêtre parente spécifiée. La fenêtre est placée au sommet de la pile relative à ses fenêtres soeurs.
Après avoir redéfini la fenêtre parente de la fenêtre spécifiée, .ZN XReparentWindow provoque la génération d'un événement .ZN ReparentNotify par le serveur X. Le membre override_redirect retourné par cet événement est positionné à la valeur de l'attribut correspondant pour la fenêtre. Les clients gestionnaires de fenêtres ignorent habituellement cette fenêtre si ce membre vaut .ZN True . Enfin, si la fenêtre spécifiée était originellement affichée, le serveur X effectue automatiquement une requête .ZN MapWindow sur celle-ci.
Le serveur X réalise les traitements habituels d'exposition sur les fenêtres précédemment masquées. Le serveur X peut ne pas générer d'événement .ZN Expose pour les régions affichées lors de la requête .ZN UnmapWindow et qui sont aussitôt masquées par la requête finale .ZN MapWindow . Une erreur .ZN BadMatch est générée si :
- La nouvelle fenêtre parente n'est pas sur le même écran que l'ancienne fenêtre parente.
- La nouvelle fenêtre parente est la fenêtre elle-même ou l'une de ses fenêtres descendantes.
- La nouvelle fenêtre parente est de classe .ZN InputOnly , et la fenêtre ne l'est pas.
- La fenêtre spécifiée est dotée d'un arrière-plan .ZN ParentRelative , et la nouvelle fenêtre parente n'a pas la même profondeur que la fenêtre spécifiée.
.ZN XReparentWindow peut provoquer des erreurs .ZN BadMatch et .ZN BadWindow .
Diagnostiques
.ZN BadWindow Un paramètre Window ne désigne pas une fenêtre définie. |
Voir aussi
XChangeSaveSet(3X11) *(xL
Traduction
Bertrand Duret, 2002.
Poster un commentaire