CWnd::EnableWindow

Artigo
08/25/2010

Ativa ou desativa a entrada de teclado e mouse.

BOOL EnableWindow(
   BOOL bEnable = TRUE 
);

Parâmetros

bEnable
Especifica se determinada janela é ativada ou desabilitado.Se esse parâmetro for TRUE, a janela será habilitada.Se esse parâmetro for FALSE, a janela será desabilitado.

Valor de retorno

Indica o estado antes do EnableWindow função de membro foi chamada. O valor retornado é diferente de zero se a janela foi desabilitado anteriormente.O valor retornado é 0 se a janela estava ativada anteriormente ou ocorreu um erro.

Comentários

Quando entrada está desabilitado, entrada, sistema autônomo cliques de mouse e pressionamentos de teclas será ignorado.Quando entrada estiver habilitada, a janela processa todas as entradas.

Se alterar o estado habilitado, o WM_ENABLE mensagem é enviada antes que esta função retorna.

Se desabilitado, todas as janelas filho implicitamente estiverem desativadas, embora elas não são enviadas WM_ENABLE mensagens.

Uma janela deve ser habilitada antes que ele pode ser ativado.Por exemplo, se um aplicativo está exibindo uma caixa de diálogo sem janela restrita e tenha desabilitado sua janela principal, a janela principal deve ser ativada antes que a caixa de diálogo é destruída.Caso contrário, outra janela receberá o foco de entrada e ser ativada.Se uma janela filho estiver desabilitado, ela será ignorada quando o Windows tenta determinar que janela deve receber mensagens do mouse.

Por padrão, uma janela é ativada quando ele é criado.Um aplicativo pode especificar o WS_DISABLED estilo de a Criar or CreateExfunção de membro para criar uma janela que inicialmente desabilitado.Depois de uma janela tiver sido criada, um aplicativo também pode usar o EnableWindow função de membro para ativar ou desabilitar a janela.

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

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;
}