activities
latest
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
Atividades do UIAutomation
Last updated 13 de ago de 2024

Focalizar Imagem

UiPath.Core.Activities.HoverImage

Pesquisa uma imagem em um elemento de interface gráfica e passa o mouse sobre ela.

Propriedades

Entrada
  • Imagem.Imagem - Uma imagem existente a ser pesquisada. Este campo é compatível apenas com variáveis Imagem.
  • Imagem.Precisão - Uma unidade de medida de 0 a 1 que expressa a semelhança mínima entre a imagem que procurada e a localizada. Útil em situações em que a imagem a ser encontrada é ligeiramente diferente daquela que você está procurando. O valor padrão é 0,8.
  • Imagem.Perfil - Permite alterar o algoritmo de detecção de imagem que você deseja usar. Básico é o algoritmo clássico, que apresenta velocidade e custo de recursos médios. Aprimorado pode oferecer resultados mais precisos à custa de mais recursos. Por padrão, este campo é definido como Básico.
  • Target.Selector - Propriedade de texto usada para localizar um determinado elemento da interface do usuário quando a atividade é executada. Na verdade, é um fragmento XML especificando atributos do elemento GUI que você está procurando e de alguns de seus pais.
  • Target.TimeoutMS - Especifica a quantidade de tempo (em milissegundos) para aguardar a execução da atividade antes que o erro SelectorNotFoundException seja lançado. O valor padrão é 30000 milissegundos (30 segundos).
  • Target.WaitForReady - Antes de executar as ações, aguarde 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 do usuário no aplicativo de destino existam antes de executar 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 UiElement retornada por outra atividade. Esta propriedade não pode ser usada junto com a propriedade Selector. Este campo suporta apenas variáveis UiElement.
  • Target.ClippingRegion - Define o retângulo de recorte, em pixels, relativo ao UiElement, nas seguintes direções: esquerda, superior, direita, inferior. Ele suporta números positivos e negativos.
Opções
  • EnviarMensagensDaJanela - Se esta caixa de seleção estiver selecionada, o foco é executado 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 selecionada, o método padrão executará o foco usando o driver de hardware. O método padrão é o mais lento e não funciona em segundo plano, porém é compatível com todos os aplicativos de desktop.
  • KeyModifiers - permite adicionar um modificador de chave. 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.
  • 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
  • NomeDeExibição - o nome de exibição da atividade.
  • DelayMS - Tempo de atraso (em milissegundos) após a execução da atividade. A quantidade de tempo padrão é 300 milissegundos.
  • DelayBefore - Tempo de atraso (em milissegundos) antes que a atividade comece a executar qualquer operação. A quantidade de tempo padrão é 200 milissegundos.
  • ContinuarComErro — 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.

    Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.
Diversos
  • Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Exemplo de uso da atividade Hover Image

A atividade Hover Image é usada para pesquisar uma imagem dentro de um elemento da interface gráfica e passar o mouse sobre ela.

Para exemplificar como usar esta atividade, criamos um exemplo que abre um navegador, passa o mouse sobre uma imagem, inicia uma ação e exibe os resultados relacionados a essa ação.

É assim que um processo de automação pode ser construído:

  1. Abra o Studio e crie um Processo.
  2. Arraste uma atividade Sequence para o Designer de fluxo de trabalho.
  3. Arraste uma atividade Open Browser dentro do contêiner Sequência.

    • No painel Propriedades, selecione a opção IE na lista suspensa TipoDeNavegador.
    • Adicione a expressão "https://www.goodreads.com/book/show/7144.Crime_and_Punishment" no campo Url.
    • Marque a caixa de seleção para a opção NovaSessão. Essa opção abre uma nova sessão do navegador selecionado.
  4. Arraste uma atividade Hover Image para dentro do contêiner Corpo da atividade Open Browser.

    • Abra o endereço do site adicionado anteriormente na atividade Open Browser.
    • Selecione o botão Clique para abrir o menu de opções a partir da atividade Hover Image em clique na opção Capturar da tela. Selecione a imagem desejada.
  5. Arraste uma atividade Click Image para baixo da atividade Hover Image.

    • No painel Propriedades, selecione a opção CLICK_SINGLE na lista suspensa TipoDeClique.
    • Selecione a opção BTN_LEFT na lista suspensa BotãoDoMouse.
    • Selecione a opção Target na lista suspensa Destino.
    • Adicione a expressão "<html title='*' /><webctrl aaname='Other editions' parentid='imagecol' tag='A' />" ao campo Seletor.
    • Selecione a opção INTERACTIVE na lista suspensa AguardarAtéEstarPronto.
  6. Execute o processo. O robô abre um novo navegador, acessa o site, passa o mouse sobre a imagem selecionada e clica no botão Outras edições.

  • Propriedades
  • Exemplo de uso da atividade Hover Image

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 White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.