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


Функция UiaProviderForNonClient (uiautomationcoreapi.h)

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

Синтаксис

HRESULT UiaProviderForNonClient(
  [in]  HWND                      hwnd,
  [in]  long                      idObject,
  [in]  long                      idChild,
  [out] IRawElementProviderSimple **ppProvider
);

Параметры

[in] hwnd

Тип: HWND

Окно, владеющее не клиентской областью или не клиентским элементом управления.

[in] idObject

Тип: long

Идентификатор объекта элемента управления, не являющегося клиентом, или OBJID_WINDOW для всей неклиентской области. Список возможных значений см. в разделе Идентификаторы объектов.

[in] idChild

Тип: long

Идентификатор дочернего элемента управления, не являющегося клиентом.

[out] ppProvider

Тип: IRawElementProviderSimple**

Получает поставщика для неклиентской области или элемента управления, не являющегося клиентом.

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

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае.

Комментарии

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

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

Поддерживаемые идентификаторы объектов для элементов управления в неклиентской области включают OBJID_WINDOW, OBJID_VSCROLL, OBJID_HSCROLL, OBJID_TITLEBAR, OBJID_MENU и OBJID_SIZEGRIP. Для OBJID_TITLEBAR используйте идентификатор дочернего элемента, чтобы различать всю строку заголовка и содержащиеся в ней кнопки.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header uiautomationcoreapi.h
Библиотека Uiautomationcore.lib
DLL Uiautomationcore.dll

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

Функции для поставщиков