Mouse Scroll

UiPath.UIAutomationNext.Activities.NMouseScroll

Description

Habilita a rolagem em aplicativos enviando eventos de rolagem do mouse para o elemento de interface gráfica especificado.

Esta atividade precisa ser adicionada a uma atividade Use Application/Browser.

To use this activity outside a Use Application/Browser activity, you need to provide an Input element.

Esta atividade é compatível com o Repositório de Objetos.

Observação:

Se nenhum destino for fornecido para essa atividade, ela usará automaticamente o destino do escopo em que está incluída.

Além disso, devido à natureza desta atividade, ela não pode ser usada em modo segundo plano.

Para obter mais informações sobre como indicar e configurar destinos, consulte Tela de Seleção.

Compatibilidade do projeto

Windows - Legado | Janelas | Multiplataforma

Windows - Legada, Configuração do Windows

Painel do Designer

• Selecione o menu para acessar as seguintes opções:

  • Indicar destino na tela — indique o destino novamente.
  • Editar destino – Abra o modo de seleção para configurar o destino.
  • Remover captura de tela informativa - Remova a captura de tela do aplicativo de destino ou página da web.
  • Adicionar ao Repositório de Objetos — Adicione o elemento de interface gráfica atual a um projeto de biblioteca, de onde ele pode ser reutilizado em todo o processo de automação.

• Direção - A direção na qual você deseja que a rolagem seja executada. As seguintes opções estão disponíveis: Esquerda, Cima, Direita, Baixo. A opção padrão é Baixo.

• Tipo de rolagem - Selecione entre os dois métodos de uso para essa atividade:

  • Para o elemento - Rola até que um elemento de interface gráfica especificado seja encontrado no aplicativo de destino. Esse é o valor padrão.

    Observação: se você selecionar Para o elemento no campo Tipo de rolagem, o campo de propriedade # de rolagens é ignorado, e o elemento de interface gráfica especificado é procurado.

    Se, em tempo de execução, o elemento indicado não for encontrado, a atividade rola tanto quanto especificado no campo # of scrolls e então tenta novamente a busca pelo elemento indicado. Este comportamento é repetido quantas vezes forem necessárias, até que o elemento seja encontrado, e pode ser útil no caso de aplicações que possuem tempos de carregamento mais longos.

  • Distância - Rola apenas tanto quanto especificado no campo de propriedade # de rolagens .

    Nota: O número de linhas roladas por um movimento de rolagem é configurado na seção Configurações do mouse no Windows. Ao rolar para um elemento específico, o elemento é pesquisado após todas as rotações serem executadas. A seleção desse método também exibe a propriedade # of scrolls no corpo da atividade.

• Rolar até o elemento - Clique em Indicar no aplicativo/navegador para indicar o elemento de interface gráfica para o qual você deseja rolar. Essa opção aparece apenas se o elemento Para for selecionado no menu suspenso Tipo de rolagem .

Painel de Propriedades

Comum

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita Boolean valores (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.

• Atraso após - Atraso (em segundos) entre o momento em que esta atividade é concluída e o momento em que a próxima atividade inicia qualquer operação. O valor padrão é 0,3 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Atraso antes — atraso (em segundos) entre o momento em que a atividade anterior é concluída e o momento em que esta atividade começa a realizar alguma operação. O valor padrão é de 0,2 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Nome daexibição - O nome exibido para a atividade no painel do Designer. Um nome de exibição é gerado automaticamente quando você indica um destino.

• Tempo limite — especifique o período (em segundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.

  Importante: se você estiver rolando para um destino de imagem, é recomendável aumentar o valor da propriedade Tempo limite para acomodar os tempos de pesquisa de imagens mais longos.

Entrada

• Tipo de movimento do cursor — Especifica o tipo de movimento realizado pelo cursor do mouse. Há duas opções disponíveis:

  • Instantâneo - O cursor salta para o destino. Esse é o valor padrão.
  • Suave - O cursor se move em incrementos. A configuração só funciona se o modo de entrada Eventos de hardware for usado.
• Destino - O elemento de destino. É necessário definir o elemento de destino. Antes de indicar na tela, esse campo é definido como (null). Assim que o destino for indicado, todas as propriedades relacionadas ao elemento indicado serão exibidas.
  • Deslocamento de clique - Especifica um deslocamento para a atividade do clique, que pode ser configurado ainda mais.
    • Ponto de ancoragem - Descreve o ponto inicial do cursor para o qual ele se desloca das propriedades Deslocamento de X e Deslocamento de Y. As seguintes opções estão disponíveis: SuperiorEsquerda, SuperiorDireita, InferiorEsquerda, InferiorDireitae Centro. Por padrão, o Centro é selecionado.
    • Deslocamento de X - Deslocamento horizontal da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Esse campo é compatível apenas com variáveis Int32 .
    • Deslocamento de Y - Deslocamento vertical da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Esse campo é compatível apenas com variáveis Int32 .
  • Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision.
  • Texto do CV - Indica o texto identificado usando o Computer Vision.
  • Seletor difuso - Os parâmetros para o seletor difuso.
  • Texto nativo - O texto usado para identificar o elemento de interface gráfica.
  • Sites responsivos — habilita o layout de sites responsivos.
  • Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica.
  • Métodos de segmentação - Os tipos de seletor que você deseja usar para identificar o elemento. Essa propriedade pode ser definida como qualquer combinação no menu suspenso:
    • Nenhum
    • Seletor restrito
    • Seletor difuso
    • Imagem
    • Texto nativo
    • Computer Vision
  • Verificação devisibilidade — verifica se o elemento de interface gráfica está visível ou não. Você pode escolher uma das três opções do menu suspenso:
    • Nenhum - Não verifica a visibilidade.
    • Interativo (para seletor Difuso) - opção padrão. Verifica se o elemento está potencialmente visível, ignorando a rolagem da página, as obstruções de outros aplicativos ou o fato de o aplicativo estar minimizado. Essa verificação é útil ao tentar garantir que você não esteja segmentando elementos invisíveis que existem no DOM, mas que estão ocultos.
    • Totalmente visível - Verifica se o elemento de interface gráfica está visível ou não.
  • Aguardar carregamento da página — antes de executar as Actions, aguarde o aplicativo ficar pronto para aceitar a entrada. Você pode escolher uma das três opções do menu suspenso:
    • Nenhum - Não aguarda que o destino esteja pronto.
    • Interativo - Aguarda até que apenas uma parte do aplicativo seja carregada.
    • Completo - Aguarda até que todo o aplicativo seja carregado.
  • Seletor de janela (instância do Aplicativo) - O seletor que é usado para a janela do aplicativo. Aplicável somente quando o modo de anexação de janela estiver definido como Instância do aplicativo.

Elemento de Entrada/Saída

• Elemento deentrada — o elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto UIElement . Esse campo é compatível apenas com objetos UIElement . Esse objeto pode ser obtido do campo de propriedade Elemento de Saída de outras atividades do UIAutomation.
• Elemento de saída - Gera um Elemento de Interface Gráfica de destino e o armazena em um objeto UIElement , que pode ser usado para direcionar o mesmo elemento com outras atividades.

Diversos

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose. Este campo é compatível apenas com valores Boolean (Verdadeiro, Falso). O valor padrão é False.

Opções

• Nº de rolagens - A quantidade de vezes para rolar, armazenada em uma variável Int32 . Se a Tipo de rolagem no corpo da atividade estiver definida como Para o elemento, esse campo será definido por padrão como 10. Se definido como Distância, este campo será definido como 5 por padrão.
• Direção - Consulte Direção no painel do designer.

• Modo de entrada - Selecione qual método o Robô deve usar para interagir com o aplicativo de destino:

  • O mesmo que App/Browser — usa o mesmo modo de entrada da atividade Use Application/Browser .

  • Eventos de hardware - usa o driver de hardware para executar a ação. Este é o método mais lento, não pode funcionar em segundo plano, mas é compatível com todos os aplicativos de desktop.

  • API do Chromium — executa ações usando APIs do depurador. Funciona apenas com elementos do Chromium. Envia todos os textos de uma vez. Funciona mesmo que o aplicativo de destino não esteja em foco. Para obter mais detalhes, consulte esta página.

• Modificadores de tecla — adicione um ou mais modificadores de teclas a serem usados em combinação com as Actions da atividade. As seguintes opções estão disponíveis: Nenhum, Alt, Ctrl, Shifte Win. A opção padrão é Nenhum.

• Elemento pesquisado - O elemento de interface gráfica indicado para o qual você deseja rolar.

  • Elemento de saída - A referência do elemento de interface gráfica pesquisado, que você pode usar em outras atividades de automação de interface gráfica, na propriedade Elemento de entrada .
  • Destino - Este elemento de interface gráfica tem sua própria propriedade Destino que pode ser configurada da mesma forma que a principal.
  • Tempo limite — tempo (em segundos) de espera para que o elemento pesquisado apareça. O valor padrão é de 0,2 segundos.

Configuração multiplataforma

• Trabalho em escopo — escolha a guia do navegador renderizando o aplicativo da Web para automatizar.
• Rolar contêiner - Role a página inteira ou dentro de um Elemento. A opção padrão é Página inteira.
• Direção derolagem - A direção na qual você deseja que a rolagem seja executada. As seguintes opções estão disponíveis: Esquerda, Cima, Direita, Baixo. A opção padrão é Baixo.
• Tipo de rolagem - Selecione entre os dois métodos de uso para essa atividade:
  • Para o elemento - Rola até que um elemento de interface gráfica especificado seja encontrado no aplicativo de destino. Esse é o valor padrão.
  • Distância - Rola apenas tanto quanto especificado no campo de propriedade Número de rolagens .

• Indicar o elemento pesquisado na tela — indique o elemento de interface gráfica para o qual você deseja rolar. Essa opção aparece apenas se o elemento Para for selecionado no menu suspenso Tipo de rolagem .

  Após indicar o destino, selecione o botão mais para acessar as seguintes opções:

  • Indicar destino na tela — indique o destino novamente.
  • Editar destino – Abra o modo de seleção para configurar o destino.

• Número de rolagens - A quantidade de vezes para rolar. Essa opção somente é exibida se Distância for selecionada no menu suspenso Tipo de rolagem .

Opções adicionais

Horários

• Atraso antes — atraso (em segundos) entre o momento em que a atividade anterior é concluída e o momento em que esta atividade começa a realizar alguma operação. O valor padrão é de 0,2 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Atraso após - Atraso (em segundos) entre o momento em que esta atividade é concluída e o momento em que a próxima atividade inicia qualquer operação. O valor padrão é 0,3 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Tempo limite — especifique o período (em segundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita Boolean valores (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.

Entrada/Saída

• Elemento deentrada — o elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto UIElement . Esse campo é compatível apenas com objetos UIElement . Esse objeto pode ser obtido do campo de propriedade Elemento de Saída de outras atividades do UIAutomation.
• Elemento de saída - Gera um Elemento de Interface Gráfica de destino e o armazena em um objeto UIElement , que pode ser usado para direcionar o mesmo elemento com outras atividades.
• Elemento pesquisado de saída - A referência do elemento de interface gráfica pesquisado, a ser usado em outras atividades como elemento de interface gráfica de entrada. Essa opção aparece apenas se o elemento Para for selecionado no menu suspenso Tipo de rolagem .