DestroyWindow

Funkcja DestroyWindow niszczy określonego okna. Funkcja wysyła wiadomości WM_DESTROY i WM_NCDESTROY , aby oknie go dezaktywować i usunięcie fokusu klawiatury. Funkcja również niszczy menu okna, opróżnia kolejkę wiadomości wątku, niszczy czasomierze, usuwa własność Schowka, podziały i łańcucha Podgląd Schowka (jeśli okno w górnej części łańcucha podglądu).

Jeśli określonego okna jest okno nadrzędne lub właściciela, DestroyWindow automatycznie niszczy podrzędnych lub właścicielem systemu windows, gdy niszczy okna nadrzędnego lub właściciela. Funkcja najpierw niszczy dziecko lub własnością systemu windows, a następnie niszczy okna nadrzędnego lub właściciela.

DestroyWindow również niszczy niemodalny okien dialogowych utworzonych przez funkcję CreateDialog.

(BOOL DestroyWindow HWND  hWnd / / dojście do okna do zniszczenia);
 

Parametry

hWnd
Dojście do okna do zniszczenia.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Wątek nie można używać DestroyWindow do zniszczenia okno utworzone przez inny wątek.

Jeśli okno zniszczeniu okna podrzędnego, który ma styl WS_EX_NOPARENTNOTIFY, WM_PARENTNOTIFY wiadomość jest wysyłana do obiektu nadrzędnego.

Systemu Windows CE: Funkcja DestroyWindow nie wysyła wiadomości WM_NCDESTROY.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Omówienie Windows, okno funkcji, CreateDialog, właściwości, funkcji CreateWindowEx, WM_DESTROY, WM_NCDESTROY, WM_PARENTNOTIFY

Index