Python pyautogui: Controle do Mouse com Movimento e Clique Direito

		Python - Usando pyautogui: Movimento e clique do mouse
@CanalQb

Controle do mouse com pyautogui

O módulo pyautogui em Python é amplamente utilizado para automação de interfaces gráficas, permitindo mover o mouse, clicar e interagir com a tela de forma programada.

Exemplo: Movendo o mouse em círculo e clicando com o botão direito

O código abaixo demonstra como mover o cursor do mouse em um círculo de raio 50 pixels, centralizado na tela, e ao final realizar um clique com o botão direito. O movimento ocorre suavemente, com duração controlada para cada passo.

import pyautogui
import time
import math

# Obter o tamanho da tela
screen_width, screen_height = pyautogui.size()

# Obter o centro da tela
center_x, center_y = screen_width / 2, screen_height / 2

# Definir o tamanho do círculo
radius = 50

# Mover o mouse em um círculo
for angle in range(0, 360, 5):
    x = center_x + radius * math.cos(math.radians(angle))
    y = center_y + radius * math.sin(math.radians(angle))
    pyautogui.moveTo(x, y, duration=0.1)

# Clicar com o botão direito do mouse
pyautogui.click(button='right')

# Esperar alguns segundos
time.sleep(5)

Você pode ajustar o tamanho do círculo alterando o valor da variável radius e controlar o tempo de espera ajustando o valor da função time.sleep().

Clique com botão direito em uma posição específica

Para clicar com o botão direito do mouse em um local específico da tela, utilize a função pyautogui.rightClick(x, y), onde x e y são as coordenadas da posição desejada.

import pyautogui

# Clicar com o botão direito do mouse nas coordenadas (100, 100)
pyautogui.rightClick(100, 100)

Se quiser adicionar um atraso antes do clique, use time.sleep() para garantir que o cursor esteja posicionado corretamente:

import pyautogui
import time

# Esperar 2 segundos
time.sleep(2)

# Clicar com o botão direito do mouse em (100, 100)
pyautogui.rightClick(100, 100)

Uso do parâmetro button na função click()

A função pyautogui.click() permite especificar qual botão do mouse deve ser clicado através do parâmetro opcional button. Por padrão, o clique é feito com o botão esquerdo (left), mas você pode definir right para clique com o botão direito.

import pyautogui

# Clicar com o botão esquerdo do mouse em (100, 100)
pyautogui.click(100, 100, button='left')

# Clicar com o botão direito do mouse em (100, 100)
pyautogui.click(100, 100, button='right')

Essas funções facilitam a automação de tarefas que exigem interações com o mouse, sendo úteis para testes automatizados, macros ou outras aplicações práticas.

Referências

• Documentação oficial do PyAutoGUI
• Site oficial do Python

Importante: Ao utilizar automações e scripts que interajam com interfaces gráficas, sempre teste em ambientes controlados para evitar ações indesejadas. Use estas ferramentas com responsabilidade.