UiPath Documentation
activities
latest
false

Atividades do UIAutomation

Última atualização 5 de mai de 2026

Aparecer Na Imagem

UiPath.Core.Activities.OnImageAppear

Um contêiner que aguarda a exibição de uma imagem e permite executar várias ações na imagem encontrada.

Propriedades

Saída
  • ElementoLocalizado - O elemento de interface gráfica resultante que contém a imagem especificada. Esse campo é compatível apenas com variáveis ElementoDaUI.
Entrada
  • Imagem.Imagem - Uma imagem existente a ser pesquisada. Este campo é compatível apenas com variáveis Imagem.
  • 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.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.
  • 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.TempoLimiteEmMs - 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/Completo - Espera que todos os elementos da interface gráfica no aplicativo de destino existam antes de executar, de fato, a ação.Para avaliar se um aplicativo está no estado Interativo ou Concluído, as seguintes tags são verificadas:
    • Aplicativos de área de trabalho — uma mensagem wm_null é enviada para verificar a existência das tags,<wnd> ,<ctrl> ,<java> ou. <uia>Se existirem, a atividade é executada.
    • Aplicativos web:
    1. Internet Explorer - A tag <webctrl> é usada para verificar se o estado Pronto do documento HTML está definido como Concluído. Além disso, o estado Ocupado deve ser definido como “Falso”.
    2. Outros - A tag <webctrl> é usada para verificar se o estado Pronto do documento HTML está Concluído.
    • Aplicativos SAP — primeiro a presença da tag <wnd> é verificada e, depois disso, uma API específica do SAP é usada para detectar se a sessão está ocupada ou não.
  • 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.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.
Comum
  • DisplayName - O nome de exibição da atividade.

  • 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.

Opções
  • RepetirParaSempre - Especifica se atividade monitora eventos continuamente. Este campo só aceita valores booleanos (True, False). True
    • o bloco é executado toda vez que a imagem especificada aparece; esse é o valor padrão. False - a atividade é executada apenas uma vez.
Diversos
  • Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.
  • 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