Функция EnableWindow включает в работу или отключает мышь и ввод с клавиатуры в заданное окно или орган управления. Когда ввод данных заблокирован, окно не принимает ввода щелчков мыши и нажатий клавиши. Когда ввод данных разрешается, окно принимает весь ввод данных.
Синтаксис
BOOL EnableWindow( HWND hWnd, BOOL bEnable ); |
Параметры
hWnd
[in] Дескриптор окна, которому разрешают или запрещают ввод.
bEnable
[in] Устанавливает, разрешить или запретить ввод данных в окно. Если этот параметр - ИСТИНА (TRUE), ввод в окно разрешается. Если параметр - ЛОЖЬ (FALSE), ввод в окно заблокирован.
Возвращаемые значения
Если окно было предварительно заблокировано, возвращаемое значение - не нуль.
Если окно не было предварительно заблокировано, возвращаемое значение - нуль. Чтобы получить дополнительные сведения об ошибке, вызовите функцию GetLastError.
Замечания
Если окно блокируется, система отправляет сообщение WM_CANCELMODE. Если включенное состояние окна изменяется, система, после сообщения WM_CANCELMODE, отправляет сообщение WM_ENABLE. (Эти сообщения отправляются, перед возвратом из функции EnableWindow). Если окно уже заблокировано, его дочерние окна также неявно блокируются, хотя они и не отправляют сообщение WM_ENABLE .
Окно должно быть включено в работу прежде, чем оно может быть активизировано. Например, если приложение показывает на экране немодальное диалоговое окно и блокирует его главное окно, приложение должно включить в работу главное окно перед разрушением диалогового окна. В противном случае, примет фокус клавиатуры и будет активизировано другое окно . Если дочернее окно заблокировано, оно игнорируется тогда, когда система пробует определить, какое окно должно принять сообщения мыши.
По умолчанию, окно включается тогда, когда оно создается. Чтобы создать окно, которое изначально заблокировано, приложение, может установить стиль WS_DISABLED в функции CreateWindow или CreateWindowEx. После того, как окно было создано, приложение может использовать функцию EnableWindow, чтобы включать или отключать окно.
Приложение может использовать эту функцию, чтобы разрешить или запретить работу органа управления в диалоговом окне. Заблокированный орган управления не может принять фокус клавиатуры, и при этом пользователь не может получить доступ к нему.
Windows 95/98/Me: Хотя функция EnableWindow существует в Windows 95/98/Me, она поддерживается подпрограммой Microsoft Layer for Unicode, чтобы обеспечить более совместимый характер работы с окнами во всех операционных системах Windows. Чтобы использовать подпрограмму, Вы должны добавить некоторые файлы к вашему приложению, как это определено в Microsoft Layer for Unicode для Windows 95/98/Me.
Смотри также
Обзор Ввод данных с клавиатуры, Функции, используемые Окном, CreateWindow, CreateWindowEx, IsWindowEnabled, WM_ENABLE
|
Размещение и совместимость EnableWindow |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |