activities
latest
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
Atividades do UIAutomation
Last updated 13 de ago de 2024

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 obter mais detalhes, consulte Automação assistida baseada em Attended .

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 Habilitados , e a propriedade Modo de agendamento está 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 Falso, o disparador inicia mas não dispara nenhum evento. Ele pode ser habilitado mais tarde no Runtime, usando a atividade Enable Local Trigger . Essa propriedade fica oculta quando a atividade Application Event Trigger é colocada dentro de uma Trigger Scope. Este campo aceita apenas 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
ApareceuArgusVazioEvento disparado quando o elemento de destino aparece.
DesapareceuArgusVazioEvento disparado quando o elemento de destino desaparece.
Título alteradoArgumentosDeTextoAlterado
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 alteradoArgumentosDeEstadoAlteradoEvento 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 alteradaArgumentosDeLocalAlteradoEvento disparado quando o local do elemento de destino é alterado.
Primeiro plano recebidoArgumentosHwndEvento disparado quando a janela do elemento de destino é posta em primeiro plano.
Primeiro plano perdidoArgumentosHwndEvento disparado quando a janela do elemento de destino não está mais em primeiro plano.
MinimizadaArgumentosHwndEvento disparado quando a janela do elemento de destino está prestes a ser minimizada.
restauradoArgumentosHwndEvento acionado quando a janela do elemento de destino está prestes a ser restaurada.

Eventos CTRL ou WND - elementos da interface gráfica

Tipo de EventoTipo TriggerEventArgsDescription
ApareceuArgusVazioEvento disparado quando o elemento de destino aparece.
DesapareceuArgusVazioEvento disparado quando o elemento de destino desaparece.
Tecla pressionadaKeyPressArgsEvento disparado quando uma teclada é pressionada quando o foco está dentro do elemento de destino.
ClickMouseClickedArgsEvento disparado quando se clica no elemento de destino.
Texto alteradoArgumentosDeTextoAlteradoEvento disparado quando o texto do elemento de destino é alterado.
Em focoArgusVazioEvento disparado quando o elemento de destino está em foco.
Foco perdidoArgusVazioEvento disparado quando o elemento de destino perde foco.
Estado alteradoArgumentosDeEstadoAlteradoEvento 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 alteradaArgumentosDeSeleçãoAlteradaEvento disparado quando a seleção do valor do elemento de destino é alterada.

Eventos JAVA - Elementos de interface gráfica

