activities
latest
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Atividades do UIAutomation

Última atualização 24 de fev de 2026

Hover

UiPath.Core.Activities.Hover

Passa o mouse sobre um elemento de interface gráfica especificado.

Propriedades

Opções
  • TipoDeMovimentoDoCursor - Especifica o tipo de movimento executado pelo cursor do mouse. Há duas opções disponíveis:
    • Instantâneo - O cursor salta para o destino.
    • Smooth - The cursor moves in increments. Has no effect if SendWindowMessages or SimulateClick are enabled. By default, Instant is selected.
  • SimularFocalizar - Se definido como verdadeiro, simula o foco pela passagem do mouse 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 foco 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.
  • EnviarMensagensDaJanela - Se definido como verdadeiro, a ação de focalizar será executada enviando uma mensagem específica ao 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 SimularFocalizar estiverem selecionadas, o método padrão simula a ação de focalizar 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.
  • PosiçãoDoCursor.DeslocamentoX - Deslocamento horizontal da posição do cursor de acordo com a opção selecionada no campo Posição.
  • PosiçãoDoCursor.DeslocamentoY - Deslocamento vertical da posição do cursor de acordo com a opção selecionada no campo Posição.
  • PosiçãoDoCursor.Posição - Descreve o ponto inicial do cursor ao qual são adicionados os deslocamentos das propriedades DeslocamentoX e DeslocamentoY. As seguintes opções estão disponíveis: SuperiorEsquerda, SuperiorDireita, InferiorEsquerda, InferiorDireita e Centro. A opção padrão é Centro.
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 Hover

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

  • Propriedades
  • Exemplo de uso da atividade Hover

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo
Confiança e segurança
© 2005-2026 UiPath. Todos os direitos reservados.