IContextMenu2::HandleMenuMsg メソッド (shobjidl_core.h)

IContextMenu インターフェイスのクライアント オブジェクトが、所有者が描画したメニュー項目に関連付けられているメッセージを処理できるようにします。

構文

HRESULT HandleMenuMsg(
  UINT   uMsg,
  WPARAM wParam,
  LPARAM lParam
);

パラメーター

uMsg

型: UINT

処理されるメッセージ。 WM_INITMENUPOPUP、WM_DRAWITEM、WM_MENUCHAR、WM_MEASUREITEMなどの一部のメッセージの場合、呼び出されるクライアント オブジェクトは、所有者が描画したメニュー項目を提供する場合があります。

wParam

型: WPARAM

追加のメッセージ情報。 このパラメーターの値は、 uMsg パラメーターの値によって異なります。

lParam

型: LPARAM

追加のメッセージ情報。 このパラメーターの値は、 uMsg パラメーターの値によって異なります。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

IContextMenu2::HandleMenuMsg は通常 、HandleMenuMsg2 に置き換えられます。 HandleMenuMsg2 は、 IContextMenu3 がサポートされていると IContextMenu3 が判断し、 uMsg パラメーターの説明で指定されたメッセージのいずれかを受信すると呼び出されます。 ただし、場合によっては、 IContextMenu2::HandleMenuMsg が引き続き呼び出されます。

IContextMenu2 または IContextMenu3 が必要な場合、新しいコンテキスト メニューの最適な実装は、HandleMenuMsg2 にすべてのロジックを実装し、IContextMenu2::HandleMenuMsg 実装で HandleMenuMsg2 への呼び出しを委任し、null をplResult パラメーターとして渡すことです。

要件

関連項目

HandleMenuMsg2

IContextMenu2