DestroyWindow

Składnia

Argumenty

Argumenty	Opis
int hWnd	Uchwyt do okna, które ma zostać zniszczone.

Zwracana wartość

Zwraca wartość różną od zera w przypadku sukcesu. W przeciwnym wypadku funkcja zwraca wartość 0.

Aby uzyskać rozszerzone informacje o błędzie wywołaj funkcję _{» WinAPI ♦} GetLastError.

Opis szczegółowy

Funkcja niszczy wskazane okno. Funkcja wysyła komunikaty WM_DESTROY oraz WM_NCDESTROY do okna w celu jego deaktywacji. Ponadto funkcja odbiera sterowanie klawiaturą wszystkim oknom, które zostaną zniszczone w wyniku wywołania tej funkcji.

Funkcja zwalnia jednocześnie zasoby powiązane z oknem takie jak menu okna i timery, a ponadto czyści kolejkę komunikatów wątku, odbiera prawo własności do schowka oraz przerywa możliwość podglądu schowka wszystkim oknom porzędnym, które są powiązane z niszczonym oknem.

Jeżeli okno przekazane jako argument jest rodzicem lub oknem nadrzędnym to funkcja DestroyWindow automatycznie niszczy okna, których jest właścicielem jak również dzieci skojarzone z oknem (np. kontrolki). Funkcja najpierw niszczy okna, których jest właścicielem oraz dzieci skojarzone z oknem, a następnie niszczy okno macierzyste, będące rodzicem dla uprzednio zniszczonych okien.

Niniejsza funkcja służy również do niszczenia okien dialogowych niemodalnych, utworzonych za pomocą funkcji CreateDialog.

Dodatkowe informacje

Funkcja DestroyWindow nie może być używana przez inny wątek niż ten, który stworzył okno.

Jeżeli okno, które jest niszczone jest oknem potomnym (czyli tzw. dzieckiem) oraz niszczone okno nie posiada stylu WS_EX_NOPARENTNOTIFY to rodzic niszczonego okna otrzyma notyfikację WM_PARENTNOTIFY.

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/windows/desktop/ms632682(v=vs.85).aspx