Método IItemContainerProvider::FindItemByProperty (uiautomationcore.h)

Recupera um elemento dentro de um elemento que contém, com base em um valor de propriedade especificado.

Sintaxe

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

Parâmetros

[in] pStartAfter

Tipo: IRawElementProviderSimple*

O Automação da Interface do Usuário provedor do elemento após o qual a pesquisa começa ou NULL para pesquisar todos os elementos.

[in] propertyId

Tipo: PROPERTYID

O identificador da propriedade. Para obter uma lista de IDs de propriedade, consulte Identificadores de propriedade.

[in] value

Tipo: VARIANT

O valor da propriedade.

[out] pFound

Tipo: IRawElementProviderSimple**

Recebe um ponteiro para o provedor Automação da Interface do Usuário do elemento .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Para listas virtuais, o elemento retornado pode ser um espaço reservado. IVirtualizedItemProvider::Realize pode ser usado para tornar o item totalmente disponível.

O método retornará E_INVALIDARG se não houver suporte para pesquisa pela propriedade especificada. A maioria dos contêineres deve dar suporte a UIA_NamePropertyId e, se apropriado, UIA_AutomationIdPropertyId e UIA_SelectionItemIsSelectedPropertyId.

Se propertyId for 0, todos os itens serão uma correspondência. Esse valor pode ser usado com pStartAfter igualando NULL para obter o primeiro item e, em seguida, obter itens sucessivos. Nesse caso, o valor deve ser VT_EMPTY.

Requisitos

Confira também

Conceitual

IItemContainerProvider

Identificadores de propriedade

Referência