Tipo de EventoTipo TriggerEventArgsDescription
ApareceuArgusVazioEvento disparado quando o elemento de destino aparece.
DesapareceuArgusVazioEvento disparado quando o elemento de destino desaparece.
Texto alteradoArgumentosDeTextoAlteradoEvento disparado quando o texto do elemento de destino é alterado.
Tecla pressionadaJavaKeyPressArgsEvento disparado quando uma teclada é pressionada quando o foco está dentro do elemento de destino.
ClickArgumentosDeAçãoDoMouseJavaEvento disparado quando se clica no elemento de destino.
Movimento do mouseArgsDeMovimentoDoMouseJavaEvento disparado quando o ponteiro passa pelo elemento de destino.
Em focoArgusVazioEvento disparado quando o elemento de destino está em foco.
Foco perdidoArgusVazioEvento disparado quando o elemento de destino perde foco.
HabilitadoArgusVazioEvento disparado quando o elemento de destino está habilitado.
DesabilitadoArgusVazioEvento disparado quando o elemento de destino está desabilitado.
Seleção alteradaArgumentosDeSeleçãoAlteradaEvento disparado quando a seleção do valor do elemento de destino é alterada.
Mouse entrouArgsDeMovimentoDoMouseJavaEvento disparado quando o ponteiro do mouse entra na parte visível do elemento de destino.
Mouse saiuArgsDeMovimentoDoMouseJavaEvento disparado quando o ponteiro do mouse sai da parte visível do elemento de destino.
Célula selecionadaArgumentosSelecionadosDeCélulaJavaEvento disparado quando o elemento de destino é uma célula de tabela que é selecionada.
Valor da célula alteradoArgumentosDeValorDaCélulaJavaAlteradoEvento disparado quando o elemento de destino é uma célula de tabela e seu valor é alterado.
Mouse pressionadoArgumentosDeAçãoDoMouseJavaEvento disparado quando qualquer botão do mouse é pressionado sobre o elemento de destino.
Mouse liberadoArgumentosDeAçãoDoMouseJavaEvento disparado quando qualquer botão do mouse é liberado sobre o elemento de destino.
Menu selecionadoArgusVazioEvento disparado quando o elemento de destino é um menu que é selecionado.
Menu desmarcadoArgusVazioEvento disparado quando o elemento de destino é um menu que é desmarcado.
Menu canceladoArgusVazioEvento disparado quando o elemento de destino é um menu que é cancelado.
Menu pop-up visívelArgusVazioEvento disparado quando o elemento de destino é um menu pop-up que fica visível.
Menu pop-up invisívelArgusVazioEvento disparado quando o elemento de destino é um menu pop-up que fica invisível.
Menu pop-up canceladoArgusVazioEvento 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 nativos incorporados (como Slack, Discord, Electron).
Tipo de EventoTipo TriggerEventArgsDescription
ApareceuArgusVazioEvento disparado quando o elemento de destino aparece.
Desapareceu ArgusVazioEvento disparado quando o elemento de destino desaparece.
Texto alteradoArgumentosDeTextoAlteradoEvento disparado quando o texto do elemento de destino é alterado.
Tecla pressionadaArgumentosDePressionamentoDaTeclaDaWebEvento disparado quando uma teclada é pressionada quando o foco está dentro do elemento de destino.
ClickArgusDeEventoDoWebMouseEvento disparado quando se clica no elemento de destino.
Clicar duas vezesArgusDeEventoDoWebMouseEvento disparado quando se clica duas vezes no elemento de destino.
Clicar com o Botão Direito do MouseArgusDeEventoDoWebMouseEvento disparado quando se clica com o botão direito do mouse no elemento de destino.
Movimento do mouseArgusDeEventoDoWebMouseEvento disparado quando o ponteiro passa pelo elemento de destino.
Mouse pressionadoArgusDeEventoDoWebMouseEvento disparado quando qualquer botão do mouse é pressionado sobre o elemento de destino.
Mouse liberadoArgusDeEventoDoWebMouseEvento disparado quando qualquer botão do mouse é liberado sobre o elemento de destino.
Mouse entrouArgusDeEventoDoWebMouseEvento disparado quando o ponteiro do mouse entra na parte visível do elemento de destino.
Mouse saiuArgusDeEventoDoWebMouseEvento disparado quando o ponteiro do mouse sai da parte visível do elemento de destino.
Em focoArgusVazioEvento disparado quando o elemento de destino está em foco.
Foco perdidoArgusVazioEvento 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:
  • Estado do download alterado
  • Guia ativada
  • Guia criada
  • Guia removida
  • Guia atualizada
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 EventoTipo TriggerEventArgsDescription
Estado do download alterado DownloadChangedArgsEvento 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 TabRemovedArgsEvento disparado quando uma guia é fechada.
Guia atualizadaTabUpdatedArgsEvento disparado quando uma guia é atualizada.
Navegação na guia iniciadaTabNavigationStartedArgsEvento disparado quando a navegação da guia para um URL específico era iniciada.
Navegação na guia concluídaTabNavigationCompletedArgsEvento disparado quando a navegação por guia até uma URL específica é concluída.
Foco da janela alteradoHtmlWindowFocusChangedArgsEvento disparado quando a janela em foco muda.
Limites da janela alteradosHtmlWindowBoundsChangedArgsEvento disparado quando uma janela é redimensionada. Ele é enviado apenas quando os novos limites são confirmados, e não para alterações em progresso.
Janela criadaHtmlWindowCreatedArgsEvento disparado quando uma guia é criada.
Janela removidaHtmlWindowRemovedArgsEvento disparado quando uma janela é removida (fechada).

Eventos de UIA - Elementos de interface do usuário

