CWnd::OnInitMenu

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

メニューがアクティブになる直前に、フレームワークによってこのメンバー関数が呼び出されます。

afx_msg void OnInitMenu(
   CMenu* pMenu 
);

パラメーター

pMenu
初期化するメニューを指定します。一時的なポインターでもかまいませんが、後で使用するために保存しておくことはできません。

解説

ユーザーがメニューバーの項目をクリックしたとき、またはメニューキーを押したときに OnInitMenu が呼び出されます。メニューを変更するには、メニューが表示される前にこのメンバー関数をオーバーライドしてください。

OnInitMenu は、メニューが最初にアクセスされるとき (たとえば、ユーザーがメニューバーの項目をクリックしたとき) にのみ呼び出されます。このメソッドは、メニュー項目についての情報は提供しません。マウスのボタンを押したままいくつかのメニュー項目の上を移動しても、この関数は呼び出されません。アプリケーションのクライアント領域上をクリックするなどして、ユーザーがいったんメニューから出て、その後でメニューバーの項目をクリックすると、この関数が再び呼び出されます。

注意

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