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, vacía la cola de mensajes del subproceso, 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 primaria 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 (incluir 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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de