こんにちは！Windows Formsを使った業務システムの自動化やUIテストで、日々格闘していませんか？
「ボタン一つで一連の入力を自動化したい！」と思って真っ先に思い浮かぶのが `SendKeys.Send` メソッドですよね。でも、実際に使ってみると……
- 「タイミングがシビアすぎて、たまに取りこぼす」
- 「途中でユーザーがマウスを触ったり別のウィンドウを開いたりすると、変な場所に文字が打ち込まれて大惨事になる」
- 「日本語（IME）の切り替えが絡むと、もう完全に制御不能……」
そんな悩みを抱えて、夜も眠れなくなっているあなたへ。今回は、その `SendKeys` のもどかしい限界を鮮やかに突破し、OSの心臓部へ直接指令を叩き込む P/Invoke（Platform Invoke）による `SendInput` 活用術 を伝授します。
ここをクリアすれば、あなたのWindows Forms開発スキルは間違いなくプロの領域に到達しますよ。さあ、一緒に扉を開きましょう！
—
なぜ `SendKeys` は実務で通用しないのか？
まずは敵を知ることから始めましょう。`SendKeys` は、 .NET Frameworkが提供する非常に手軽なキーボードシミュレーション手段です。しかし、その内部動作は「Windowsメッセージキューに対して、キーが押されたというメッセージをポイッと放り投げているだけ」に過ぎません。
そのため、以下の致命的な弱点を抱えています。
1. フォーカスの脆弱性: メッセージが処理される瞬間にターゲットがアクティブでなければ、入力が闇に消えます。
2. 実行速度のギャップ: アプリケーションの描画や処理速度が追いつかないうちに次のキー入力が飛ぶため、高速処理に耐えられません。
3. 修飾キー（ShiftやCtrl）の解放漏れ: 処理の途中で例外が発生すると、キーが押されっぱなしの状態になり、PC全体がおかしくなることがあります。
これに対し、今回紹介する `SendInput` API は、Windowsの入力サブシステム（Win32 API）の最下層に直接キーボードイベントを注入します。OSレベルで確実に入力をエミュレートするため、圧倒的な安定性と速度を誇ります。
—
秘伝のレシピ：VB.NETで `SendInput` を操る
百聞は一見に如かず。さっそく、VB.NETからWindows APIを呼び出すための実装コードを見てみましょう。
今回は、テキストボックスへの高速・確実な文字列入力と、特殊キー（Enterキーなど）の送信を例にします。このままプロジェクトにコピペして使える完全なコードです。
Imports System.Runtime.InteropServices
Imports System.Text
Public Class Form1
‘ ==========================================
‘ Win32 API の定義 (P/Invoke)
‘ ==========================================
Private Shared Function SendInput(
ByVal nInputs As UInt32,
ByRef pInputs As INPUT,
ByVal cbSize As Integer
) As UInt32
End Function
‘ 入力構造体の定義 (キーボード用)
Private Structure INPUT
Public type As UInt32
Public u As InputUnion
End Structure
Private Structure InputUnion
‘ ※マウスやハードウェア入力を使う場合もここに拡張できますが割愛します
End Structure
Private Structure KEYBDINPUT
Public wVk As UShort ‘ 仮想キーコード
Public wScan As UShort ‘ スキャンコード
Public dwFlags As UInteger ‘ 動作フラグ（押す、離す等）
Public time As UInteger ‘ タイムスタンプ
Public dwExtraInfo As IntPtr ‘ 追加情報
End Structure
‘ 定数定義
Private Const INPUT_KEYBOARD As UInt32 = 1
Private Const KEYEVENTF_KEYDOWN As UInteger = &H0
Private Const KEYEVENTF_KEYUP As UInteger = &H2
‘ ==========================================
‘ 実用メソッド：文字列を確実に送信する
‘ ==========================================
Private Sub SendString(ByVal textToSend As String)
For Each c As Char In textToSend
‘ 1文字ずつ仮想キーコードに変換して送信
Dim vk As UShort = CUShort(Asc(c))
‘ 1. キーを押す
PressKey(vk)
‘ 2. キーを離す
ReleaseKey(vk)
Next
End Sub
Private Sub PressKey(ByVal vk As UShort)
Dim inp As New INPUT()
inp.type = INPUT_KEYBOARD
inp.u.ki.wVk = vk
inp.u.ki.dwFlags = KEYEVENTF_KEYDOWN
SendInput(1, inp, Marshal.SizeOf(GetType(INPUT)))
End Sub
Private Sub ReleaseKey(ByVal vk As UShort)
Dim inp As New INPUT()
inp.type = INPUT_KEYBOARD
inp.u.ki.wVk = vk
inp.u.ki.dwFlags = KEYEVENTF_KEYUP
SendInput(1, inp, Marshal.SizeOf(GetType(INPUT)))
End Sub
‘ ==========================================
‘ ボタンクリック時の処理
‘ ==========================================
Private Sub btnAutomate_Click(sender As Object, e As EventArgs) Handles btnAutomate.Click
‘ フォーカスを対象のコントロールに強制的にあてます
TextBox1.Focus()
‘ 少しウェイトを入れてUIの安定を図る (実務では必須の知見)
System.Threading.Thread.Sleep(100)
‘ 文字列を流し込む！
SendString(“Hello Windows Forms!”)
‘ 必要であればEnterキーも送信可能
‘ PressKey(CUShort(Keys.Enter))
‘ ReleaseKey(CUShort(Keys.Enter))
End Sub
End Class
—
コードの核心：ここがプロの技術
上記のコードで、初心者の方が「おっ」と思うポイントや、現場で生きる重要なテクニックを解説します。
1. `DllImport` と構造体のマッピング
VB.NETからC言語系のWindows APIを叩く際、最も重要なのはメモリレイアウトの完全な一致です。
`StructLayout(LayoutKind.Sequential)` や `Explicit` を用いることで、.NETのマネージドメモリと、OS（ネイティブ）が要求するアンマネージドメモリの構造を完璧に一致させています。この基礎を抑えているだけで、API連携でバグを踏む確率が激減します。
2. 「押す（KEYDOWN）」と「離す（KEYUP）」の分離
`SendKeys` は「文字を打つ」という高次な抽象化を行っていますが、`SendInput` は物理的なハードウェアの動きを再現します。つまり、「キーを押す（`KEYEVENTF_KEYDOWN`）」と「キーを離す（`KEYEVENTF_KEYUP`）」のセットを必ずペアで行う必要があります。これを怠ると、PCが「キーが押しっぱなしの状態」と誤認してしまいます。
3. 実務における「お作法」（ウェイトの重要性）
コード内の `TextBox1.Focus()` の後に `System.Threading.Thread.Sleep(100)` を入れている点に注目してください。
いくらAPIが高速であっても、Windows Formsがそのフォーカスを受け取り、メッセージループを回すまでに「数ミリ秒のタイムラグ」が存在します。ここを無視して超高速で入力を流し込むと、最初の1〜2文字が抜け落ちるという悲劇が起きます。「フォーカス取得 ＝ 即入力開始」は禁忌であり、わずかなウェイトを入れることが、現場で生き抜くエンジニアの知恵です。
—
陥りやすいエラーと注意点
最後に、現場でこの手法を使う際によくある落とし穴をシェアしておきます。
- 日本語（IME）が有効になっている場合
上記のサンプルはASCII文字（半角英数）を前提としています。日本語入力（漢字やひらがな）を `SendInput` で完全に制御しようとすると、IMEの変換ウィンドウやロケールの制御が絡むため、クリップボード経由（テキストボックスの `Text` プロパティに直接代入するか、クリップボードにコピーして `Ctrl + V` を送信する手法）を併用するのが実務上の定石です。純粋なキーシミュレーションは「英数字と制御キー（Enter, Tabなど）」の自動化に特化させましょう。
- 権限（UAC）の壁
自動化対象のアプリケーションが管理者権限で動いていて、あなたの開発しているツールが一般権限である場合、Windowsのセキュリティ機構（UIPI）によって入力がブロックされます。テストツールや自動化ツールを作る際は、自身のアプリも同等以上の権限で実行させる必要があります。
—
まとめ
今回は、`SendKeys` の限界を打ち破る P/Invoke と `SendInput` を使った確実なキー入力自動化の極意をお伝えしました。
- `SendKeys` は手軽だが、イベントキュー任せのため不安定。
- `SendInput` はOSの最下層から直接入力イベントを注入するため、圧倒的に確実で高速。
- 実装の際は、「押す・離す」のペアを意識し、フォーカス後のわずかなウェイト（Sleep）を忘れないこと。
このテクニックをマスターすれば、Windows FormsアプリケーションのUIテストや、日々の面倒なデータ入力作業の自動化において、もう怖いものはありません。
ぜひあなたのプロジェクトに組み込んで、その圧倒的な安定性を体感してください。それでは、次回の開発もお楽しみに！
