Метод IWindowProvider::WaitForInputIdle (uiautomationcore.h)

Статья
08/26/2023

Блокирует вызывающий код в течение заданного промежутка времени или до того момента, как связанный процесс перейдет в состояние бездействия, в зависимости от того, что произойдет раньше.

Синтаксис

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
Header	uiautomationcore.h (включая UIAutomation.h)

См. также раздел

IWindowProvider

Общие сведения о поставщиках автоматизации пользовательского интерфейса

Поделиться через