Ir para o conteúdo

Mouse

Usando os métodos abaixo, você pode controlar e obter informações do mouse.

Obtendo coordenadas do mouse

Se você deseja obter a coordenada do mouse, use os métodos abaixo para obter a posição X e Y do mouse.

# Para obter a última coordenada que foi salva do mouse.
x = bot.get_last_x()
y = bot.get_last_y()

print(f'A última posição salva do mouse é: {x}, {y}')

// Para obter a última coordenada que foi salva do mouse.
int x = getLastX();
int y = getLastY();

System.out.printf("A última posição salva do mouse é: %d, %d", x, y);

Movendo o mouse para uma coordenada específica

Para mover o mouse para uma coordenada, use o método abaixo.

# Movendo o mouse para a posição x = 100 e y = 200.
bot.mouse_move(x=100, y=200)

// Movendo o mouse para a posição x = 100 e y = 200.
mouseMove(100, 200);

Movendo o mouse

Se você deseja mover o mouse para um elemento, use os métodos abaixo.

Você pode mover o mouse diretamente para um elemento, mover para uma posição em relação à posição do elemento encontrado ou para uma posição aleatória na página.

Observação

O find () é usado para procurar o elemento e coletar sua posição. Clique aqui para obter mais informações.

# Procurando o elemento na página com o label 'Submitform'.
if bot.find(label='SubmitForm', matching=0.97, waiting_time=10000):
    # Movendo-se diretamente para o elemento encontrado.
    bot.move()

    # Movendo-se para a posição x = 100 e y = 200 em relação ao elemento encontrado.
    bot.move_relative(x=100, y=200)


# Movendo o mouse para uma posição aleatória dentro de um intervalo x = 100 e y = 200.
bot.move_random(range_x=100, range_y=200)

// Procurando o elemento na página com o label 'SubmitForm'.
if (find("SubmitForm", 0.97, 10000)) {
    // Movendo-se diretamente para o elemento encontrado.
    move();

    // Movendo-se para a posição x = 100 e y = 200 em relação ao elemento encontrado.
    moveRelative(100, 200);
}

// Movendo o mouse para uma posição aleatória dentro de um intervalo x = 100 e y = 200.
moveRandom(100, 200);

Clicando em uma coordenada

Se você precisar clicar em uma posição na página, use o método abaixo.

# Clique esquerdo na posição x = 100 e y = 200.
bot.click_at(x=100, y=200)

# Clique com o botão direito do mouse na posição x = 100 e y = 200.
bot.right_click_at(x=100, y=200)

// Clique esquerdo na posição x = 100 e y = 200.
clickAt(100, 200)

// Clique com o botão direito do mouse na posição x = 100 e y = 200.
rightClickAt(100, 200);

Clicando no elemento

Se você deseja clicar em um elemento encontrado, use os métodos abaixo.

Você pode clicar diretamente no elemento ou clicar em uma posição relativa ao elemento encontrado.

Observação

O find () é usado para procurar o elemento e coletar sua posição. Clique aqui para obter mais informações.

# 'SubmitForm' é o label do elemento que será clicado.
bot.click_on(label='SubmitForm')


# Procurando o elemento na página com o label 'SubmitForm'.
if bot.find(label='SubmitForm', matching=0.9, waiting_time=10000):
    # Clique esquerdo no elemento encontrado.
    bot.click()

    # Clique com o botão direito no elemento encontrado.
    bot.right_click()

# Procurando o elemento na página com o label 'SubmitForm'.
if bot.find(label='SubmitForm', matching=0.9, waiting_time=10000):
    # Clique esquerdo na posição x = 100 e y = 200 em relação ao elemento encontrado.
    bot.click_relative(x=100, y=200)

    # Clique com o botão direito do mouse na posição x = 100 e y = 200 em relação ao elemento encontrado.
    bot.right_click_relative(x=100, y=200)

