Função UiaFind (uiautomationcoreapi.h)

Nota Essa função foi preterida. Em vez disso, os aplicativos cliente devem usar as interfaces COM (Modelo de Objeto de Componente) do Microsoft Automação da Interface do Usuário.

 

Recupera um ou mais nós Automação da Interface do Usuário que correspondem aos critérios de pesquisa.

Sintaxe

HRESULT UiaFind(
  [in]  HUIANODE        hnode,
  [in]  UiaFindParams   *pParams,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] SAFEARRAY       **ppOffsets,
  [out] SAFEARRAY       **ppTreeStructures
);

Parâmetros

[in] hnode

Tipo: HUIANODE

O nó a ser usado como ponto de partida da pesquisa.

[in] pParams

Tipo: UiaFindParams*

O endereço de uma estrutura UiaFindParams que contém os parâmetros de pesquisa.

[in] pRequest

Tipo: UiaCacheRequest*

O endereço de uma estrutura UiaCacheRequest que especifica quais informações devem ser armazenadas em cache.

[out] ppRequestedData

Tipo: SAFEARRAY**

O endereço de uma variável que recebe um ponteiro para um SAFEARRAY que contém os dados solicitados. Este parâmetro é passado não inicializado. Consulte Observações.

[out] ppOffsets

Tipo: SAFEARRAY**

O endereço de uma variável que recebe um ponteiro para um SAFEARRAY que contém os índices para a matriz de dados solicitada para onde a subárvore do elemento é iniciada. Este parâmetro é passado não inicializado.

[out] ppTreeStructures

Tipo: SAFEARRAY**

O endereço de uma variável que recebe um ponteiro para um SAFEARRAY que contém a descrição da estrutura da árvore. Este parâmetro é passado não inicializado. Consulte Observações.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário.

Comentários

A estrutura de árvore é descrita por uma cadeia de caracteres em que cada caractere é "p" ou ")". O primeiro caractere na cadeia de caracteres sempre representa o nó raiz. A cadeia de caracteres será NULL se nenhum elemento for retornado pela função .

Um "p" representa um nó (elemento Automação da Interface do Usuário). Quando um "p" segue diretamente o outro, o segundo nó é um filho do primeiro. Um ")" representa um passo atrás na árvore. Por exemplo, "pp)p" representa um nó seguido por dois nós filho que são irmãos um do outro. Em "pp))p", o último nó é um irmão do primeiro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uiautomationcoreapi.h
Biblioteca	Uiautomationcore.lib
DLL	Uiautomationcore.dll