XDestroyWindow

Aus DGL Wiki
Wechseln zu: Navigation, Suche

XDestroyWindow

Name

XDestroyWindow - zerstört ein Fenster.


Delphi-Spezifikation

function XDestroyWindow(dpy: PDisplay; w: Window): Integer;


Parameter

dpy Gibt die Verbindung zum X-Server an.
w Gibt das Fenster an.


Beschreibung

Die Funktion XDestroyWindow zerstört das angegebene Fenster sowie alle seine untergeordneten Fenster; der X-Server generiert dabei ein DestroyNotify-Event für jedes Fenster. Das Fenster sollte danach nicht wieder referenziert werden. Falls das durch den Parameter w angegebene Fenster gemappt ist, wird dies automatisch aufgehoben. Die Reihenfolge der DestroyNotify-Events gestaltet sich derart, dass für jedes zu zerstörende Fenster das Event zuerst für die untergeordneten Fenster generiert wird, bevor dies für das Fenster selbst geschieht. Die Reihenfolge der Events für Fenster in der gleichen Hierarchiestufe (siblings) und in den untergeordneten Hierarchien unterliegt keinen weiteren Einschränkungen. Falls das angegebene Fenster das Root-Fenster ist, werden keine Fenster zerstört. Das Zerstören eines gemappten Fensters generiert Expose-Events für Fenster, die von dem zerstörten Fenster verdeckt wurden.


Fehlermeldungen

BadWindow wird generiert, wenn w kein gültiges Fenster ist.


Siehe auch

XChangeWindowAttributes, XConfigureWindow, XCreateWindow, XDestroySubwindows, XMapWindow, XRaiseWindow, XUnmapWindow