Application event trigger

UiPath.UIAutomationNext.Activities.NNativeEventTrigger

Description

Define um gatilho com base em um evento nativo de qualquer tipo de elemento (janela de nível superior ou qualquer outro elemento de interface gráfica indicado). É possível indicar o elemento de destino na tela e, em seguida, escolher o evento nativo da lista de eventos compatíveis com esse elemento.

Esta atividade é compatível com o Repositório de Objetos.

O gatilho deve ser a primeira atividade no fluxo de trabalho e o fluxo de trabalho é acionado quando um determinado evento de interface gráfica ocorre. É permitido apenas um gatilho por fluxo de trabalho. Para mais detalhes, consulte Automação assistida baseada em gatilho.

Observação:

Se você estiver usando uma versão do Studio inferior à 2023.4, você precisa colocar a atividade Application Event Trigger dentro de uma atividade Trigger Scope . Nesse caso, a atividade Application Event Trigger não exibe o Modo de agendamento e as propriedades Habilitadas , e a propriedade Modo de agendamento fica disponível na atividade Trigger Scope .

Compatibilidade do projeto

Windows - Legado | Janelas

Windows - Legada, Configuração do Windows

Painel do Designer

• Clique em Indicar destino na tela para definir o elemento de interface gráfica a ser usado.

  Após indicar o destino, selecione o Menu para acessar as seguintes opções:

  • Indicar destino na tela — indique o destino novamente.
  • Editar destino – Abra o modo de seleção para configurar o destino.
  • Remover captura de tela informativa - Remova a captura de tela do aplicativo de destino ou página da web.
  • Adicionar ao Repositório de Objetos — Adicione o elemento de interface gráfica atual a um projeto de biblioteca, de onde ele pode ser reutilizado em todo o processo de automação.

• Tipo de evento - A lista de tipos de eventos nativos específicos para o elemento indicado. Defina o tipo de evento. A lista de eventos expostos depende do tipo de elemento de destino e da tecnologia do aplicativo de destino. Por exemplo, um elemento de interface gráfica da Web pode expor uma lista de eventos diferente de um elemento da interface gráfica do Java.

Painel de Propriedades

Comum

• Nome daexibição - O nome exibido para a atividade no painel do Designer. Um nome de exibição é gerado automaticamente quando você indica um destino.

Entrada

• Sincronização de correspondência - Indica se a correspondência do seletor de elemento de destino é feita de forma síncrona ou assíncrona. É compatível apenas com eventos Java, exceto para Apareceu e Desapareceu. Esse campo é compatível apenas com valores Boolean . O valor padrão é False.
• Seletores — coleção opcional de seletores a serem monitorados para o evento indicado; esses seletores são monitorados ao lado do destino indicado. Os seletores devem ser seletores totais (não parciais).

• Destino - O elemento de destino: janela de nível superior ou elemento de interface gráfica. Apenas seletores restritos são compatíveis, sem âncoras. É necessário definir o elemento de destino. Antes de indicar na tela, esse campo é definido como (null). Assim que o destino for indicado, todas as propriedades relacionadas ao elemento indicado serão exibidas.
  • Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica de destino. Fica vazio para janelas de nível superior.
  • Seletor de janela (instância do Aplicativo) — o seletor da janela do aplicativo (aplicativo/navegador).

Diversos

• Habilitado — se definido como False, o gatilho é iniciado, mas não dispara nenhum evento. Ele pode ser habilitado mais tarde no runtime, usando a atividade Enable Local Trigger . Esta propriedade é ocultada quando a atividade Application Event Trigger é colocada dentro de uma Trigger Scope. Esse campo é compatível apenas com valores Boolean . O valor padrão é True.
• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose. Este campo é compatível apenas com valores Boolean (Verdadeiro, Falso). O valor padrão é False.

Opções

• Incluir filhos - Quando selecionado, os filhos do elemento de interface gráfica especificado também são monitorados. Ele é compatível com todos os tipos de eventos, exceto Apareceu ou Desapareceu e qualquer elemento de interface gráfica, exceto janelas de nível superior. Este campo é compatível apenas com valores Boolean (Verdadeiro, Falso). O valor padrão é False.
• Modo de agendamento — especifica como executar as Actions quando um gatilho é acionado. Escolha uma das cinco opções do menu suspenso:
  • Sequencial — as ações são executadas uma após a outra.
  • Simultânea a execução de ações pode se sobrepor.
  • UmaVez - executa uma Actions e sai do monitoramento.
  • Colapso sequencial - Ignora todos os eventos futuros, exceto o mais recente, até que o evento atual termine a execução.
  • Queda sequencial - Interrompe a execução do evento anterior e inicia o próximo evento.

  Nos modos Sequencial e Simultânea , o monitoramento continua a menos que o usuário interrompa a execução ou uma atividade Break seja atingida.

