当前位置:   article > 正文

WPF基础五:UI④ 条目控件Menu_wpf menuitem command

wpf menuitem command

Object->DispatcherObject->DependencyObject->Visual->UIElement->FrameworkElement->Control->ItemsControl->MenuBase->Menu


Menu

表示一个 Windows 菜单控件,该控件可用于按层次组织与命令和事件处理程序关联的元素。

Menu控件提供了一个项列表,这些项指定了应用程序的命令或选项。 通常,单击菜单上的项将打开子菜单或使应用程序执行命令。

Menu 是 ItemsControl ,这意味着它可以包含任何类型的对象的集合 (例如字符串、图像或面板) 。 有关更多信息,请参见 ItemsControl 类。 MenuItem是 Menu 中最常见的项类型。 MenuItem可以包含子项。 当用户选择父项时,子菜单项将出现在 MenuItem 子菜单中。

自定义菜单控件

若要对多个 Menu 控件应用相同的属性设置,请使用 Style 属性。 您可以修改 ControlTemplate默认值 ,为控件指定独特的外观。 有关创建 ControlTemplate 的详细信息,请参阅 通过创建 System.windows.controls.controltemplate> 自定义现有控件的外观。 若要查看特定于Menu 的部分和状态,请 参阅 菜单样式和模板

此控件的依赖属性可能由控件的默认样式设置。 如果按默认样式设置属性,则当控件出现在应用程序中时,属性可能会更改为默认值。 默认样式取决于应用程序运行时使用的桌面主题。 有关详细信息,请参阅 默认的 WPF 主题

只有视觉对象属性已存在于控件的默认模板中并且已使用 TemplateBinding 设置时,设置该属性才有效。 在通过创建 ControlTemplate 自定义现有控件的外观一文的更改控件的视觉结构部分可以找到视觉属性列表。

名称备注权限

IsMainMenuProperty

标识 IsMainMenu 依赖项属性。public static readonly
名称备注权限

IsMainMenu

获取或设置一个值,该值指示此 Menu 是否接收主菜单激活通知。get; set;
名称备注权限

HandleMouseButton

在按下或释放任意鼠标按钮时调用。protected

OnCreateAutomationPeer

提供 MenuAutomationPeer 此控件的适当实现,作为 WPF 自动化基础结构的一部分。protected

OnInitialized

当 IsInitialized 属性设置为 true 时调用。protected

OnKeyDown

响应 KeyDown 事件。protected

OnTextInput

处理 TextInput 路由事件,该事件在菜单接收来自任何设备的文本输入时发生。protected

PrepareContainerForItemOverride

准备好指定的元素以显示指定的项。protected

MenuItem

表示 Menu 内某个可选择的项。

MenuItem 是一个 HeaderedItemsControl ,它表示对象的标头和集合可以是任何类型 (例如字符串、图像或面板) 。 有关更多信息,请参见 HeaderedItemsControl 类。

MenuItem可以具有子菜单。MenuItem  的子菜单由 MenuItem 的中的ItemCollection 对象组成 。 通常, MenuItem 包含其他 MenuItem 对象来创建嵌套的子菜单。

MenuItem可以具有以下多个函数之一:

  • 可以选择它来调用命令。

  • 它可以是其他菜单项的分隔符。

  • 它可以是子菜单的标头。

  • 可以选中或取消选中此项。

 备注

默认情况下,MenuItem 的 HorizontalAlignment 设置为 HorizontalAlignment.Stretch 。 StackPanel 的默认水平位置 是 HorizontalAlignment.Center 。 如果通过StackPanel 设置MenuItem 的Width 属性,则将StackPanel 的默认值传递给MenuItem ,将项目居中。

MenuItem的MouseDown事件,如果您用一个的MouseDown事件来处理,你的处理方法将永远不会被调用。要添加自己的处理程序,订阅PreviewMouseDown事件或订阅MouseDown通过调用 AddHandler(RoutedEvent, Delegate, Boolean)handledEventsToo设置为true

若要将相同的属性设置应用于多个MenuItem控件,请使用“样式”属性。您可以修改默认的ControlTemplate以使控件具有唯一的外观。有关创建ControlTemplate的更多信息,请参见通过创建ControlTemplate自定义现有控件的外观。若要查看特定于MenuItem的部分和状态,请参见菜单样式和模板

此控件的依赖项属性可以由控件的默认样式设置。如果使用默认样式设置属性,则当控件出现在应用程序中时,该属性可能会从其默认值更改。默认样式由运行应用程序时使用的桌面主题确定。有关更多信息,请参见默认WPF主题

Note

