Ir para o conteúdo

Teclado

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

Escrevendo texto

Você pode escrever texto de algumas maneiras diferentes, dependendo do comportamento que você deseja simular.

Digitação semelhante à humana

Usando esse método, você pode simular uma digitação humana tecla por tecla.

# O método 'kb_type' recebe o texto a ser digitado.
bot.kb_type("Este é um exemplo usando o método 'kb_type'")

// O método 'type' recebe o texto a ser digitado.
type("Este é um exemplo usando o método 'type'");

// O método 'kbType' recebe o texto a ser digitado.
await desktopBot.kbType("Este é um exemplo usando o método 'kbType'")

// O método 'kbType' recebe o texto a ser digitado.
await desktopBot.kbType("Este é um exemplo usando o método 'kbType'")

Colando o texto de uma só vez

O método de paste é rápido e amplamente usado, mas a diferença é que ele apenas cola o conteúdo da área de transferência.

Dica

Alguns campos, como caixas de seleção (widgets de ComboBox) ou alguns formulários Web não permitem a operação paste. Para superar questões como essa, use o método que simula uma digitação humana descrito acima.

# O método `paste` recebe o texto a ser colado.
bot.paste("Este é um exemplo usando o método 'paste'")

// O método `paste` recebe o texto a ser colado.
paste("Este é um exemplo usando o método 'paste'");

// O método `paste` recebe o texto a ser colado.
await desktopBot.paste("Este é um exemplo usando o método 'paste'")

// O método `paste` recebe o texto a ser colado.
await desktopBot.paste("Este é um exemplo usando o método 'paste'")

Pressionando teclas do teclado

Você pode pressionar teclas no teclado para ativar os atalhos e realizar outras operações.

Tab

O método tab pressiona a tecla Tab do teclado.

# Pressione a tecla tab
bot.tab()

// Pressione a tecla tab
tab();

// Pressione a tecla tab
await desktopBot.tab()

// Pressione a tecla tab
await desktopBot.tab()

Enter

O método enter pressiona a tecla Enter do teclado.

Dica

Esse método geralmente pode ser usado para substituir um clique ou interação por um botão por meio da visão computacional.

# Pressione a tecla enter
bot.enter()

// Pressione a tecla enter
enter();

// Pressione a tecla enter
await desktopBot.enter()

// Pressione a tecla enter
await desktopBot.enter()

Escape/Esc

# Pressione a tecla Esc
bot.key_esc()

// Pressione a tecla Esc
keyEsc();

// Pressione a tecla Esc
await desktopBot.keyEsc()

// Pressione a tecla Esc
await desktopBot.keyEsc()

Space

# Pressione a tecla Espaço
bot.space()

// Pressione a tecla Espaço
space();

// Pressione a tecla Espaço
await desktopBot.space()

// Pressione a tecla Espaço
await desktopBot.space()

Backspace

# Pressione a tecla Backspace
bot.backspace()

// Pressione a tecla Backspace
backspace();

// Pressione a tecla Backspace
await desktopBot.backspace()

// Pressione a tecla Backspace
await desktopBot.backspace()

Delete

# Pressione a tecla Delete
bot.delete()

// Pressione a tecla Delete
delete();

// Pressione a tecla Delete
await desktopBot.delete()

// Pressione a tecla Delete
await desktopBot.delete()

Shift

A tecla Shift pode ser pressionada e liberada para simular uma magnitude de comportamentos dependendo do aplicativo que você está usando.

Para demonstrar, vamos manter a tecla Shift pressionada e digitar um texto para deixá-lo com letra maiúsculas. Também iremos fazer o release da tecla Shift e digitar o texto, porém agora a escrita ficará com letras minúsculas.

# Pressione e segure o 'shift'
bot.hold_shift()

# Digite o texto "teste letra maiuscula", observando que o texto será digitado com a escrita em letras maiúsculas.
bot.type_key("teste letra maiuscula")

# Libera o 'shift'
bot.release_shift()

# Espaço para digitar um novo texto
bot.space(wait=1000)

