IContextMenu3::HandleMenuMsg2-Methode (shobjidl_core.h)

Artikel
03/02/2024

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.

Hinweis Wenn IContextMenu3 nicht implementiert wird, gibt es keine Garantie, dass IContextMenu2 an seiner Stelle aufgerufen wird. In einigen Fällen wird das Fehlen von IContextMenu3 bestimmt, und dann wird der Prozess angehalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)
DLL	Shell32.dll (Version 4.71 oder höher)

Share via