IWindowProvider::WaitForInputIdle 方法 (uiautomationcore.h)

在指定时间阻止或在关联进程进入空闲状态之前持续阻止调用代码。

语法

HRESULT WaitForInputIdle(
  [in]          int  milliseconds,
  [out, retval] BOOL *pRetVal
);

参数

[in] milliseconds

类型: int

等待关联进程变为空闲状态的时间(以毫秒为单位)。 最大值为 Int32.MaxValue。

[out, retval] pRetVal

类型: BOOL*

如果窗口已进入空闲状态,则接收 TRUE ;如果发生超时,则 为 FALSE 。 此参数未经初始化即被传递。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法通常与 处理UIA_Window_WindowOpenedEventId结合使用。 实现依赖于基础应用程序框架;因此,此方法可能会在窗口准备好供用户输入后返回一段时间。 调用代码不应依赖此方法来确定窗口的确切空闲时间。 使用 pRetVal 的值可确定窗口是否已准备好输入,或者方法是否超时。

要求

要求
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 uiautomationcore.h (包括 UIAutomation.h)

另请参阅

IWindowProvider

UI 自动化提供程序概述