IMenuPopup ::P opup, méthode (shobjidl_core.h)

Article
03/02/2024

Appelle le menu contextuel à un emplacement à l’écran spécifié.

Syntaxe

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

Paramètres

[in] ppt

Type : POINTL*

Pointeur vers une structure POINTL qui spécifie l’emplacement du menu contextuel dans les coordonnées de l’écran. Le menu contextuel s’affiche par rapport à ce point, tel que déterminé par les indicateurs de position définis dans dwFlags.

[in] prcExclude

Type : RECTL*

Pointeur vers une structure RECTL qui spécifie le rectangle à exclure lors du positionnement du menu. Dans Windows Vista, l’alignement du menu par rapport à cette zone est déterminé par les indicateurs d’alignement définis dans dwFlags. Ce paramètre peut être NULL pour inclure l’intégralité de l’écran.

[in] dwFlags

Type : MP_POPUPFLAGS

Une ou plusieurs des constantes suivantes qui contrôlent l’affichage du menu contextuel.

MPPF_SETFOCUS (0x00000001)

Le menu doit avoir le focus lorsqu’il s’affiche.

MPPF_INITIALSELECT (0x00000002)

Le premier élément du menu doit être sélectionné.

MPPF_NOANIMATE (0x00000004)

N’animez pas ce spectacle.

MPPF_KEYBOARD (0x00000010)

Le menu est activé par le clavier.

MPPF_REPOSITION (0x00000020)

Repositionnez la barre affichée.

MPPF_FORCEZORDER (0x00000040)

La barre de menus doit ignorer les positions de sous-menu.

MPPF_FINALSELECT (0x00000080)

Le dernier élément du menu doit être sélectionné.

MPPF_TOP (0x20000000)

Affichez le menu contextuel au-dessus du point spécifié dans ppt.

MPPF_LEFT (0x40000000)

Affichez le menu contextuel à gauche du point spécifié dans ppt.

MPPF_RIGHT (0x60000000)

Affichez le menu contextuel à droite du point spécifié dans ppt.

MPPF_BOTTOM (0x80000000)

Affichez le menu contextuel sous le point spécifié dans ppt.

MPPF_POS_MASK (0xE0000000)

Masquez les valeurs de position MPPF_TOP, MPPF_LEFT et MPPF_RIGHT.

MPPF_ALIGN_LEFT (0x02000000)

Alignement par défaut.

MPPF_ALIGN_RIGHT (0x04000000)

Le menu contextuel doit être aligné à droite du rectangle exclu spécifié par prcExclude.

Valeur retournée

Type : HRESULT

Retourne S_OK si l’objet implémente le menu contextuel en tant que menu sans mode. Sinon, retourne S_FALSE, qui indique la fin de l’implémentation du menu.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via