Enviar Tecla de Acesso

UiPath.Core.Activities.SendHotkey

Envia atalhos de teclado a um elemento de interface gráfica.

Propriedades

Opções

• ModificadoresDeTecla - Habilita você a adicionar um modificador de tecla. As seguintes opções estão disponíveis: Alt, Ctrl, Shift, Win.

  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.

• TeclaEspecial - Indica se você está usando uma tecla especial no atalho de teclado. Uma lista de todas as teclas especiais disponíveis é fornecida na lista suspensa Tecla.

• EnviarMensagensDaJanela - Se esta caixa de seleção estiver marcada, a tecla de atalho será executada 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.

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

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

Entrada

• Tecla - A tecla ou combinação de teclas que compõem a tecla de atalho enviada. Este campo é compatível apenas com strings e variáveis String.

  Observação:

  A partir da versão 2018.3, a propriedade Tecla aceita variáveis String como entrada, permitindo criar variáveis para as teclas de atalho mais utilizadas em sua automação e simplesmente utilizá-las como entrada para este campo de propriedade, facilitando a criação do processo.

Comum

• DisplayName - O nome de exibição da atividade.

• AtrasoEmMs - Tempo de espera (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.

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Observação:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.
• 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.

Exemplo de uso da atividade Send Hotkey

Aqui é possível ver como a atividade Send Hotkey é usada em um exemplo que incorpora várias atividades.