EnableWindow

小甲鱼

注：本文档由 Diu 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

EnableWindow 函数允许或禁止指定的窗口或控件接受鼠标和键盘输入。当输入被禁止时，窗口不接受类似鼠标点击和按键的输入。当输入被允许时，窗口接受所有的输入。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL WINAPI EnableWindow(
  _In_ HWND hWnd,
  _In_ BOOL bEnable
);

参数解析：

参数	含义
hWnd	将被允许或者禁止的窗口的句柄
bEnable	指明是允许还是禁止窗口输入。如果该参数为 TRUE，则窗口被允许。如果参数为 FALSE，则窗口被禁止

返回值：

1. 如果窗口在此前已被禁用，则返回值为非 0；

2. 如果窗口在此前没有被禁用，则返回值为 0。


备注：

1. 如果窗口将被禁止，系统将会发送一条 WM_CANCELMODE 消息。如果窗口的允许状态将发生改变，系统会在 WM_CANCELMODE 消息之后发送一条 WM_ENABLE 消息。（这些消息在 EnableWindow 函数返回之前发送）如果一个窗口已经被禁止了，那么它的子窗口也将隐式的被禁止，尽管并未向子窗口发送 WM_ENABLE 消息。

2. 窗口被激活前必须被允许。例如，一个应用程序正显示一个非模态对话框并且禁止了它的主窗口，则在销毁该对话框之前必须允许其主窗口。否则，其他窗口将接受键盘焦点并被激活。若子窗口被禁止，则当系统决定该由哪个窗口接受鼠标消息时将忽略该窗口。

3. 默认情况下，当窗口被创建时被置为允许。若创建一个初始化为禁止状态的窗口，应用程序可以在 CeateWindow 或 CeateWindowEX 函数中定义 WS_DISABLED 样式。在窗口创建后，应用程序可用 EnbleWindow 函数来允许或禁止窗口。

4. 应用程序可用该函数来允许或禁止对话框中的某个控件。被禁止的控件既不能接受键盘输入，也不能被用户访问。


需求：

Minimum supported client	Windows 2000 专业版[桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [桌面应用程序]
Header	Winuser.h（包含于 Windows.h）
Library	User32.lib
DLL	User32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。