Saltar a contenido

Teclado

Utilizando los métodos a continuación, puedes controlar y obtener información del teclado.

Escribir texto

Puedes escribir texto de diferentes maneras dependiendo del comportamiento que desees simular.

Escritura similar a la humana

Utilizando este método puedes simular la escritura de texto como lo haría un humano, tecla por tecla.

# El método 'kb_type' recibe el texto a escribir.
bot.kb_type("Este es un ejemplo utilizando el método 'kb_type'")

// El método 'type' recibe el texto a escribir.
type("Este es un ejemplo utilizando el método 'type'");

// El método 'kbType' recibe el texto a escribir.
await desktopBot.kbType('Este es un ejemplo utilizando el método "kbType"')

// El método 'kbType' recibe el texto a escribir.
await desktopBot.kbType('Este es un ejemplo utilizando el método "kbType"')

Pegar el texto de una vez

El método paste es rápido y ampliamente utilizado, pero la diferencia es que simplemente pega el contenido del portapapeles.

Tip

Algunos campos como las casillas de selección (widgets ComboBox) o algunos formularios web no permiten la operación de paste. Para superar problemas como ese, utiliza el método similar a la escritura humana descrito anteriormente.

# El método 'paste' recibe el texto a pegar.
bot.paste("Este es un ejemplo utilizando el método 'paste'")

// El método 'paste' recibe el texto a pegar.
paste("Este es un ejemplo utilizando el método 'paste'");

// El método 'paste' recibe el texto a pegar.
await desktopBot.paste('Este es un ejemplo utilizando el método "paste"')

// El método 'paste' recibe el texto a pegar.
await desktopBot.paste('Este es un ejemplo utilizando el método "paste"')

Presionar teclas del teclado

Puedes presionar teclas del teclado para activar atajos y realizar otras operaciones.

Tabulador

El método tab presiona la tecla Tab del teclado.

# Press the tab key.
bot.tab()

// Presiona la tecla tabulador.
tab();

// Presiona la tecla tabulador.
await desktopBot.tab()

// Presiona la tecla tabulador.
await desktopBot.tab()

Enter

El método enter presiona la tecla Enter en el teclado.

Tip

Este método a menudo se puede utilizar para reemplazar un clic o interacción con un botón a través de la visión por computadora.

# Press enter key.
bot.enter()

// Presiona la tecla enter.
enter();

// Presiona la tecla enter.
await desktopBot.enter()

// Presiona la tecla enter.
await desktopBot.enter()

Escape/Esc

# Press Esc key.
bot.key_esc()

// Presiona la tecla Esc.
keyEsc();

// Presiona la tecla Esc.
await desktopBot.keyEsc()

// Presiona la tecla Esc.
await desktopBot.keyEsc()

Espacio

# Press the space key.
bot.space()

// Presiona la tecla espacio.
space();

// Presiona la tecla espacio.
await desktopBot.space()

// Presiona la tecla espacio.
await desktopBot.space()

Retroceso

# Press the backspace key.
bot.backspace()

// Presiona la tecla retroceso.
backspace();

// Presiona la tecla retroceso.
await desktopBot.backspace()

// Presiona la tecla retroceso.
await desktopBot.backspace()

Suprimir

# Press the Delete key.
bot.delete()

// Presiona la tecla Suprimir.
delete();

// Presiona la tecla Suprimir.
await desktopBot.delete()

// Presiona la tecla Suprimir.
await desktopBot.delete()

Shift

La tecla Shift se puede mantener presionada y soltar para simular una variedad de comportamientos dependiendo de la aplicación que estés utilizando.

Para demostrarlo, vamos a mantener presionada la tecla Shift y escribir un texto para que el texto aparezca en mayúsculas. También vamos a soltar la tecla Shift y escribir el mismo texto en minúsculas.

# Press and hold shift.
bot.hold_shift()

# Type the text "test", noting that the text is rendered in uppercase.
bot.type_key("test uppercase")

# Realese shift.
bot.release_shift()

# take a space to type new text.
bot.space(wait=1000)

# Type the text "test", noting that the text is rendered in lowercase because was used the method release shift earlier.
bot.type_key("test lowercase")

// Presiona y mantiene presionada la tecla shift.
holdShift();

// Escribe el texto "test", observa que el texto se muestra en mayúsculas.
type("test en mayúsculas");

// Suelta la tecla shift.
releaseShift();

// Deja un espacio para escribir un nuevo texto.
space(1000);

// Escribe el texto "test", observa que el texto se muestra en minúsculas porque se utilizó el método release shift anteriormente.
type("test en minúsculas");

// Press and hold shift.
await desktopBot.holdShift()

// Type the text "test", noting that the text is rendered in uppercase.
await desktopBot.typeKeys("test uppercase")

// Release shift.
await desktopBot.releaseShift()

// take a space to type new text.
await desktopBot.space(1000)

