EnableWindow

A função EnableWindow habilita ou desabilita o mouse e entrada do teclado para a janela especificada ou controle. Quando entrada estiver desabilitada, a janela não recebe entrada such as cliques no mouse e os pressionamentos de teclas. Quando entrada estiver habilitada, a janela recebe todas as entradas.

(BOOL EnableWindow HWND  hWnd, / / identificador para janela BOOLbEnable / / bandeira para habilitar ou desabilitar a entrada);
 

Parâmetros

hWnd
Identificador para a janela para ser ativado ou desativado.
bEnable
Especifica se para habilitar ou desativar a janela. Se este parâmetro for TRUE, a janela está habilitado. Se o parâmetro for FALSE, a janela é desativada.

Retornar valores

Se a janela anteriormente foi desabilitada, o valor de retorno é diferente de zero.

Se a janela não foi anteriormente desactivada, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Se está alterando o estado habilitado de uma janela, uma mensagem WM_ENABLE é enviada antes de EnableWindow função retorna. Se uma janela já estiver desativada, todas as suas janelas filho são implicitamente desativadas, embora eles não são enviados uma mensagem WM_ENABLE.

Uma janela deve ser habilitada antes de ele pode ser ativado. Por exemplo, se um aplicativo está exibindo uma caixa de diálogo sem janela restrita e desativou sua janela principal, o requerimento deve permitir a janela principal antes de destruir a caixa de diálogo. Caso contrário, outra janela irá receber o foco do teclado e ser ativada. Se uma janela filho é desabilitada, ele é ignorado quando o sistema tenta determinar qual janela deve receber mensagens do mouse.

Por padrão, uma janela é habilitado quando ele é criado. Para criar uma janela que inicialmente está desativada, um aplicativo pode especificar o estilo WS_DISABLED in a CreateWindow ou CreateWindowEx função. Depois de ter sido criada uma janela, um aplicativo pode usar EnableWindow para habilitar ou desativar a janela.

Um aplicativo pode usar esta função para ativar ou desativar um controle em uma caixa de diálogo. Um controle desabilitado não pode receber o foco do teclado, nem pode um usuário acessá-lo.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de entrada de teclado, funções de entrada de teclado, CreateWindow, CreateWindowEx, IsWindowEnabled, WM_ENABLE

Index