CWnd::OnMouseActivate
更新 : 2007 年 11 月
カーソルが非アクティブなウィンドウにある間にユーザーがマウス ボタンを押すと、フレームワークからこのメンバ関数が呼び出されます。
afx_msg int OnMouseActivate(
CWnd* pDesktopWnd,
UINT nHitTest,
UINT message
);
パラメータ
pDesktopWnd
アクティブになるウィンドウのトップレベルの親ウィンドウへのポインタを指定します。このポインタは一時的である場合があるので、後で使用するために保持しておくことはできません。nHitTest
ヒット テストの領域コードを指定します。ヒット テストとは、カーソルの位置を調べるテストです。message
マウス メッセージの番号を指定します。
戻り値
CWnd をアクティブにするかどうか、およびマウス イベントを破棄するかどうかを指定します。次の値のいずれかになります。
MA_ACTIVATE CWnd オブジェクトをアクティブにします。
MA_NOACTIVATE CWnd オブジェクトをアクティブにはしません。
MA_ACTIVATEANDEAT CWnd オブジェクトをアクティブにし、マウス イベントを破棄します。
MA_NOACTIVATEANDEAT CWnd オブジェクトをアクティブにしないで、マウス イベントを破棄します。
解説
既定の実装では、処理をする前に、このメッセージを親ウィンドウに渡します。親ウィンドウが TRUE を返すと、処理は中断されます。
各ヒット テストの領域コードの説明については、OnNcHitTest メンバ関数の説明を参照してください。
.gif "メモ") メモ : |
|---|
このメンバ関数は、アプリケーションが Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。この関数に渡されるパラメータの値は、フレームワークがメッセージ受信時に受け取ったパラメータの値に基づいています。この関数の基本クラスの実装を呼び出した場合は、関数に渡したパラメータではなく、メッセージと共に渡されたパラメータ自体が使用されます。 |
使用例
// The code fragment below shows how to UI activate an ActiveX control.
// CMyAxCtrl is a COleControl-derived class.
int CMyAxCtrl::OnMouseActivate(CWnd* pDesktopWnd, UINT nHitTest, UINT message)
{
OnActivateInPlace(TRUE, NULL); // OnActivateInPlace() is an undocumented function
return COleControl::OnMouseActivate(pDesktopWnd, nHitTest, message);
}
必要条件
ヘッダー : afxwin.h
参照
参照
CWnd::OnMouseActivate