设置视觉属性仅在该属性同时存在于控件的默认模板中并且通过使用TemplateBinding进行设置时才有效。您可以在通过创建ControlTemplate定制现有控件的外观的更改控件的视觉结构”部分中找到视觉属性列表。


 

名称备注权限

CheckedEvent

标识 Checked 路由事件。public static readonly

ClickEvent

标识 Click 路由事件。public static readonly

CommandParameterProperty

标识 CommandParameter 依赖项属性。public static readonly

CommandProperty

标识 Command 依赖项属性。public static readonly

CommandTargetProperty

标识 CommandTarget 依赖项属性。public static readonly

IconProperty

标识 Icon 依赖项属性。public static readonly

InputGestureTextProperty

标识 InputGestureText 依赖项属性。public static readonly

IsCheckableProperty

标识 IsCheckable 依赖项属性。public static readonly

IsCheckedProperty

标识 IsChecked 依赖项属性。public static readonly

IsHighlightedProperty

标识 IsHighlighted 依赖项属性。public static readonly

IsPressedProperty

标识 IsPressed 依赖项属性。public static readonly

IsSubmenuOpenProperty

标识 IsSubmenuOpen 依赖项属性。public static readonly

IsSuspendingPopupAnimationProperty

标识 IsSuspendingPopupAnimation 依赖项属性。public static readonly

ItemContainerTemplateSelectorProperty

 

标识 ItemContainerTemplateSelector 依赖项属性。public static readonly

RoleProperty

标识 Role 依赖项属性。public static readonly

StaysOpenOnClickProperty

标识 StaysOpenOnClick 依赖项属性。public static readonly

SubmenuClosedEvent

标识 SubmenuClosed 路由事件。public static readonly

SubmenuOpenedEvent

标识 SubmenuOpened 路由事件。public static readonly

UncheckedEvent

标识 Unchecked 路由事件。public static readonly

UsesItemContainerTemplateProperty

标识 UsesItemContainerTemplate 依赖项属性。public static readonly
名称备注权限

Command

获取或设置与菜单项关联的命令。get; set;

CommandParameter

获取或设置要传递给 Command 的 MenuItem 属性的参数。get; set;

CommandTarget

获取或设置在其上引发指定命令的目标元素。get; set;

HandlesScrolling

获取控件是否支持滚动。get;

Icon

获取或设置显示在 MenuItem 中的图标。get; set;

InputGestureText

设置文本,以描述将调用与指定项关联的命令的输入笔势。get; set;

IsCheckable

获取一个指示是否可选中 MenuItem 的值。get;

IsChecked

获取或设置一个指示是否选中 MenuItem 的值。get; set;

IsEnabledCore

获取一个值,该值指示当前菜单项的 IsEnabled 属性是否为 trueget;

IsHighlighted

获取一个指示是否突出显示 MenuItem 的值。get;

IsPressed

获取一个指示是否按下 MenuItem 的值。get;

IsSubmenuOpen

获取或设置一个值,该值指示是否打开 MenuItem 的子菜单。get; set;

IsSuspendingPopupAnimation

获取菜单是否对其 Popup 控件挂起动画。get;

ItemContainerTemplateSelector

获取或设置用于选择用来显示每个项的模板的自定义逻辑。get; set;

Role

获取一个值,该值指示 MenuItem 的角色。get;

SeparatorStyleKey

获取当 MenuItem 为 MenuItem 时应用于 Separator 的样式的资源键。get;

StaysOpenOnClick

获取或设置一个值,该值指示在单击此 MenuItem 时,该项所在的子菜单不应关闭。get; set;

SubmenuHeaderTemplateKey

获取当 MenuItem 为子菜单标头时应用于 MenuItem 的样式的资源键。get;

SubmenuItemTemplateKey

获取当 MenuItem 为子菜单时应用于 MenuItem 的样式的资源键。get;

TopLevelHeaderTemplateKey

获取当 MenuItem 为顶级菜单标头时应用于 MenuItem 的样式的资源键。get;

TopLevelItemTemplateKey

获取当 MenuItem 为可调用命令的顶级 MenuItem 时应用于它的样式的资源键。get;

UsesItemContainerTemplate

获取或设置指示菜单是根据基础集合中项的类型还是一些其他的启发方法来选择不同的项容器的值。get; set;
名称备注权限

GetContainerForItemOverride

创建或标识用于显示指定项的元素。protected

IsItemItsOwnContainerOverride

确定指定项是否是(或者是否可以作为)自己的 ItemContainerprotected

OnAccessKey

在调用此控件的 AccessKey 时响应protected

