Compartir a través de


Función DestroyWindow (winuser.h)

Destruye la ventana especificada. La función envía WM_DESTROY y WM_NCDESTROY mensajes a la ventana para desactivarlo y quitar el foco del teclado. La función también destruye el menú de la ventana, destruye temporizadores, quita la propiedad del Portapapeles y interrumpe la cadena del visor del Portapapeles (si la ventana está en la parte superior de la cadena del visor).

Si la ventana especificada es una ventana primaria o propietaria, DestroyWindow destruye automáticamente las ventanas secundarias o de propiedad asociadas cuando destruye la ventana principal o propietaria. La función destruye primero las ventanas secundarias o de propiedad y, a continuación, destruye la ventana primaria o propietaria.

DestroyWindow también destruye los cuadros de diálogo modeless creados por la función CreateDialog .

Sintaxis

BOOL DestroyWindow(
  [in] HWND hWnd
);

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana que se va a destruir.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Un subproceso no puede usar DestroyWindow para destruir una ventana creada por otro subproceso.

Si la ventana que se destruye es una ventana secundaria que no tiene el estilo WS_EX_NOPARENTNOTIFY , se envía un mensaje WM_PARENTNOTIFY al elemento primario.

Ejemplos

Para obtener un ejemplo, vea Destruir una ventana.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluya Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-window-l1-1-0 (introducido en Windows 8)

Consulte también

Conceptual

CreateDialog

CreateWindow

CreateWindowEx

Referencia

WM_DESTROY

WM_NCDESTROY

WM_PARENTNOTIFY

Windows