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