Tipo de EventoTipo de TriggerEventsArgsDescription
ApareceuArgusVazioEvento disparado quando o elemento de destino aparece.
DesapareceuArgusVazioEvento disparado quando o elemento de destino desaparece.
Tecla pressionadaKeyPressArgsEvento disparado quando uma teclada é pressionada quando o foco está dentro do elemento de destino.
ClickMouseClickedArgsEvento disparado quando se clica no elemento de destino.
Texto alteradoArgumentosDeTextoAlteradoEvento disparado quando o texto do elemento de destino é alterado.
Seleção de texto alteradaUiaTextSelectionChangedArgsEvento disparado quando o texto selecionado do elemento de destino é alterado.
Em focoArgusVazioEvento disparado quando o elemento de destino está em foco.
Foco perdidoArgusVazioEvento disparado quando o elemento de destino perde foco.
InvocadoArgusVazioEvento disparado quando o elemento de destino é invocado.
SelectedArgumentosDeSeleçãoAlteradaEvento disparado quando o elemento de destino é selecionado.
DesmarcadoArgumentosDeSeleçãoAlteradaEvento disparado quando o elemento de destino é desmarcado.
ativou/desativouUiaToggledArgsEvento disparado quando o elemento de destino é alternado.

Propriedades TriggerEventArgs

TriggerArgs

Classe base para todas as classes args relacionadas a gatilhos.
PropriedadeTipoDescription
TriggerNameStringO nome da atividade do gatilho que emitiu este evento (exibido como nome da atividade).
TriggerTypeTipoO tipo .NET do gatilho de atividade que emitiu este evento.

Argumentos de Gatilho de ElementoDaUI

Herança: TriggerArgs > UiElementTriggerArgs
PropriedadeTipoDescription
SelectorStringO seletor do elemento de destino.
TargetElementElementoDaUIO elemento de destino monitorado.

NativeTriggerBaseArgs

Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs
PropriedadeTipoDescription
SelectorIndexNúmero inteiroO í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
PropriedadeTipoDescription
TextStringO novo texto para o elemento de destino.

ArgumentosDeEstadoAlterado

Retorna dados dos seguintes eventos:
  • Estado alterado
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > StateChangedArgs
PropriedadeTipoDescription
StateStringO novo estado para o elemento de destino.

ArgumentosDeSeleçãoAlterada

Retorna dados dos seguintes eventos:
  • Seleção alterada
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > SelectionChangedArgs
PropriedadeTipoDescription
SelectionStringA nova seleção para o elemento de destino.

ArgumentosDeLocalAlterado

Retorna dados dos seguintes eventos:
  • Localização alterada
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > LocationChangedArgs
PropriedadeTipoDescription
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
PropriedadeTipoDescription
HwndIntPtrIdentificador da janela.
HwndAsStringStringIdentificador da janela como string.

KeyPressArgs

Retorna dados dos seguintes eventos de elementos WND e CTRL:
  • Tecla pressionada
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > KeyPressArgs
PropriedadeTipoDescription
KeyNúmero inteiroA chave com a qual houve a interação.
ScanCodeNúmero inteiroO código de verificação correspondente à chave com a qual interagimos.
KeyActionNúmero inteiroIndica se a tecla foi pressionada ou liberada. Valores possíveis:
  • 0 — tecla foi pressionada
  • 1 - chave foi lançada
KeyModifiersModificadoresDeTecla NO modificador de tecla usado ao lado da tecla. Valores possíveis:
  • 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
PropriedadeTipoDescription
XNúmero inteiroA coordenada X do ponteiro do mouse.
YNúmero inteiroA coordenada Y do ponteiro do mouse.
MouseButtonNúmero inteiroO botão do mouse que foi clicado. Valores possíveis:
  • 0 - Nenhum
  • 1 - Esquerda
  • 2 - Meio
  • 3 - Direita
MouseActionNúmero inteiroIndica se o botão do mouse foi pressionado ou liberado. Valores possíveis:
  • 0 — o botão do mouse foi pressionado
  • 1 — o botão do mouse foi liberado
KeyModifiersModificadoresDeTecla NO modificador de tecla usado ao lado do botão do mouse. Valores possíveis:
  • 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
PropriedadeTipoDescription
KeyCharStringO caractere correspondente à tecla pressionada.
KeyCodeNúmero inteiroO código correspondente à tecla pressionada.
ExtendedKeyCodeNúmero inteiroO código estendido da tecla pressionada. Ao contrário de KeyCode, esse valor depende do layout de teclado atual.
LocationStringO local da chave que originou o evento.
KeyModifiersModificadoresDeTecla NO 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 para Java:

  • Click
  • Mouse pressionado
  • Mouse liberado
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseActionArgs
PropriedadeTipoDescription
XNúmero inteiroA coordenada X do ponteiro do mouse.
YNúmero inteiroA coordenada Y do ponteiro do mouse.
ButtonNúmero inteiroO botão do mouse que foi clicado. Valores possíveis:
  • 1 - Esquerda
  • 2 - Meio
  • 3 - Direita
