CWnd::EnableWindow

Artículo
06/10/2015

Habilita o deshabilita la entrada del mouse y del teclado.

BOOL EnableWindow( 
   BOOL bEnable = TRUE  
);

Parámetros

bEnable
Especifica si la ventana especificada debe habilitarse o deshabilitarse. Si este parámetro es TRUE, la ventana se habilitada. Si este parámetro es FALSO, la ventana se deshabilitará.

Valor devuelto

Indica el estado antes de que la función miembro de EnableWindow fuera denominada. El valor devuelto es distinto de cero si la ventana se deshabilitó anteriormente. El valor devuelto es 0 si la ventana está habilitada o un error ha producido anteriormente.

Comentarios

Cuando se deshabilita la entrada, la entrada como clics del mouse y pulsaciones de tecla se omite. cuando se habilita la entrada, la ventana procesa toda la entrada.

Si el estado habilitado cambia, se envía el mensaje de WM_ENABLE antes de que la función vuelva.

Si se deshabilitan, todas las ventanas secundarias deshabilitadas implícitamente, aunque no se envían los mensajes de WM_ENABLE .

Una ventana debe habilitarse antes de poder activar. Por ejemplo, si una aplicación muestra un cuadro de diálogo no modal y ha deshabilitado la ventana principal, la ventana principal debe habilitarse antes de que se destruya el cuadro de diálogo. Si no, otra ventana obtendrá el foco de entrada y se producirá. Si se deshabilita una ventana secundaria, se omite cuando Windows intenta determinar qué ventana debe obtener los mensajes del mouse.

de forma predeterminada, se habilita una ventana cuando se crea. Una aplicación puede especificar el estilo de WS_DISABLED en función de miembro de Crear o de CreateEx para crear una ventana que se deshabilite inicialmente. Después de haber creado una ventana, una aplicación puede utilizar la función miembro de EnableWindow para habilitar o deshabilitar la ventana.

Una aplicación puede utilizar esta función para habilitar o deshabilitar un control en un cuadro de diálogo. Un control deshabilitado no puede recibir el foco, ni puede un acceso de usuario.

Ejemplo

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