CWnd::OnMouseActivate

[アーティクル]
08/09/2011

カーソルが非アクティブなウィンドウにある間にユーザーがマウスボタンを押すと、フレームワークからこのメンバー関数が呼び出されます。

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 メンバー関数の説明を参照してください。

注意

このメンバー関数は、アプリケーションが 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);
}