IContextMenu3::HandleMenuMsg2-Methode (shobjidl_core.h)

Ermöglicht Clientobjekten der IContextMenu3-Schnittstelle die Verarbeitung von Nachrichten, die mit vom Besitzer gezeichneten Menüelementen verknüpft sind.

Syntax

HRESULT HandleMenuMsg2(
  UINT    uMsg,
  WPARAM  wParam,
  LPARAM  lParam,
  LRESULT *plResult
);

Parameter

uMsg

Typ: UINT

Die zu verarbeitende Meldung. Bei einigen Nachrichten, z. B. WM_INITMENUPOPUP, WM_DRAWITEM, WM_MENUCHAR oder WM_MEASUREITEM, kann das aufgerufene Clientobjekt vom Besitzer gezeichnete Menüelemente bereitstellen.

wParam

Typ: WPARAM

Zusätzliche Nachrichteninformationen. Der Wert dieses Parameters hängt vom Wert des uMsg-Parameters ab.

lParam

Typ: LPARAM

Zusätzliche Nachrichteninformationen. Der Wert dieses Parameters hängt vom Wert des uMsg-Parameters ab.

plResult

Typ: LRESULT*

Die Adresse eines LRESULT-Werts , den der Besitzer des Menüs aus der Nachricht zurückgibt. Dieser Parameter kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

IContextMenu3::HandleMenuMsg2 ersetzt IContextMenu2::HandleMenuMsg im Allgemeinen und wird aufgerufen, wenn IContextMenu3 bestimmt, dass IContextMenu3 unterstützt wird und eine der unterstützten Nachrichten (siehe uMsg) empfangen wurde. In einigen Fällen wird IContextMenu2::HandleMenuMsg jedoch weiterhin aufgerufen. Kontextmenühosts können Menümeldungen über eine oder beide Methoden senden. Wenn eine Shell-Erweiterung daher sowohl IContextMenu2::HandleMenuMsg als auch IContextMenu3::HandleMenuMsg2 implementiert, muss sie vorbereitet sein, damit Menünachrichten über beide Methoden eingehen.

Anforderungen