CWnd::OnPowerBroadcast

2011-08-09

電源管理イベントが発生すると、フレームワークからこのメンバー関数が呼び出されます。

afx_msg UINT OnPowerBroadcast(
    UINT nPowerEvent, 
    UINT nEventData
);

パラメーター

パラメーター	説明
[入力] nPowerEvent	電源管理イベント。
[入力] nEventData	イベント固有のデータ。

戻り値

そのイベントが要求の場合、その要求を受け入れるには true を返し、その要求を拒否するには BROADCAST_QUERY_DENY を返します。

解説

このメソッドは、WM_POWERBROADCAST メッセージを受け取ります。このメッセージについては、Windows SDK を参照してください。

nPowerEvent パラメーターでは、バッテリの電力が低下している、電源のステータスが変わった、操作を中断するためのアクセス許可が要求 (または拒否) された、イベント発生後に自動的に操作が再開している、システムが操作を中断している、中断後に操作が再開している、などのイベントを指定します。 nEventData パラメーターは、通常は使用しません。詳細については、WM_POWERBROADCAST メッセージの wParam パラメーターと lParam パラメーターを参照してください。

注意

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