MenuItem.Command Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the command associated with the menu item.
public:
property System::Windows::Input::ICommand ^ Command { System::Windows::Input::ICommand ^ get(); void set(System::Windows::Input::ICommand ^ value); };
[System.ComponentModel.Bindable(true)]
[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public System.Windows.Input.ICommand Command { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
member this.Command : System.Windows.Input.ICommand with get, set
Public Property Command As ICommand
Property Value
The command associated with the MenuItem. The default is null
.
- Attributes
Examples
The following examples show how to use the command property to associate commands with menu items.
<MenuItem Header="_Open" Command="ApplicationCommands.Open"/>
<MenuItem Header="_Save" Command="ApplicationCommands.Save"/>
mib = new MenuItem();
mib.Command = System.Windows.Input.ApplicationCommands.Copy;
mib.Header = "_Copy";
mi.Items.Add(mib);
mic = new MenuItem();
mic.Command = System.Windows.Input.ApplicationCommands.Paste;
mic.Header = "_Paste";
mi.Items.Add(mic);
Remarks
This property is used to associate a command with a particular MenuItem instance. The following example associates the Copy command with a MenuItem and automatically supplies the input gesture text Ctrl+C. The example does not set the Header property, but the Header for the MenuItem is "Copy" at run time. You can specify another header for the MenuItem if you want it to be different. For information on how to bind to the desired command, see Add a Command to a MenuItem.
<MenuItem Command="ApplicationCommands.Copy"/>
A command is raised when a MenuItem is clicked - just after the Click event. The command is raised on the element according to the following priorities:
If CommandTarget is set on the MenuItem, that element is used.
The PlacementTarget of a ContextMenu that contains the MenuItem.
The focus target of the main window that contains a Menu.
The MenuItem that was clicked.
Dependency Property Information
Item | Value |
---|---|
Identifier field | CommandProperty |
Metadata properties set to true |
None |