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.

Para usar esta atividade fora de uma atividade Use Application/Browser , você precisa fornecer um Elemento de entrada.

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 estiver 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 - Legada | Windows | Multiplataforma

Configuração do Windows e multiplataforma

• Trabalho no escopo - Escolha a guia do navegador que renderiza o aplicativo para automatizar, quando a atividade é colocada dentro de atividades Use Application/Browser aninhadas.
• Contêiner de rolagem — rola toda a página ou dentro de um Elemento. A opção padrão é Página inteira.
• Indicar Destino na Tela — Indique o elemento de interface gráfica do contêiner no qual você deseja realizar a rolagem. Essa opção aparece apenas se a opção Elemento estiver selecionada no menu suspenso Contêiner de rolagem . Depois de indicar o destino, selecione o botão de adição para acessar as seguintes opções:
  • Indicar destino — indique o destino novamente.
  • Editar destino - Abra o modo de seleção para configurar o destino.
• Direção de rolagem — 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 .
• Número de rolagens - A quantidade de vezes para rolar. Esta opção aparece apenas se Distância for selecionada no menu suspenso Tipo de rolagem .

Painel de Propriedades

Destino

• Botão Expandir propriedades de destino/Recolher propriedades de destino - Exibe/oculta o contêiner de destino e suas propriedades de âncora.
• Métodos de segmentação - Os tipos de seletores que você deseja usar para identificar o elemento. Essa propriedade pode ser definida como qualquer combinação no menu suspenso:
  • Seletor restrito
  • Seletor difuso
  • Imagem
  • Texto nativo
  • Computer Vision
  • Seletor semântico
• Seletor de janela (Instância do aplicativo) - O seletor que é usado para a janela do aplicativo. Aplicável apenas quando o modo de anexação de janela estiver definido como Instância do aplicativo.
• Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica.
• Fuzzy selector - The parameters for the fuzzy selector.
• Precisão da imagem - Indica o nível de precisão para correspondência de imagens. O valor padrão é 0,8.
• Ocorrência de imagem - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas.
• Texto nativo - O texto que é usado para identificar o elemento de interface gráfica.
• Ocorrência de texto nativo - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas.
• Texto nativo com diferenciação de maiúsculas e minúsculas - Indica que a correspondência de texto do clima diferencia maiúsculas de minúsculas.
• Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision.
• CV Text - Indica o texto identificado usando o Computer Vision.
• Precisão do texto CV - Indica o nível de precisão para correspondência de texto OCR. O valor padrão é 0,7.
• Ocorrência de CV Text - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas.
• Seletor semântico – Uma descrição semântica que define o destino.
• Aguardar carregamento da página — antes de executar a ação, aguarda o aplicativo ficar pronto para aceitar a entrada. Você pode escolher uma das três opções no 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.
• Verificação de visibilidade - Verifica se o elemento de interface gráfica está visível ou não. Você pode escolher uma das três opções no menu suspenso:
  • Nenhum - Não verifica a visibilidade.
  • Interativo (para Seletor difuso) - Opção padrão. Verifica se o elemento é potencialmente visível, ignorando a rolagem de página e obstruções por outros aplicativos ou o fato de o aplicativo estar minimizado. Essa verificação é útil ao tentar garantir que você não esteja visando 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.
• Sites responsivos - Habilitar o layout de sites responsivos.
• Destino - Ponto de deslocamento - Especifica um deslocamento, que pode ser configurado ainda mais.
  • Ponto de ancoragem - Descreve o ponto inicial do cursor ao qual ele se desloca das propriedades Deslocamento X e Deslocamento Y. As seguintes opções estão disponíveis: SuperiorEsquerda, SuperiorDireita, InferiorEsquerda, InferiorDireita e Centro (selecionado por padrão).
  • Deslocamento X - Deslocamento horizontal da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Este campo é compatível apenas com variáveis Int32 .
  • Deslocamento Y - Deslocamento vertical da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Este campo é compatível apenas com variáveis Int32 .

Elemento pesquisado - Destino

• Botão Expandir propriedades de destino/Recolher propriedades de destino - Exibe/oculta o contêiner de destino e suas propriedades de âncora.
• Métodos de segmentação - Os tipos de seletores que você deseja usar para identificar o elemento. Essa propriedade pode ser definida como qualquer combinação no menu suspenso:
  • Seletor restrito
  • Seletor difuso
  • Imagem
  • Texto nativo
  • Computer Vision
  • Seletor semântico