Eventos nativos

Sobre

O mecanismo de monitoramento de eventos nativos foi aprimorado implementando novos conjuntos de eventos compatíveis com diferentes tipos de tecnologias de aplicativo:

• Eventos nativos do WND

• Eventos nativos CTRL

• Eventos nativos do JAVA

• Eventos nativos WEBCTRL

• Eventos nativos do HTML

• Eventos nativos de UIA

Eventos WND - Janela de nível superior

Tipo de Evento	Tipo TriggerEventArgs	Description
Apareceu	ArgusVazio	Evento disparado quando o elemento de destino aparece.
Desapareceu	ArgusVazio	Evento disparado quando o elemento de destino desaparece.
Título alterado	ArgumentosDeTextoAlterado	Evento disparado quando o título do elemento de destino é alterado. Observação: este é o evento Texto alterado , renomeado para Título alterado para janelas de nível superior, para mais clareza.
Estado alterado	ArgumentosDeEstadoAlterado	Evento disparado quando o estado do elemento de destino é alterado. Observação: esse evento é disparado quando algo é alterado no estado da janela: habilitado, desabilitado, marcado, desmarcado, focalizável, focado, visível, etc. O novo valor do estado é exposto na variável de argumentos.
Localização alterada	ArgumentosDeLocalAlterado	Evento disparado quando o local do elemento de destino é alterado.
Primeiro plano recebido	ArgumentosHwnd	Evento disparado quando a janela do elemento de destino é posta em primeiro plano.
Primeiro plano perdido	ArgumentosHwnd	Evento disparado quando a janela do elemento de destino não está mais em primeiro plano.
Minimizada	ArgumentosHwnd	Evento disparado quando a janela do elemento de destino está prestes a ser minimizada.
restaurado	ArgumentosHwnd	Evento acionado quando a janela do elemento de destino está prestes a ser restaurada.

Eventos CTRL ou eventos WND – Elementos de interface gráfica

Tipo de Evento	Tipo TriggerEventArgs	Description
Apareceu	ArgusVazio	Evento disparado quando o elemento de destino aparece.
Desapareceu	ArgusVazio	Evento disparado quando o elemento de destino desaparece.
Texto alterado	ArgumentosDeTextoAlterado	Evento disparado quando o texto do elemento de destino é alterado.
Em foco	ArgusVazio	Evento disparado quando o elemento de destino está em foco.
Foco perdido	ArgusVazio	Evento disparado quando o elemento de destino perde foco.
Estado alterado	ArgumentosDeEstadoAlterado	Evento disparado quando o estado do elemento de destino é alterado. Observação: esse evento é disparado quando algo é alterado no estado da janela: habilitado, desabilitado, marcado, desmarcado, focalizável, focado, visível, etc. O novo valor do estado é exposto na variável de argumentos.
Seleção alterada	ArgumentosDeSeleçãoAlterada	Evento disparado quando a seleção do valor do elemento de destino é alterada.

Eventos JAVA - Elementos de interface gráfica

