IMenuPopup ::P opup, méthode (shobjidl_core.h)
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) |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour