はじめに

現在、Friendlyと呼ばれるGUIのテスト自動化をするためのコンポーネントが存在します。
一体どうすれば他アプリケーションをどうやったら操作できるのか疑問に思い、学習しましたので記事として残します。

今回の記事で試したこと

以下の記事を参考にすると、外部アプリケーションを操作できます。
今回はこのサンプルを少し変更して、C#でメモ帳に文字列を入力します。
https://tech.sanwasystem.com/entry/2015/11/25/171004

メモ帳を操作するための事前準備

アプリケーション名を調べます。メモ帳のアプリケーション名は「notepad」です。
対象のアプリのウインドウ構造を調べます。実際に上記のURLのプログラムを動かして調べたところ、編集領域のクラス名は「Edit」コントロールのようでした。
どんなメッセージ、パラメータを送信すればテキスト入力できるかを調査します。参考URLを読み、以下のことが分かりました。
- 「WM_CHAR（0x0102）」というメッセージを送るとテキスト入力できる。
- wParamはキーの文字コード（UTF-16）を表す
- lParamは以下を表す
  - 0-15 bit:メッセージの繰り返し回数
  - 16-23 bit:スキャンコード、OEM依存
  - 24 bit:拡張キー
  - 25-28 bit:予約済み
  - 29 bit:Altキーが押されていると1, それ以外の場合0
  - 30 bit:以前のキーの状態、キーが押されていれば1、上げられていれば0
  - 31 bit:遷移状態、キーが離されていれば1、押されていれば0

実際のプログラム

以下に参考にした記事のプログラムとの差分を示します。以下の差分を取り込んでいただくと、メモ帳に"A"が7回入力できるプログラムが作成できます。

	class Program
	{
		public const int WM_CHAR = 0x0102;

		...

		static void Main(string[] args)
		{
			// メモ帳のトップウィンドウのウィンドウハンドル（※見つかることを前提としている）
			var mainWindowHandle = Process.GetProcessesByName("notepad")[0].MainWindowHandle;

			// 対象の編集領域を探す
			var hWnd = FindTargetEdit(GetWindow(mainWindowHandle));

			// キーボードにメッセージを送る
			// 0x00000041 : "A"の文字コード
			// 0x40000007 : キーが離された状態から押された状態へ遷移、7回キー入力を繰り返すことを表すパラメータ
			//              （どんな値を埋めれば良いか分からない箇所は0埋めとしました）
			SendMessage(hWnd, WM_CHAR, 0x00000041, 0x40000007);
		}

		// 全てのEditコントロールを列挙し、最初に見つけたEditコントロールのウィンドウハンドルを返す
		public static IntPtr FindTargetEdit(Window top)
		{
			var all = GetAllChildWindows(top, new List<Window>());
			
			// クラス名からコントロールを取得する。メモ帳の場合はEditコントロールが編集領域。
			return all.Where(x => x.ClassName == "Edit").First().hWnd;
		}

実際にやってみて

全く知らない状態からに他アプリケーション（今回の場合はメモ帳）を操作しようと思うと、色々なことを知らなければならないことが分かりました。おそらく、Friendlyはこのような処理をきれいに隠蔽することでGUIの操作を簡潔にできるようにしているのだと思います。
また、改めてFriendlyのソースコードを読んで肝となる部分の理解を深めたいと思います。

はじめに

今回の記事で試したこと

メモ帳を操作するための事前準備

実際のプログラム

実際にやってみて

参考URL