Pular para conteúdo

Ações do Mouse

Ações de teclado são ações para emular uma entrada de teclado.

Ações

mouse.click

Clique na posição atual do mouse ou em um X, Y se uma posição for fornecida.

Se uma posição da tela for fornecida, você deve sempre definir as posições X e Y para evitar qualquer problema.

Parâmetros:

x (opcional) - X posição na tela para clicar (padrão=Nenhum - posição atual).

y (opcional) - Y posição na tela para clicar (padrão=Nenhum - posição atual).

button (opcional) - define qual botão do mouse deve ser usado para clicar 'esquerda', 'meio' ou 'direita' (padrão='esquerda').

clicks (opcional) - Define quantos cliques serão dados (padrão=1).

move_click_delay (opcional) - tempo em segundos entre o movimento do mouse e o clique do mouse. Útil ao usar conexões remotas ou aplicativos lentos (padrão=0).

Retorna:

x - X posição do mouse.

y - Y posição do mouse.

Exceções:

Esta ação não retorna nenhuma exceção

mouse.click_element

Atua da mesma forma que chrome.click_element

mouse.click_image

Encontre a imagem dada na tela e clique nela. Clicará na posição com melhor ajuste à imagem do modelo.

Parâmetros:

template_image - a imagem do modelo para encontrar na tela e clicar nela.

threshold (opcional) - define a porcentagem mínima de correspondência com a imagem do modelo (padrão=0,9 - 90%).

screenshot_img (opcional) - Pode definir uma imagem para encontrar o modelo dentro, ou se definido como Nenhum fará uma nova captura de tela (padrão=Nenhum).

timeout (opcional) - número de segundos a esperar até que o modelo seja exibido na tela (padrão=5).

clicks (opcional) - Define quantos cliques serão dados (padrão=1).

move_click_delay (opcional) - tempo em segundos entre o movimento do mouse e o clique do mouse. Útil ao usar conexões remotas ou aplicativos lentos (padrão=0).

Retorna:

x - X correspondente ao centro do modelo correspondido.

y - Y correspondente ao centro do modelo correspondido.

Exceções:

ImageNotFoundException - quando o template_image não pôde ser encontrado após o tempo limite expirar.

mouse.double_click

Clique duas vezes na posição atual do mouse ou em um X, Y se uma posição for fornecida.

Se uma posição da tela for fornecida, você deve sempre definir as posições X e Y para evitar qualquer problema.

Parâmetros:

x (opcional) - número da posição X na tela para clicar (padrão=Nenhum - posição atual).

y (opcional) - número da posição Y na tela para clicar (padrão=Nenhum - posição atual).

button (opcional) - define qual botão do mouse deve ser usado para clicar duas vezes 'esquerda', 'meio' ou 'direita' (padrão='esquerda').

interval (opcional) - intervalo entre cada clique, para computadores mais lentos, considere definir um valor maior que default (padrão=0 - instantâneo).

move_click_delay (opcional) - tempo em segundos entre o movimento do mouse e o clique do mouse. Útil ao usar conexões remotas ou aplicativos lentos (padrão=0).

Retorna:

x - X posição do mouse.

y - Y posição do mouse.

Exceções:

Esta ação não retorna nenhuma exceção

mouse.drag_to

Arraste o mouse da posição atual para a posição final X e Y especificada.

Parâmetros:

x - o número da posição X vai nas extremidades do arrasto.

y - o número da posição Y vai nas extremidades do arrasto.

speed (opcional) - número que representa os segundos necessários para se mover da posição atual para a posição final.

button (opcional) - define qual botão do mouse deve ser usado para arrastar 'esquerda', 'meio' ou 'direita' (padrão='esquerda').

Retorna:

x - X posição do mouse.

y - Y posição do mouse.

Exceções:

Esta ação não retorna nenhuma exceção

mouse.get_position

Retorna a posição X, Y atual do mouse.

Parâmetros:

Nenhum

Retorna:

x - X posição do mouse.

y - Y posição do mouse.

Exceções:

