Función EnableWindow (winuser.h)

Artículo
08/27/2023

Habilita o deshabilita la entrada del mouse y del teclado en la ventana o control especificados. Cuando la entrada está deshabilitada, la ventana no recibe entradas como clics del mouse y pulsaciones de teclas. Cuando la entrada está habilitada, la ventana recibe toda la entrada.

Sintaxis

BOOL EnableWindow(
  [in] HWND hWnd,
  [in] BOOL bEnable
);

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana que se va a habilitar o deshabilitar.

[in] bEnable

Tipo: BOOL

Indica si se va a habilitar o deshabilitar la ventana. Si este parámetro es TRUE, la ventana está habilitada. Si el parámetro es FALSE, la ventana está deshabilitada.

Valor devuelto

Tipo: BOOL

Si la ventana se deshabilitó anteriormente, el valor devuelto es distinto de cero.

Si la ventana no estaba deshabilitada anteriormente, el valor devuelto es cero.

Comentarios

Si la ventana está deshabilitada, el sistema envía un mensaje WM_CANCELMODE . Si cambia el estado habilitado de una ventana, el sistema envía un mensaje de WM_ENABLE después del mensaje WM_CANCELMODE . (Estos mensajes se envían antes de que Se devuelva EnableWindow ). Si una ventana ya está deshabilitada, sus ventanas secundarias están deshabilitadas implícitamente, aunque no se envían un mensaje de WM_ENABLE .

Para poder activar una ventana, se debe habilitarla antes. Por ejemplo, si una aplicación muestra un cuadro de diálogo modelado y ha deshabilitado su ventana principal, la aplicación debe habilitar la ventana principal antes de destruir el cuadro de diálogo. De lo contrario, otra ventana recibirá el foco del teclado y se activará. Si una ventana secundaria está deshabilitada, se omite cuando el sistema intenta determinar qué ventana debe recibir mensajes del mouse.

De forma predeterminada, se habilita una ventana cuando se crea. Para crear una ventana que está deshabilitada inicialmente, una aplicación puede especificar el estilo WS_DISABLED en la función CreateWindow o CreateWindowEx . Una vez creada una ventana, una aplicación puede usar EnableWindow para habilitar o deshabilitar la ventana.

Una aplicación puede usar esta función para habilitar o deshabilitar un control en un cuadro de diálogo. Un control deshabilitado no puede recibir el foco del teclado ni un usuario puede obtener acceso a él.

Requisitos


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-4 (introducido en Windows 10, versión 10.0.14393)