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.

This activity must be added inside a Use Application/Browser activity.

To use this activity outside a Use Application/Browseractivity, 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 - Para usar o Computer Vision como um método de segmentação, você precisa acessar Configurações do projeto > Computer Vision e certificar-se de definir o ponto de extremidade do servidor correto. Você pode deixar esse campo como está e usar o UiPath Cloud, que é preenchido por padrão, ou você pode inserir outro valor selecionando qualquer um dos outros pontos de extremidade públicos específicos de uma região do servidor ou seu próprio servidor no local.

      Outra maneira de usar o Computer Vision como um método de segmentação é definir Usar Servidor Local como True. Isso indica que o pacote UiPath.ComputerVision.LocalServer está instalado em seu projeto. Quando o Servidor local é habilitado, o valor do servidor é substituído. No entanto, o Servidor local não está disponível em projetos multiplataforma.

  • 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. Compatível 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 .