OnApplyTemplate

在生成模板树时调用。public

OnChecked

在 IsChecked 属性变为 true 时调用。 此方法引发 Checked 路由事件。protected

OnClick

在单击 MenuItem 并引发 Click 事件时调用。protected

OnCreateAutomationPeer

提供 MenuItemAutomationPeer 此控件的适当实现,作为 WPF 自动化基础结构的一部分。protected

OnGotKeyboardFocus

宣布键盘焦点位于此元素上。protected

OnInitialized

在 IsInitialized 属性设置为 true 并引发 Initialized 事件时调用。protected

OnIsKeyboardFocusWithinChanged

当焦点不再在 MenuItem 之上或之内时调用。protected

OnItemsChanged

当 Items 属性更改时调用。protected

OnKeyDown

响应 KeyDown 事件。protected

OnMouseEnter

每当鼠标进入 MenuItem 时调用。protected

OnMouseLeave

每当鼠标离开 MenuItem 时调用。protected

OnMouseLeftButtonDown

在按下鼠标左键时调用。protected

OnMouseLeftButtonUp

在释放鼠标左键时调用。protected

OnMouseMove

在鼠标移到菜单项上时调用。protected

OnMouseRightButtonDown

在按下鼠标右键时调用。protected

OnMouseRightButtonUp

在释放鼠标右键时调用。protected

OnSubmenuClosed

在关闭 MenuItem 的子菜单时调用。protected

OnSubmenuOpened

在打开 MenuItem 的子菜单时调用。protected

OnUnchecked

在 IsChecked 属性变为 false 时调用。 此方法引发 Unchecked 路由事件。protected

OnVisualParentChanged

在可视 MenuItem 的父级更改时调用。protected

PrepareContainerForItemOverride

准备好指定的元素以显示指定的项。protected

ShouldApplyItemContainerStyle

用于确定是否对项容器应用样式。protected
名称备注

Checked

在选中菜单项时发生。

Click

在单击 MenuItem 时发生。

SubmenuClosed

在 IsSubmenuOpen 属性的状态更改为 false 时发生。

SubmenuOpened

在 IsSubmenuOpen 属性的状态更改为 true 时发生。

Unchecked

在未选中 MenuItem 时发生。

 


XAML范例

  • IsMainMenu属性的影响

  • 本例中Click和Command是相同效果,但是务必学会使用Command,这在MVVM中经常使用。

  1. <Window x:Class="MenuDemo.MainWindow"
  2. xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  3. xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  4. xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  5. xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  6. xmlns:local="clr-namespace:MenuDemo"
  7. mc:Ignorable="d"
  8. Title="MainWindow" Height="450" Width="800">
  9. <!--命令绑定-->
  10. <Window.Resources>
  11. <RoutedCommand x:Key="OpenCommand"/>
  12. </Window.Resources>
  13. <Window.CommandBindings>
  14. <CommandBinding Command="{StaticResource OpenCommand}" Executed="OnOpen"/>
  15. </Window.CommandBindings>
  16. <!--快捷键-->
  17. <Window.InputBindings>
  18. <KeyBinding Command="{StaticResource OpenCommand}" Gesture="Ctrl+O"/>
  19. </Window.InputBindings>
  20. <Grid>
  21. <Grid.RowDefinitions>
  22. <RowDefinition Height="20"/>
  23. <RowDefinition/>
  24. <RowDefinition Height="20"/>
  25. </Grid.RowDefinitions>
  26. <StackPanel>
  27. <Menu IsMainMenu="False">
  28. <MenuItem Header="_File">
  29. <MenuItem Header="_Open" Command="{StaticResource OpenCommand }" InputGestureText="Ctrl+O"/>
  30. <MenuItem Header="_Closed" Click="OnClosed"/>
  31. </MenuItem>
  32. <MenuItem Header="_Edit"/>
  33. </Menu>
  34. </StackPanel>
  35. <StackPanel Grid.Row="2" >
  36. <Menu IsMainMenu="True">
  37. <MenuItem Header="_View" >
  38. <MenuItem Header="_Left"/>
  39. <MenuItem Header="_Right"/>
  40. </MenuItem>
  41. <MenuItem Header="_Help" />
  42. </Menu>
  43. </StackPanel>
  44. </Grid>
  45. </Window>
  1. using System;
  2. using System.Collections.Generic;
  3. using System.Linq;
  4. using System.Text;
  5. using System.Threading.Tasks;
  6. using System.Windows;
  7. using System.Windows.Controls;
  8. using System.Windows.Data;
  9. using System.Windows.Documents;
  10. using System.Windows.Input;
  11. using System.Windows.Media;
  12. using System.Windows.Media.Imaging;
  13. using System.Windows.Navigation;
  14. using System.Windows.Shapes;
  15. namespace MenuDemo
  16. {
  17. /// <summary>
  18. /// MainWindow.xaml 的交互逻辑
  19. /// </summary>
  20. public partial class MainWindow : Window
  21. {
  22. public MainWindow()
  23. {
  24. InitializeComponent();
  25. }
  26. private void OnOpen(object sender, ExecutedRoutedEventArgs e)
  27. {
  28. MessageBox.Show("你使用了Open命令!");
  29. }
  30. private void OnClosed(object sender, RoutedEventArgs e)
  31. {
  32. this.Close();
  33. }
  34. }
  35. }

 