// Type the text "test", noting that the text is rendered in lowercase because was used the method release shift earlier.
await desktopBot.typeKeys("test lowercase")

// Press and hold shift
await desktopBot.holdShift()

// Type the text "test", noting that the text is rendered in uppercase.
await desktopBot.typeKeys("test uppercase")

// Realese shift
await desktopBot.releaseShift()

// take a space to type new text
await desktopBot.space(1000)

// Type the text "test", noting that the text is rendered in lowercase because was used the method release shift earlier.
await desktopBot.typeKeys("test lowercase")

Tecla de Windows

# Presiona la tecla del logotipo de Windows y abre el menú de inicio de Windows.
bot.type_windows()

// Presiona la tecla del logotipo de Windows y abre el menú de inicio de Windows.
keyWindows();

// Presiona la tecla del logotipo de Windows y abre el menú de inicio de Windows.
await desktopBot.typeWindows()

// Presiona la tecla del logotipo de Windows y abre el menú de inicio de Windows.
await desktopBot.typeWindows()

Teclas de función

Puedes activar las teclas de función del 1 al 12 con la función key fn.

# Press key f5 to trigger the native function of this key, In this case, refreshes pages in most browsers.
bot.key_f5()

# Press key f11, triggers the native function of this key, in this case, it changes the screen to full mode.
bot.key_f11()

# For other keys, use key_fn where n is the number from 1 to 12.

// Presiona la tecla f5 para activar la función nativa de esta tecla, en este caso, actualiza las páginas en la mayoría de los navegadores.
keyF5();

// Presiona la tecla f11 para activar la función nativa de esta tecla, en este caso, cambia la pantalla al modo de pantalla completa.
keyF11();

// Para otras teclas, utiliza keyFn donde n es el número del 1 al 12.

// Press key f5 to trigger the native function of this key, In this case, refreshes pages in most browsers.
await desktopBot.keyF5()

// Press key f11, triggers the native function of this key, in this case, it changes the screen to full mode.
await desktopBot.keyF5()

// For other keys, use keyFn where n is the number from 1 to 12.

// Press key f5 to trigger the native function of this key, In this case, refreshes pages in most browsers.
await desktopBot.keyF5()

// Press key f11, triggers the native function of this key, in this case, it changes the screen to full mode.
await desktopBot.keyF5()

// For other keys, use keyFn where n is the number from 1 to 12.

Teclas direccionales

Con los métodos a continuación, podemos interactuar o presionar las teclas direccionales del teclado (arriba, abajo, izquierda y derecha).

# On the directional keyboard, press the up key.
bot.type_up()

# On the directional keyboard, press the down key.
bot.type_down()

# On the directional keyboard, press the left key, left arrow.
bot.type_left()

# On the directional keyboard, press the right key, right arrow.
bot.type_right()

// the directional keyboard, press the up key, up arrow.
keyUp();

// On the directional keyboard, press the down, down arrow.
keyDown();

// On the directional keyboard, press the Left key, Left arrow.
keyLeft();

// On the directional keyboard, press the right key, right arrow.
keyRight();

// On the directional keyboard, press the up key, up arrow.
await desktopBot.typeUp()

// On the directional keyboard, press the down key, down arrow.
await desktopBot.typeDown()

// On the directional keyboard, press the left key, left arrow.
await desktopBot.typeLeft()

// On the directional keyboard, press the right key, right arrow.
await desktopBot.typeRight()

// On the directional keyboard, press the up key, up arrow.
await desktopBot.typeUp()

// On the directional keyboard, press the down key, down arrow.
await desktopBot.typeDown()

// On the directional keyboard, press the left key, left arrow.
await desktopBot.typeLeft()

// On the directional keyboard, press the right key, right arrow.
await desktopBot.typeRight()

Page Up y Page Down

# Press page up key, making the page scroll up.
bot.page_up()

# Press page up key, making the page scroll down.
bot.page_down()

// Presiona la tecla de arriba, haciendo que la página se desplace hacia arriba.
keyUp();

// Presiona la tecla de abajo, haciendo que la página se desplace hacia abajo.
keyDown();

// Press the up key, making the page scroll up.
await desktopBot.pageUp();

// Press the down key, making the page scroll down.
await desktopBot.pageDown();

// Press the up key, making the page scroll up.
await desktopBot.pageUp();

// Press the down key, making the page scroll down.
await desktopBot.pageDown();

Atajos de teclado

El framework tiene los atajos más utilizados listos para usar.

En caso de que hayamos omitido alguno, puedes utilizar el método type keys para presionar cualquier lista de teclas y simular cualquier atajo.

Utilizando type keys para atajos

# Pressing the 'win', 'shift', 's' keys in sequence. This shortcut enables capturing the screen in Windows 11.
bot.type_keys(["win", "shift", "s"])

# Pressing the 'win', 'shift', 's' keys in sequence with an interval in which to press and release keys.
bot.type_keys_with_interval(interval=2000, keys=["win", "shift", "s"])

import java.awt.event.KeyEvent;