# Digite o texto "teste letra minuscula", observando que o texto será digitado com a escrita em letras minúsculas, pois o `shift` foi liberado anteriormente.
bot.type_key("teste letra minuscula")

// Pressione e segure o `shift`.
holdShift();

// Digite o texto "teste letra maiuscula", observando que o texto será digitado com a escrita em letras maiúsculas.
type("teste letra maiuscula");

// Libera o 'shift'.
releaseShift();

// Espaço para digitar um novo texto
space(wait=1000);

// Digite o texto "teste letra minuscula", observando que o texto será digitado com a escrita em letras minúsculas, pois o `shift` foi liberado anteriormente.
type("teste letra minuscula");

// Pressione e segure o `shift`.
await desktopBot.holdShift()

// Digite o texto "teste letra maiuscula", observando que o texto será digitado com a escrita em letras maiúsculas.
await desktopBot.typeKeys("teste letra maiuscula")

// Libera o 'shift'
await desktopBot.releaseShift()

// Espaço para digitar um novo texto
await desktopBot.space(1000)

// Digite o texto "teste letra minuscula", observando que o texto será digitado com a escrita em letras minúsculas, pois o `shift` foi liberado anteriormente.
await desktopBot.typeKeys("teste letra minuscula")

// Pressione e segure o `shift`
await desktopBot.holdShift()

// Digite o texto "teste letra maiuscula", observando que o texto será digitado com a escrita em letras maiúsculas.
await desktopBot.typeKeys("teste letra maiuscula")

// Libera o 'shift'
await desktopBot.releaseShift()

// Espaço para digitar um novo texto
await desktopBot.space(1000)

// Digite o texto "teste letra minuscula", observando que o texto será digitado com a escrita em letras minúsculas, pois o `shift` foi liberado anteriormente.
await desktopBot.typeKeys("teste letra minuscula")

Tecla Windows

# Pressione a tecla do logotipo do Windows
bot.type_windows()

// Pressione a tecla do logotipo do Windows
keyWindows();

// Pressione a tecla do logotipo do Windows
await desktopBot.typeWindows()

// Pressione a tecla do logotipo do Windows
await desktopBot.typeWindows()

Teclas de função

Você pode ativar as teclas de função de 1 a 12 com o método key fn.

# Pressione a tecla F5 aciona a função nativa dessa tecla, neste caso, atualiza as páginas na maioria dos navegadores.
bot.key_f5()

# Pressione a tecla F11, aciona a função nativa dessa tecla, neste caso altera a tela para o modo completo.
bot.key_f11()

# Para outras teclas, use key_fn onde n é o número de 1 a 12

// Pressione a tecla F5 aciona a função nativa dessa tecla, neste caso, atualiza as páginas na maioria dos navegadores.
keyF5();

// Pressione a tecla F11, aciona a função nativa dessa tecla, neste caso altera a tela para o modo completo.
keyF11();

// Para outras teclas, use keyFn onde n é o número de 1 a 12

// Pressione a tecla F5 aciona a função nativa dessa tecla, neste caso, atualiza as páginas na maioria dos navegadores.
await desktopBot.keyF5()

// Pressione a tecla F11, aciona a função nativa dessa tecla, neste caso altera a tela para o modo completo.
await desktopBot.keyF5()

// Para outras teclas, use keyFn onde n é o número de 1 a 12

// Pressione a tecla F5 aciona a função nativa dessa tecla, neste caso, atualiza as páginas na maioria dos navegadores.
await desktopBot.keyF5()

// Pressione a tecla F11, aciona a função nativa dessa tecla, neste caso altera a tela para o modo completo.
await desktopBot.keyF5()

// Para outras teclas, use keyFn onde n é o número de 1 a 12

Teclas direcionais

Com os métodos abaixo, podemos interagir ou pressionar as teclas direcionais do teclado (para cima, para baixo, esquerda e direita).

# No teclado direcional, pressione a tecla 'Up', seta para cima.
bot.type_up()

# No teclado direcional, pressione a tecla 'Down', seta para baixo.
bot.type_down()

# No teclado direcional, pressione a tecla 'Left', seta esquerda.
bot.type_left()

