ContextMenu, classe
Mise à jour : novembre 2007
Représente un menu contextuel qui permet à un contrôle de proposer des fonctionnalités propres à son contexte.
Assembly : PresentationFramework (dans PresentationFramework.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/xaml/presentation
Modèle de contenu : ContextMenu est un ItemsControl. Ses propriétés de contenu sont Items et ItemsSource. Pour plus d'informations sur le modèle de contenu de ContextMenu, consultez Vue d'ensemble du modèle de contenu des contrôles.
Les propriétés de la classe ContextMenu permettent de définir la position et le comportement de ContextMenu.
Un FrameworkElement ou un FrameworkContentElement peut disposer d'un ContextMenu. Si vous assignez un ContextMenu à la propriété FrameworkElement.ContextMenu ou FrameworkContentElement.ContextMenu, la classe ContextMenuService gère les opérations du menu contextuel en réponse à une intervention de l'utilisateur. Une partie du travail de la classe ContextMenuService consiste à ouvrir le ContextMenu lorsque l'utilisateur clique sur le contrôle avec le bouton droit de la souris.
Les propriétés suivantes sont définies par les classes ContextMenu et ContextMenuService. Si l'une de ces propriétés est définie sur les deux classes, ContextMenu et ContextMenuService, la valeur définie dans ContextMenuService est utilisée.
Les ContextMenu sont automatiquement placés dans un contrôle Popup. Ce comportement ne peut pas être modifié.
Les exemples suivants montrent comment créer un ContextMenu.
<Button Name="cmButton" Height="30"> Button with Context Menu <Button.ContextMenu> <ContextMenu Name="cm" Opened="OnOpened" Closed="OnClosed" StaysOpen="true"> <MenuItem Header="File"/> <MenuItem Header="Save"/> <MenuItem Header="SaveAs"/> <MenuItem Header="Recent Files"> <MenuItem Header="ReadMe.txt"/> <MenuItem Header="Schedule.xls"/> </MenuItem> </ContextMenu> </Button.ContextMenu> </Button>
btn = new Button(); btn.Content = "Created with C#"; contextmenu = new ContextMenu(); btn.ContextMenu = contextmenu; mi = new MenuItem(); mi.Header = "File"; mia = new MenuItem(); mia.Header = "New"; mi.Items.Add(mia); mib = new MenuItem(); mib.Header = "Open"; mi.Items.Add(mib); mib1 = new MenuItem(); mib1.Header = "Recently Opened"; mib.Items.Add(mib1); mib1a = new MenuItem(); mib1a.Header = "Text.xaml"; mib1.Items.Add(mib1a); contextmenu.Items.Add(mi); cv2.Children.Add(btn);
System.Windows.Threading.DispatcherObject
System.Windows.DependencyObject
System.Windows.Media.Visual
System.Windows.UIElement
System.Windows.FrameworkElement
System.Windows.Controls.Control
System.Windows.Controls.ItemsControl
System.Windows.Controls.Primitives.MenuBase
System.Windows.Controls.ContextMenu
Windows Vista
Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.