Tipo de Evento	Tipo TriggerEventArgs	Description
Apareceu	ArgusVazio	Evento disparado quando o elemento de destino aparece.
Desapareceu	ArgusVazio	Evento disparado quando o elemento de destino desaparece.
Texto alterado	ArgumentosDeTextoAlterado	Evento disparado quando o texto do elemento de destino é alterado.
Tecla pressionada	JavaKeyPressArgs	Evento disparado quando uma teclada é pressionada quando o foco está dentro do elemento de destino.
Click	ArgumentosDeAçãoDoMouseJava	Evento disparado quando se clica no elemento de destino.
Movimento do mouse	ArgsDeMovimentoDoMouseJava	Evento disparado quando o ponteiro passa pelo elemento de destino.
Em foco	ArgusVazio	Evento disparado quando o elemento de destino está em foco.
Foco perdido	ArgusVazio	Evento disparado quando o elemento de destino perde foco.
Habilitado	ArgusVazio	Evento disparado quando o elemento de destino está habilitado.
Desabilitado	ArgusVazio	Evento disparado quando o elemento de destino está desabilitado.
Seleção alterada	ArgumentosDeSeleçãoAlterada	Evento disparado quando a seleção do valor do elemento de destino é alterada.
Mouse entrou	ArgsDeMovimentoDoMouseJava	Evento disparado quando o ponteiro do mouse entra na parte visível do elemento de destino.
Mouse saiu	ArgsDeMovimentoDoMouseJava	Evento disparado quando o ponteiro do mouse sai da parte visível do elemento de destino.
Célula selecionada	ArgumentosSelecionadosDeCélulaJava	Evento disparado quando o elemento de destino é uma célula de tabela que é selecionada.
Valor da célula alterado	ArgumentosDeValorDaCélulaJavaAlterado	Evento disparado quando o elemento de destino é uma célula de tabela e seu valor é alterado.
Mouse pressionado	ArgumentosDeAçãoDoMouseJava	Evento disparado quando qualquer botão do mouse é pressionado sobre o elemento de destino.
Mouse liberado	ArgumentosDeAçãoDoMouseJava	Evento disparado quando qualquer botão do mouse é liberado sobre o elemento de destino.
Menu selecionado	ArgusVazio	Evento disparado quando o elemento de destino é um menu que é selecionado.
Menu desmarcado	ArgusVazio	Evento disparado quando o elemento de destino é um menu que é desmarcado.
Menu cancelado	ArgusVazio	Evento disparado quando o elemento de destino é um menu que é cancelado.
Menu pop-up visível	ArgusVazio	Evento disparado quando o elemento de destino é um menu pop-up que fica visível.
Menu pop-up invisível	ArgusVazio	Evento disparado quando o elemento de destino é um menu pop-up que fica invisível.
Menu pop-up cancelado	ArgusVazio	Evento disparado quando o elemento de destino é um menu pop-up que é cancelado.

Eventos WEBCTRL - Elementos de interface gráfica

Observação: a partir do UiPath.UIAutomation.Activities v23.10, adicionamos suporte para eventos nativos baseados em WEBCTRL em navegadores nativos incorporados (como Slack, Discord, Electron).

A partir do UiPath.UIAutomation.Activities v23.12, adicionamos suporte para eventos nativos baseados em WEBCTRL em navegadores incorporados gerenciados (como o CefSharp).

O evento Text selection changed é compatível com navegadores incorporados a partir do UiPath.UIAutomation.Activities v23.12.

Tipo de Evento	Tipo TriggerEventArgs	Description
Apareceu	ArgusVazio	Evento disparado quando o elemento de destino aparece.
Desapareceu	ArgusVazio	Evento disparado quando o elemento de destino desaparece.
Texto alterado	ArgumentosDeTextoAlterado	Evento disparado quando o texto do elemento de destino é alterado.
Tecla pressionada	ArgumentosDePressionamentoDaTeclaDaWeb	Evento disparado quando uma teclada é pressionada quando o foco está dentro do elemento de destino.
Click	ArgusDeEventoDoWebMouse	Evento disparado quando se clica no elemento de destino.
Clicar duas vezes	ArgusDeEventoDoWebMouse	Evento disparado quando se clica duas vezes no elemento de destino.
Clicar com o Botão Direito do Mouse	ArgusDeEventoDoWebMouse	Evento disparado quando se clica com o botão direito do mouse no elemento de destino.
Movimento do mouse	ArgusDeEventoDoWebMouse	Evento disparado quando o ponteiro passa pelo elemento de destino.
Mouse pressionado	ArgusDeEventoDoWebMouse	Evento disparado quando qualquer botão do mouse é pressionado sobre o elemento de destino.
Mouse liberado	ArgusDeEventoDoWebMouse	Evento disparado quando qualquer botão do mouse é liberado sobre o elemento de destino.
Mouse entrou	ArgusDeEventoDoWebMouse	Evento disparado quando o ponteiro do mouse entra na parte visível do elemento de destino.
Mouse saiu	ArgusDeEventoDoWebMouse	Evento disparado quando o ponteiro do mouse sai da parte visível do elemento de destino.
Em foco	ArgusVazio	Evento disparado quando o elemento de destino está em foco.
Foco perdido	ArgusVazio	Evento disparado quando o elemento de destino perde foco.
Seleção de texto alterada	WebTextSelectionChangedArgs	Evento disparado quando o texto selecionado do elemento de destino é alterado.

Eventos do HTML — Elementos de interface do usuário

Observação: os seguintes tipos de eventos são compatíveis apenas para aplicativos Web identificados por seletores <html> que têm apenas o atributo app:

• Download state changed

• Tab activated

• Tab created

• Tab removed

• Tab updated

