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 é disparado quando um determinado evento de UI ocorre. É permitido apenas um gatilho por fluxo de trabalho. Para obter mais detalhes, consulte Automação assistida baseada em gatilho.

Observação:

Se você estiver usando uma versão do Studio inferior a 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 Habilitado , e a propriedade Modo de agendamento está disponível na atividade Trigger Scope .

Compatibilidade do projeto

Windows - Legacy | Windows

Windows - Legada, Configuração do Windows

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

Depois de indicar o destino, selecione o Menu botão para acessar as seguintes opções:

• Indicate target on screen - Indicate the target again.
• Editar destino - Abra o modo de seleção para configurar o destino.
• Remover captura de tela informativa – Remove 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 seu 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 da de um elemento de interface gráfica Java.

Painel de Propriedades

Comum

• Nome de exibição — o nome exibido da 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 completos (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. Defina o elemento de destino. Antes de indicar na tela, esse campo é definido como (null). Depois que o destino for indicado, todas as propriedades relacionadas ao elemento que foi indicado são exibidas.

  • Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica de destino. Está vazio para janelas de nível superior.
  • Seletor de janela (Instância do aplicativo) - O seletor para a janela do aplicativo (aplicativo/navegador).

• Habilitado – Se definido como False, o gatilho começa, mas não dispara nenhum evento. Pode ser habilitado posteriormente no runtime, usando a atividade Enable Local Trigger . Essa propriedade fica oculta 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. Esse campo é compatível apenas com valores Boolean (True, False). O valor padrão é False.

• Incluir filhos - Quando selecionado, os filhos do elemento de interface gráfica especificado também são monitorados. Ela é compatível com todos os tipos de eventos, exceto para Apareceu ou Desapareceu e qualquer elemento de interface gráfica, exceto para janelas de nível superior. Esse campo é compatível apenas com valores Boolean (True, False). O valor padrão é False.

• Modo de agendamento – Especifica como executar as ações quando um gatilho é disparado. Escolha uma das cinco opções no 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.
  • OneTime – executa uma ação e encerra o 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.

• Modo do Healing Agent - configura o comportamento do Healing Agent para esta atividade, com base nas configurações de Governança ou do Orchestrator no nível do processo ou trabalho.

  • Desabilitado - Desativa o Healing Agent para essa atividade.
  • Herdar configurações do trabalho — aplica as configurações definidas na governança ou no Orchestrator no nível do processo ou trabalho.
  • Apenas recomendação — permite que o Healing Agent forneça recomendações sobre como corrigir problemas de automação de interface gráfica na execução de trabalhos, mas somente se permitido pela governança ou pelas configurações do Orchestrator.
  • Igual ao Aplicativo/Navegador — herda a configuração da atividade pai Use Application/Browser .

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 como Título alterado para janelas de nível superior, para maior 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, focalizado, 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 WND - elementos da 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.
Tecla pressionada	KeyPressArgs	Evento disparado quando uma teclada é pressionada quando o foco está dentro do elemento de destino.
Click	MouseClickedArgs	Evento disparado quando se clica no elemento de destino.
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, focalizado, 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.3, adicionamos suporte para: * Eventos nativos baseados em WEBCTRL em navegadores incorporados nativos (como Slack, Discord, Electron).

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).
Solicitação da Web: antes do redirecionamento	WebRequestBeforeRedirectArgs	Evento disparado quando um redirecionamento iniciado pelo servidor está prestes a ocorrer.
Solicitação da Web: antes da solicitação	WebRequestBeforeRequestArgs	Evento disparado quando uma solicitação está prestes a ocorrer.
Solicitação da Web: antes de enviar cabeçalhos HTTP	WebRequestBeforeSendHeadersArgs	Evento acionado quando uma solicitação está prestes a ocorrer e os cabeçalhos iniciais foram preparados.O evento destina-se a permitir que extensões adicionem, modifiquem e excluam cabeçalhos de solicitações.
Solicitação da Web: concluída	WebRequestCompletedArgs	Evento acionado quando uma solicitação da Web foi processada com sucesso.
Solicitação da Web: ocorreu um erro	WebRequestErrorOccurredArgs	Evento acionado quando uma solicitação da Web não pôde ser processada com sucesso. A API de solicitação da Web garante que, para cada solicitação, Completed ou Error occurred é disparado como o evento final com uma exceção.
Solicitação da Web: cabeçalhos HTTP recebidos	WebRequestHeadersReceivedArgs	Evento disparado cada vez que um cabeçalho de resposta HTTP(S) é recebido. Devido a redirecionamentos e solicitações de autenticação, isso pode acontecer várias vezes por solicitação.
Solicitação da Web: resposta iniciada	WebRequestResponseStartedArgs	Evento disparado quando o primeiro byte do corpo da resposta é recebido. Para solicitações HTTP, isso significa que a linha de status e os cabeçalhos de resposta estão disponíveis. Esse evento é informativo e tratado de forma assíncrona. Não permite modificar ou cancelar a solicitação.
Solicitação da Web: enviar cabeçalhos HTTP	WebRequestSendHeadersArgs	Evento disparado após todas as extensões terem tido a chance de modificar os cabeçalhos de solicitação e apresenta a versão final. O evento é disparado antes que os cabeçalhos sejam enviados para a rede. Esse evento é informativo e tratado de forma assíncrona. Não permite modificar ou cancelar a solicitação.

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.
Tecla pressionada	KeyPressArgs	Evento disparado quando uma teclada é pressionada quando o foco está dentro do elemento de destino.
Click	MouseClickedArgs	Evento disparado quando se clica no elemento de destino.
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 da atividade do gatilho que emitiu este evento (exibido como nome da atividade).
TriggerType	Tipo	O tipo .NET do gatilho de atividade que emitiu este evento.

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
• Foco perdido
• 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:

