Windows Dev Center

PopupMenu Class

Représente un menu contextuel.

Syntaxe


var popupMenu = new Windows.UI.Popups.PopupMenu();

Attributs

[MarshalingBehavior(Standard)]
[Muse()]
[Version(0x06020000)]

Membres

PopupMenuClasse possède ces types de membres :

Constructeurs

PopupMenuClasse possède ces constructeurs.

ConstructeurDescription
PopupMenu Creates a new instance of the PopupMenu class.

 

Méthodes

The PopupMenu Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
ShowAsync Shows the context menu at the specified client coordinates.
ShowForSelectionAsync(Rect) Shows the context menu above the specified selection.
ShowForSelectionAsync(Rect, Placement) Shows the context menu in the preferred placement relative to the specified selection.

 

Propriétés

Le PopupMenuClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

Commands

En lecture seuleGets the commands for the context menu.

 

Remarques

les menus contextuels peuvent afficher un maximum de six commandes. Cette limite permet de vérifier que le menu contextuel n'est pas encombré, utilisable et directement approprié pour les utilisateurs.

Vous pouvez consulter des exemples de code complets qui expliquent comment créer et personnaliser des menus contextuels dans l'Exemple de menu contextuel sur la Page d'accueil d'exemples d'applications Windows Store.

Remarque   : 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 Threads et marshaling (C++/CX) et Utilisation d'objets Windows Runtime dans un environnement multithread (.NET).

Exemples

Fournissez aux utilisateurs un menu contextuel en ajoutant un écouteur d'événements pour l'événement "contextmenu". Par exemple, l'Exemple de menu contextuel écoute l'événement sur les éléments HTML spécifiques, puis appelle la fonction scenario1AttachmentHandler.


document.getElementById("attachment").addEventListener("contextmenu", attachmentHandler, false);


Lorsque vous ajoutez un écouteur d'événements "contextmenu", le menu contextuel par défaut est utilisé. Le menu par défaut fournit des commandes limitées pour le texte sélectionné ou les liens hypertexte (pour en savoir plus, consultez Ajout de menus contextuels).

Pour personnaliser le menu contextuel, appelez preventDefault sur l'événement pour supprimer la valeur par défaut, puis créez un menu contextuel vide comme indiqué dans l'exemple de menu.


e.preventDefault(); // Prevent the default context menu.



var menu = new Windows.UI.Popups.PopupMenu();


Utilisez popupMenu.commands pour ajouter des commandes à votre menu contextuel.

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.UI.Popups
Windows::UI::Popups [C++]

Métadonnées

Windows.winmd

Voir aussi

Ajout des menus contextuels
Exemple de menu contextuel
Instructions et liste de contrôle pour les menus contextuels
Référence
PopupMenu.Commands
UICommand
UICommandSeparator

 

 

Afficher:
© 2015 Microsoft