IContextMenu2::HandleMenuMsg-Methode (shobjidl_core.h)

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.

Anforderungen

Weitere Informationen

HandleMenuMsg2

IContextMenu2