Anvisningar: Skapa en RoutedCommand

Det här exemplet visar hur du skapar en anpassad RoutedCommand och hur du implementerar det anpassade kommandot genom att skapa en ExecutedRoutedEventHandler och en CanExecuteRoutedEventHandler och koppla dem till en CommandBinding. Mer information om kommandon finns i -kommandoöversikten.

Exempel

Det första steget i att skapa en RoutedCommand är att definiera kommandot och instansiera det.

public static RoutedCommand CustomRoutedCommand = new RoutedCommand();

Public Shared CustomRoutedCommand As New RoutedCommand()

För att kunna använda kommandot i ett program måste händelsehanterare som definierar vad kommandot gör skapas

private void ExecutedCustomCommand(object sender,
    ExecutedRoutedEventArgs e)
{
    MessageBox.Show("Custom Command Executed");
}

Private Sub ExecutedCustomCommand(ByVal sender As Object, ByVal e As ExecutedRoutedEventArgs)
    MessageBox.Show("Custom Command Executed")
End Sub

// CanExecuteRoutedEventHandler that only returns true if
// the source is a control.
private void CanExecuteCustomCommand(object sender,
    CanExecuteRoutedEventArgs e)
{
    Control target = e.Source as Control;

    if(target != null)
    {
        e.CanExecute = true;
    }
    else
    {
        e.CanExecute = false;
    }
}

' CanExecuteRoutedEventHandler that only returns true if
' the source is a control.
Private Sub CanExecuteCustomCommand(ByVal sender As Object, ByVal e As CanExecuteRoutedEventArgs)
    Dim target As Control = TryCast(e.Source, Control)

    If target IsNot Nothing Then
        e.CanExecute = True
    Else
        e.CanExecute = False
    End If
End Sub

Därefter skapas en CommandBinding som associerar kommandot med händelsehanterarna. CommandBinding skapas på ett specifikt objekt. Det här objektet definierar omfånget för CommandBinding i elementträdet

<Window x:Class="SDKSamples.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:custom="clr-namespace:SDKSamples"
    Height="600" Width="800"
    >
  <Window.CommandBindings>
    <CommandBinding Command="{x:Static custom:Window1.CustomRoutedCommand}"
                    Executed="ExecutedCustomCommand"
                    CanExecute="CanExecuteCustomCommand" />
  </Window.CommandBindings>

CommandBinding customCommandBinding = new CommandBinding(
    CustomRoutedCommand, ExecutedCustomCommand, CanExecuteCustomCommand);

// attach CommandBinding to root window
this.CommandBindings.Add(customCommandBinding);

Dim customCommandBinding As New CommandBinding(CustomRoutedCommand, AddressOf ExecutedCustomCommand, AddressOf CanExecuteCustomCommand)

' attach CommandBinding to root window
Me.CommandBindings.Add(customCommandBinding)

Det sista steget är att anropa kommandot. Ett sätt att anropa ett kommando är att associera det med en ICommandSource, till exempel en Button.

<StackPanel>
  <Button Command="{x:Static custom:Window1.CustomRoutedCommand}"
          Content="CustomRoutedCommand"/>
</StackPanel>

// create the ui
StackPanel CustomCommandStackPanel = new StackPanel();
Button CustomCommandButton = new Button();
CustomCommandStackPanel.Children.Add(CustomCommandButton);

CustomCommandButton.Command = CustomRoutedCommand;

' create the ui
Dim CustomCommandStackPanel As New StackPanel()
Dim CustomCommandButton As New Button()
CustomCommandStackPanel.Children.Add(CustomCommandButton)

CustomCommandButton.Command = CustomRoutedCommand

När man klickar på knappen anropas metoden Execute på den anpassade RoutedCommand. RoutedCommand utlöser PreviewExecuted och Executed dirigerade händelser. Dessa händelser passerar elementträdet och letar efter en CommandBinding för det här kommandot. Om en CommandBinding hittas anropas den ExecutedRoutedEventHandler som är associerad med CommandBinding.

Se även

• RoutedCommand
• Kommandobeskrivning