1.27.1.14 Функция EnableWindow

(ВключитьОкно)

Функция EnableWindow включает или отключает мышь и ввод с клавиатуры в определенном окне или элементе управления. Когда ввод заблокирован, окно не принимает ввод типа щелчков мыши и нажатий клавиш. Когда ввод включен, окно принимает всю вводимую информацию.

Синтаксис

BOOL EnableWindow
(
  HWND hWnd,	// дескриптор окна
  BOOL bEnable 	// флажок для включения или отключения ввода информации
);

Параметры

hWnd
Идентификатор окна, которое будет включено или заблокировано.
bEnable Определяет, включено или отключено окно. Если этот параметр - ИСТИНА (TRUE), окно включено. Если параметр - ЛОЖЬ(FALSE), окно заблокировано.

Возвращаемые значения
Если окно было предварительно заблокировано, возвращаемое значение не ноль. Если окно предварительно не было заблокировано, возвращаемое значение нулевое. Чтобы получить расширенные данные об ошибках, вызовите GetLastError.

Замечания
Если включенное состояние окна изменяется, посылается сообщение WM_ENABLE перед возвратом значения функцией EnableWindow. Если окно уже заблокировано, все его дочерние окна потенциально заблокированы, хотя они и не посылали сообщение WM_ENABLE. Окно должно быть включено прежде, чем оно может быть активизировано. Например, если прикладная программа отображает немодальное диалоговое окно и отключила его основное окно, то прикладная программа должна включить основное окно перед разрушением диалогового окна. Иначе, другое окно примет фокус клавиатуры и будет активизировано. Если дочернее окно заблокировано, это игнорируется, когда Windows пробует определить, которое окно должно принять сообщения мыши. По умолчанию, окно включено, когда оно создается. Чтобы создать окно, которое первоначально заблокировано, прикладная программа, может определить стиль WS_DISABLED в функции CreateWindow или CreateWindowEx. После того, как окно будет создано, прикладная программа может использовать EnableWindow, чтобы включить или отключить окно. Прикладная программа может использовать эту функцию, чтобы включить или отключить элемент управления в диалоговом окне. Заблокированный элемент управление не может принимать фокус клавиатуры, и при этом пользователь не может получить доступ к нему.

Смотри также
CreateWindow, CreateWindowEx, IsWindowEnabled, WM_ENABLE

Размещение и совместимость EnableWindow

Windows NT			Да
Win95				Да
Win32s				Да
Импортируемая библиотека		user32.lib
Заголовочный файл			winuser.h
Unicode				Нет
Замечания по платформе		Не имеется

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков - 06.12.2001