Scroll to navigation

XDestroyWindow(3X11) XLIB FUNCTIONS XDestroyWindow(3X11)

NOM

XDestroyWindow, XDestroySubwindows - destruction de fenêtres

SYNTAXE

XDestroyWindow(display, f)
Display *display;
Window f;

XDestroySubwindows(display, f)
Display *display;
Window f;

ARGUMENTS

Spécifie la connexion au serveur X.
Spécifie la fenêtre.

DESCRIPTION

La fonction 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 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 DestroyNotify est tel que pour toute fenêtre détruite, un événement 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 Expose pour toutes les fenêtres qui sont masquées par la fenêtre détruite.

XDestroyWindow peut générer l'erreur BadWindow.

La fonction 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 DestroyNotify pour chaque fenêtre. Si des fenêtres filles détruites sont affichées, XDestroySubwindows provoque la génération par le serveur X d'événements 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.

XDestroySubwindows peut générer une erreur BadWindow.

DIAGNOSTICS

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)
Xlib - C Language X Interface

TRADUCTION

Bertrand Duret, 2001.

Release 6.4 X Version 11