Blog

Macro simples de teclado: enviar teclas ao Bloco de Notas com VBScript SendKeys

Traga a janela ao primeiro plano e digite texto de exemplo no Bloco de Notas com SendKeys. Configure a espera, as repetições, os modificadores e as teclas especiais.

Três teclas enviam a entrada para uma janela do Bloco de Notas, onde aparecem duas linhas de texto.

Para repetir um texto ou atalho, envie as teclas usando SendKeys do Windows Script Host (WSH). A janela que está em primeiro plano recebe a entrada. Use AppActivate para ativar a janela desejada antes de enviar as teclas.

Digitar a mesma linha duas vezes em um documento vazio

O exemplo requer Windows 11 com suporte à execução de VBScript no WSH. Crie um arquivo de texto vazio no Bloco de Notas e salve-o com um nome único, como ixam-key-macro-example.txt. Abra o arquivo em uma única janela e coloque o cursor na área de edição.

Salve o código abaixo como key-macro.vbs. Ele contém apenas caracteres ASCII, então pode ser salvo como texto sem BOM.

Option Explicit

Const repeatCount = 2
Dim shell, targetTitle, i

If WScript.Arguments.Count <> 1 Then
    WScript.Echo "Usage: cscript //nologo key-macro.vbs ""window title"""
    WScript.Quit 2
End If

targetTitle = Trim(WScript.Arguments(0))
If Len(targetTitle) = 0 Then WScript.Quit 2

Set shell = CreateObject("WScript.Shell")

For i = 1 To repeatCount
    If Not shell.AppActivate(targetTitle) Then
        WScript.Echo "Target window could not be activated."
        WScript.Quit 1
    End If

    shell.SendKeys "macro sample{ENTER}"
    If i < repeatCount Then WScript.Sleep 250
Next

No Prompt de Comando, acesse a pasta em que salvou o script e execute-o como a seguir. O argumento deve coincidir com o título exibido na janela do Bloco de Notas. Se o título em inglês for “ixam-key-macro-example.txt - Notepad”, coloque o texto inteiro entre aspas duplas. Referência da Microsoft para cscript

cscript //nologo key-macro.vbs "ixam-key-macro-example.txt - Notepad"

A área de edição mostra duas linhas com macro sample. Defina o número de repetições em repeatCount. Se o script não conseguir ativar a janela, ele para antes de enviar as teclas daquela vez.

Definir a espera e as teclas especiais

WScript.Sleep 250 aguarda 250 milissegundos, ou 0,25 segundo, antes de enviar a linha seguinte. Uma espera fixa não confirma se o campo ou a caixa de diálogo está pronto. Trocar de aplicativo pode redirecionar a entrada, então evite interagir manualmente durante o teste. Use dados de teste antes de incluir ações como salvar ou enviar.

Entrada Texto passado a SendKeys
Enter, Tab, Esc {ENTER}, {TAB}, {ESC}
Backspace, Delete {BS}, {DELETE}
Setas para cima, baixo, esquerda e direita {UP}, {DOWN}, {LEFT}, {RIGHT}
Home, End, Page Up, Page Down {HOME}, {END}, {PGUP}, {PGDN}
F2 {F2}
Shift+A, Ctrl+A +a, ^a
Alt e outra tecla Coloque % antes da tecla
a cinco vezes {a 5}
Sinal de mais literal {+}

Para aplicar o mesmo modificador a várias teclas, agrupe-as entre parênteses. %(fs) envia f e depois s, mantendo Alt pressionada. A ação depende dos atalhos do aplicativo.

A Microsoft declarou o VBScript obsoleto e pretende removê-lo de uma versão futura do Windows. Para entender um .vbs existente, analise separadamente o destino da entrada, a espera e a sequência de teclas. Em novas tarefas de leitura e gravação de arquivos, usar PowerShell ou outra ferramenta direta diminui a dependência do foco da janela e dos tempos de espera. Aviso da Microsoft sobre a descontinuação do VBScript