IContextMenu2::HandleMenuMsg-Methode (shobjidl_core.h)

Artikel
08/26/2023

Ermöglicht Clientobjekten der IContextMenu-Schnittstelle die Verarbeitung von Nachrichten, die besitzergezeichneten Menüelementen zugeordnet sind.

Syntax

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

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.

Rückgabewert

Typ: HRESULT

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

Hinweise

IContextMenu2::HandleMenuMsg wird im Allgemeinen durch HandleMenuMsg2 ersetzt. HandleMenuMsg2 wird aufgerufen, wenn IContextMenu bestimmt, dass IContextMenu3 unterstützt wird und eine der in der Beschreibung des uMsg-Parameters angegebenen Nachrichten empfängt. In einigen Fällen wird IContextMenu2::HandleMenuMsg jedoch weiterhin aufgerufen.

Wenn IContextMenu2 oder IContextMenu3 benötigt wird, besteht die beste Implementierung für neue Kontextmenüs darin, ihre gesamte Logik in HandleMenuMsg2 zu implementieren und ihre IContextMenu2::HandleMenuMsg-Implementierung einfach zu delegieren, um den Aufruf von HandleMenuMsg2 zu delegieren und NULL als plResult-Parameter zu übergeben.

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


Unterstützte Mindestversion (Client)	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.0 oder höher)

Weitere Informationen

HandleMenuMsg2

IContextMenu2

Share via