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 coordenada 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);

// Para obter a coordenada do mouse.
const x = desktopBot.getLastX()
const y = desktopBot.getLastY()

console.log(`A última posição salva do mouse é: ${x}, ${y}`)

// Para obter a coordenada do mouse.
const x: number = desktopBot.getLastX()
const y: number = desktopBot.getLastY()

console.log(`A última posição salva do mouse é: ${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, y=200.
bot.mouse_move(x=100, y=200)

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

// Movendo o mouse para a posição x=100, y=200.
await desktopBot.moveMouse(100, 200)

// Movendo o mouse para a posição x=100, y=200.
await desktopBot.moveMouse(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 tela.

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);

// Procurando o elemento na página com o label 'SubmitForm'.
if (await desktopBot.find('SubmitForm')) {
    const center = this.state.center()
    await desktopBot.moveMouse(center.x, center.y)

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

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

// Procurando o elemento na página com o label 'SubmitForm'.
if (await desktopBot.find('SubmitForm')) {
    const center: object = this.state.center()
    await desktopBot.moveMouse(center?.x, center?.y)

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

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

Clicando em uma coordenada

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

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

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

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

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

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

// Clique com o botão direito do mouse na posição x=100, y=200.
await desktopBot.clickAt(100, 200, 'right')

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

// Clique com o botão direito do mouse na posição x=100, y=200.
await desktopBot.clickAt(100, 200, 'right')

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):
    # Clicando 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):
    # Clicando na posição x=100, 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, 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)) {
    // Clicando 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)) {
    // Clicando na posição x=100, y=200 em relação ao elemento encontrado.
    clickRelative(100, 200);

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

// 'SubmitForm' é o rótulo do elemento que será clicado.
await desktopBot.clickOn('SubmitForm')

// Procurando o elemento na página com o label 'SubmitForm'.
if (await bot.find('SubmitForm') !== null) {
    // Clicando no elemento encontrado.
    await desktopBot.click()

    // Clique com o botão direito no elemento encontrado.
    await desktopBot.click('right')
}

// Procurando o elemento na página com o label 'SubmitForm'.
if (await desktopBot.find('SubmitForm') !== null):
    // Clicando na posição x=100, y=200 em relação ao elemento encontrado.
    await desktopBot.clickRelative(100, 200)

    // Clique com o botão direito do mouse na posição x=100, y=200 em relação ao elemento encontrado.
    await desktopBot.clickRelative(100, 200, 'right')

// 'SubmitForm' é o rótulo do elemento que será clicado.
await desktopBot.clickOn('SubmitForm')

// Procurando o elemento na página com o label 'SubmitForm'.
if (await bot.find('SubmitForm') !== null) {
    // Clicando no elemento encontrado
    await desktopBot.click()

    // Clique com o botão direito no elemento encontrado.
    await desktopBot.click('right')
}

// Procurando o elemento na página com o label 'SubmitForm'.
if (await desktopBot.find('SubmitForm') !== null):
    // Clicando na posição x=100, y=200 em relação ao elemento encontrado.
    await desktopBot.clickRelative(100, 200)

    // Clique com o botão direito do mouse na posição x=100, y=200 em relação ao elemento encontrado.
    await desktopBot.clickRelative(100, 200, 'right')

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 rótulo 'SubmitForm'.
if bot.find(label='SubmitForm', matching=0.97, waiting_time=10000):
    # Duplo clique na posição x=100, 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, y=200 em relação ao elemento encontrado.
    doubleClickRelative(100, 200);
}

// Procurando o elemento na página com o label 'SubmitForm'.
if (await desktopBot.find('SubmitForm')){
    // Duplo clique no elemento encontrado.
    await desktopBot.doubleClick()
}

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

// Procurando o elemento na página com o label 'SubmitForm'.
if (await desktopBot.find('SubmitForm')){
    // Duplo clique no elemento encontrado.
    await desktopBot.doubleClick()
}

// Procurando o elemento na página com o label 'SubmitForm'.
if (await desktopBot.find('SubmitForm')){
    // Duplo clique na posição x=100, y=200 em relação ao elemento encontrado.
    await desktopBot.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, 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, y=200 em relação ao elemento encontrado.
    tripleClickRelative(100, 200);
}

// Procurando o elemento na página com o label 'SubmitForm'.
if (await desktopBot.find('SubmitForm')){
    // Clique triplo no elemento encontrado.
    await desktopBot.tripleClick()
}

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

// Procurando o elemento na página com o label 'SubmitForm'.
if (await desktopBot.find('SubmitForm')){
    // Clique triplo no elemento encontrado.
    await desktopBot.tripleClick()
}

// Procurando o elemento na página com o label 'SubmitForm'.
if (await desktopBot.find('SubmitForm')){
    // Triplo clique na posição x=100, y=200 em relação ao elemento encontrado.
    await desktopBot.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()

// Ainda não implementado.

// Pressionando o botão do mouse.
await desktopBot.mouse_down()

// Liberando o botão do mouse.
await desktopBot.mouse_up()

// Pressionando o botão do mouse.
await desktopBot.mouse_down()

// Liberando o botão do mouse.
await desktopBot.mouse_up()

Se você precisar navegar pela tela 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);

// Role para cima 10 vezes.
await desktopBot.scrollUp(10)

// Role para baixo 10 vezes.
await desktopBot.scrollDown(10)

// Role para cima 10 vezes.
await desktopBot.scrollUp(10)

// Role para baixo 10 vezes.
await desktopBot.scrollDown(10)