Metodo IContextMenu3::HandleMenuMsg2 (shobjidl_core.h)

Articolo
03/09/2024

Consente agli oggetti client dell'interfaccia IContextMenu3 di gestire i messaggi associati alle voci di menu disegnate dal proprietario.

Sintassi

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

Parametri

uMsg

Tipo: UINT

Messaggio da elaborare. Nel caso di alcuni messaggi, ad esempio WM_INITMENUPOPUP, WM_DRAWITEM, WM_MENUCHAR o WM_MEASUREITEM, l'oggetto client chiamato può fornire voci di menu disegnate dal proprietario.

wParam

Tipo: WPARAM

Informazioni aggiuntive sui messaggi. Il valore di questo parametro dipende dal valore del parametro uMsg .

lParam

Tipo: LPARAM

Informazioni aggiuntive sui messaggi. Il valore di questo parametro dipende dal valore del parametro uMsg .

plResult

Tipo: LRESULT*

Indirizzo di un valore LRESULT restituito dal messaggio dal proprietario del menu. Questo parametro può essere NULL.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

IContextMenu3::HandleMenuMsg2 sostituisce in genere IContextMenu2::HandleMenuMsg e viene chiamato quando IContextMenu determina che IContextMenu3 è supportato e uno dei messaggi supportati (vedere uMsg) è stato ricevuto. Tuttavia, in alcuni casi, IContextMenu2::HandleMenuMsg è ancora chiamato. Gli host di menu di scelta rapida possono inviare messaggi di menu tramite o entrambi i metodi. Di conseguenza, se un'estensione shell implementa sia IContextMenu2::HandleMenuMsg sia IContextMenu3::HandleMenuMsg2, deve essere preparata per l'arrivo di messaggi di menu tramite entrambi i metodi.

Nota Se IContextMenu3 non è implementato, non vi è alcuna garanzia che IContextMenu2 verrà chiamato al suo posto. In alcuni casi, l'assenza di IContextMenu3 viene determinata e quindi il processo viene arrestato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 4.71 o successiva)

Condividi tramite