UiPath Documentation
activities
latest
false

Atividades do UIAutomation

Última atualização 8 de mai de 2026

Click OCR Text

UiPath.Core.Activities.ClickOCRText

Pesquisa uma determinada string em um elemento ou imagem da interface gráfica indicada usando a tecnologia OCR e clica nela. Por padrão, o mecanismo UiPath Screen OCR é usado.

Importante:

A atividade Double Click OCR Text tem a mesma funcionalidade que a atividade Click OCR Text , a única diferença é que, para a atividade Double Click OCR Text , o ClickType é definido por padrão em CLICK\_DOUBLE, enquanto que para a atividade Click OCR Text , o TipoDeClique é 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 esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, 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.

  • 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.
  • Ocorrência - Se a string no campo Texto aparecer mais de uma vez no elemento de interface gráfica indicado, especifique aqui o número de ocorrências em que deseja clicar. Por exemplo, se a string aparecer 4 vezes e você quiser clicar na primeira ocorrência, escreva 1 neste campo. O valor padrão é 1.
  • 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.
  • Texto - A string a ser clicada. Todas as strings têm que ser colocadas entre aspas.
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.

  • As seguintes opções estão disponíveis: Nenhuma, Alt, Ctrl, Shift, Win. 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 é mais lento e não funciona em segundo plano, mas é compatível com todos os aplicativos de desktop.

  • Propriedades

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades