Click

UiPath.Core.Activities.Click

Clica em um elemento de interface gráfica especificado.

Importante:

A atividade Double Click tem a mesma funcionalidade que a atividade Click , a única diferença é que para a atividade Double Click , o ClickType é definido por padrão em CLICK_DOUBLE, enquanto para a atividade Click , o ClickType é definido por padrão em CLICK_SINGLE.

Propriedades

Comum

• ContinuarComErro — especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.
  Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.
• AtrasoApós - Tempo de atraso (em milissegundos) após executar a atividade. O período padrão é 300 milissegundos.
• DelayBefore - Tempo de atraso (em milissegundos) antes que a atividade comece a executar qualquer operação. A quantidade de tempo padrão é 200 milissegundos.
• NomeDeExibição - o nome de exibição da atividade.

Entrada

• ClickType - Especifica o tipo de clique do mouse (simples, duplo, para cima, para baixo) usado ao simular o evento click. Por padrão, clique único é selecionado.
• MouseButton - O botão do mouse (esquerdo, direito, meio) usado para a ação de clicar. Por padrão, o botão esquerdo do mouse é selecionado.
• Target.ClippingRegion - Define o retângulo de recorte, em pixels, relativo ao UiElement, nas seguintes direções: esquerda, superior, direita, inferior. Ele suporta números positivos e negativos.
• Target.Element - Use a variável UiElement retornada por outra atividade. Esta propriedade não pode ser usada junto com a propriedade Selector. Este campo suporta apenas variáveis UiElement.
• Target.Selector - Propriedade de texto usada para localizar um determinado elemento da interface do usuário quando a atividade é executada. Na verdade, é um fragmento XML especificando atributos do elemento GUI que você está procurando 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, aguarde 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, Instant é selecionado.
  • Suave - O cursor se move em incrementos. Não tem efeito se SendWindowMessages ou SimulateClick 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.
• KeyModifiers - permite adicionar um modificador de chave. As seguintes opções estão disponíveis: None, Alt, Ctrl, Shift, Win. A opção padrão é Nenhum.
  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.
• SendWindowMessages - 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 de desktop, mas não é o mais rápido dos métodos. Por padrão, essa caixa de seleção não está marcada. Se nem esta nem as caixas de seleção SimulateClick estiverem selecionadas, o método padrão simulará o clique usando o driver de hardware. O método padrão é o mais lento, não pode funcionar em segundo plano, mas é compatível com todos os aplicativos de desktop.
• SimulateClick - 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, essa caixa de seleção não está marcada. Se nem esta nem as caixas de seleção SendWindowMessages estiverem marcadas, o método padrão executa o clique usando o driver de hardware. O método padrão é o mais lento, não pode funcionar em segundo plano, mas é compatível com todos os aplicativos de desktop. Se você selecionar essa propriedade, é recomendável verificar o estado do elemento de interface do usuário de destino antes da execução. Mais detalhes podem ser encontrados nesta página.
  Observação: SimulateClick 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 restrita ou outra interface gráfica bloqueada. Só funciona com Simulate Click Esse campo é compatível apenas com valores Boolean . O valor padrão para essa 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

Aqui você pode ver como a atividade Double Click é usada em um exemplo que incorpora várias atividades.