PopupMenu Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente un menu contextuel.
Dans une application de bureau, avant d’utiliser un instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.
public ref class PopupMenu sealed/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class PopupMenu final/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class PopupMenu final[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class PopupMenu[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class PopupMenufunction PopupMenu()Public NotInheritable Class PopupMenu- Héritage
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Exemples
Fournissez aux utilisateurs un menu contextuel en ajoutant un écouteur d’événement pour l’événement "contextmenu" . Par exemple, l’exemple de menu contextuel écoute l’événement sur des éléments HTML spécifiques, puis appelle la scenario1AttachmentHandler fonction.
document.getElementById("attachment").addEventListener("contextmenu", attachmentHandler, false);
Pour personnaliser le menu contextuel, appelez preventDefault sur l’événement pour supprimer la valeur par défaut, puis créez un nouveau menu contextuel vide, comme indiqué dans l’exemple de menu contextuel.
e.preventDefault(); // Prevent the default context menu.
var menu = new Windows.UI.Popups.PopupMenu();
Remarques
Un menu contextuel peut afficher un maximum de six commandes. Cette limite permet de garantir que le menu contextuel reste épuré, utilisable et directement pertinent pour les utilisateurs.
Vous pouvez voir des exemples de code complets qui montrent comment créer et personnaliser un menu contextuel dans l’exemple de menu contextuel (Windows 10) et l’exemple de menu contextuel (Windows 8.1).
Pour les applications de bureau XAML, nous vous recommandons d’utiliser un menu volant pour implémenter des menus contextuels.
Notes
Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX) et Using Windows Runtime objects in a multithreaded environment (.NET).
Constructeurs
| PopupMenu() |
Crée une instance de la classe PopupMenu. Dans une application de bureau, avant d’utiliser un instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow. |
Propriétés
| Commands |
Obtient les commandes du menu contextuel. |
Méthodes
| ShowAsync(Point) |
Affiche le menu contextuel aux coordonnées du client spécifiées. |
| ShowForSelectionAsync(Rect) |
Affiche le menu contextuel au-dessus de la sélection spécifiée. |
| ShowForSelectionAsync(Rect, Placement) |
Affiche le menu contextuel dans l’emplacement préféré par rapport à la sélection spécifiée. |