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 自動化提供者概觀