Função EnableWindow (winuser.h)

Artigo
08/27/2023

Habilita ou desabilita a entrada de mouse e teclado para a janela ou controle especificado. Quando a entrada é desabilitada, a janela não recebe entrada, como cliques e pressionamentos de teclas do mouse. Quando a entrada está habilitada, a janela recebe todas as entradas.

Sintaxe

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

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela a ser habilitada ou desabilitada.

[in] bEnable

Tipo: BOOL

Indica se a janela deve ser habilitada ou desabilitada. Se esse parâmetro for TRUE, a janela será habilitada. Se o parâmetro for FALSE, a janela será desabilitada.

Valor retornado

Tipo: BOOL

Se a janela tiver sido desabilitada anteriormente, o valor retornado será diferente de zero.

Se a janela não tiver sido desabilitada anteriormente, o valor retornado será zero.

Comentários

Se a janela estiver sendo desabilitada, o sistema enviará uma mensagem WM_CANCELMODE . Se o estado habilitado de uma janela estiver sendo alterado, o sistema enviará uma mensagem WM_ENABLE após a mensagem WM_CANCELMODE . (Essas mensagens são enviadas antes de EnableWindow retornar.) Se uma janela já estiver desabilitada, suas janelas filho serão desabilitadas implicitamente, embora não sejam enviadas uma mensagem WM_ENABLE .

Uma janela deve ser habilitada antes de ser ativada. Por exemplo, se um aplicativo estiver exibindo uma caixa de diálogo de modelagem e tiver desabilitado sua janela main, o aplicativo deverá habilitar a janela main antes de destruir a caixa de diálogo. Caso contrário, outra janela receberá o foco do teclado e será ativada. Se uma janela filho estiver desabilitada, ela será ignorada quando o sistema tentar determinar qual janela deve receber mensagens do mouse.

Por padrão, uma janela é habilitada quando é criada. Para criar uma janela inicialmente desabilitada, um aplicativo pode especificar o estilo WS_DISABLED na função CreateWindow ou CreateWindowEx . Depois que uma janela for criada, um aplicativo poderá usar EnableWindow para habilitar ou desabilitar a janela.

Um aplicativo pode usar essa função para habilitar ou desabilitar um controle em uma caixa de diálogo. Um controle desabilitado não pode receber o foco do teclado, nem um usuário pode obter acesso a ele.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-window-l1-1-4 (introduzido no Windows 10, versão 10.0.14393)