Por enquanto, esses eventos são permitidos apenas quando o Seletor de janela contém a parte <html>, como <html app='chrome.exe' />. Outros atributos, como title ou url não são permitidos. Se o Seletor de janela contiver atributos diferentes de app, um erro de runtime será gerado.

O Seletor restrito deve estar vazio.

Esses tipos de eventos não são compatíveis para navegadores incorporados.

Tipo de Evento	Tipo TriggerEventArgs	Description
Estado do download alterado	DownloadChangedArgs	Evento disparado quando alguma das propriedades de um DownloadItem é alterada.
Guia ativada	TabActivatedArgs	Evento disparado quando a guia ativa em uma janela muda. Observação: o URL da guia pode não ser definido no momento em que esse evento foi disparado, mas você pode ouvir eventos onUpdated para ser notificado quando um URL for definido.
Guia criada	TabCreatedArgs	Evento disparado quando uma guia é criada. Observação: a associação ao grupo de guias e o URL da guia podem não ser definidos no momento em que esse evento for disparado, mas você pode ouvir eventos onUpdated para ser notificado quando um URL for definido ou a guia for adicionada a um grupo de guias.
Guia removida	TabRemovedArgs	Evento disparado quando uma guia é fechada.
Guia atualizada	TabUpdatedArgs	Evento disparado quando uma guia é atualizada.
Navegação na guia iniciada	TabNavigationStartedArgs	Evento disparado quando a navegação da guia para um URL específico era iniciada.
Navegação na guia concluída	TabNavigationCompletedArgs	Evento disparado quando a navegação por guia até uma URL específica é concluída.
Foco da janela alterado	HtmlWindowFocusChangedArgs	Evento disparado quando a janela em foco muda.
Limites da janela alterados	HtmlWindowBoundsChangedArgs	Evento disparado quando uma janela é redimensionada. Ele é enviado apenas quando os novos limites são confirmados, e não para alterações em progresso.
Janela criada	HtmlWindowCreatedArgs	Evento disparado quando uma guia é criada.
Janela removida	HtmlWindowRemovedArgs	Evento disparado quando uma janela é removida (fechada).

Eventos de UIA - Elementos de interface do usuário

Tipo de Evento	Tipo de TriggerEventsArgs	Description
Apareceu	ArgusVazio	Evento disparado quando o elemento de destino aparece.
Desapareceu	ArgusVazio	Evento disparado quando o elemento de destino desaparece.
Texto alterado	ArgumentosDeTextoAlterado	Evento disparado quando o texto do elemento de destino é alterado.
Seleção de texto alterada	UiaTextSelectionChangedArgs	Evento disparado quando o texto selecionado do elemento de destino é alterado.
Em foco	ArgusVazio	Evento disparado quando o elemento de destino está em foco.
Foco perdido	ArgusVazio	Evento disparado quando o elemento de destino perde foco.
Invocado	ArgusVazio	Evento disparado quando o elemento de destino é invocado.
Selected	ArgumentosDeSeleçãoAlterada	Evento disparado quando o elemento de destino é selecionado.
Desmarcado	ArgumentosDeSeleçãoAlterada	Evento disparado quando o elemento de destino é desmarcado.
ativou/desativou	UiaToggledArgs	Evento disparado quando o elemento de destino é alternado.

Propriedades TriggerEventArgs

TriggerArgs

Classe base para todas as classes args relacionadas a gatilhos.

Propriedade	Tipo	Description
TriggerName	String	O nome do gatilho (exibido como nome da atividade).
TriggerType	Tipo	O tipo de TriggerEventArgs.

Argumentos de Gatilho de ElementoDaUI

Herança: TriggerArgs > UiElementTriggerArgs

Propriedade	Tipo	Description
Selector	String	O seletor do elemento de destino.
TargetElement	ElementoDaUI	O elemento de destino monitorado.

NativeTriggerBaseArgs

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs

Propriedade	Tipo	Description
SelectorIndex	Número inteiro	O índice do seletor de elemento de destino.

ArgusVazio

Retorna dados dos seguintes eventos: Apareceu, Desapareceu, Em foco, Sem foco, Habilitado, Desabilitado, Menu selecionado, Menu desmarcado, Menu cancelado, Menu pop-up visível, Menu pop-up invisível, Menu pop-up cancelado.

Herança: TriggerArgs > UiElementTriggerArgs > EmptyArgs

TextChangedArg

Retorna dados dos seguintes eventos: Texto alterado, Título alterado.

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TextChangedArgs

Propriedade	Tipo	Description
Text	String	O novo texto para o elemento de destino.

ArgumentosDeEstadoAlterado

