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

Метод IItemContainerProvider::FindItemByProperty (uiautomationcore.h)

  • Статья

Извлекает элемент внутри содержащего элемента на основе указанного значения свойства.

Синтаксис

HRESULT FindItemByProperty(
  [in]  IRawElementProviderSimple *pStartAfter,
  [in]  PROPERTYID                propertyId,
  [in]  VARIANT                   value,
  [out] IRawElementProviderSimple **pFound
);

Параметры

[in] pStartAfter

Тип: IRawElementProviderSimple*

Поставщик модель автоматизации пользовательского интерфейса элемента, после которого начинается поиск, или ЗНАЧЕНИЕ NULL для поиска всех элементов.

[in] propertyId

Тип: PROPERTYID

Идентификатор свойства. Список идентификаторов свойств см. в разделе Идентификаторы свойств.

[in] value

Тип: VARIANT

Значение свойства.

[out] pFound

Тип: IRawElementProviderSimple**

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

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

Тип: HRESULT

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

Комментарии

Для виртуальных списков возвращаемый элемент может быть заполнителем. Затем можно использовать IVirtualizedItemProvider::Realize , чтобы сделать элемент полностью доступным.

Метод возвращает E_INVALIDARG, если поиск по указанному свойству не поддерживается. Большинство контейнеров должны поддерживать UIA_NamePropertyId и при необходимости UIA_AutomationIdPropertyId и UIA_SelectionItemIsSelectedPropertyId.

Если свойство PropertyId равно 0, все элементы являются совпадением. Это значение можно использовать с параметром pStartAfter , равным NULL , чтобы получить первый элемент, а затем получить последующие элементы. В этом случае значение должно быть VT_EMPTY.

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista, Windows XP с пакетом обновления 3 (SP3) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и обновление платформы для Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) и обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header uiautomationcore.h (включая UIAutomation.h)
DLL Uiautomationcore.dll

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

Основные понятия

IItemContainerProvider

Идентификаторы свойств

Справочные материалы