• Seletor de janela (Instância do aplicativo) - O seletor que é usado para a janela do aplicativo. Aplicável apenas quando o modo de anexação de janela estiver definido como Instância do aplicativo.
• Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica.
• Fuzzy selector - The parameters for the fuzzy selector.
• Precisão da imagem - Indica o nível de precisão para correspondência de imagens. O valor padrão é 0,8.
• Ocorrência de imagem - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas.
• Texto nativo - O texto que é usado para identificar o elemento de interface gráfica.
• Ocorrência de texto nativo - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas.
• Texto nativo com diferenciação de maiúsculas e minúsculas - Indica que a correspondência de texto do clima diferencia maiúsculas de minúsculas.
• Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision.
• CV Text - Indica o texto identificado usando o Computer Vision.
• Precisão do texto CV - Indica o nível de precisão para correspondência de texto OCR. O valor padrão é 0,7.
• Ocorrência de CV Text - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas.
• Seletor semântico – Uma descrição semântica que define o destino.
• Aguardar carregamento da página — antes de executar a ação, aguarda o aplicativo ficar pronto para aceitar a entrada. Você pode escolher uma das três opções no 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.
• Verificação de visibilidade - Verifica se o elemento de interface gráfica está visível ou não. Você pode escolher uma das três opções no menu suspenso:
  • Nenhum - Não verifica a visibilidade.
  • Interativo (para Seletor difuso) - Opção padrão. Verifica se o elemento é potencialmente visível, ignorando a rolagem de página e obstruções por outros aplicativos ou o fato de o aplicativo estar minimizado. Essa verificação é útil ao tentar garantir que você não esteja visando 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.
• Sites responsivos - Habilitar o layout de sites responsivos.

Entrada/Saída

• Elemento de entrada - O elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto UIElement . Este campo é compatível apenas com objetos UIElement . Esse objeto pode ser obtido do campo de propriedade Elemento de saída de outras atividades de Automação de interface gráfica.
• 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 - Gera a referência do Elemento de interface gráfica pesquisado e a armazena em um objeto UIElement , para usar em outras atividades como Elemento de entrada.
• Elemento pesquisado de entrada - Especifica uma referência de elemento de interface gráfica existente a ser usada como o elemento de destino pesquisado. A atividade rola até esse elemento ficar visível na tela.

Opções

• Input mode - Select which method the Robot should use to interact with the target application:
  • Igual ao aplicativo/navegador — use o mesmo modo de entrada da atividade Use Application/Browser .
  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • 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 a API do Chromium.
• Modo do Healing Agent - configura o comportamento do Healing Agent para esta atividade, com base nas configurações de Governança ou do Orchestrator no nível do processo ou trabalho.
  • Igual ao Aplicativo/Navegador — herda a configuração da atividade pai Use Application/Browser .
  • Herdar configurações do trabalho — aplica as configurações definidas na governança ou no Orchestrator no nível do processo ou trabalho.
  • Desabilitado - Desativa o Healing Agent para essa atividade.
  • Apenas recomendação — permite que o Healing Agent forneça recomendações sobre como corrigir problemas de automação de interface gráfica na execução de trabalhos, mas somente se permitido pela governança ou pelas configurações do Orchestrator.
• Tipo de movimento do cursor - Especifica o tipo de movimento executado 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 tem efeito apenas se o modo de entrada de eventos de hardware for usado.
• Modificadores de tecla — Adicione um ou mais modificadores de tecla a serem usados na combinação com a ação da atividade. As seguintes opções estão disponíveis: None, Alt, Ctrl, Shift e Win. A opção padrão é None.
• Continuar com erro - 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.

Horários

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Tempo limite — especifique a quantidade de tempo (em segundos) para esperar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.
• Tempo limite do elemento pesquisado — especifique o tempo (em segundos) a ser aguardado para que o elemento apareça após cada ação de rolagem. Use um valor mais alto para uma rolagem mais lenta ou animada. O valor padrão é de 0,2 segundos.

Windows - Configuração legada

