Compartilhar via

Método IUIAutomationItemContainerPattern::FindItemByProperty (uiautomationclient.h)

  • Artigo

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

Sintaxe

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

Parâmetros

[in] pStartAfter

Tipo: IUIAutomationElement*

Um ponteiro para o 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, retval] pFound

Tipo: IUIAutomationElement**

Recebe um ponteiro para o elemento correspondente.

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

O provedor poderá retornar uma interface IUIAutomationElement real ou um espaço reservado se o elemento correspondente for virtualizado.

Esse método retornará E_INVALIDARG se a propriedade solicitada não for aquela que o contêiner dá suporte à pesquisa. Espera-se que a maioria dos contêineres dê suporte à propriedade Name e, se apropriado para o contêiner, AutomationId e IsSelected.

Esse método pode ser lento, pois talvez seja necessário percorrer vários objetos para encontrar um correspondente. Quando usado em um loop para retornar vários itens, nenhuma ordem específica é definida desde que cada item seja retornado apenas uma vez (ou seja, o loop deve terminar). Esse método também é centrado em item, não centrado na interface do usuário, portanto, itens com várias representações de interface do usuário precisam ser atingidos apenas uma vez.

Quando o parâmetro propertyId é especificado como 0 (zero), espera-se que o provedor retorne o próximo item após pStartAfter. Se pStartAfter for especificado como NULL com uma propertyId de 0, o provedor deverá retornar o primeiro item no contêiner. Quando propertyId é especificado como 0, o parâmetro de valor deve ser VT_EMPTY.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationclient.h (inclua UIAutomation.h)

Confira também

IUIAutomationItemContainerPattern

Perceber

Referência