.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

XDestroyWindow, XDestroySubwindows - destruction de fenêtres

Syntaxe

XDestroyWindow^(^display, f^) Display *display^; Window f^;
 
  XDestroySubwindows^(^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 XDestroyWindow détruit la fenêtre spécifiée ainsi que toutes ses descendantes et provoque la génération par le serveur X d'un événement .ZN DestroyNotify pour chaque fenêtre détruite. La fenêtre ne doit plus être référencée à nouveau. Si la fenêtre spécifiée par l'argument f est affichée, elle est automatiquement retirée (unmapped). L'ordre de génération des événements .ZN DestroyNotify est tel que pour toute fenêtre détruite, un événement .ZN DestroyNotify est généré pour chacune des ses fenêtres descendantes avant d'être généré pour elle-même. L'ordre parmi les fenêtres soeurs et leurs descendantes est indéterminé. Si la fenêtre spécifiée est la fenêtre racine, aucune fenêtre n'est détruite. La destruction d'une fenêtre affichée génère des événements .ZN Expose pour toutes les fenêtres qui sont masquées par la fenêtre détruite.
 
  .ZN XDestroyWindow peut générer l'erreur .ZN BadWindow .
 
  La fonction .ZN XDestroySubwindows détruit toutes les fenêtres filles de la fenêtre spécifiée, dans l'ordre inverse d'empilement (de bas en haut). Elle provoque la génération par le serveur X d'un événement .ZN DestroyNotify pour chaque fenêtre. Si des fenêtres filles détruites sont affichées, .ZN XDestroySubwindows provoque la génération par le serveur X d'événements .ZN Expose pour la fenêtre spécifiée. Cette méthode est beaucoup plus performante que de supprimer les 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. Les fenêtres descendantes ne doivent plus être référencées à nouveau.
 
  .ZN XDestroySubwindows peut générer une erreur .ZN BadWindow .

Diagnostiques

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

Voir aussi

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

Traduction

Bertrand Duret, 2001.