Blog

キーマクロの種。VBScriptのSendKeysでメモ帳にキー入力を送る

旧サイトの「キーマクロの種」を、Windows Script Hostで対象ウィンドウを確かめてからキー入力を送る例に書き直した。待ち時間、繰り返し、特殊キーの指定とVBScriptの提供状況を解説する。

三つのキーからメモ帳を表したウィンドウに入力が送られ、二行の文字が表示される図

同じ入力を二度、三度と繰り返す場面で、キーボード操作だけをスクリプトに移したいことがある。旧サイトの「キーマクロの種」は、起動して数秒待つ間に手で対象ウィンドウを選び、Windows Script Host(WSH)の SendKeys で入力を繰り返すテンプレートだった。ここでは、メモ帳のテスト用ファイルを開いてから、対象を前面に出せたときだけ入力する形で仕組みを確かめる。旧「キーマクロの種」の保存版

空のメモ帳に同じ一行を二回入力する

Windows 11で、WSHからVBScriptを実行できる環境を前提とする。メモ帳で空のテキストファイルを作り、例えば ixam-key-macro-example.txt という固有の名前で保存する。そのファイルを開いたメモ帳のウィンドウを一つだけ用意し、本文にカーソルを置く。

次のコードを key-macro.vbs という名前で保存する。コードはASCIIの範囲で書いてあるので、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

コマンドプロンプトでスクリプトを保存したフォルダーに移動し、次のように実行する。引数はメモ帳のウィンドウに表示された実際のタイトルに合わせる。例えばタイトルが「ixam-key-macro-example.txt - メモ帳」なら、その文字列全体を引用符で囲む。Microsoftのcscriptコマンドの仕様

cscript //nologo key-macro.vbs "ixam-key-macro-example.txt - メモ帳"

メモ帳の編集中の本文に macro sample が二行入る。入力回数は repeatCount で指定する。対象を前面にできない場合は、その回の入力を送る前に終了する。

待ち時間と特殊キーを指定する

WScript.Sleep 250 の単位はミリ秒で、この例では次の一行を送る前に0.25秒待つ。時間を空けても、入力欄やダイアログの準備が完了したことまでは分からない。別のアプリに切り替えると入力先も変わり得るため、手で操作せず、保存や送信などを伴う手順に広げる前に、テスト用のデータで確認する。

入力 SendKeysに渡す文字列
Enter、Tab、Esc {ENTER}、{TAB}、{ESC}
右矢印、F2 {RIGHT}、{F2}
Shift+A、Ctrl+A +a、^a
Altと別のキー % の後ろに対象キーを書く
aを5回 {a 5}
文字としてのプラス {+}

VBScriptはMicrosoftが非推奨としており、将来のWindowsでの廃止が予定されている。既存の .vbs を読み解くときは、このように入力先・待ち時間・キー列を分けると挙動を追いやすい。新しく処理を作る場合、ファイルの読み書きで済む作業はPowerShellなどで直接行えば、画面のフォーカスや待ち時間への依存を減らせる。MicrosoftのVBScript非推奨化の案内