# No teclado direcional, pressione a tecla 'Right', seta direita.
bot.type_right()

// No teclado direcional, pressione a tecla 'Up', seta para cima.
keyUp();

// No teclado direcional, pressione a tecla 'Down', seta para baixo.
keyDown();

// No teclado direcional, pressione a tecla 'Left', seta esquerda.
keyLeft();

// No teclado direcional, pressione a tecla 'Right', seta direita.
keyRight();

// No teclado direcional, pressione a tecla 'Up', seta para cima.
await desktopBot.typeUp()

// No teclado direcional, pressione a tecla 'Down', seta para baixo.
await desktopBot.typeDown()

// No teclado direcional, pressione a tecla 'Left', seta esquerda.
await desktopBot.typeLeft()

// No teclado direcional, pressione a tecla 'Right', seta direita.
await desktopBot.typeRight()

// No teclado direcional, pressione a tecla 'Up', seta para cima.
await desktopBot.typeUp()

// No teclado direcional, pressione a tecla 'Down', seta para baixo.
await desktopBot.typeDown()

// No teclado direcional, pressione a tecla 'Left', seta esquerda.
await desktopBot.typeLeft()

// No teclado direcional, pressione a tecla 'Right', seta direita.
await desktopBot.typeRight()

Page Up e Page Down

# Pressione a tecla para cima, fazendo a página rolar para cima.
bot.page_up()

# Pressione a tecla para baixo, fazendo a página rolar para baixo.
bot.page_down()

// Pressione a tecla para cima, fazendo a página rolar para cima.
keyUp();

// Pressione a tecla para baixo, fazendo a página rolar para baixo.
keyDown();

// Pressione a tecla para cima, fazendo a página rolar para cima.
await desktopBot.pageUp();

// Pressione a tecla para baixo, fazendo a página rolar para baixo.
await desktopBot.pageDown();

// Pressione a tecla para cima, fazendo a página rolar para cima.
await desktopBot.pageUp();

// Pressione a tecla para baixo, fazendo a página rolar para baixo.
await desktopBot.pageDown();

Atalhos do teclado

O framework possui os atalhos mais usados prontos para uso.

Caso precise executar um atalho específico, você pode usar o método type keys para pressionar qualquer lista de teclas e simular qualquer atalho.

Usando teclas de digitação para atalhos

# Pressionando as teclas 'Win', 'Shift', 'S' em sequência. Este atalho permite capturar a tela no Windows 11.
bot.type_keys(["win", "shift", "s"])

# Pressionando as teclas 'Win', 'Shift', 'S' em sequência, com intervalo para pressionar e liberar as teclas.
bot.type_keys_with_interval(interval=2000, keys=["win", "shift", "s"])

import java.awt.event.KeyEvent;

// Pressionando as teclas 'Win', 'Shift', 'S' em sequência. Este atalho permite capturar a tela no Windows 11.
typeKeys(KeyEvent.VK_WINDOWS, KeyEvent.VK_SHIFT, KeyEvent.VK_S);

// Pressionando as teclas 'Win', 'Shift', 'S' em sequência, com intervalo para pressionar e liberar as teclas.
typeKeysWithInterval(KeyEvent.VK_WINDOWS, KeyEvent.VK_SHIFT, KeyEvent.VK_S);

// Pressionando as teclas 'Win', 'Shift', 'S' em sequência. Este atalho permite capturar a tela no Windows 11.
await desktopBot.typeKeys(["win", "shift", "s"])

// Pressionando as teclas 'Win', 'Shift', 'S' em sequência, com intervalo para pressionar e liberar as teclas.
await desktopBot.typeKeys(["win", "shift", "s"], 2000)

// Pressionando as teclas 'Win', 'Shift', 'S' em sequência. Este atalho permite capturar a tela no Windows 11.
await desktopBot.typeKeys(["win", "shift", "s"])

// Pressionando as teclas 'Win', 'Shift', 'S' em sequência, com intervalo para pressionar e liberar as teclas.
await desktopBot.typeKeys(["win", "shift", "s"], 2000)

Atalhos com Alt