• Localização alterada

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:

• Primeiro plano recebido
• Primeiro plano perdido
• Minimizada
• restaurado

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HwndArgs

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

KeyPressArgs

Retorna dados dos seguintes eventos de elementos WND e CTRL:

• Tecla pressionada

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > KeyPressArgs

Propriedade	Tipo	Description
Key	Número inteiro	A chave com a qual houve a interação.
ScanCode	Número inteiro	O código de verificação correspondente à chave com a qual interagimos.
KeyAction	Número inteiro	0 — tecla foi pressionada 1 - chave foi lançada
KeyModifiers	ModificadoresDeTecla N	None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win - 8

MouseClickedArgs

Retorna dados dos seguintes eventos de elementos WND e CTRL:

• Click

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > MouseClickedArgs

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	0 - Nenhum 1 - Esquerda 2 - Meio 3 - Direita
MouseAction	Número inteiro	0 — o botão do mouse foi pressionado 1 — o botão do mouse foi liberado
KeyModifiers	ModificadoresDeTecla N	None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win - 8

JavaKeyPressArgs

Retorna dados dos seguintes eventos para Java:

• Tecla pressionada

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	None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win - 8

ArgumentosDeAçãoDoMouseJava

Retorna dados dos seguintes eventos para Java:

• Click
• Mouse pressionado
• Mouse liberado

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	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	None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win - 8

ArgsDeMovimentoDoMouseJava

Retorna dados dos seguintes eventos para Java:

• Movimento do mouse
• Mouse entrou
• Mouse saiu

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	0 - Nenhum 1 - Esquerda 2 - Meio 3 - Direita

ArgumentosSelecionadosDeCélulaJava

Retorna dados dos seguintes eventos para Java:

• Click

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 para Java:

• Click

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 para WEBCTRL:

• Click
• Clicar duas vezes
• Clicar com o Botão Direito do Mouse
• Movimento do mouse
• Mouse entrou
• Mouse saiu
• Mouse pressionado
• Mouse liberado

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebMouseEventArgs

Observação:

Ele segue os nomes de propriedades definidos para Eventos do Mouse.

Propriedade	Tipo	Description
AltKey	Booleano	Se a tecla ALT for pressionada.
Button	Número inteiro	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 para WEBCTRL:

• Tecla pressionada

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebKeyPressArgs

Observação:

Ela segue os nomes de propriedades definidos para Eventos do Teclado.

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 como Título alterado para janelas de nível superior, para maior 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, focalizado, 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.

WebTextSelectionChangedArgs

Retorna dados dos seguintes eventos para WEBCTRL:

• Seleção de texto alterada

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebTextSelectionChangedArgs

Observação:

Ela segue os nomes de propriedades 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 para WEBCTRL:

• Estado do download alterado

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 para WEBCTRL:

• Guia ativada

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 para WEBCTRL:

• Guia criada

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 para WEBCTRL:

• Guia removida

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 para WEBCTRL:

• Guia atualizada

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 seguintes eventos para HTML:

• Navegação na guia iniciada

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationStartedArgs

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 dentro da guia, para o qual o evento iniciado foi disparado, resultando na navegação de guias. Os quadros são identificados exclusivamente por seus TabId e FrameId.
TimeStampMs	Double	A hora em que a navegação por guias começou, em milissegundos desde a época. Só é garantido que a propriedade TimeStampMs dos eventos da navegação na Web seja consistente internamente . A comparação de um evento com outro evento dará a você o deslocamento correto entre eles, mas compará-los com o tempo atual dentro da extensão (por meio de (new Date()).getTime(), por exemplo) pode fornecer resultados inesperados.
DateTime	Data	A data e a hora em que a navegação por guias iniciou (UTC).

TabNavigationCompletedArgs

Retorna dados dos seguintes eventos para HTML:

