Clicar na Imagem

UiPath.Core.Activities.ClickImage

Pesquisa uma imagem em um elemento de interface gráfica e clica nela.

Importante:

A atividade Double Click Image tem a mesma funcionalidade que a atividade Click Image , a única diferença é que, para a atividade Double Click Image , o ClickType é definido por padrão CLICK\_DOUBLE, enquanto que para a atividade Click Image , o ClickType é definido por padrão em CLICK\_SINGLE.

Propriedades

Comum

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Observação:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

• AtrasoApós - Tempo de atraso (em milissegundos) após executar a atividade. O período padrão é 300 milissegundos.

• AtrasoAntes - Tempo de atraso (em milissegundos) antes de a atividade começar a realizar qualquer operação. O período padrão é 200 milissegundos.

• DisplayName - O nome de exibição da atividade.

Entrada

• TipoDeClique - Especifica o tipo de clique do mouse (simples, duplo, para cima, para baixo) usado ao simular o evento clique.
• Imagem.Precisão - Uma unidade de medida de 0 a 1 que expressa a semelhança mínima entre a imagem que procurada e a localizada. Útil em situações em que a imagem a ser encontrada é ligeiramente diferente daquela que você está procurando. O valor padrão é 0,8.
• Imagem.Imagem - Uma imagem existente a ser pesquisada. Este campo é compatível apenas com variáveis Imagem.
• Imagem.Perfil - Permite alterar o algoritmo de detecção de imagem que você deseja usar. Básico é o algoritmo clássico, que apresenta velocidade e custo de recursos médios. Aprimorado pode oferecer resultados mais precisos à custa de mais recursos. Por padrão, este campo é definido como Básico.
• BotãoDoMouse - O botão do mouse (esquerdo, direito, central) usado para a ação de clique. Por padrão, o botão esquerdo do mouse é selecionado.
• Destino.RegiãoDeRecorte - Define o retângulo de clipagem, em pixels, em relação ao ElementoDaUi, conforme as seguintes direções: esquerda, superior, direita, inferior. Suporta números positivos e negativos.
• Target.Element - Use a variável ElementoDaUI retornada por outra atividade. Essa propriedade não pode ser usada com a propriedade Seletor. Esse campo é compatível apenas com variáveis ElementoDaUI.
• Destino.Seletor - Propriedade de texto usada para localizar um determinado elemento de interface gráfica quando a atividade é executada. Em realidade, é um fragmento XML especificando atributos do elemento GUI procurado e de alguns de seus pais.
• Destino.TempoLimite (milissegundos) - Especifica o período (em milissegundos) que se deve aguardar para a execução da atividade antes de gerar o erro SelectorNotFoundException.O valor padrão é de 30.000 milissegundos (30 segundos).
• Target.WaitForReady - Antes de executar as ações, aguarda o destino ficar pronto. Por padrão, Interativo/Completo é selecionado. As seguintes opções estão disponíveis:
  • Nenhum — não espera por nada, exceto o elemento de interface gráfica do alvo existir antes de executar a ação. Por exemplo, você pode usar essa opção se quiser recuperar apenas o texto de uma página web ou clicar em um botão específico, sem precisar esperar todos os elementos da interface gráfica carregarem. Observe que isso pode ter consequências indesejadas se o botão depender de elementos ainda não carregados, como scripts.
  • Interativo - Aguarda até que apenas uma parte do aplicativo seja carregada.
  • Completo - Aguarda até que todo o aplicativo seja carregado.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• PosiçãoDoCursor.DeslocamentoX - Deslocamento horizontal da posição do cursor de acordo com a opção selecionada no campo Posição.

• PosiçãoDoCursor.DeslocamentoY - Deslocamento vertical da posição do cursor de acordo com a opção selecionada no campo Posição.

• PosiçãoDoCursor.Posição - Descreve o ponto inicial do cursor ao qual são adicionados os deslocamentos das propriedades DeslocamentoX e DeslocamentoY. As seguintes opções estão disponíveis: SuperiorEsquerda, SuperiorDireita, InferiorEsquerda, InferiorDireita e Centro. A opção padrão é Centro.

• ModificadoresDeTecla - Habilita você a adicionar um modificador de tecla. As seguintes opções estão disponíveis: None, Alt, Ctrl, Shift, Win. A opção padrão é None.

  Observação:

  ModificadoresDeTecla não pode ser usado com a opção EnviarMensagensDaJanela . Nenhum erro é gerado ao executar um fluxo de trabalho que contém uma atividade com essa combinação de opções.

• EnviarMensagensDaJanela - Se esta caixa de seleção estiver marcada, o clique é executado enviando uma mensagem específica para o aplicativo de destino. Este método de entrada é mais rápido e funciona em segundo plano. Por padrão, esta caixa de seleção fica desmarcada. Se a caixa de seleção não estiver marcada, o método padrão executa o clique usando o driver de hardware. O método padrão é o mais lento e não funciona em segundo plano, porém é compatível com todos os aplicativos de desktop.

Exemplo de uso das atividades Click Image e Double Click Image

Você pode ver como as atividades Click Image e Double Click Image são usadas em um exemplo que incorpora várias atividades.

Você pode verificar e baixar o exemplo aqui.