Delen via

Procedure: Een opdracht inschakelen

  • Artikel

In het volgende voorbeeld ziet u hoe u opdrachten gebruikt in Windows Presentation Foundation (WPF). In het voorbeeld ziet u hoe u een RoutedCommand koppelt aan een Button, een CommandBindingmaakt en de gebeurtenis-handlers maakt waarmee de RoutedCommandwordt geïmplementeerd. Voor meer informatie over het aansturen, zie de Commanding Overview.

Voorbeeld

De eerste sectie met code maakt de gebruikersinterface (UI), die bestaat uit een Button en een StackPanel, en maakt een CommandBinding die de opdrachthandlers koppelt aan de RoutedCommand.

De eigenschap Command van de Button is gekoppeld aan de opdracht Close.

De CommandBinding wordt toegevoegd aan de CommandBindingCollection van de root Window. De Executed en CanExecute gebeurtenis-handlers zijn gekoppeld aan deze binding en zijn gekoppeld aan de opdracht Close.

Zonder de CommandBinding is er geen opdrachtlogica, alleen een mechanisme om de opdracht aan te roepen. Wanneer op de Button wordt geklikt, wordt de PreviewExecutedRoutedEvent opgeroepen op het doel van de opdracht, gevolgd door de ExecutedRoutedEvent. Deze gebeurtenissen doorlopen de elementstructuur om te zoeken naar een CommandBinding voor die specifieke opdracht. Het is de moeite waard om te vermelden dat, omdat RoutedEvent tunnelt en bubbelt door de elementstructuur, er zorg moet worden gedragen bij het plaatsen van CommandBinding. Als de CommandBinding zich op hetzelfde niveau als het doel van de opdracht bevindt of op een ander knooppunt dat niet op de route van de RoutedEventligt, zal de CommandBinding niet opgevraagd worden.

<Window x:Class="WCSamples.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    Title="CloseCommand"
    Name="RootWindow"
    >
  <Window.CommandBindings>
    <CommandBinding Command="ApplicationCommands.Close"
                    Executed="CloseCommandHandler"
                    CanExecute="CanExecuteHandler"
                    />
  </Window.CommandBindings>
  <StackPanel Name="MainStackPanel">
    <Button Command="ApplicationCommands.Close" 
            Content="Close File" />
  </StackPanel>
</Window>

// Create ui elements.
StackPanel CloseCmdStackPanel = new StackPanel();
Button CloseCmdButton = new Button();
CloseCmdStackPanel.Children.Add(CloseCmdButton);

// Set Button's properties.
CloseCmdButton.Content = "Close File";
CloseCmdButton.Command = ApplicationCommands.Close;

// Create the CommandBinding.
CommandBinding CloseCommandBinding = new CommandBinding(
    ApplicationCommands.Close, CloseCommandHandler, CanExecuteHandler);

// Add the CommandBinding to the root Window.
RootWindow.CommandBindings.Add(CloseCommandBinding);

' Create ui elements.
Dim CloseCmdStackPanel As New StackPanel()
Dim CloseCmdButton As New Button()
CloseCmdStackPanel.Children.Add(CloseCmdButton)

' Set Button's properties.
CloseCmdButton.Content = "Close File"
CloseCmdButton.Command = ApplicationCommands.Close

' Create the CommandBinding.
Dim CloseCommandBinding As New CommandBinding(ApplicationCommands.Close, AddressOf CloseCommandHandler, AddressOf CanExecuteHandler)

' Add the CommandBinding to the root Window.
RootWindow.CommandBindings.Add(CloseCommandBinding)

In het volgende gedeelte van de code worden de Executed en CanExecute gebeurtenis-handlers geïmplementeerd.

De Executed handler roept een methode aan om het geopende bestand te sluiten. De CanExecute handler roept een methode aan om te bepalen of een bestand is geopend. Als een bestand is geopend, wordt CanExecute ingesteld op true; anders is deze ingesteld op false.

// Executed event handler.
private void CloseCommandHandler(object sender, ExecutedRoutedEventArgs e)
{
    // Calls a method to close the file and release resources.
    CloseFile();
}

// CanExecute event handler.
private void CanExecuteHandler(object sender, CanExecuteRoutedEventArgs e)
{
    // Call a method to determine if there is a file open.
    // If there is a file open, then set CanExecute to true.
    if (IsFileOpened())
    {
        e.CanExecute = true;
    }
    // if there is not a file open, then set CanExecute to false.
    else
    {
        e.CanExecute = false;
    }
}

' Executed event handler.
Private Sub CloseCommandHandler(ByVal sender As Object, ByVal e As ExecutedRoutedEventArgs)
    ' Calls a method to close the file and release resources.
    CloseFile()
End Sub

' CanExecute event handler.
Private Sub CanExecuteHandler(ByVal sender As Object, ByVal e As CanExecuteRoutedEventArgs)
    ' Call a method to determine if there is a file open.
    ' If there is a file open, then set CanExecute to true.
    If IsFileOpened() Then
        e.CanExecute = True
    ' if there is not a file open, then set CanExecute to false.
    Else
        e.CanExecute = False
    End If
End Sub

Zie ook