ClickCountNúmero inteiroO número de vezes em que o botão foi clicado.
KeyModifiersModificadoresDeTecla NO 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 para Java:

  • Movimento do mouse
  • Mouse entrou
  • Mouse saiu
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseMotionArgs
PropriedadeTipoDescription
XNúmero inteiroA coordenada X do ponteiro do mouse.
YNúmero inteiroA coordenada Y do ponteiro do mouse.
MouseButtonNúmero inteiroO botão do mouse clicado Valores possíveis:
  • 0 - Nenhum
  • 1 - Esquerda
  • 2 - Meio
  • 3 - Direita

ArgumentosSelecionadosDeCélulaJava

Retorna dados dos seguintes eventos para Java:
  • Click
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellSelectedArgs
PropriedadeTipoDescription
RowNúmero inteiroLinha selecionada da célula.
ColumnNúmero inteiroColuna selecionada da célula.

ArgumentosDeValorDaCélulaJavaAlterado

Retorna dados dos seguintes eventos para Java:
  • Click
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellValueChangedArgs
PropriedadeTipoDescription
RowNúmero inteiroLinha da célula.
ColumnNúmero inteiroColuna da célula.
ValueStringNovo 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: seguem os nomes das propriedades definidos para Eventos de mouse.
PropriedadeTipoDescription
AltKeyBooleanoSe a tecla ALT for pressionada.
ButtonNúmero inteiroQual botão do mouse é pressionado. Valores possíveis:
  • 0 - Esquerda
  • 1 - Meio
  • 2 - Direita
ClientXNúmero inteiroA coordenada X do ponteiro do mouse (em relação à janela).
ClientYNúmero inteiroA coordenada Y do ponteiro do mouse (em relação à janela).
CtrlKeyBooleanoSe a tecla CTRL for pressionada.
MetaKeyBooleanoSe a tecla META for pressionada.
MovementXNúmero inteiroA coordenada X do ponteiro do mouse (em relação à posição do último evento mousemove).
MovementYNúmero inteiroA coordenada Y do ponteiro do mouse (em relação à posição do último evento mousemove).
OffsetXNúmero inteiroA coordenada X do ponteiro do mouse (em relação ao destino).
OffsetYNúmero inteiroA coordenada Y do ponteiro do mouse (em relação ao destino).
PageXNúmero inteiroA coordenada X do ponteiro do mouse (em relação ao documento).
PageYNúmero inteiroA coordenada Y do ponteiro do mouse (em relação ao documento).
ScreenXNúmero inteiroA coordenada X do ponteiro do mouse (em relação à tela).
ScreenYNúmero inteiroA coordenada Y do ponteiro do mouse (em relação à tela).
ShiftKeyBooleanoSe a tecla SHIFT for pressionada.

ArgumentosDePressionamentoDaTeclaDaWeb

Retorna dados dos seguintes eventos para WEBCTRL:
  • Tecla pressionada
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebKeyPressArgs
Observação: seguem os nomes das propriedades definidos para Eventos de teclado.
PropriedadeTipoDescription
AltKeyBooleanoSe a tecla ALT for pressionada.
CodeStringO código da tecla que disparou o evento (por exemplo, KeyA, KeyB, ControlLeft, ControlRight).
CtrlKeyBooleanoSe a tecla CTRL for pressionada.
IsComposingBooleanoSe o estado do evento estiver em composição ou não.
KeyStringO valor da tecla que disparou o evento (por exemplo. a, b, Control).
LocationNúmero inteiroO 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
MetaKeyBooleanoSe a tecla META for pressionada.
RepeatBooleanoSe uma tecla estiver sendo pressionada repetidamente ou não.
ShiftKeyBooleanoSe a tecla SHIFT for pressionada.

WebTextSelectionChangedArgs