• Navegação na guia concluída

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 dentro da guia, para o qual o evento concluído foi disparado, resultando na navegação por guias. Os quadros são identificados exclusivamente por seus TabId e FrameId.
TimeStampMs	Double	A hora em que a navegação na guia foi concluída, em milissegundos desde a época. Só é garantido que a propriedade TimeStampMs dos eventos da navegação na Web seja consistente internamente . A comparação de um evento com outro evento dará a você o deslocamento correto entre eles, mas compará-los com o tempo atual dentro da extensão (por meio de (new Date()).getTime(), por exemplo) pode fornecer resultados inesperados.
DateTime	Data	A data e a hora em que a navegação na guia foi concluída (UTC).

HtmlWindowFocusChangedArgs

Retorna dados dos seguintes eventos para HTML:

• Foco da janela alterado

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 dos seguintes eventos para HTML:

• Limites da janela alterados

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 dos seguintes eventos para HTML:

• Janela criada

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowCreatedArgs

Propriedade	Tipo	Description
WindowId	String	O ID da janela criada.

HtmlWindowRemovedArgs

Retorna dados dos seguintes eventos para HTML:

• Janela removida

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowRemovedArgs

Propriedade	Tipo	Description
WindowId	String	O ID da janela removida.

WebRequestBaseArgs

Classe base para eventos de Solicitação da Web args para HTML.

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs

Propriedade	Tipo	Description
FrameId	String	O ID do quadro no qual a solicitação acontece.
Initiator	String	A origem onde a solicitação foi iniciada.
Method	String	Método HTTP padrão.
ParentFrameId	String	O ID do frame que envolve o frame que enviou a solicitação.
RequestId	String	O ID da solicitação.
TabId	String	O ID da aba na qual a solicitação ocorre.
TimeStamp	String	O momento em que esse sinal é disparado, em milissegundos desde a época.
Type	String	Como o recurso solicitado será usado.
Url	String	A URL.

WebRequestHeadersReceivedArgs

Retorna dados dos seguintes eventos para HTML:

• Solicitação da Web: cabeçalhos HTTP recebidos

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs

Propriedade	Tipo	Description
ResponseHeaders	String	Os cabeçalhos de resposta HTTP que foram recebidos com essa resposta.
StatusCode	String	Código de status HTTP padrão retornado pelo servidor.
StatusLine	String	Linha de status HTTP da resposta.

WebResponseCacheDetailsArgs

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs > WebResponseCacheDetailsArgs

Propriedade	Tipo	Description
FromCache	Booleano	Indica se essa resposta foi obtida do cache de disco.
Ip	String	O endereço IP do servidor para o qual a solicitação foi realmente enviada.

WebRequestBeforeRedirectArgs

Retorna dados dos seguintes eventos para HTML:

• Solicitação da Web: antes do redirecionamento

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebResponseCacheDetailsArgs > WebRequestBeforeRedirectArgs

Propriedade	Tipo	Description
RedirectUrl	String	O URL de redirecionamento.

WebRequestBeforeRequestArgs

Retorna dados dos seguintes eventos para HTML:

• Solicitação da Web: antes da solicitação

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestBeforeRequestArgs

WebRequestBeforeSendHeadersArgs

Retorna dados dos seguintes eventos para HTML:

• Solicitação da Web: antes de enviar cabeçalhos HTTP

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestBeforeSendHeadersArgs

Propriedade	Tipo	Description
RequestHeaders	String	Os cabeçalhos de solicitação HTTP que serão enviados com essa solicitação.

WebRequestCompletedArgs

Retorna dados dos seguintes eventos para HTML:

• Solicitação da Web: concluída

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs > WebResponseCacheDetailsArgs > WebRequestCompletedArgs

WebRequestErrorOccurredArgs

Retorna dados dos seguintes eventos para HTML:

• Solicitação da Web: ocorreu um erro

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestErrorOccurredArgs

Propriedade	Tipo	Description
Error	String	A descrição do erro.
FromCache	Booleano	Indica se essa resposta foi obtida do cache de disco.
Ip	String	O endereço IP do servidor para o qual a solicitação foi realmente enviada.

WebRequestResponseStartedArgs

Retorna dados dos seguintes eventos para HTML:

• Solicitação da Web: resposta iniciada

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs → WebRequestHeadersReceivedArgs→ WebResponseCacheDetailsArgs→ WebRequestResponseStartedArgs

WebRequestSendHeadersArgs

Retorna dados dos seguintes eventos para HTML:

• Solicitação da Web: enviar cabeçalhos HTTP

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestSendHeadersArgs

Propriedade	Tipo	Description
RequestHeaders	String	Os cabeçalhos de solicitação HTTP que serão enviados com essa solicitação.

UiaToggledArgs

Retorna dados dos seguintes eventos para UIA:

• Eventos alternados

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaToggledArgs

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

UiaTextSelectionChangedArgs

Retorna dados dos seguintes eventos para UIA:

• Eventos alterados seleção de texto

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaTextSelectionChangedArgs

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 como Título alterado para janelas de nível superior, para maior 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, focalizado, 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.

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.