ClipCursorでマウス移動範囲を制限する方法

Windowsアプリケーションでマウスポインターを特定の矩形内にとどめたい場合は、Win32 APIのClipCursorを使用します。ゲーム画面、画像編集領域、キオスク端末、ドラッグ操作などで、カーソルが対象ウィンドウの外へ移動するのを防ぐ処理に利用できます。

このAPIは単にマウス座標を監視して戻す方法とは異なり、OS側でカーソルの移動可能範囲を制限します。使い終わったら必ず制限を解除し、ウィンドウの最小化やフォーカス喪失にも対応することが重要です。

ClipCursorの基本的な役割

ClipCursorの宣言は次のようになっています。

BOOL ClipCursor(
    const RECT *lpRect
);

引数に画面座標で表したRECT構造体のアドレスを渡すと、その矩形領域の内部にマウスポインターを制限します。成功するとTRUE、失敗するとFALSEが返ります。制限を解除する場合はNULLを渡します。

RECT area = { 100, 100, 800, 600 };

if (!ClipCursor(&area)) {
    // エラー処理
}

// 解除
ClipCursor(NULL);

RECTの左上はleftとtop、右下はrightとbottomで指定します。座標の基準はデスクトップ全体の画面座標であり、対象ウィンドウのクライアント座標をそのまま渡してはいけません。

ネットワーク通信と同時に入力処理を行うアプリケーションでは、メッセージループや別スレッドとの関係も確認が必要です。Windowsプログラムでの通信処理を整理する際は、ソケット作成の解説も関連する基礎資料になります。

RECTを画面座標へ変換する

ウィンドウ全体ではなく、クライアント領域へカーソルを閉じ込めるには、まずGetClientRectでクライアント座標を取得します。この関数が返す座標は通常、ウィンドウ左上を原点とした相対座標です。

その後、ClientToScreenを使って左上と右下を画面座標へ変換します。タイトルバーや境界線の幅を自分で計算する必要がないため、ウィンドウスタイルが変わっても扱いやすい方法です。

RECT clipRect;
GetClientRect(hwnd, &clipRect);

POINT topLeft = { clipRect.left, clipRect.top };
POINT bottomRight = { clipRect.right, clipRect.bottom };

ClientToScreen(hwnd, &topLeft);
ClientToScreen(hwnd, &bottomRight);

clipRect.left = topLeft.x;
clipRect.top = topLeft.y;
clipRect.right = bottomRight.x;
clipRect.bottom = bottomRight.y;

ClipCursor(&clipRect);

複数モニター環境では、画面座標が負の値になることがあります。左側に配置されたディスプレイを考慮し、固定値で座標を補正せず、Windows APIから得た値をそのまま利用する設計が安全です。

制限の保存と解除

すでに別の処理がカーソル範囲を制限している可能性がある場合は、変更前の範囲をGetClipCursorで保存できます。自分の処理が終了した時点で、保存した矩形へ戻す設計にすると、他の機能への影響を抑えられます。

RECT oldClip;
bool hasOldClip = GetClipCursor(&oldClip) != FALSE;

if (ClipCursor(&clipRect)) {
    // 制限中の処理
}

if (hasOldClip) {
    ClipCursor(&oldClip);
} else {
    ClipCursor(NULL);
}

ただし、アプリケーションが通常のデスクトップ状態で取得した範囲を保存した場合でも、終了時にはClipCursor(NULL)で解除する処理を用意しておくと明確です。解除漏れがあると、ユーザーが別のウィンドウへマウスを移動できなくなります。

ClipCursorはマウス入力のキャプチャそのものではありません。ウィンドウへメッセージを送り続ける仕組みではないため、必要に応じてSetCapture、ReleaseCapture、アクティブ状態の確認も組み合わせます。

目的	主に使うAPI	座標や動作の特徴
カーソルの移動範囲を制限	`ClipCursor`	画面座標の矩形内に制限
現在の制限範囲を取得	`GetClipCursor`	既存の矩形を保存できる
クライアント領域を取得	`GetClientRect`	ウィンドウ内の相対座標
クライアント座標を変換	`ClientToScreen`	画面座標へ変換
マウスメッセージを捕捉	`SetCapture`	カーソル範囲の制限とは別の機能
制限を解除	`ClipCursor(NULL)`	システムのカーソル制限を解除

C++での実装例

実際のアプリケーションでは、範囲制限と解除を専用関数に分けると、例外処理や終了処理へ組み込みやすくなります。

bool LimitCursorToClient(HWND hwnd)
{
    RECT rect;
    if (!GetClientRect(hwnd, &rect)) {
        return false;
    }

    POINT p1 = { rect.left, rect.top };
    POINT p2 = { rect.right, rect.bottom };

    if (!ClientToScreen(hwnd, &p1) ||
        !ClientToScreen(hwnd, &p2)) {
        return false;
    }

    RECT screenRect = {
        p1.x, p1.y, p2.x, p2.y
    };

    return ClipCursor(&screenRect) != FALSE;
}

void ReleaseCursorLimit()
{
    ClipCursor(NULL);
}

ゲームのプレイ開始時やモーダル操作の開始時にLimitCursorToClientを呼び、終了時、ウィンドウの非アクティブ化時、アプリケーション終了時にReleaseCursorLimitを呼びます。処理の途中で失敗しても解除関数を通せるよう、状態フラグやRAIIクラスで管理する方法も有効です。

ウィンドウサイズが変更された場合は、古い矩形が残らないように制限範囲を再計算します。WM_SIZEを受け取ったとき、または次の入力処理の開始時にクライアント領域を取得し直すと、リサイズ後のずれを防止できます。

実装前に確認したい事項

ClipCursorを組み込む前に、対象ウィンドウのライフサイクルと異常終了時の動作を決めておくことが大切です。特に、Alt+Tab、最小化、モーダルダイアログの表示、リモートデスクトップ接続では、通常の操作経路とは異なる状態遷移が発生します。

次の項目を実装時の確認基準にすると、カーソル制限による操作不能を防ぎやすくなります。

範囲を画面座標で計算し、複数モニターの負座標にも対応する
制限開始前の状態を必要に応じてGetClipCursorで保存する
WM_KILLFOCUSや最小化時にClipCursor(NULL)を呼び出す
アプリケーション終了時に必ず制限を解除する
リサイズ後にクライアント領域から矩形を再計算する
キーボード操作など、マウスを使わない解除手段を用意する