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