CMenu::TrackPopupMenuEx

Article
06/10/2015

Affiche un menu contextuel flottant à l'emplacement spécifié et suivre la sélection des éléments dans le menu contextuel.

BOOL TrackPopupMenuEx( 
   UINT fuFlags, 
   int x, 
   int y, 
   CWnd* pWnd, 
   LPTPMPARAMS lptpm 
);

Paramètres

fuFlags
Spécifie des différentes fonctions du menu étendu. Pour une liste de toutes les valeurs et de leur signification, consultez TrackPopupMenuEx.
x
Spécifie la position horizontale dans les coordonnées d'écran du menu contextuel.
y
Spécifie la position verticale dans les coordonnées d'écran du haut du menu sur l'écran.
pWnd
Un pointeur vers la fenêtre possédant le menu contextuel et en recevant les messages du menu créé. Cette fenêtre peut être une fenêtre d'application actuelle mais ne peut pas être NULL. Si vous spécifiez TPM_NONOTIFY dans le paramètre d' fuFlags , la fonction n'envoie un message à pWnd. La fonction doit retourner pour la fenêtre pointée pointe vers pWnd pour recevoir le message de WM_COMMAND .
lptpm
Le pointeur vers une structure de TPMPARAMS qui spécifie une zone de l'écran le menu ne doit pas se chevaucher. Ce paramètre peut être NULL.

Valeur de retour

Si vous spécifiez TPM_RETURNCMD dans le paramètre d' fuFlags , la valeur de retour est l'identificateur d'élément de menu de l'élément sélectionné. Si l'utilisateur annule le menu sans effectuer une sélection, ou si une erreur se produit, la valeur de retour est 0.

Si vous ne spécifiez pas TPM_RETURNCMD dans le paramètre d' fuFlags , la valeur de retour est différente de zéro si la fonction réussit et 0 si elle échoue. Pour obtenir des informations d'erreurs étendues, appelez GetLastError.

Notes

Un menu contextuel flottant peut apparaître sur l'écran. Pour plus d'informations sur les erreurs de gestion en créant le menu contextuel, consultez TrackPopupMenuEx.