UIElement.CommandBindings Property

Reference

Definition

Namespace:: System.Windows

Assembly:: PresentationCore.dll

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 a collection of CommandBinding objects associated with this element. A CommandBinding enables command handling for this element, and declares the linkage between a command, its events, and the handlers attached by this element.

public:
 property System::Windows::Input::CommandBindingCollection ^ CommandBindings { System::Windows::Input::CommandBindingCollection ^ get(); };

public System.Windows.Input.CommandBindingCollection CommandBindings { get; }

member this.CommandBindings : System.Windows.Input.CommandBindingCollection

Public ReadOnly Property CommandBindings As CommandBindingCollection

Property Value

CommandBindingCollection

The collection of all CommandBinding objects.

Examples

The following example adds a CommandBinding to a window using markup. Note that in XAML, the CommandBindingCollection is not declared in the markup as an element; the collection object is inferred by the type that the property takes, and you populate the property element with one or more CommandBinding elements:

<Window.CommandBindings>
  <CommandBinding Command="ApplicationCommands.Open"
                  Executed="OpenCmdExecuted"
                  CanExecute="OpenCmdCanExecute"/>
</Window.CommandBindings>

For more information about the XAML syntax for collections, see XAML Syntax In Detail.

The following example does essentially the same thing in code:

// Creating CommandBinding and attaching an Executed and CanExecute handler
CommandBinding OpenCmdBinding = new CommandBinding(
    ApplicationCommands.Open,
    OpenCmdExecuted,
    OpenCmdCanExecute);

this.CommandBindings.Add(OpenCmdBinding);

' Creating CommandBinding and attaching an Executed and CanExecute handler
Dim OpenCmdBinding As New CommandBinding(ApplicationCommands.Open, AddressOf OpenCmdExecuted, AddressOf OpenCmdCanExecute)

Me.CommandBindings.Add(OpenCmdBinding)

Remarks

Another typical way to populate the CommandBindings collection is to use CommandManager methods programmatically.

XAML Property Element Usage

<object>  
  <object.CommandBindings>  
    oneOrMoreCommandBindings  
  </object.CommandBindings>  
</object>

XAML Values

oneOrMoreCommandBindings
One or more CommandBinding elements. Each of these should have a Command attribute set to a known command, and attributes set for the CanExecute and Executed handler implementations. For more information see CommandBinding.

Applies to

Dela via