Type Into

UiPath.Core.Activities.TypeInto

Envia pressionamentos de teclas para um elemento de interface gráfica.

Teclas especiais são compatíveis e podem ser selecionadas da lista suspensa.

Teclas de adesão também são suportadas. Por exemplo, se você quiser digitar Shift+End para selecionar apenas parte do texto de um controle, você precisa selecionar Shift e End da lista de teclas especiais e o texto proposto é [k(Shift)][k(End)]. Isso emula os pressionamentos das teclas Shift e End sequencialmente. O texto correto é [d(Shift)][k(End)][u(Shift)], onde d significa tecla pressionada para baixo, k significa pressionada tecla e u significa tecla pressionada para cima.

Propriedades

Entrada

• Texto - O texto seguro a ser gravado no elemento de interface gráfica especificado. Teclas especiais são compatíveis, e você pode selecioná-las na lista suspensa da atividade.

  Também é possível enviar pressionamentos de tecla para baixo ou enviar pressionamentos de tecla para cima usando esta sintaxe:

  %[d(ctrl)] - para pressionar um botão específico para baixo;
  %[u(ctrl)] - para levantar um botão específico.

Por exemplo, para enviar uma combinação de teclas CTRL + V, você pode usar %[d(ctrl)]v[u(ctrl)].

Observação:Isso só funciona para as opções Padrão e EnviarMensagensDaJanela (veja abaixo).

Opções

• SimulateType - Se marcada, simula a digitação 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 EnviarMensagensDaJanela 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 de desktop. 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.
• EnviarMensagensDaJanela - Se selecionado, o tipo é executado enviando uma mensagem específica para o aplicativo de destino. Esse 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 SimularDigitar estiverem selecionadas, o método padrão simula o pressionamento de teclas 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.
• AtrasoEntreChaves - Tempo de atraso (em milissegundos) entre duas teclas digitadas. O período padrão é 10 milissegundos. O valor máximo é 1000 milissegundos.
• ClicarAntesDeDigitar - Quando esta caixa de seleção é marcada, o elemento de interface gráfica especificado é clicado antes que o texto seja gravado.

• CampoVazio - Quando esta caixa de seleção é marcada, todo o conteúdo existente anteriormente no elemento de interface gráfica é apagado antes de o texto ser gravado.

  Observação: em ambientes web, os campos são esvaziados por padrão.

• Ativar - Quando esta caixa de seleção é marcada, o elemento de interface gráfica especificado é trazido para o primeiro plano e ativado antes que o texto seja escrito.

  Observação: Se a caixa de seleção Ativar não estiver selecionada, a atividade será digitada na janela atualmente ativa.
• AlterarSeDesabilitado - Caso ativado, a ação de verificação é executada mesmo se o elemento de interface gráfica especificado estiver desativado.

Comum

• NomeDeExibição - o nome de exibição da atividade.
• 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.

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

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.

Exemplo de uso da atividade Type Into

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