Metodo IMenuPopup::P opup (shobjidl_core.h)

  • Articolo

Richiama il menu di scelta rapida in una posizione sullo schermo specificata.

Sintassi

HRESULT Popup(
  [in] POINTL        *ppt,
  [in] RECTL         *prcExclude,
  [in] MP_POPUPFLAGS dwFlags
);

Parametri

[in] ppt

Tipo: POINTL*

Puntatore a una struttura POINTL che specifica la posizione del menu a comparsa nelle coordinate dello schermo. Il menu a comparsa viene visualizzato in relazione a questo punto, come determinato dai flag di posizione impostati in dwFlags.

[in] prcExclude

Tipo: RECTL*

Puntatore a una struttura RECTL che specifica il rettangolo da escludere durante il posizionamento del menu. In Windows Vista l'allineamento del menu in relazione a questa area è determinato dai flag di allineamento impostati in dwFlags. Questo parametro può essere NULL per includere l'intera schermata.

[in] dwFlags

Tipo: MP_POPUPFLAGS

Una o più delle costanti seguenti che controllano la visualizzazione del menu a comparsa.

MPPF_SETFOCUS (0x00000001)

Quando viene visualizzato, il menu deve avere lo stato attivo.

MPPF_INITIALSELECT (0x00000002)

La prima voce del menu deve essere selezionata.

MPPF_NOANIMATE (0x00000004)

Non animare questo spettacolo.

MPPF_KEYBOARD (0x00000010)

Il menu viene attivato dalla tastiera.

MPPF_REPOSITION (0x00000020)

Riposizionare la barra visualizzata.

MPPF_FORCEZORDER (0x00000040)

La barra dei menu deve ignorare le posizioni dei sottomenu.

MPPF_FINALSELECT (0x00000080)

L'ultima voce del menu deve essere selezionata.

MPPF_TOP (0x20000000)

Visualizzare il menu a comparsa sopra il punto specificato in ppt.

MPPF_LEFT (0x40000000)

Visualizzare il menu a comparsa a sinistra del punto specificato in ppt.

MPPF_RIGHT (0x60000000)

Visualizzare il menu a comparsa a destra del punto specificato in ppt.

MPPF_BOTTOM (0x80000000)

Visualizzare il menu a comparsa sotto il punto specificato in ppt.

MPPF_POS_MASK (0xE0000000)

Maschera per i valori di posizione MPPF_TOP, MPPF_LEFT e MPPF_RIGHT.

MPPF_ALIGN_LEFT (0x02000000)

Allineamento predefinito.

MPPF_ALIGN_RIGHT (0x04000000)

Il menu a comparsa deve essere allineato a destra del rettangolo escluso specificato da prcExclude.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se l'oggetto implementa il menu a comparsa come menu senza modalità. In caso contrario, restituisce S_FALSE, che indica la fine dell'implementazione per il menu.

Requisiti

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