// 'SubmitForm' é o label do elemento que será clicado.
clickOn("SubmitForm");


// Procurando o elemento na página com o label 'SubmitForm'.
if (find("SubmitForm", 0.97, 10000)) {
    // Clique esquerdo no elemento encontrado.
    click();

    // Clique com o botão direito no elemento encontrado.
    rightClick();
}


// Procurando o elemento na página com o label 'SubmitForm'.
if (find("SubmitForm", 0.97, 10000)) {
    // Clique esquerdo na posição x = 100 e y = 200 em relação ao elemento encontrado.
    clickRelative(100, 200);

    // Clique com o botão direito do mouse na posição x = 100 e y = 200 em relação ao elemento encontrado.
    rightClickRelative(100, 200);
}

Duplo clique no elemento

Se você precisar clicar duas vezes no elemento ou clicar duas vezes em uma posição relativa ao elemento, use os métodos abaixo.

Observação

O find () é usado para procurar o elemento e coletar sua posição. Clique aqui para obter mais informações.

# Procurando o elemento na página com o label 'SubmitForm'.
if bot.find(label='SubmitForm', matching=0.97, waiting_time=10000):
    # Duplo clique no elemento encontrado.
    bot.double_click()

# Procurando o elemento na página com o label'SubmitForm'.
if bot.find(label='SubmitForm', matching=0.97, waiting_time=10000):
    # Duplo clique na posição x = 100 e y = 200 em relação ao elemento encontrado.
    bot.double_click_relative(x=100, y=200)

// Procurando o elemento na página com o label 'SubmitForm'.
if (find("SubmitForm", 0.97, 10000)) {
    // Duplo clique no elemento encontrado.
    doubleClick();
}

// Procurando o elemento na página com o label 'SubmitForm'.
if (find("SubmitForm", 0.97, 10000)) {
    // Duplo clique na posição x = 100 e y = 200 em relação ao elemento encontrado.
    doubleClickRelative(100, 200);
}

Triplo clique no elemento

Se você precisar clicar trez vezes no elemento ou clicar tres vezes em uma posição relativa ao elemento, use os métodos abaixo.

Observação

O find () é usado para procurar o elemento e coletar sua posição.Clique aqui para obter mais informações.

# Procurando o elemento na página com o label 'SubmitForm'.
if bot.find(label='SubmitForm', matching=0.97, waiting_time=10000):
    # Clique triplo no elemento encontrado.
    bot.triple_click()

# Procurando o elemento na página com o label 'SubmitForm'.
if bot.find(label='SubmitForm', matching=0.97, waiting_time=10000):
    # Triplo clique na posição x = 100 e y = 200 em relação ao elemento encontrado.
    bot.triple_click_relative(x=100, y=200)

// Procurando o elemento na página com o label 'SubmitForm'.
if (find("SubmitForm", 0.97, 10000)) {
    // Clique triplo no elemento encontrado.
    tripleClick();
}

// Procurando o elemento na página com o label 'SubmitForm'.
if (find("SubmitForm", 0.97, 10000)) {
    // Triplo clique na posição x = 100 e y = 200 em relação ao elemento encontrado.
    tripleClickRelative(100, 200);
}

Pressionando e liberando o botão do mouse

Para pressionar e liberar o botão do mouse, use os métodos abaixo. Atualmente apenas o botão esquerdo é suportado.

# Pressionando o botão do mouse.
bot.mouse_down()

# Liberando o botão do mouse.
bot.mouse_up()

// Pressionando o botão do mouse.
mouseDown();

// Liberando o botão do mouse.
mouseUp();

Se você precisar navegar pela página usando a rolagem para cima ou para baixo, use os métodos abaixo.

# Role para cima 10 vezes.
bot.scroll_up(clicks=10)

# Role para baixo 10 vezes.
bot.scroll_down(clicks=10)

// Role para cima 10 vezes.
scrollUp(10);

// Role para baixo 10 vezes.
scrollDown(10);