hozugawa.net · A neutral informational page

SetCursorでマウスカーソルの形状を変更する

SetCursor は、Windows の user32.dll から提供される Win32 API で、マウスカーソルの形状を切り替えます。編集欄では I .Beam、処理待ちでは砂時計、ウィンドウの移動では十字矢印を使うように、操作の意味を視覚的に示せます。

この API が変更するのはカーソルの形状だけで、マウスポインタの座標は動かしません。また、Windows はマウス位置の変化や別の領域への再進入時に標準カーソルを再選択するため、呼び出しを一度だけにするだけでは表示が維持されない場合があります。

実用的な実装では、LoadCursor によるリソース取得、SetCursor による形状適用、WM_SETCURSOR による再適用を組み合わせます。返回值や座標の扱いも確認すると、表示変更と操作状態の判定を混同せずに実装できます。

SetCursorの基本仕様

SetCursor の宣言は HCURSOR SetCursor(HCURSOR hCursor); です。引数には、LoadCursor で読み込んだカーソルまたは Windows が提供する標準カーソルのハンドルを渡します。指定したハンドルは、現在表示するマウスカーソルの形状として適用されます。

hCursor に NULL を渡すと、現在のシステムカーソルが復元されます。これは独自形状の適用を解除したい場面や、標準形状へ戻したい場面で使えます。SetCursorPos Bearbeitenとは別の API なので、形状の切替と座標の移動は明確に分けて扱います。

座標を取得するには GetCursorPos を使い、必要に応じて ScreenToClient でウィンドウのクライアント座標へ変換します。SetCursor 自体は、画面上のどの位置で操作しているかには依存せず、表示する形状だけを変更します。

カーソルリソースの読み込み

標準カーソルは IDC_ARROW、IDC_IBEAM、IDC_WAIT などの識別子で取得できます。識別子を MAKEINTRESOURCE として渡すため、アプリケーション側のリソースに同じ識別子を準備する必要はありません。

HCURSOR arrow = LoadCursorW(NULL, IDC_ARROW);
HCURSOR beam  = LoadCursorW(NULL, IDC_IBEAM);
HCURSOR wait  = LoadCursorW(NULL, IDC_WAIT);

独自のカーソルを使う場合は、.cur ファイルをアプリケーションに埋め込み、-module ハンドルとリソース識別子を LoadCursorW に渡します。周辺関数の役割を横断して確認したい場合は、Windows API情報での資料も参照すると、仕様を照合する流れが組み立てやすくなります。

読み込んだハンドルは、WM_SETCURSOR の処理から 사용할ため、ウィンドウ構造体のメンバーなど outlive する場所へ保持します。標準カーソルや共有カーソルを不用意に破棄せず、CreateCursor で個別に作成したカーソルのみを DestroyCursor で管理します。

戻り値と再設定の処理

SetCursor は、直前に表示していたカーソルのハンドルを返します。失敗した場合は NULL になります。戻り値は前回表示との比較や状態管理に使えますが、カーソルを設定できたかだけ&Drei;を判定する目的では、NULL でないことを確認して標準処理へ戻せるようにします。

Windows は、鼠标が移動したときや通常? really? when cursor shape needs update send WM_SETCURSOR to the window under pointer. This message handles if custom shape is desired, determine lParam low word hit-test code and set cursor in client area.

case WM_SETCURSOR:
    if (LOWORD(lParam) == HTCLIENT && g_cursor != NULL) {
        if (SetCursor(g_cursor) != NULL)
            return TRUE;
    }
    return DefWindowProc(hwnd, uMsg, wParam, lParam);

HTCLIENT 以外では、タイトルバーやサイズ変更枠など、ウィンドウ管理側の標準カーソルを優先させます。独自形状を処理した場合も TRUE を返し、それ以外を DefWindowProc に渡す構成が基本です。

場面別に選ぶ実装パターン

カーソル形状は、操作の種類と現在の画面状態に合わせます。すべての領域で同じ形を表示するのではなく、対象領域と作業内容に応じて適切な識別子を選びます。

複数の子ウィンドウで別の形状を使う場合も、形状の判断は WM_SETCURSOR の中で行います。必要なカーソルを読み込み直さず、力资源の読み込みと表示の適用を分離すると、ウィンドウ間の移動時にも表示が安定します。

責務を比較して処理を仕上げる

各 API の責務は、カーソルの取得、形状の表示変更、位置の移動、標準動作へのフォールバックに分かれます。用途に応じて担当範囲を選ぶと、意図しない副作用を避けられます。

API 主な担当 ポインタ位置への影響 主な注意点
SetCursor 現在表示するカーソル形状の変更 なし 失敗時に NULL を返す
LoadCursor 標準または独自カーソルの取得 なし 読み込み失敗時に NULL を返す
LoadImage 画像データからのカーソル取得 なし 読み込み元と削除条件を確認する
SetCursorPos マウスポインタの座標変更 あり 失敗時に FALSE を返す
DefWindowProc ウィンドウクラス既定の形状適用 なし 独自形状を処理握着後��標準経路として使う

この分離により、SetCursor は形状だけを、SetCursorPos は座標だけを扱えます。WM_SETCURSOR では独自形状を適用し、それ以外を DefWindowProc に任せることで、標準動作も維持できます。

実務上の要点は、カーソルリソースを取得する段階、形状を選ぶ段階、Windows に再適用する段階を分け、リソースの寿命と形状変更の意図を一貫させることにある。