Esta ação não retorna nenhuma exceção

mouse.mouse_down

Simule um botão pressionado (clique) sem soltar o botão.

Parâmetros:

button (opcional) - define qual botão do mouse deve ser usado para o mouse para baixo 'esquerda', 'meio' ou 'direita' (padrão='esquerda').

Retorna:

Esta ação não dá retorno

Exceções:

Esta ação não retorna nenhuma exceção

mouse.mouse_up

Simule a liberação de um botão após uma ação mouse.mouse_down.

Parâmetros:

button (opcional) - define qual botão do mouse deve ser usado para o mouse para baixo 'esquerda', 'meio' ou 'direita' (padrão='esquerda').

Retorna:

Esta ação não dá retorno

Exceções:

Esta ação não retorna nenhuma exceção

mouse.move

Move a posição do mouse X, Y pixels em relação à posição atual.

Ex: se o mouse estiver em 100, 100 e mouse.move(30, 50) se chamado, moverá o cursor do mouse para a posição 130, 150 X,Y.

Esta ação depende da posição atual do mouse. Se você quiser mover para uma posição absoluta, use a ação mouse.move_to.

Parâmetros:

x - número com quantos pixels devem ser movidos da posição atual. X pode ser um número positivo (mover para a esquerda) ou negativo (mover para a direita).

y - número com quantos pixels devem ser movidos da posição atual. Y pode ser um número positivo (descer) ou negativo (subir).

speed (opcional) - número de segundos para o movimento do mouse da posição atual para a nova posição X, Y.

Retorna:

x - X posição final do mouse.

y - Y posição final do mouse.

Exceções:

Esta ação não retorna nenhuma exceção

mouse.move_to

Mova o mouse para a posição X, Y na tela.

Ex: se o mouse estiver em 100, 100 e mouse.move_(30, 50) se for chamado, moverá o cursor do mouse para a posição 30, 50 X,Y.

Esta ação é independente da posição atual do mouse. Se você deseja mover em relação à posição atual, use a ação mouse.move.

Parâmetros:

x (opcional) - número com quantos pixels devem ser movidos da posição atual. X pode ser um número positivo (mover para a esquerda) ou negativo (mover para a direita).

y (opcional) - número com quantos pixels devem ser movidos da posição atual. Y pode ser um número positivo (descer) ou negativo (subir).

speed (opcional) - número de segundos para o movimento do mouse da posição atual para a nova posição X, Y.

Retorna:

x - X posição final do mouse.

y - Y posição final do mouse.

Exceções:

Esta ação não retorna nenhuma exceção

mouse.multi_click

Execute uma ação de clique múltiplo na posição atual do mouse ou em um X, Y se uma posição for fornecida.

Se uma posição da tela for fornecida, você deve sempre definir as posições X e Y para evitar qualquer problema.

Parâmetros:

x (opcional) - número da posição X na tela para clicar (padrão=Nenhum - posição atual).

y (opcional) - número da posição Y na tela para clicar (padrão=Nenhum - posição atual).

clicks (opcional) - número de cliques a serem realizados na posição (padrão=1)

button (opcional) - define qual botão do mouse deve ser usado para múltiplos cliques 'esquerda', 'meio' ou 'direita' (padrão='esquerda').

interval (opcional) - intervalo entre cada clique, para computadores mais lentos, considere definir um valor maior que default (padrão=0 - instantâneo).

move_click_delay (opcional) - tempo em segundos entre o movimento do mouse e o clique do mouse. Útil ao usar conexões remotas ou aplicativos lentos (padrão=0).

Retorna:

x - X posição do mouse.

y - Y posição do mouse.

Exceções:

Esta ação não retorna nenhuma exceção

mouse.scroll

Execute uma rolagem para cima ou para baixo usando a roda de rolagem do mouse.

Parâmetros:

size - número de pixels para rolar. O número negativo executa uma rolagem para baixo e o número positivo executa uma rolagem para cima.

Retorna:

Esta ação não dá retorno

Exceções:

Esta ação não retorna nenhuma exceção