CWnd::EnableWindow

Artigo
06/10/2015

Habilita ou desabilita a entrada de mouse e teclado.

BOOL EnableWindow( 
   BOOL bEnable = TRUE  
);

Parâmetros

bEnable
Especifica se a janela determinada deve ser ativado ou desativado. Se esse parâmetro é Verdadeiro, a janela será ativada. Se esse parâmetro é Falso, a janela será desativado.

Valor de retorno

Indicou o estado antes que a função de membro de EnableWindow foi chamada. O valor de retorno é diferente de zero se a janela foi desabilitada anteriormente. O valor de retorno é 0 se a janela ativada foi anteriormente ou um erro ocorreu.

Comentários

Quando a entrada é desativada, a entrada como cliques do mouse e pressionamentos de teclas será ignorada. Quando a entrada é ativada, a janela processa qualquer entrada.

Se o estado ativado for alterada, a mensagem de WM_ENABLE é enviada antes que essa função retorna.

Se desativadas, todas as janelas filho são implicitamente desativadas, apesar de não serem mensagens enviadas de WM_ENABLE .

Uma janela deve ser habilitada antes que possa ser ativado. Por exemplo, se um aplicativo está exibindo uma caixa de diálogo sem-modo e desativou a janela principal, a janela principal deve ser habilitada antes que a caixa de diálogo seja destruída. Caso contrário, outra janela receber o foco de entrada e será ativada. Se uma janela filho é desativada, será ignorada quando as janelas tentam determinar qual janela deve receber mensagens do mouse.

Por padrão, uma janela é ativada quando é criada. Um aplicativo pode especificar o estilo de WS_DISABLED na função de membro de Criar ou de CreateEx para criar uma janela que é desativada inicialmente. Depois que uma janela foi criada, um aplicativo pode também usar a função de membro de EnableWindow para ativar ou desativar a janela.

Um aplicativo pode usar essa função para ativar ou desativar um controle em uma caixa de diálogo. Um enfermo controla não pode receber o foco de entrada, nem pode acelerar o acesso de usuário a ele.

Exemplo

//CMyFileDialog is a CFileDialog-derived class 
//OnInitDialog is the handler for WM_INITDIALOG
BOOL CMyFileDialog::OnInitDialog() 
{
   CFileDialog::OnInitDialog();

   CWnd* pWndParent = GetParent();

   //make sure you add #include <dlgs.h> for IDs 'edt1' & 'stc3' 

   //disables the 'file name' edit and static control 
   //of the standard file open dialog 

   //get handle of 'file name' combobox control & disable it
   CWnd* pWnd = pWndParent->GetDlgItem(cmb13);
   pWnd->EnableWindow(FALSE);

   //get handle of 'file name' static control & disable it
   pWnd = pWndParent->GetDlgItem(stc3);
   pWnd->EnableWindow(FALSE);

   return TRUE;
}