• Selecione o botão Menu para acessar as seguintes opções:
  • Indicate target on screen - Indicate the target again.
  • Editar destino - Abra o modo de seleção para configurar o destino.
  • Remover captura de tela informativa – Remove 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 seu 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, no runtime, o elemento indicado não for encontrado, a atividade rolará tanto quanto especificado no campo # de rolagens e, em seguida, tentará pesquisar o elemento indicado novamente. Esse comportamento é repetido quantas vezes forem necessárias, até que o elemento seja encontrado, e pode ser útil no caso de aplicativos que tenham tempos de carregamento mais longos.

  • Distância — rola somente tanto quanto especificado no campo de propriedade # de rolagens .
    Observação:

    The number of lines scrolled by a scroll movement is configured in the Mouse settings section in Windows. If scrolling to a specific element, the element is searched after all rotations are executed. Selecting this method also displays the # of scrolls property in the body of the activity.

• Rolar até o elemento — clique em Indicar em 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 estiver 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 aceita apenas valores Boolean (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.

• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Nome de exibição — o nome exibido da atividade no painel do Designer. Um nome de exibição é gerado automaticamente quando você indica um destino.

• Tempo limite — especifique a quantidade de tempo (em segundos) para esperar 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 imagem mais longos.

• Tipo de movimento do cursor - Especifica o tipo de movimento executado 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 tem efeito apenas se o modo de entrada de eventos de hardware for usado.

• Destino — o elemento de destino. Defina o elemento de destino. Antes de indicar na tela, esse campo é definido como (null). Depois que o destino for indicado, todas as propriedades relacionadas ao elemento que foi indicado são exibidas.

  • Deslocamento de clique - Especifica um deslocamento para a atividade de clique, que pode ser configurado ainda mais.
    • Ponto de ancoragem - Descreve o ponto inicial do cursor ao qual ele se desloca das propriedades Deslocamento X e Deslocamento Y. As seguintes opções estão disponíveis: SuperiorEsquerda, SuperiorDireita, InferiorEsquerda, InferiorDireita e Centro. Por padrão, o Centro é selecionado.
    • Deslocamento X - Deslocamento horizontal da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Este campo é compatível apenas com variáveis Int32 .
    • Deslocamento Y - Deslocamento vertical da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Este campo é compatível apenas com variáveis Int32 .
  • Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision.
  • CV Text - Indica o texto identificado usando o Computer Vision.
  • Fuzzy selector - The parameters for the fuzzy selector.
  • Texto nativo - O texto que é usado para identificar o elemento de interface gráfica.
  • Sites responsivos - Habilitar 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 seletores 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.
    • Seletor semântico – Aproveita modelos de linguagem grande (LLMs) para gerar descrições funcionais e semelhantes às humanas de elementos de interface gráfica. Essas descrições são altamente confiáveis, tornando-as adaptáveis a alterações de interface gráfica e melhorando significativamente a resiliência da automação quando os seletores tradicionais falham.
  • Verificação de visibilidade - Verifica se o elemento de interface gráfica está visível ou não. Você pode escolher uma das três opções no menu suspenso:
    • Nenhum - Não verifica a visibilidade.
    • Interativo (para Seletor difuso) - Opção padrão. Verifica se o elemento é potencialmente visível, ignorando a rolagem de página e obstruções por outros aplicativos ou o fato de o aplicativo estar minimizado. Essa verificação é útil ao tentar garantir que você não esteja visando 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 a ação, aguarda o aplicativo ficar pronto para aceitar a entrada. Você pode escolher uma das três opções no 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 apenas quando o modo de anexação de janela estiver definido como Instância do aplicativo.

• Elemento de entrada - O elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto UIElement . Este campo é compatível apenas com objetos UIElement . Esse objeto pode ser obtido do campo de propriedade Elemento de saída de outras atividades de Automação de interface gráfica.

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

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

• Número de rolagens - A quantidade de vezes para rolar, armazenada em uma variável Int32 . Se o Tipo de rolagem no corpo da atividade estiver definido como Para o elemento, este campo será definido por padrão como 10. Se estiver definido como Distância, este campo será definido como 5 por padrão.

• Direção — consulte Direção no painel Designer.

• Input mode - Select which method the Robot should use to interact with the target application:

  • Igual ao aplicativo/navegador — use o mesmo modo de entrada da atividade Use Application/Browser .
  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • 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 tecla a serem usados na combinação com a ação da atividade. As seguintes opções estão disponíveis: None, Alt, Ctrl, Shift e Win. A opção padrão é None.

• 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 - Esse elemento de interface gráfica tem sua própria propriedade Destino , que pode ser configurada da mesma forma que a principal.
  • Tempo limite — tempo de espera (em segundos) para que o elemento pesquisado apareça. O valor padrão é de 0,2 segundos.