Compartilhar via


Estrutura UiaChangeInfo (uiautomationcore.h)

Contém dados sobre uma alteração Automação da Interface do Usuário que ocorreu.

Sintaxe

struct UiaChangeInfo {
  int     uiaId;
  VARIANT payload;
  VARIANT extraInfo;
};

Membros

uiaId

Identifica o tipo de informações de alteração. Os valores possíveis são todos os valores de Identificadores de Alteração, Identificadores de Propriedade, Identificadores de Atributo de Texto, Identificadores de Tipo de Anotação e Identificadores de Estilo.

payload

Informações sobre o tipo de alteração que ocorreu.

extraInfo

Informações detalhadas sobre a alteração que ocorreu.

Comentários

O provedor pode chamar UiaRaiseChangesEvent e passar uma matriz de structs UiaChangeInfo para notificar os clientes de um grupo relacionado de alterações. A carga e extraInfo variam dependendo do uiaId preenchido no struct UiaChangeInfo .

Se houver vários desses tipos de evento, vários structs UiaChangeInfo serão criados. Veja abaixo uma descrição do que são para cada par de valores.

UiaId payload Extrainfo
UIA_SummaryChangeId VT_BSTR

Uma cadeia de caracteres que descreve o significado da alteração do ponto de vista do aplicativo.

Um valor de ID constante do provedor que indica o significado desse evento.
Para alterações na propriedade UIA, identificadas na seção Identificadores de Propriedade . Type é o tipo da propriedade e o valor é o novo valor da propriedade.  
Para alterações de atributos de texto, identificadas na seção Identificadores de Atributo de Texto , extraInfo não é usado. Type é o tipo do atributo e o valor é o novo valor do atributo.  
Para alterações de anotação, identificadas na seção Identificadores de Tipo de Anotação , extraInfo não é usado. VT_BSTR

Para texto, os caracteres do intervalo ao qual a anotação se aplica.

 
Para alterações de estilo, identificadas na seção Identificadores de Estilo , extraInfo não é usado. VT_BSTR

Para texto, os caracteres do intervalo ao qual o estilo se aplica.

 

Requisitos

Requisito Valor
Cabeçalho uiautomationcore.h