Click

UiPath.Core.Activities.Click

Clica em um elemento de interface gráfica especificado.

Importante:

A atividade de Clique Duplo tem a mesma funcionalidade que a atividade de Clique . A única diferença é que, para a atividade de Clique Duplo , o TipoDeClique é definido por padrão em CLICK\_DOUBLE, enquanto que para a atividade Click , 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. Por padrão, o clique único é selecionado.
• 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. 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

• AlterarSeDesabilitado - Caso ativado, a ação de verificação é executada mesmo se o elemento de interface gráfica especificado estiver desativado.

• TipoDeMovimentoDoCursor - Especifica o tipo de movimento executado pelo cursor do mouse. Há duas opções disponíveis:

  • Instantâneo - O cursor salta para o destino. Por padrão, Instante é selecionado.
  • Suave - O cursor se move em incrementos. Não terá efeito se EnviarMensagensDeJanela ou SimularClique estiverem habilitados.

• 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 podem ser usados com as opções SimularClique ou EnviarMensagensDaJanela. Executar um fluxo de trabalho que contém uma atividade com uma dessas combinações de opções não gera erro.

• EnviarMensagensDaJanela - Se selecionado, o clique é executado enviando uma mensagem específica para o aplicativo de destino. Este método de entrada pode funcionar em segundo plano, é compatível com a maioria dos aplicativos desktop, mas não é o mais rápido dos métodos. Por padrão, esta caixa de seleção fica desmarcada. Se nem essa caixa de seleção nem SimularClique estiverem selecionadas, o método padrão simula o clique usando o driver de hardware. O método padrão é o mais lento e pode não funcionar em segundo plano, mas é compatível com todos os aplicativos da área de trabalho.

• SimularClique - Se selecionado, simula o clique usando a tecnologia do aplicativo de destino. Este método de entrada é o mais rápido dos três e funciona em segundo plano. Por padrão, esta caixa de seleção fica desmarcada. Se nem esta caixa nem as caixas de seleção EnviarMensagensDeJanela estiverem marcadas, o método padrão executará o clique usando o driver de hardware. O método padrão é o mais lento e pode não funcionar em segundo plano, mas é compatível com todos os aplicativos da área de trabalho. Se você selecionar essa propriedade, é recomendado verificar o estado do Elemento da UI alvo antes da execução. Mais informações podem ser encontradas nesta página.

  Observação:

  SimularClique só pode ser usado com os tipos de entrada CLICK_SINGLE e BTN_LEFT . Caso contrário, um erro é gerado ao executar o fluxo de trabalho.

• DesbloquearEntrada - Deve ser usado quando Clicar dispara uma caixa de diálogo modal ou outra interface gráfica bloqueada. Só funciona com Simulate Click. Esse campo é compatível apenas com valores Boolean . O valor padrão para esta opção é False.

Exemplo de uso da atividade Click

Confira aqui como a atividade Click é usada em um exemplo que incorpora várias atividades.

Exemplo de uso da atividade Double Click

Confira aqui como a atividade Double Click é usada em um exemplo que incorpora várias atividades.