Metodo IContextMenuSite::D oContextMenuPopup (shobjidl_core.h)

[DoContextMenuPopup non è più disponibile per l'uso a partire da Windows Server 2003.]

Crea e visualizza un menu di scelta rapida, tiene traccia della selezione di elementi nel menu e richiama un comando scelto.

Sintassi

HRESULT DoContextMenuPopup(
  [in] IUnknown *punkContextMenu,
  [in] UINT     fFlags,
  [in] POINT    pt
);

Parametri

[in] punkContextMenu

Tipo: IUnknown*

Puntatore all'implementazione IUnknown del menu di scelta rapida.

[in] fFlags

Tipo: UINT

Flag facoltativi che specificano la modalità di modifica del menu di scelta rapida. Questo parametro può essere impostato su qualsiasi combinazione dei valori seguenti. I bit rimanenti della parola con ordine basso sono riservati dal sistema. La parola di ordine elevato può essere usata per le comunicazioni specifiche del contesto. Il valore CMF_RESERVED può essere usato per mascherare la parola in ordine basso.

CMF_NORMAL (0x00000000)

0x00000000. Indica il normale funzionamento. Un'estensione del menu di scelta rapida, un'estensione dello spazio dei nomi o un gestore di trascinamento della selezione può aggiungere tutte le voci di menu.

CMF_DEFAULTONLY (0x00000001)

0x00000001. Questo flag viene impostato quando l'utente attiva l'azione predefinita, in genere facendo doppio clic. Questo flag fornisce un suggerimento per l'estensione del menu di scelta rapida per aggiungere nulla se non modifica la voce predefinita nel menu. Un'estensione del menu di scelta rapida o un gestore di trascinamento della selezione non deve aggiungere voci di menu se questo valore è specificato. Un'estensione dello spazio dei nomi deve aggiungere solo l'elemento predefinito (se presente).

CMF_VERBSONLY (0x00000002)

0x00000002. Questo flag viene impostato se il menu di scelta rapida è per un oggetto di scelta rapida. I gestori di menu di scelta rapida devono ignorare questo valore.

CMF_EXPLORE (0x00000004)

0x00000004. Questo flag viene impostato quando è presente la finestra dell'albero di Esplora risorse.

CMF_NOVERBS (0x00000008)

0x00000008. Questo flag è impostato per gli elementi visualizzati nel menu Invia a . I gestori di menu di scelta rapida devono ignorare questo valore.

CMF_CANRENAME (0x00000010)

0x00000010. Questo flag viene impostato se l'applicazione chiamante supporta la ridenominazione degli elementi. Un'estensione del menu di scelta rapida o un gestore di trascinamento della selezione deve ignorare questo flag. Un'estensione dello spazio dei nomi deve aggiungere una voce di ridenominazione al menu, se applicabile.

CMF_NODEFAULT (0x00000020)

0x00000020. Questo flag viene impostato se nessuna voce nel menu è stata impostata come predefinita. Un gestore di trascinamento della selezione deve ignorare questo flag. Un'estensione dello spazio dei nomi non deve impostare alcuna voce di menu sul valore predefinito.

CMF_INCLUDESTATIC (0x00000040)

Questo valore non è disponibile.

Windows Server 2003 e Windows XP: 0x00000040. Questo flag viene impostato quando viene costruito un menu statico. Solo il browser deve usare questo flag. Tutte le altre estensioni del menu di scelta rapida devono ignorare questo flag.

CMF_ITEMMENU (0x00000080)

0x00000080. Questo flag viene impostato quando l'applicazione chiamante richiama un menu di scelta rapida su una voce nella visualizzazione ,anziché lo sfondo della visualizzazione.

Windows Server 2003 e Windows XP: Questo valore non è disponibile.

CMF_EXTENDEDVERBS (0x00000100)

0x00000100. Questo flag viene impostato quando l'applicazione chiamante vuole verbi estesi. I verbi normali vengono visualizzati quando l'utente fa clic con il pulsante destro del mouse su un oggetto. Per visualizzare verbi estesi, l'utente deve fare clic con il pulsante destro del mouse mentre preme il tasto MAIUSC.

CMF_DISABLEDVERBS (0x00000200)

0x00000200. Questo flag viene impostato quando l'applicazione chiamante intende richiamare verbi altrimenti disabilitati, ad esempio menu legacy.

Windows Server 2003 e Windows XP: Questo valore non è disponibile.

CMF_ASYNCVERBSTATE (0x00000400)

0x00000400. Questo flag viene impostato se lo stato del verbo può essere valutato in modo asincrono.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è disponibile.

CMF_OPTIMIZEFORINVOKE (0x00000800)

0x00000800. Informa i gestori di menu di scelta rapida che non supportano la chiamata di un verbo tramite un nome verbo canonico per ignorare l'elaborazione nell'implementazione IContextMenu::QueryContextMenu .

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è disponibile.

CMF_SYNCCASCADEMENU (0x00001000)

0x00001000.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è disponibile.

CMF_DONOTPICKDEFAULT (0x00002000)

0x00001000. Quando non viene specificato alcun verbo in modo esplicito, non usare un verbo predefinito al suo posto.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è disponibile.

CMF_RESERVED (0xffff0000)

0xffff0000. Questo flag è una maschera di bit che specifica tutti i bit che non devono essere usati. Questa operazione deve essere utilizzata solo come maschera. Non passare questo valore come valore di parametro.

[in] pt

Tipo: POINT

Posizione in cui si desidera visualizzare il menu di scelta rapida. Questo punto specifica la posizione dell'angolo superiore sinistro del menu nelle coordinate dello schermo.

Valore restituito

Tipo: HRESULT

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

Requisiti

Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 5.0 o successiva)