Retorna dados dos seguintes eventos: Estado alterado.

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > StateChangedArgs

Propriedade	Tipo	Description
State	String	O novo estado para o elemento de destino.

ArgumentosDeSeleçãoAlterada

Retorna dados dos seguintes eventos: Seleção alterada.

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > SelectionChangedArgs

Propriedade	Tipo	Description
Selection	String	A nova seleção para o elemento de destino.

ArgumentosDeLocalAlterado

Retorna dados dos seguintes eventos: Local alterado.

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > LocationChangedArgs

Propriedade	Tipo	Description
Location	Rectangle	Retângulo do local alterado, com informações sobre o tamanho do elemento e sua posição.

ArgumentosHwnd

Retorna dados dos seguintes eventos: Em primeiro plano, Fora do primeiro plano, Minimizado, Restaurado.

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HwndArgs

Propriedade	Tipo	Description
Hwnd	IntPtr	Identificador da janela.
HwndAsString	String	Identificador da janela como string.

JavaKeyPressArgs

Retorna dados dos seguintes eventos: Tecla pressionada (para Java).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaKeyPressArgs

Propriedade	Tipo	Description
KeyChar	String	O caractere correspondente à tecla pressionada.
KeyCode	Número inteiro	O código correspondente à tecla pressionada.
ExtendedKeyCode	Número inteiro	O código estendido da tecla pressionada. Ao contrário de KeyCode, esse valor depende do layout de teclado atual.
Location	String	O local da chave que originou o evento.
KeyModifiers	ModificadoresDeTecla N	O modificador de tecla usado ao lado da tecla. Valores possíveis: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win - 8

ArgumentosDeAçãoDoMouseJava

Retorna dados dos seguintes eventos: Clique, Mouse pressionado, Mouse liberado (para Java).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseActionArgs

Propriedade	Tipo	Description
X	Número inteiro	A coordenada X do ponteiro do mouse.
Y	Número inteiro	A coordenada Y do ponteiro do mouse.
Button	Número inteiro	O botão do mouse que foi clicado. Valores possíveis: 1 - Esquerda 2 - Meio 3 - Direita
ClickCount	Número inteiro	O número de vezes em que o botão foi clicado.
KeyModifiers	ModificadoresDeTecla N	O modificador de tecla usado ao lado do botão do mouse. Valores possíveis: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win - 8

ArgsDeMovimentoDoMouseJava

Retorna dados dos seguintes eventos: Mouse em movimento, Entrada do mouse, Saída do mouse (para Java).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseMotionArgs

Propriedade	Tipo	Description
X	Número inteiro	A coordenada X do ponteiro do mouse.
Y	Número inteiro	A coordenada Y do ponteiro do mouse.
MouseButton	Número inteiro	O botão do mouse clicado Valores possíveis: 0 - Nenhum 1 - Esquerda 2 - Meio 3 - Direita

ArgumentosSelecionadosDeCélulaJava

Retorna dados dos seguintes eventos: Clique (para Java).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellSelectedArgs

Propriedade	Tipo	Description
Row	Número inteiro	Linha selecionada da célula.
Column	Número inteiro	Coluna selecionada da célula.

ArgumentosDeValorDaCélulaJavaAlterado

Retorna dados dos seguintes eventos: Clique (para Java).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellValueChangedArgs

Propriedade	Tipo	Description
Row	Número inteiro	Linha da célula.
Column	Número inteiro	Coluna da célula.
Value	String	Novo valor da célula.

ArgusDeEventoDoWebMouse

Retorna dados dos seguintes eventos: Clique, Duplo clique, Clique com o botão direito, Mouse em movimento, Entrada do mouse, Saída do mouse, Mouse pressionado, Mouse liberado (para WEBCTRL).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebMouseEventArgs

Observação: segue os nomes de propriedade definidos para Eventos do mouse.

