10.16.1.2 - Функция EnableWindow

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

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

Синтаксис

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

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

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

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

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

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

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

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