CWnd::OnSetCursor

マウス入力がキャプチャされていない場合に、CWnd オブジェクト内でカーソルを移動させると、フレームワークからこのメンバー関数が呼び出されます。

afx_msg BOOL OnSetCursor(
   CWnd* pWnd,
   UINT nHitTest,
   UINT message 
);

パラメーター

  • pWnd
    カーソルを持つウィンドウへのポインターを指定します。このポインターは一時的である場合があるので、後で使用するために保持しておくことはできません。

  • nHitTest
    ヒット テストの領域コードを指定します。ヒット テストとは、カーソルの位置を調べるテストのことです。

  • message
    マウス メッセージの番号を指定します。

戻り値

以降の処理を中断するときは 0 以外を返します。それ以外の場合は 0 を返します。

解説

既定の実装では、OnSetCursor 関数の処理の前に親ウィンドウの OnSetCursor 関数を呼び出します。親ウィンドウから TRUE が返されると、それ以降の処理を中断します。呼び出された親ウィンドウでは、子ウィンドウ内のカーソルの設定を制御できるようになります。

既定の実装では、カーソルは、クライアント領域にないときは矢印に設定され、クライアント領域にあるときは登録クラス カーソルに設定されます。

nHitTest が HTERROR であり、message がマウスのボタン ダウン メッセージの場合は、MessageBeep メンバー関数が呼び出されます。

CWnd がメニュー モードになっているときは、パラメーター message は 0 になります。

[!メモ]

このメンバー関数は、アプリケーションが Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。この関数に渡されるパラメーターの値は、フレームワークがメッセージ受信時に受け取ったパラメーターの値に基づいています。この関数の基本クラスの実装を呼び出した場合は、関数に渡したパラメーターではなく、メッセージと共に渡されたパラメーター自体が使用されます。

必要条件

ヘッダー: afxwin.h

参照

関連項目

CWnd クラス

階層図

CWnd::OnNcHitTest

WM_SETCURSOR

その他の技術情報

操作方法: Microsoft Foundation Class アプリケーションのマウス カーソルを変更します。