// Presionando las teclas 'win', 'shift', 's' en secuencia. Este atajo permite capturar la pantalla en Windows 11.
typeKeys(KeyEvent.VK_WINDOWS, KeyEvent.VK_SHIFT, KeyEvent.VK_S);

// Presionando las teclas 'win', 'shift', 's' en secuencia con un intervalo en el que presionar y soltar las teclas.
typeKeysWithInterval(KeyEvent.VK_WINDOWS, KeyEvent.VK_SHIFT, KeyEvent.VK_S);

// Pressing the 'win', 'shift', 's' keys in sequence. This shortcut enables capturing the screen in Windows 11.
await desktopBot.typeKeys(["win", "shift", "s"])

// Pressing the 'win', 'shift', 's' keys in sequence with an interval in which to press and release keys.
await desktopBot.typeKeys(["win", "shift", "s"], 2000)

// Pressing the 'win', 'shift', 's' keys in sequence. This shortcut enables capturing the screen in Windows 11.
await desktopBot.typeKeys(["win", "shift", "s"])

// Pressing the 'win', 'shift', 's' keys in sequence with an interval in which to press and release keys.
await desktopBot.typeKeys(["win", "shift", "s"], 2000)

Atajos con Alt

# Pressing Alt + Space, the keyboard shortcut.
bot.alt_space()
# Pressing Alt + e, the keyboard shortcut.
bot.alt_e()
# Pressing Alt + r, the keyboard shortcut.
bot.alt_r()
# Pressing Alt + f, the keyboard shortcut.
bot.alt_f()
# Pressing Alt + U, the keyboard shortcut.
bot.alt_u()
# Pressing Alt + f4, the keyboard shortcut.
bot.alt_f4()

// Presionando Alt + Espacio, el atajo de teclado.
altSpace();
// Presionando Alt + e, atajo de teclado.
altE();
// Presionando Alt + r, atajo de teclado.
altR();
// Presionando Alt + f, atajo de teclado.
altF();
// Presionando Alt + U, atajo de teclado.
altU();
// Presionando Alt + f4, atajo de teclado.
altF4();

// Pressing Alt + Space, the keyboard shortcut.
await desktopBot.altSpace()
// Pressing Alt + e, keyboard shortcut.
await desktopBot.altE()
// Pressing Alt + r,  keyboard shortcut.
await desktopBot.altR()
// Pressing Alt + f, keyboard shortcut.
await desktopBot.altF()
// Pressing Alt + U, keyboard shortcut.
await desktopBot.altU()
// Pressing Alt + f4, keyboard shortcut.
await desktopBot.altF4()

// Pressing Alt + Space, the keyboard shortcut.
await desktopBot.altSpace()
// Pressing Alt + e, keyboard shortcut.
await desktopBot.altE()
// Pressing Alt + r,  keyboard shortcut.
await desktopBot.altR()
// Pressing Alt + f, keyboard shortcut.
await desktopBot.altF()
// Pressing Alt + U, keyboard shortcut.
await desktopBot.altU()
// Pressing Alt + f4, keyboard shortcut.
await desktopBot.altF4()

Atajos con Shift

# Pressing Shift + tab, the keyboard shortcut.
bot.shift_tab()

// Presionando Shift + tab, el atajo de teclado.
shiftTab();

// Presionando Shift + tab, el atajo de teclado.
await dekstopBot.shiftTab()

// Presionando Shift + tab, el atajo de teclado.
await dekstopBot.shiftTab()

Atajo con Control

# Pressing 'Ctrl + c' to copy the clipboard.
bot.control_c()

# Pressing 'Ctrl + v' to paste content.
bot.control_v()

# Pressing 'Ctrl + a' to select all content.
bot.control_a()

# Pressing 'Ctrl + f' to open a search bar.
bot.control_f()

# Pressing 'Ctrl + p' to print the screen.
bot.control_p()

// Pressing 'Ctrl + c' to copy the clipboard.
controlC();

// Pressing 'Ctrl + v' to paste content.
controlV();

// Pressing 'Ctrl + a' to select all content.
controlA();

// Pressing 'Ctrl + f' to open the search bar.
controlF();

// Pressing 'Ctrl + p' to print the screen.
controlP();

// Presionando 'Ctrl + c' para copiar al portapapeles.
await desktopBot.controlC()

// Presionando 'Ctrl + v' para pegar contenido.
await desktopBot.controlV()

// Presionando 'Ctrl + a' para seleccionar todo el contenido.
await desktopBot.controlA()

// Pressing 'Ctrl + c' to copy the clipboard.
await desktopBot.controlC()

// Pressing 'Ctrl + v' to paste content.
await desktopBot.controlV()

// Pressing 'Ctrl + a' to select all content.
await desktopBot.controlA()
Otros atajos con Ctrl

Además de los métodos mostrados anteriormente, tenemos otros atajos con las teclas de control que se pueden utilizar de la misma manera:

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