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) |