Retorna dados dos seguintes eventos para WEBCTRL:
  • Seleção de texto alterada
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebTextSelectionChangedArgs
Observação: seguem os nomes das propriedades definidos para Eventos de teclado.
PropriedadeTipoDescription
AnchorClientBoundsRectangleOs limites do cliente âncora: informações sobre o tamanho do elemento e sua posição em relação à janela de visualização.
AnchorElementElementoDaUIO elemento de interface gráfica âncora.
AnchorOffsetNúmero inteiroO índice baseado em 0 do caractere no qual a seleção do texto começou (do texto completo do elemento de destino).
FocusClientBoundsRectangleOs limites do cliente foco: informações sobre o tamanho do elemento e sua posição em relação à janela de visualização.
FocusElementElementoDaUIO elemento de interface gráfica em foco.
FocusOffsetNúmero inteiroO índice baseado em 0 do caractere no qual a seleção de texto terminou (do texto completo do elemento de destino).
SelectedTextStringA 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
PropriedadeTipoDescription
StateStringA string descrevendo uma alteração em state de um downloads.DownloadItem.
IdStringO id de downloads.DownloadItem que foi alterado.
FileNameStringA string descrevendo uma alteração em url de um downloads.DownloadItem.
UrlStringA string descrevendo uma alteração em filename de um downloads.DownloadItem.
StartTimeStringA string descrevendo uma alteração em startTime de um downloads.DownloadItem.
EndTimeStringA string descrevendo uma alteração em endTime de um downloads.DownloadItem.
ErrorStringA 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
PropriedadeTipoDescription
TabIdStringO ID da guia que se tornou ativa.
WindowIdStringO ID da janela na qual a guia selecionada foi alterada.
TitleStringO novo título da guia.
UrlStringO URL da guia, caso tenha sido alterado.

TabCreatedArgs

Retorna dados dos seguintes eventos para WEBCTRL:
  • Guia criada
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabCreatedArgs
PropriedadeTipoDescription
TabIdStringO ID da guia que foi criada.
WindowIdStringO ID da janela que contém a guia.
TitleStringO novo título da guia.
UrlStringO URL da guia.

TabRemovedArgs

Retorna dados dos seguintes eventos para WEBCTRL:
  • Guia removida
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabRemovedArgs
PropriedadeTipoDescription
TabIdStringO ID da guia que foi removida.
WindowIdStringO ID da janela cuja guia é fechada.
IsWindowClosingBooleanoTrue 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
PropriedadeTipoDescription
TabIdStringO ID da guia que foi atualizada.
WindowIdStringO ID da janela que contém a guia.
StatusStringO status de carregamento da guia.
TitleStringO novo título da guia.
UrlStringO URL da guia, caso tenha sido alterado.
ActiveBooleanoSe 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
PropriedadeTipoDescription
UrlStringO 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.
TabIdNúmero inteiroO ID da guia onde o quadro está.
FrameIdNú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.
TimeStampMsDouble

O horário no qual a navegação por guias começou, em milissegundos, desde o epoch.

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.
DateTimeDataA 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
PropriedadeTipoDescription
UrlStringO 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.
TabIdNúmero inteiroO ID da guia na qual o quadro é.
FrameIdNú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.
TimeStampMsDouble

A hora na qual a navegação da guia foi concluída, em milissegundos desde o epoch.

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.
DateTimeDataA 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
PropriedadeTipoDescription
TabIdStringO ID da guia recém-alocada em foco.
WindowIdStringO ID da janela que contém a guia.
TitleStringO título da guia.
UrlStringO 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
PropriedadeTipoDescription
WindowIdStringO ID da janela cujos limites foram alterados.
FocusedBooleanoSe a janela é a janela em foco no momento.
TopNúmero inteiroO deslocamento da janela a partir da borda superior da tela em pixels.
LeftNúmero inteiroO deslocamento da janela a partir da borda esquerda da tela em pixels.
WidthNúmero inteiroA largura da janela, incluindo a moldura, em pixels.
HeightNúmero inteiroA altura da janela, incluindo a moldura, em pixels.

HtmlWindowCreatedArgs

Retorna dados dos seguintes eventos para HTML:
  • Janela criada
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowCreatedArgs
PropriedadeTipoDescription
WindowIdStringO ID da janela criada.

HtmlWindowRemovedArgs

Retorna dados dos seguintes eventos para HTML:
  • Janela removida
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowRemovedArgs
PropriedadeTipoDescription
WindowIdStringO ID da janela removida.

UiaToggledArgs

Retorna dados dos seguintes eventos para UIA:
  • Eventos alternados
Herança: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaToggledArgs
PropriedadeTipoDescription
StateStringO 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
PropriedadeTipoDescription
TextRangesUiaTextRange()

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.


Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.