Compartilhar via

Função de retorno de chamada UiaEventCallback (uiautomationcoreapi.h)

  • Artigo
Nota Essa função foi preterida. Em vez disso, os aplicativos cliente devem usar as interfaces COM (Modelo de Objeto do Componente de Automação da Interface do Usuário) da Microsoft.
 
Uma função implementada pelo cliente que é chamada pela Automação da Interface do Usuário quando um evento é gerado ao qual o cliente se inscreveu.

Sintaxe

UiaEventCallback Uiaeventcallback;

void Uiaeventcallback(
  [in] UiaEventArgs *pArgs,
  [in] SAFEARRAY *pRequestedData,
  [in] BSTR pTreeStructure
)
{...}

Parâmetros

[in] pArgs

Tipo: UiaEventArgs*

O endereço de uma estrutura UiaEventArgs que contém os argumentos de evento.

[in] pRequestedData

Tipo: SAFEARRAY*

Uma SAFEARRAY que contém dados associados ao evento.

[in] pTreeStructure

Tipo: BSTR

Uma cadeia de caracteres que contém a estrutura da árvore associada ao evento, se o evento estiver associado a um conjunto de nós. Consulte Observações.

Valor retornado

Nenhum

Comentários

Essa função é passada para UiaAddEvent e UiaRemoveEvent.

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 de Automação da Interface do Usuário). Quando um "p" segue diretamente o outro, o segundo nó é filho do primeiro. Um ")" representa um passo de volta para cima da á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

   
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