Метод IInvokeProvider::Invoke (uiautomationcore.h)
Направляет запрос на активацию элемента управления и инициирует его единственное, однозначное действие.
Синтаксис
HRESULT Invoke();
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
IInvokeProvider::Invoke является асинхронным вызовом и должен немедленно возвращаться без блокировки.
Примечание Это особенно важно для элементов управления, которые прямо или косвенно запускают модальное диалоговое окно при вызове.
Любой клиент модели автоматизации пользовательского интерфейса Майкрософт, который спровоцировал событие, будет заблокирован до закрытия модального диалогового окна.
Событие должно вызываться перед обслуживанием запроса Invoke в следующих сценариях:
- невозможно или нецелесообразно ожидать завершения действия;
- действие требует взаимодействия с пользователем;
- Это действие занимает много времени и приведет к тому, что вызывающий клиент будет блокироваться на значительное время.
Требования
Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
Целевая платформа | Windows |
Header | uiautomationcore.h (включая UIAutomation.h) |
DLL | Uiautomationcore.dll |
См. также раздел
Общие сведения о поставщиках автоматизации пользовательского интерфейса