- Visão geral
- Automação de Interface Gráfica
- Aplicativos e tecnologias automatizados com a Automação de Interface Gráfica
- Compatibilidade do projeto
- UI-ANA-016 - Extrair URL de navegador aberto
- UI-ANA-017 - ContinuarComErro verdadeiro
- UI-ANA-018 - Listar atividades de OCR/Imagem
- UI-DBP-006 - Uso do contêiner
- UI-DBP-013 - Uso Incorreto da Automação do Excel
- UI-DBP-030 - Uso de variáveis proibidas em seletores
- UI-PRR-001 - Simular clique
- UI-PRR-002 - Simular Digitação
- UI-PRR-003 - Uso incorreto do aplicativo aberto
- UI-PRR-004 - Atrasos Embutidos em Código
- UI-REL-001 - Idx grande em Seletores
- UI-SEC-004 - Dados de e-mail do seletor
- UI-SEC-010 — restrições de app/URL
- UI-USG-011 - Atributos não permitidos
- UX-SEC-010 — restrições de app/URL
- UX-DBP-029 - Uso de senha não segura
- UI-PST-001 - Nível de log de auditoria nas configurações do projeto
- Ferramenta de Migração de Navegador do UiPath
- Computer Vision Recorder
- Ativar
- Anchor Base
- Anexar Navegador
- Anexar Janela
- Block User Input
- Call Transaction
- Texto Explicativo
- Marcar
- Click
- Clicar na Imagem
- Click Image Trigger
- Click OCR Text
- Click Picture on Screen
- Clicar no Texto
- Click Toolbar Button
- Click Trigger
- Close Application
- Fechar Guia
- Close Window
- Context Aware Anchor
- Copy Selected Text
- Element Attribute Change Trigger
- Element Exists
- Element Scope
- Element State Change Trigger
- Expand ALV Hierarchical Table
- Expand ALV Tree
- Expand Tree
- Export UI Tree
- Extrair Dados Estruturados
- Find Children
- Localizar Elemento
- Localizar Imagem
- Find Image Matches
- Find OCR Text Position
- Localizar Elemento Relativo
- Find Text Position
- Get Active Window
- Get Ancestor
- Get Attribute
- Get Event Info
- Get From Clipboard
- Obter Texto Completo
- Get OCR Text
- Get Password
- Get Position
- Get Source Element
- Get Text
- Obter Texto Visível
- Voltar
- Avançar
- Ir para a Página Inicial
- Google Cloud Vision OCR
- Hide Window
- Highlight
- Hotkey Trigger
- Hover
- Focalizar Imagem
- Hover OCR Text
- Focalizar Texto
- Imagem Existe
- Indicate On Screen
- Inject .NET Code
- Injetar script de JS
- Invoke ActiveX Method
- Key Press Trigger
- Carregar Imagem
- Maximize Window
- Microsoft Azure Computer Vision OCR
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- Minimize Window
- Monitorar eventos
- Mouse Trigger
- Move Window
- Navegar Para
- OCR Text Exists
- On Element Appear
- On Element Vanish
- Aparecer Na Imagem
- Desaparecer Na Imagem
- Abrir Aplicativo
- Abrir Navegador
- Read Statusbar
- Atualizar Navegador
- Replay User Event
- Restore Window
- SAP Login
- SAP Logon
- SAP Session Attributes Change Trigger
- Save Image
- Selecionar datas no calendário
- Select Item
- Select Menu Item
- Select Multiple Items
- Enviar Tecla de Acesso
- Set Clipping Region
- Set Focus
- Set Text
- Set To Clipboard
- Set Web Attribute
- Show Window
- Iniciar Processo
- System Trigger
- Table Cell Scope
- Take Screenshot
- Tesseract OCR
- Texto Existe
- Dica de ferramenta
- Type Into
- Digitar Texto Seguro
- Use Foreground
- Wait Attribute
- Esperar Elemento Desaparecer
- Aguardar Imagem Desaparecer
- Application event trigger
- Check/Uncheck
- Check App State
- Check Element
- Click
- Click Event Trigger
- Fechar pop-up
- Drag and Drop
- Extract Table Data
- For Each UI Element
- Get Attribute
- Get Browser Data
- Get Text
- Get URL
- Go To URL
- Highlight
- Hover
- Inject Js Script
- Keyboard Shortcuts
- Keypress Event Trigger
- Mouse Scroll
- Navigate Browser
- Select Item
- Set Browser Data
- Set Runtime Browser
- Set Text
- Take Screenshot
- Type Into
- Use Application/Browser
- Realize pesquisa no navegador e recupere resultados usando APIs de Automação de interface gráfica
- Navegação na Web
- Localizar imagens
- Clicar em imagens
- Disparar e monitorar eventos
- Criar e substituir arquivos
- Páginas HTML: extrair e manipular informações
- Manipulação de janelas
- Seleção automatizada de listas
- Localizar e manipular elementos de janela
- Gerenciar automação de texto
- Carregar e processar imagens
- Gerenciar ações ativadas pelo mouse
- Automatizar o runtime de aplicativos
- Execução automatizada de um aplicativo local
- Navegação em navegador
- Automação da Web
- Exemplo de escopo de disparador
- Computer Vision Local Server
- Automação Móvel
- Notas de versão
- Compatibilidade do projeto
- Get Log Types
- Get Logs
- Get Page Source
- Get Device Orientation
- Get Session Identifier
- Instalar Aplicativo
- Gerenciar Aplicativo Atual
- Manage Other App
- Open DeepLink
- Abrir URL
- Mobile Device Connection
- Positional Swipe
- Press Hardware Button
- Set Device Orientation
- Take Screenshot
- Obter parte da captura de tela
- Element Exists
- Execute Command
- Get Attribute
- Get Selected Item
- Get Text
- Set Selected Item
- Set Text
- Deslizar
- Tap
- Type Text
- Padrão de Desenho
- Terminal
- Notas de versão
- Sobre o pacote de atividades Terminal
- Compatibilidade do projeto
- Melhores práticas
- Find Text
- Get Color At Position
- Get Cursor Position
- Get Field
- Obter Campo na Posição
- Obter Área da Tela
- Get Text
- Obter Texto na Posição
- Mover Cursor
- Mover cursor para o texto
- Enviar Tecla de Controle
- Send Keys
- Send Keys Secure
- Set Field
- Definir Campo na Posição
- Terminal Session
- Aguardar Texto do Campo
- Aguardar Texto da Tela
- Aguardar Texto na Posição
Application event trigger
UiPath.UIAutomationNext.Activities.NNativeEventTrigger
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 .
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 .
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.
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
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. |
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, 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. |
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 nativos baseados em WEBCTRL em navegadores nativos incorporados (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. |
<html>
que têm apenas o atributo app
:
Estado do download alterado
Guia ativada
Guia criada
Guia removida
Guia atualizada
<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). |
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. |
TriggerArgs
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
TriggerArgs
> UiElementTriggerArgs
Propriedade | Tipo | Description |
Selector | String | O seletor do elemento de destino. |
TargetElement | ElementoDaUI | O elemento de destino monitorado. |
NativeTriggerBaseArgs
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
Propriedade | Tipo | Description |
---|---|---|
SelectorIndex | Número inteiro | O índice do seletor de elemento de destino. |
ArgusVazio
- 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
TriggerArgs
> UiElementTriggerArgs
> EmptyArgs
TextChangedArg
- Texto alterado
- Título alterado
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> TextChangedArgs
Propriedade | Tipo | Description |
---|---|---|
Text | String | O novo texto para o elemento de destino. |
ArgumentosDeEstadoAlterado
- Estado alterado
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> StateChangedArgs
Propriedade | Tipo | Description |
---|---|---|
State | String | O novo estado para o elemento de destino. |
ArgumentosDeSeleçãoAlterada
- Seleção alterada
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> SelectionChangedArgs
Propriedade | Tipo | Description |
---|---|---|
Selection | String | A nova seleção para o elemento de destino. |
ArgumentosDeLocalAlterado
- Localização alterada
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
- Primeiro plano recebido
- Primeiro plano perdido
- Minimizada
- restaurado
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> HwndArgs
Propriedade | Tipo | Description |
---|---|---|
Hwnd | IntPtr | Identificador da janela. |
HwndAsString | String | Identificador da janela como string. |
KeyPressArgs
- Tecla pressionada
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 | Indica se a tecla foi pressionada ou liberada. Valores possíveis:
|
KeyModifiers | ModificadoresDeTecla N | O modificador de tecla usado ao lado da tecla. Valores possíveis:
|
MouseClickedArgs
- Click
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 | O botão do mouse que foi clicado. Valores possíveis:
|
MouseAction | Número inteiro | Indica se o botão do mouse foi pressionado ou liberado. Valores possíveis:
|
KeyModifiers | ModificadoresDeTecla N | O modificador de tecla usado ao lado do botão do mouse. Valores possíveis:
|
JavaKeyPressArgs
Retorna dados dos seguintes eventos para Java:
- Tecla pressionada
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:
|
ArgumentosDeAçãoDoMouseJava
Retorna dados dos seguintes eventos para Java:
- Click
- Mouse pressionado
- Mouse liberado
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:
|
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:
|
ArgsDeMovimentoDoMouseJava
Retorna dados dos seguintes eventos para Java:
- Movimento do mouse
- Mouse entrou
- Mouse saiu
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:
|
ArgumentosSelecionadosDeCélulaJava
- Click
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
- Click
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
- Click
- Clicar duas vezes
- Clicar com o Botão Direito do Mouse
- Movimento do mouse
- Mouse entrou
- Mouse saiu
- Mouse pressionado
- Mouse liberado
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> WebMouseEventArgs
Propriedade | Tipo | Description |
---|---|---|
AltKey | Booleano | Se a tecla ALT for pressionada. |
Button | Número inteiro | Qual botão do mouse é pressionado. Valores possíveis:
|
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
- Tecla pressionada
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> WebKeyPressArgs
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:
|
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
- Seleção de texto alterada
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> WebTextSelectionChangedArgs
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
- Estado do download alterado
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
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
- Guia criada
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
- Guia removida
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
- Guia atualizada
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
- Navegação na guia iniciada
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 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 |
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.
|
DateTime | Data | A data e a hora em que a navegação por guias iniciou (UTC). |
TabNavigationCompletedArgs
- Navegação na guia concluída
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 |
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.
|
DateTime | Data | A data e a hora em que a navegação na guia foi concluída (UTC). |
HtmlWindowFocusChangedArgs
- Foco da janela alterado
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
- Limites da janela alterados
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
- Janela criada
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> HtmlWindowCreatedArgs
Propriedade | Tipo | Description |
---|---|---|
WindowId | String | O ID da janela criada. |
HtmlWindowRemovedArgs
- Janela removida
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> HtmlWindowRemovedArgs
Propriedade | Tipo | Description |
---|---|---|
WindowId | String | O ID da janela removida. |
UiaToggledArgs
- Eventos alternados
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> UiaToggledArgs
Propriedade | Tipo | Description |
---|---|---|
State | String | O novo estado para o elemento de destino. |
UiaTextSelectionChangedArgs
- Eventos alterados seleção de texto
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:
|
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.
- 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.
- Limpar - Exclui todos os eventos registrados.
- CSV - Os eventos capturados podem ser exportados para um arquivo
.csv
para uma análise posterior.
- 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.
- 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.
.csv
. Para iniciar o monitoramento novamente, feche a janela e abra outra instância da Ferramenta de inspeção de eventos.
- Description
- Compatibilidade do projeto
- Windows - Legada, Configuração do Windows
- Eventos nativos
- Sobre
- Eventos WND - Janela de nível superior
- Eventos CTRL ou WND - elementos da interface gráfica
- Eventos JAVA - Elementos de interface gráfica
- Eventos WEBCTRL - Elementos de interface gráfica
- Eventos do HTML — Elementos de interface do usuário
- Eventos de UIA - Elementos de interface do usuário
- Propriedades TriggerEventArgs
- Ferramenta de Inspeção de Eventos