C#代码

  1. using System;
  2. using System.Collections.Generic;
  3. using System.Linq;
  4. using System.Text;
  5. using System.Threading.Tasks;
  6. using System.Windows;
  7. using System.Windows.Controls;
  8. using System.Windows.Data;
  9. using System.Windows.Documents;
  10. using System.Windows.Input;
  11. using System.Windows.Media;
  12. using System.Windows.Media.Imaging;
  13. using System.Windows.Navigation;
  14. using System.Windows.Shapes;
  15. namespace MenuDemo
  16. {
  17. /// <summary>
  18. /// MainWindow.xaml 的交互逻辑
  19. /// </summary>
  20. public partial class MainWindow : Window
  21. {
  22. public MainWindow()
  23. {
  24. InitializeComponent();
  25. RowDefinition row0 = new RowDefinition { Height = new GridLength(20.0) };
  26. RowDefinition row1 = new RowDefinition ();
  27. RowDefinition row2 = new RowDefinition { Height = new GridLength(20.0) };
  28. (this.Content as Grid).RowDefinitions.Add(row0);
  29. (this.Content as Grid).RowDefinitions.Add(row1);
  30. (this.Content as Grid).RowDefinitions.Add(row2);
  31. Menu menu0 = new Menu { IsMainMenu = false };
  32. MenuItem menuFile = new MenuItem { Header= "_File" };
  33. RoutedCommand OpenCommand = new RoutedCommand();
  34. CommandBinding command = new CommandBinding {Command= OpenCommand};
  35. this.CommandBindings.Add(command);
  36. KeyBinding keyBinding = new KeyBinding { Command = OpenCommand };
  37. this.InputBindings.Add(keyBinding);
  38. keyBinding.Gesture = new KeyGesture(Key.O, ModifierKeys.Control);
  39. command.Executed += OnOpen;
  40. MenuItem menuOpen = new MenuItem { Header = "_Open", InputGestureText = "Ctrl+O" , Command = OpenCommand };
  41. MenuItem menuClosed = new MenuItem { Header = "_Closed" };
  42. menuClosed.Click += OnClosed;
  43. MenuItem menuEdit = new MenuItem { Header = "_Edit" };
  44. menuFile.Items.Add(menuOpen);
  45. menuFile.Items.Add(menuClosed);
  46. menu0.Items.Add(menuFile);
  47. menu0.Items.Add(menuEdit);
  48. Menu menu1 = new Menu { IsMainMenu = true };
  49. MenuItem menuView = new MenuItem { Header = "_View" };
  50. MenuItem menuLeft = new MenuItem { Header = "_Left" };
  51. MenuItem menuRight = new MenuItem { Header = "_Right" };
  52. MenuItem menuHelp = new MenuItem { Header = "_Help" };
  53. menuView.Items.Add(menuLeft);
  54. menuView.Items.Add(menuRight);
  55. menu1.Items.Add(menuView);
  56. menu1.Items.Add(menuHelp);
  57. StackPanel stackPanel0 = new StackPanel();
  58. StackPanel stackPanel1 = new StackPanel();
  59. stackPanel0.Children.Add(menu0);
  60. stackPanel1.Children.Add(menu1);
  61. Grid.SetRow(stackPanel1, 2);
  62. (this.Content as Grid).Children.Add(stackPanel0);
  63. (this.Content as Grid).Children.Add(stackPanel1);
  64. }
  65. private void OnOpen(object sender, ExecutedRoutedEventArgs e)
  66. {
  67. MessageBox.Show("你使用了Open命令!");
  68. }
  69. private void OnClosed(object sender, RoutedEventArgs e)
  70. {
  71. this.Close();
  72. }
  73. }
  74. }

 

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/凡人多烦事01/article/detail/493402
推荐阅读
相关标签
  

闽ICP备14008679号