Função EnableWindow (winuser.h)
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) |
Confira também
Conceitual
Referência