０．イメージ図

１．前提条件

Visual studio 2022 Version 17.13.6
.Net 9

なお、すべてのソースコードを公開しています。

２．なぜ IMessageFilter を選んだのか？ 🎯

Windowsアプリで「ユーザー操作の監視」を行う手段は複数ありますが、本記事では IMessageFilter を採用しました。その理由を説明します。

(1) Win32 API を使った DLL ベースのグローバルフックは危険

グローバルにマウスやキーボードの操作をフックするには、SetWindowsHookEx を使って DLL を別プロセスに挿入する方式があります。
ですが、これは以下の理由から本プロジェクトでは採用しませんでした：

管理者権限が必要な場合がある（UAC との相性が悪い）
アンチウイルスソフトに引っかかる可能性がある
アプリがクラッシュした際に OS 全体に影響するリスクがある
コードが煩雑で保守性が下がる

つまり、業務アプリのような安定性と信頼性が求められるシステムでは不適です。

(2) すべてのコントロールにイベントハンドラを設定するのは重い

当初、以下のような実装をしていました：

foreach (Control ctrl in parent.Controls)
{
    ctrl.MouseDown += OnMouseDown;
    ctrl.KeyDown += OnKeyDown;
    ...
}

しかしこの方式では以下の課題があります：

フォーム内のコントロールが多いと、イベントフック数が指数的に増える
一部の動的に追加されるコントロールが漏れる可能性がある
ループが深くなり、起動時や画面切り替え時のパフォーマンスが落ちる

これは UI が複雑になるほど問題になっていきます。

(3) IMessageFilter のメリット

代わりに採用した IMessageFilter は以下の点で優れています：

すべての WinForms メッセージを低コストで横取りできる
キーボードやマウスのクリック操作を簡単に検知できる
フォームやコントロールの構造に依存せず、一括で操作を監視できる
軽量で安定性も高く、商用利用にも安心

この方法で、「コントロール数が多いと重くなる」「マウス・キーボードの操作を正確に拾えない」といった課題をすべて解消できます。

３．実装ポイント

A) IMessageFilter の導入

public class UserActivityMessageFilter : IMessageFilter
{
    public bool PreFilterMessage(ref Message m)
    {
        switch (m.Msg)
        {
            case 0x0100: // WM_KEYDOWN
            case 0x0201: // WM_LBUTTONDOWN
                UserActivityTracker.Update();
                break;
        }
        return false;
    }
}

→ Application.AddMessageFilter(...) により一括フック。マウス移動を除外して負荷軽減。

[STAThread]
static void Main()
{
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);

    // ユーザーアクティビティを監視するフィルタを追加
    Application.AddMessageFilter(new UserActivityMessageFilter());

    var loginForm = new FormLogin();
    AppContextInstance = new MyAppContext(loginForm);
    Application.Run(AppContextInstance);
}

🔸この中の Application.AddMessageFilter(new UserActivityMessageFilter()) の行が、ユーザー操作の検知の要です。

B) アクティビティ監視の共通クラス

public static class UserActivityTracker
{
    public static DateTime LastActionTime { get; private set; } = DateTime.Now;

    public static void Update() => LastActionTime = DateTime.Now;

    public static bool IsInactive(TimeSpan timeout) =>
        DateTime.Now - LastActionTime > timeout;
}

C) 自動ログアウトの呼び出しをFormの基底クラスで共通化する

public partial class BaseForm : Form

    protected override void OnLoad(EventArgs e)
    {
        base.OnLoad(e);
        // 未操作タイマーを開始
        StartInactivityTimer();
    }

    private void StartInactivityTimer()
    {
        _inactivityTimer.Interval = CheckIntervalMilliseconds;
        _inactivityTimer.Tick += (_, _) => CheckTimeout();
        _inactivityTimer.Start();
    }

    private void CheckTimeout()
    {
        if (UserActivityTracker.IsInactive(Timeout))
        {
            _inactivityTimer.Stop();
            BeginInvoke(() =>
            {
                Program.AppContextInstance!.ShowLoginAndCloseOthers();
            });
        }
    }
}

→ 各フォームで BaseForm を継承するだけで自動ログアウト対応。

D) 自動ログアウト処理

public class MyAppContext : ApplicationContext
{
    // 新しいログインフォームを表示し、他のフォームを全て閉じる
    public void ShowLoginAndCloseOthers()
    {
        // ログインフォームは常にNEWする
        var loginForm = new FormLogin();
        loginForm.Show();

        foreach (Form f in Application.OpenForms.Cast<Form>().ToList())
        {
            // 過去のログインフォームが残っていても、NEWしたインスタンス以外は閉じる
            if (f != loginForm)
                f.Close();
        }
    }
}

４．最終構成 📦

UserActivityMessageFilter.cs（ユーザーの操作を監視するフィルタ）
UserActivityTracker.cs（ユーザー操作の間隔を取得）
BaseForm.cs（すべてのフォームが継承する監視用の継承元）
MyAppContext.cs（ログアウト処理）

５．最後に 📝

この構成は、
✅ シンプル
✅ 軽量
✅ 実務アプリでも安定
をすべて両立できることを目指しました。

現場のWinFormsアプリに自動ログアウトを追加したい場面はよくあります。
色々試した結果、IMessageFilterの採用が一番有効でした🌸