# Pressionando Alt + espaço, o atalho do teclado.
bot.alt_space()
# Pressionando Alt + E, o atalho do teclado.
bot.alt_e()
# Pressionando Alt + R, o atalho do teclado.
bot.alt_r()
# Pressionando Alt + F, o atalho do teclado.
bot.alt_f()
# Pressionando Alt + U, o atalho do teclado.
bot.alt_u()
# Pressionando Alt + F4, o atalho do teclado.
bot.alt_f4()

// Pressionando Alt + espaço, o atalho do teclado.
altSpace();
// Pressionando Alt + E, o atalho do teclado.
altE();
// Pressionando Alt + R, o atalho do teclado.
altR();
// Pressionando Alt + F, o atalho do teclado.
altF();
// Pressionando Alt + U, o atalho do teclado.
altU();
// Pressionando Alt + F4, o atalho do teclado.
altF4();

// Pressionando Alt + espaço, o atalho do teclado.
await desktopBot.altSpace()
// Pressionando Alt + E, o atalho do teclado.
await desktopBot.altE()
// Pressionando Alt + R, o atalho do teclado.
await desktopBot.altR()
// Pressionando Alt + F, o atalho do teclado.
await desktopBot.altF()
// Pressionando Alt + U, o atalho do teclado.
await desktopBot.altU()
// Pressionando Alt + F4, o atalho do teclado.
await desktopBot.altF4()

// Pressionando Alt + espaço, o atalho do teclado.
await desktopBot.altSpace()
//Pressionando Alt + E, o atalho do teclado.
await desktopBot.altE()
// Pressionando Alt + R, o atalho do teclado.
await desktopBot.altR()
// Pressionando Alt + F, o atalho do teclado.
await desktopBot.altF()
// Pressionando Alt + U, o atalho do teclado.
await desktopBot.altU()
// Pressionando Alt + F4, o atalho do teclado.
await desktopBot.altF4()

Atalhos com Shift

# Pressionando Shift + Tab, o atalho do teclado.
bot.shift_tab()

// Pressionando Shift + Tab, o atalho do teclado.
shiftTab();

// Pressionando Shift + Tab, o atalho do teclado.
await dekstopBot.shiftTab()

// Pressionando Shift + Tab, o atalho do teclado.
await dekstopBot.shiftTab()

Atalhos com Control

# Pressionando 'Ctrl + C' para copiar a área de transferência.
bot.control_c()

# Pressionando 'Ctrl + V' para colar o conteúdo.
bot.control_v()

# Pressionando 'Ctrl + A' para selecionar todo o conteúdo.
bot.control_a()

# Pressionando 'Ctrl + F' para abrir a barra de pesquisa.
bot.control_f()

# Pressionando 'Ctrl + P' para imprimir a tela.
bot.control_p()

// Pressionando 'Ctrl + C' para copiar a área de transferência.
controlC();

// Pressionando 'Ctrl + V' para colar o conteúdo.
controlV();

// Pressionando 'Ctrl + A' para selecionar todo o conteúdo.
controlA();

// Pressionando 'Ctrl + F' para abrir a barra de pesquisa.
controlF();

// Pressionando 'Ctrl + P' para salvar/imprimir a tela.
controlP();

// Pressionando 'Ctrl + C' para copiar a área de transferência.
await desktopBot.controlC()

// Pressionando 'Ctrl + V' para colar o conteúdo.
await desktopBot.controlV()

// Pressionando 'Ctrl + A' para selecionar todo o conteúdo.
await desktopBot.controlA()

// Pressionando 'Ctrl + C' para copiar a área de transferência.
await desktopBot.controlC()

// Pressionando 'Ctrl + V' para colar o conteúdo.
await desktopBot.controlV()

// Pressionando 'Ctrl + A' para selecionar todo o conteúdo.
await desktopBot.controlA()
Outros atalhos Ctrl

Além dos métodos mostrados acima, temos outros atalhos com a tecla de controle que podem ser usados da mesma maneira:

Shortcut
Ctrl+U
Ctrl+R
Ctrl+T
Ctrl+W
Ctrl+End
Ctrl+Home
Ctrl+Shift+J
Ctrl+Shift+P