CWnd::EnableWindow

Статья
06/10/2015

Включение или отключение ввода мыши и клавиатуры.

BOOL EnableWindow( 
   BOOL bEnable = TRUE  
);

Параметры

bEnable
Определяет, является ли заданный окно быть включено или запрещен. Если этот параметр TRUE, окно будет включена. Если этот параметр FALSE, окно будет отключен.

Возвращаемое значение

Отображает состояние EnableWindow был вызван перед вызовом функции-члена. Возвращаемое значение не равно нулю, если окно ранее было отключен. Возвращаемое значение 0, если окно ранее было включено или произошла ошибка.

Заметки

Если входные данные отключить вход как щелчка мыши и нажатия клавиши игнорировать. Если входные данные включен, окно рассматривает весь ввод.

Если включено состояние изменится, сообщение WM_ENABLE отправлено, прежде чем эта функция возвращает значение.

Если отключен все дочерние окна неявно отключены, хотя они не отправленных сообщений WM_ENABLE.

Окно необходимо включить, прежде чем он может быть активирована. Например, если приложение отображает диалоговое окно modeless и заблокированный свое главное окно, то в главное окно необходимо включить, прежде чем появится диалоговое окно будет удалено. В противном случае другое окно получит фокус ввода и активировано. Если дочернее окно отключен, оно игнорирован, когда Windows пытается определить, какое окно должно получать сообщения мыши.

По умолчанию окно включен, когда он создано. Приложение может определить стиль WS_DISABLED в функции-члене Создание или CreateEx, чтобы создать поле, которое изначально отключен. После того как окно было создано приложение может также использовать функции-члена EnableWindow чтобы включить или отключить окна.

Приложение может использовать эту функцию для включения или отключения элемент управления в диалоговом окне. Отключенный элемент управления не может получить фокус ввода, ни может доступ пользователя.

Пример

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