PopupMenu Classe

Définition

Espace de noms:

Windows.UI.Popups

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.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.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 PopupMenu

function PopupMenu()

Public NotInheritable Class PopupMenu

Héritage

Object Platform::Object IInspectable PopupMenu

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

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.

Voir aussi

• Commands
• UICommand
• UICommandSeparator
• Ajout de menus contextuels
• Exemple de menu contextuel
• Exemple de menu contextuel (Windows 10)
• Menus et menus contextuels pour les applications de bureau
• Afficher les objets d’interface utilisateur WinRT qui dépendent de CoreWindow