Propriedade	Tipo	Description
AltKey	Booleano	Se a tecla ALT for pressionada.
Button	Número inteiro	Qual botão do mouse é pressionado. Valores possíveis: 0 - Esquerda 1 - Meio 2 - Direita
ClientX	Número inteiro	A coordenada X do ponteiro do mouse (em relação à janela).
ClientY	Número inteiro	A coordenada Y do ponteiro do mouse (em relação à janela).
CtrlKey	Booleano	Se a tecla CTRL for pressionada.
MetaKey	Booleano	Se a tecla META for pressionada.
MovementX	Número inteiro	A coordenada X do ponteiro do mouse (em relação à posição do último evento mousemove).
MovementY	Número inteiro	A coordenada Y do ponteiro do mouse (em relação à posição do último evento mousemove).
OffsetX	Número inteiro	A coordenada X do ponteiro do mouse (em relação ao destino).
OffsetY	Número inteiro	A coordenada Y do ponteiro do mouse (em relação ao destino).
PageX	Número inteiro	A coordenada X do ponteiro do mouse (em relação ao documento).
PageY	Número inteiro	A coordenada Y do ponteiro do mouse (em relação ao documento).
ScreenX	Número inteiro	A coordenada X do ponteiro do mouse (em relação à tela).
ScreenY	Número inteiro	A coordenada Y do ponteiro do mouse (em relação à tela).
ShiftKey	Booleano	Se a tecla SHIFT for pressionada.

ArgumentosDePressionamentoDaTeclaDaWeb

Retorna dados dos seguintes eventos: Tecla pressionada (para WEBCTRL).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebKeyPressArgs

Observação: seguem os nomes da propriedade definidos para Eventos do teclado.

Propriedade	Tipo	Description
AltKey	Booleano	Se a tecla ALT for pressionada.
Code	String	O código da tecla que disparou o evento (por exemplo, KeyA, KeyB, ControlLeft, ControlRight).
CtrlKey	Booleano	Se a tecla CTRL for pressionada.
IsComposing	Booleano	Se o estado do evento estiver em composição ou não.
Key	String	O valor da tecla que disparou o evento (por exemplo. a, b, Control).
Location	Número inteiro	O local de uma tecla no teclado ou dispositivo. Valores possíveis: 0 - Padrão - representa quase todas as teclas do teclado 1 - A tecla esquerda foi pressionada 2 - A tecla direita foi pressionada 3 - A tecla foi pressionada no teclado numérico
MetaKey	Booleano	Se a tecla META for pressionada.
Repeat	Booleano	Se uma tecla estiver sendo pressionada repetidamente ou não.
ShiftKey	Booleano	Se a tecla SHIFT for pressionada.

WebTextSelectionChangedArgs

Retorna dados dos seguintes eventos: Seleção de texto alterada (para WEBCTRL).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebTextSelectionChangedArgs

Observação: seguem os nomes da propriedade definidos para Eventos do teclado.

Propriedade	Tipo	Description
AnchorClientBounds	Rectangle	Os limites do cliente âncora: informações sobre o tamanho do elemento e sua posição em relação à janela de visualização.
AnchorElement	ElementoDaUI	O elemento de interface gráfica âncora.
AnchorOffset	Número inteiro	O índice baseado em 0 do caractere no qual a seleção do texto começou (do texto completo do elemento de destino).
FocusClientBounds	Rectangle	Os limites do cliente foco: informações sobre o tamanho do elemento e sua posição em relação à janela de visualização.
FocusElement	ElementoDaUI	O elemento de interface gráfica em foco.
FocusOffset	Número inteiro	O índice baseado em 0 do caractere no qual a seleção de texto terminou (do texto completo do elemento de destino).
SelectedText	String	A nova seleção de texto para o elemento de destino.

DownloadChangedArgs

Retorna dados dos seguintes eventos: Estado de download alterado (para WEBCTRL).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > DownloadChangedArgs

Propriedade	Tipo	Description
State	String	A string descrevendo uma alteração em state de um downloads.DownloadItem.
Id	String	O id de downloads.DownloadItem que foi alterado.
FileName	String	A string descrevendo uma alteração em url de um downloads.DownloadItem.
Url	String	A string descrevendo uma alteração em filename de um downloads.DownloadItem.
StartTime	String	A string descrevendo uma alteração em startTime de um downloads.DownloadItem.
EndTime	String	A string descrevendo uma alteração em endTime de um downloads.DownloadItem.
Error	String	A string descrevendo uma alteração no status error de um downloads.DownloadItem.

TabActivatedArgs

Retorna dados dos seguintes eventos: Guia ativada (para WEBCTRL).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabActivatedArgs

Propriedade	Tipo	Description
TabId	String	O ID da guia que se tornou ativa.
WindowId	String	O ID da janela na qual a guia selecionada foi alterada.
Title	String	O novo título da guia.
Url	String	O URL da guia, caso tenha sido alterado.

TabCreatedArgs

Retorna dados dos seguintes eventos: Guia criada (para WEBCTRL).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabCreatedArgs

Propriedade	Tipo	Description
TabId	String	O ID da guia que foi criada.
WindowId	String	O ID da janela que contém a guia.
Title	String	O novo título da guia.
Url	String	O URL da guia.

