activities
latest
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
Atividades do UIAutomation
Last updated 13 de ago de 2024

Obter Texto Visível

UiPath.Core.Activities.GetVisibleText

Extrai uma cadeia de caracteres e suas informações de um elemento de interface gráfica indicado usando o método de extração da tela Native. Esta atividade também pode ser gerada automaticamente ao realizar a extração da tela com um contêiner.

Observação: essa atividade não funciona corretamente quando usada em navegadores que requerem automatização de extensões, como Chrome, Firefox e Edge.

Propriedades

Saída
  • Texto - A string de caracteres extraída do elemento de interface gráfica indicado.
  • InformaçõesSobrePalavras - As coordenadas de tela de cada palavra localizada no elemento de interface gráfica indicado. Este campo é compatível apenas com variáveis TextInfo.
Opções
  • Separadores - Especifica os caracteres usados como separadores de string. Se o campo estiver vazio, todos os separadores de texto conhecidos serão usados (espaço, ponto final, vírgula etc.).
  • TextoFormatado - Se esta caixa de seleção estiver marcada, o layout de tela do texto copiado é preservado.
Diversos
  • Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.
  • 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.
  • Target.TimeoutMS - Especifica a quantidade de tempo (em milissegundos) para aguardar a execução da atividade antes que o erro SelectorNotFoundException seja lançado. O valor padrão é 30000 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/completo - espera que todos os elementos da interface do usuário no aplicativo de destino existam antes de executar 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 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.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.
Comum
  • NomeDeExibição - 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 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.

Exemplo de uso da atividade Get Visible Text

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

  • Propriedades
  • Exemplo de uso da atividade Get Visible Text

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.