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
Referencia