TabRemovedArgs

Retorna dados dos seguintes eventos: Guia removida (para WEBCTRL).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabRemovedArgs

Propriedade	Tipo	Description
TabId	String	O ID da guia que foi removida.
WindowId	String	O ID da janela cuja guia é fechada.
IsWindowClosing	Booleano	True quando a guia era fechada porque sua janela pai estava fechada.

TabUpdatedArgs

Retorna dados dos seguintes eventos: Guia atualizado (para WEBCTRL).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabUpdatedArgs

Propriedade	Tipo	Description
TabId	String	O ID da guia que foi atualizada.
WindowId	String	O ID da janela que contém a guia.
Status	String	O status de carregamento da guia.
Title	String	O novo título da guia.
Url	String	O URL da guia, caso tenha sido alterado.
Active	Booleano	Se a guia está ativa em sua janela. Não significa, necessariamente, que a janela está em foco.

TabNavigationStartedArgs

Retorna dados dos eventos iniciados de navegação por Guia (para html).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavelationStartedArgs

Propriedade	Tipo	Description
Url	String	O URL atualmente associado ao quadro, se o quadro identificado pelo FrameId tiver existido em um determinado ponto da guia fornecida. O fato de um URL estar associado a um determinado FrameId não implica que o quadro correspondente ainda exista.
TabId	Número inteiro	O ID da guia onde o quadro está.
FrameId	Número inteiro	O ID do quadro na guia para o qual o evento inicial foi disparado, resultando na navegação por guias. Os quadros são identificados exclusivamente por seus TabId e FrameId.
TimeStampMs	Double	Só é garantido que a propriedade TimeStampMs de eventos da navegação na web seja consistente internamente . Comparar um evento com outro lhe fornecerá o deslocamento correto entre eles, mas compará-los com a hora atual dentro da extensão (por meio do (new Date()).getTime(), por exemplo) pode gerar resultados inesperados.
DateTime	Data	N/A

TabNavigationCompletedArgs

Retorna dados dos eventos de navegação concluída em Guias (para html).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationCompletedArgs

Propriedade	Tipo	Description
Url	String	O URL atualmente associado a este quadro, se o quadro identificado pelo FrameId existir em um ponto na guia fornecida. O fato de um URL estar associado a um determinado FrameId não implica que o quadro correspondente ainda exista.
TabId	Número inteiro	O ID da guia na qual o quadro é.
FrameId	Número inteiro	O ID do quadro na guia para o qual o evento concluído foi acionado, resultando na navegação por guias. Os quadros são identificados exclusivamente por seus TabId e FrameId.
TimeStampMs	Double	Só é garantido que a propriedade TimeStampMs de eventos da navegação na web seja consistente internamente . Comparar um evento com outro lhe fornecerá o deslocamento correto entre eles, mas compará-los com a hora atual dentro da extensão (por meio do (new Date()).getTime(), por exemplo) pode gerar resultados inesperados.
DateTime	Data	N/A

HtmlWindowFocusChangedArgs

Retorna dados de eventos de foco alterado da Janela (para html).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowFocusChangedArgs

Propriedade	Tipo	Description
TabId	String	O ID da guia recém-alocada em foco.
WindowId	String	O ID da janela que contém a guia.
Title	String	O título da guia.
Url	String	O URL da guia, caso tenha sido alterado.

HtmlWindowBoundsChangedArgs

Retorna dados de eventos alterados de limites da janela (para html).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowBoundsChangedArgs

Propriedade	Tipo	Description
WindowId	String	O ID da janela cujos limites foram alterados.
Focused	Booleano	Se a janela é a janela em foco no momento.
Top	Número inteiro	O deslocamento da janela a partir da borda superior da tela em pixels.
Left	Número inteiro	O deslocamento da janela a partir da borda esquerda da tela em pixels.
Width	Número inteiro	A largura da janela, incluindo a moldura, em pixels.
Height	Número inteiro	A altura da janela, incluindo a moldura, em pixels.

HtmlWindowCreatedArgs

Retorna dados de eventos criados por Janela (para html).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowCreatedArgs

Propriedade	Tipo	Description
WindowId	String	O ID da janela criada.

HtmlWindowRemovedArgs

Retorna dados de eventos de Janela removida (para html).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowRemovedArgs

Propriedade	Tipo	Description
WindowId	String	O ID da janela removida.

UiaToggledArgs

Retorna dados dos seguintes eventos: Eventos alternados (para UIA).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaToggledArgs

Propriedade	Tipo	Description
State	String	O novo estado para o elemento de destino.

