Win32 API. Функции окна
Страница 19. Функция EnableWindow


Функция 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Нет
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »