Méthode IContextMenu2::HandleMenuMsg (shobjidl_core.h)

Article
08/26/2023

Permet aux objets clients de l’interface IContextMenu de gérer les messages associés aux éléments de menu dessinés par le propriétaire.

Syntaxe

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

Paramètres

uMsg

Type : UINT

Message à traiter. Dans le cas de certains messages, tels que WM_INITMENUPOPUP, WM_DRAWITEM, WM_MENUCHAR ou WM_MEASUREITEM, l’objet client appelé peut fournir des éléments de menu dessinés par le propriétaire.

wParam

Type : WPARAM

Informations supplémentaires sur les messages. La valeur de ce paramètre dépend de la valeur du paramètre uMsg .

lParam

Type : LPARAM

Informations supplémentaires sur les messages. La valeur de ce paramètre dépend de la valeur du paramètre uMsg .

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

IContextMenu2::HandleMenuMsg est généralement remplacé par HandleMenuMsg2. HandleMenuMsg2 est appelé quand IContextMenu détermine qu’IContextMenu3 est pris en charge et reçoit l’un des messages spécifiés dans la description du paramètre uMsg . Toutefois, dans certains cas, IContextMenu2::HandleMenuMsg est toujours appelé.

Si IContextMenu2 ou IContextMenu3 est nécessaire, la meilleure implémentation pour les nouveaux menus contextuels consiste à implémenter toute leur logique dans HandleMenuMsg2 et à avoir leur implémentation IContextMenu2::HandleMenuMsg simplement déléguer l’appel à HandleMenuMsg2 et passer NULL comme paramètre plResult .

Note Si IContextMenu3 n’est pas implémenté, rien ne garantit qu’IContextMenu2 sera appelé à sa place. Dans certains cas, l’absence d’IContextMenu3 est déterminée, puis le processus est arrêté.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)
DLL	Shell32.dll (version 4.0 ou ultérieure)

Voir aussi

HandleMenuMsg2

IContextMenu2

Partager via