UiaTextSelectionChangedArgs

Retorna dados de eventos alterados da seleção de Texto (para uia).

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaTextSelectionChangedArgs

Propriedade	Tipo	Description
TextRanges	UiaTextRange()	Matriz que contém informações diferentes sobre os elementos de texto selecionados no elemento de destino (podemos ter vários elementos de texto selecionados no caso de seleção de texto não adjacente). Cada item desta matriz expõe as seguintes informações: Text (tipo String) — Seleção de texto para esse elemento de texto selecionado. Exemplo: TriggerEventArgs.TextRanges(0).Text representa o texto do primeiro elemento de texto selecionado. BoundingRectangles (tipo Rectangle()) — matriz de retângulos delimitadores do elemento de texto selecionado. Um elemento de texto selecionado pode ter vários retângulos delimitadores associados a ele se abranger várias linhas. Cada retângulo delimitador é do tipo Rectangle {X, Y, Width, Height} e fornece informações sobre a posição e o tamanho do elemento. Exemplo: TriggerEventArgs.TextRanges(0).BoundingRectangles(0) representa o retângulo delimitador da primeira linha no primeiro elemento de texto selecionado.

Ferramenta de Inspeção de Eventos

No contexto da automação attended baseada em gatilhos, a Ferramenta de inspeção de eventos pode ser usada para identificar os tipos de eventos nativos disparados quando você interage com determinados elementos de interface gráfica em um aplicativo e, em seguida, pode ser usada para configurar a atividade Application Event Trigger. A ferramenta captura e monitora todos os tipos de eventos selecionados, como Clique, Tecla pressionada, Foco ganho, Foco perdido e outras interações relevantes, permitindo analisar as ações realizadas e, se aplicável, diagnosticar problemas.

A Ferramenta de inspeção de eventos pode ser aberta a partir do UI Explorer, depois que um elemento de interface gráfica válido for selecionado, clicando no botão Inspecionar eventos.

A barra de ferramentas consiste nas seguintes opções:

• Registro - Os eventos gerados pela interação com o elemento de interface gráfica são registrados e adicionados à lista de eventos.
• Pausa - Os eventos gerados pelo elemento de interface gráfica quando você interage com ele não são mais registrados.
• Realçar — Mostra o contorno do elemento de destino e o coloca em primeiro plano por alguns segundos. O destaque permanece até que seja desabilitado.
• Abrir no UI Explorer — O elemento monitorado é aberto no UI Explorer, permitindo observar o seletor desse elemento.

Depois de iniciar o registro de eventos, mais duas opções ficam disponíveis:

• Limpar - Exclui todos os eventos registrados.
• CSV - Os eventos capturados podem ser exportados para um arquivo .csv para uma análise posterior.

A janela Ferramenta de inspeção de eventos apresenta duas seções principais:

• Filtro de eventos — Permite selecionar os tipos de eventos que você deseja monitorar para o elemento de destino.
• Lista de eventos — Exibe informações sobre eventos capturados.

Você pode filtrar os tipos de eventos para serem capturados habilitando ou desabilitando as caixas de seleção na lista de tipos de eventos. A lista pode variar com base na tecnologia do elemento selecionado.

Todos os tipos de eventos de mouse (Movimento do mouse, mouse pressionado, mouse liberado, mouse inserido, mouse retirado), específicos para elementos de interface gráfica Web ou Java, são desabilitados por padrão porque a lista de eventos, nesses casos, pode se tornar muito grande. Nossa recomendação é habilitar os tipos de eventos de mouse apenas se você tiver uma necessidade específica de monitorá-los.

Vale ressaltar também que os tipos de eventos podem ser habilitados ou desabilitados mesmo após o início da gravação do evento.

A lista de eventos possui três colunas:

• Nome do evento - O tipo de evento.
• Carimbo de tempo - A data e a hora em que o evento foi realizado.
• Dados do evento - Os dados e parâmetros associados a um determinado evento.

Cada coluna pode ser classificada em ordem crescente ou descendente. Os eventos são exibidos por padrão na ordem em que foram realizados.

Quando o tipo de evento Desaparecido for encontrado, não será mais possível continuar o monitoramento e uma mensagem de erro será exibida na tela. Ao clicar em qualquer opção da barra de ferramentas, a mesma mensagem de erro é exibida na tela. As únicas opções disponíveis são limpar os dados ou exportá-los para um arquivo .csv. Para iniciar o monitoramento novamente, feche a janela e abra outra instância da Ferramenta de inspeção de eventos.