[C#] キー入力をプログラムから自動化する方法

Q: 自動化が動作しない場合の対処法は？

自動化が期待通りに動作しない場合、以下の対処法を試してみてください。 アクティブウィンドウの確認 : 自動化はアクティブなウィンドウに対してのみ動作します。 対象のウィンドウがアクティブであることを確認してください。 権限の確認 : 一部のアプリケーションでは、管理者権限が必要な場合があります。 プログラムを管理者として実行してみてください。 遅延の追加 : 自動化の実行タイミングが早すぎる場合、適切な遅延を追加してみてください。 特に、UIが完全に読み込まれるまで待つことが重要です。 エラーメッセージの確認 : プログラムがエラーを出している場合、その内容を確認し、適切な修正を行ってください。

2024-09-16

C#でキー入力をプログラムから自動化するには、主にSendKeysクラスやInputSimulatorライブラリを使用します。

SendKeysは、Windowsフォームアプリケーションで簡単にキー入力をシミュレートできますが、制約が多く、特にゲームや高精度が求められるアプリケーションには不向きです。

一方、InputSimulatorは、Windows APIを利用してより精密なキー入力のシミュレーションが可能です。

これにより、キーの押下やリリースを細かく制御でき、複雑な入力シナリオにも対応できます。

InputSimulatorを使用するには、NuGetパッケージとしてインストールし、InputSimulatorクラスを利用してキー操作を行います。

この記事でわかること

SendKeysクラスの基本的な使い方
InputSimulatorライブラリの活用法
Windows APIによる高度な自動化
自動化の具体的な応用例
自動化ツールの使用に関する注意点

目次から探す

SendKeysクラスを使ったキー入力自動化

SendKeysクラスの概要

SendKeysクラスは、C#でキー入力を自動化するための便利なクラスです。

このクラスを使用することで、特定のキーやキーの組み合わせをプログラムから送信することができます。

主にWindowsアプリケーションでの自動化やテストに利用されます。

SendKeysクラスは、System.Windows.Forms名前空間に含まれています。

SendKeysの基本的な使い方

SendKeysクラスを使用するには、まずプロジェクトにSystem.Windows.Formsを参照追加する必要があります。

以下は、SendKeysを使って Hello, World! という文字列を入力するサンプルコードです。

using System;
using System.Windows.Forms; // SendKeysクラスを使用するために必要
class Program
{
    [STAThread] // STAThread属性を指定
    static void Main()
    {
        // 1秒待機
        System.Threading.Thread.Sleep(1000); 
        
        // "Hello, World!"を入力
        SendKeys.SendWait("Hello, World!"); 
    }
}

このコードを実行すると、1秒後にアクティブなウィンドウに Hello, World! と入力されます。

Hello, World!

SendKeysの制約と注意点

SendKeysクラスを使用する際には、いくつかの制約や注意点があります。

以下に主なポイントをまとめます。

スクロールできます

制約・注意点	説明
アクティブウィンドウが必要	SendKeysはアクティブなウィンドウに対してのみ動作します。
特殊キーの扱い	特殊キー(Ctrl、Alt、Shiftなど)は特定の記号で表現する必要があります。
セキュリティ制限	一部のアプリケーションでは、SendKeysによる入力が制限されることがあります。

これらの制約を理解し、適切に使用することが重要です。

InputSimulatorライブラリの活用

InputSimulatorとは

InputSimulatorは、C#でキー入力をシミュレートするためのライブラリです。

このライブラリを使用することで、SendKeysクラスよりも柔軟で強力なキー入力の自動化が可能になります。

特に、複雑なキー操作やマウス操作を簡単に実装できる点が特徴です。

InputSimulatorは、Windows APIを利用して、より低レベルの操作を行います。

InputSimulatorのインストール方法

InputSimulatorを使用するには、NuGetパッケージマネージャーを利用してインストールします。

以下の手順でインストールできます。

Visual Studioを開く。
プロジェクトを右クリックし、「NuGetパッケージの管理」を選択。
「参照」タブで InputSimulator を検索。
InputSimulator を選択し、「インストール」をクリック。

これで、InputSimulatorライブラリがプロジェクトに追加されます。

基本的なキー入力のシミュレーション

InputSimulatorを使って、基本的なキー入力をシミュレートするサンプルコードを以下に示します。

このコードでは、 Hello, World! という文字列を入力します。

using System;
using WindowsInput; // InputSimulatorを使用するために必要
using WindowsInput.Native; // NativeInputを使用するために必要
class Program
{
    static void Main()
    {
        // InputSimulatorのインスタンスを作成
        var simulator = new InputSimulator(); 
        
        // 1秒待機
        System.Threading.Thread.Sleep(1000); 
        
        // "Hello, World!"を入力
        simulator.Keyboard.TextEntry("Hello, World!"); 
    }
}

このコードを実行すると、1秒後にアクティブなウィンドウに Hello, World! と入力されます。

Hello, World!

複雑なキー操作の実装

InputSimulatorを使用すると、複雑なキー操作も簡単に実装できます。

以下のサンプルコードでは、CtrlキーとCキーを同時に押してコピー操作を行います。

using System;
using WindowsInput; // InputSimulatorを使用するために必要
using WindowsInput.Native; // NativeInputを使用するために必要
class Program
{
    static void Main()
    {
        // InputSimulatorのインスタンスを作成
        var simulator = new InputSimulator(); 
        
        // 1秒待機
        System.Threading.Thread.Sleep(1000); 
        
        // Ctrl + Cを押す(コピー操作)
        simulator.Keyboard.ModifiedKeyStroke(
            new[] { VirtualKeyCode.CONTROL }, 
            VirtualKeyCode.VK_C
        ); 
    }
}

このコードを実行すると、1秒後にアクティブなウィンドウでコピー操作が行われます。

(コピー操作が実行される)

InputSimulatorを使用することで、より複雑な操作を簡単に実装できるため、さまざまな自動化シナリオに対応可能です。

Windows APIを利用した高度な自動化

Windows APIの概要

Windows API(Application Programming Interface)は、Windowsオペレーティングシステムとアプリケーション間のインターフェースを提供する一連の関数や手続きです。

これを利用することで、アプリケーションはハードウェアやOSの機能にアクセスし、さまざまな操作を実行できます。

特に、キーボードやマウスの操作をプログラムから制御するために、Windows APIは非常に強力なツールとなります。

キーボードイベントの送信

Windows APIを使用してキーボードイベントを送信するには、SendInput関数を利用します。

この関数は、キーボードやマウスの入力をシミュレートするための低レベルのAPIです。

SendInputを使用することで、より詳細な制御が可能になり、特定のキーの押下やリリースを正確にシミュレートできます。

SendInput関数の利用方法

以下は、SendInput関数を使用して Hello, World! という文字列を入力するサンプルコードです。

このコードでは、各キーの押下とリリースを手動で行っています。

using System;
using System.Runtime.InteropServices; // P/Invokeを使用するために必要
class Program
{
    // SendInput関数の宣言
    [DllImport("user32.dll")]
    public static extern uint SendInput(uint nInputs, INPUT[] pInputs, int cbSize);
    // INPUT構造体の定義
    [StructLayout(LayoutKind.Sequential)]
    public struct INPUT
    {
        public uint type;
        public MOUSEKEYBDHARDWARE mi;
    }
    // キーボード入力の構造体
    [StructLayout(LayoutKind.Sequential)]
    public struct MOUSEKEYBDHARDWARE
    {
        public ushort wVk; // 仮想キーコード
        public ushort wScan; // スキャンコード
        public uint dwFlags; // フラグ
        public uint time; // 時間
        public IntPtr dwExtraInfo; // 追加情報
    }
    // 定数の定義
    const uint INPUT_KEYBOARD = 1;
    const uint KEYEVENTF_KEYUP = 0x0002;
    static void Main()
    {
        // 1秒待機
        System.Threading.Thread.Sleep(1000); 
        // "H"を入力
        SendKey(0x48); // Hの仮想キーコード
        SendKey(0x45); // Eの仮想キーコード
        SendKey(0x4C); // Lの仮想キーコード
        SendKey(0x4C); // Lの仮想キーコード
        SendKey(0x4F); // Oの仮想キーコード
        SendKey(0x2C); // カンマの仮想キーコード
        SendKey(0x20); // スペースの仮想キーコード
        SendKey(0x57); // Wの仮想キーコード
        SendKey(0x4F); // Oの仮想キーコード
        SendKey(0x52); // Rの仮想キーコード
        SendKey(0x4C); // Lの仮想キーコード
        SendKey(0x44); // Dの仮想キーコード
        SendKey(0x21); // 感嘆符の仮想キーコード
    }
    static void SendKey(ushort keyCode)
    {
        INPUT[] inputs = new INPUT[1];
        inputs[0].type = INPUT_KEYBOARD;
        inputs[0].mi.wVk = keyCode;
        inputs[0].mi.dwFlags = 0; // キー押下
        // キー押下を送信
        SendInput(1, inputs, Marshal.SizeOf(typeof(INPUT)));
        // キーリリース
        inputs[0].mi.dwFlags = KEYEVENTF_KEYUP; // キーリリース
        SendInput(1, inputs, Marshal.SizeOf(typeof(INPUT)));
    }
}

このコードを実行すると、1秒後にアクティブなウィンドウに Hello, World! と入力されます。