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

Метод IRawElementProviderHwndOverride::GetOverrideProviderForHwnd (uiautomationcore.h)

  • Статья

Возвращает поставщик модель автоматизации пользовательского интерфейса для указанного элемента.

Синтаксис

HRESULT GetOverrideProviderForHwnd(
  [in]          HWND                      hwnd,
  [out, retval] IRawElementProviderSimple **pRetVal
);

Параметры

[in] hwnd

Тип: HWND

Дескриптор окна элемента.

[out, retval] pRetVal

Тип: IRawElementProviderSimple**

Получает указатель на новый поставщик для указанного окна или значение NULL , если поставщик не переопределяется. Этот параметр передается неинициализированным.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод реализуется корнями фрагментов, содержащими дочерние элементы на основе окна. По умолчанию элементы управления, размещенные в windows, обслуживаются поставщиками по умолчанию в дополнение к любым настраиваемым поставщикам. Поставщики по умолчанию обрабатывают все окна в родительском окне как одноуровневые элементы. Если требуется реструктурировать дерево модель автоматизации пользовательского интерфейса таким образом, чтобы один оконный элемент управления считался дочерним по отношению к другому, необходимо переопределить поставщик по умолчанию, реализовав этот метод в корне фрагмента. Возвращаемый поставщик может предоставлять дополнительные свойства или переопределять свойства указанного компонента.

Возвращаемый поставщик должен быть частью дерева фрагментов. Он может предоставлять дополнительные свойства или переопределять свойства указанного компонента.

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

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header uiautomationcore.h (включая UIAutomation.h)

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

IRawElementProviderHwndOverride