Partager via

Comment : activer une commande

  • Article

L’exemple suivant montre comment utiliser des commandes dans WPF (Windows Presentation Foundation). L’exemple montre comment associer un RoutedCommand à un Button, créer un CommandBindinget créer les gestionnaires d’événements qui implémentent le RoutedCommand. Pour plus d’informations sur la commande, consultez la vue d’ensemble de la commande.

Exemple

La première section du code crée l’interface utilisateur (UI), qui se compose d’un Button et d’un StackPanel, et crée un CommandBinding qui associe les gestionnaires de commandes au RoutedCommand.

La Command propriété du fichier Button est associée à la Close commande.

Il CommandBinding est ajouté à la CommandBindingCollection racine Window. Les Executed gestionnaires d’événements et CanExecute les gestionnaires d’événements sont attachés à cette liaison et associés à la Close commande.

Sans aucune CommandBinding logique de commande, seul un mécanisme pour appeler la commande. Lorsque le Button clic est effectué, celui-ci PreviewExecuted RoutedEvent est déclenché sur la cible de commande suivie du Executed RoutedEvent. Ces événements parcourent l’arborescence d’éléments à la recherche d’une CommandBinding commande particulière. Il vaut la peine de noter que parce que RoutedEvent tunnel et bulle à travers l’arbre d’élément, vous devez prendre soin de l’endroit où l’on CommandBinding met. Si l’utilisateur CommandBinding se trouve sur un frère de la cible de commande ou d’un autre nœud qui n’est pas sur l’itinéraire du RoutedEvent, il CommandBinding n’est pas accessible.

<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)

La section suivante du code implémente les gestionnaires d’événements et CanExecute les Executed gestionnaires d’événements.

Le Executed gestionnaire appelle une méthode pour fermer le fichier ouvert. Le CanExecute gestionnaire appelle une méthode pour déterminer si un fichier est ouvert. Si un fichier est ouvert, CanExecute est défini sur true; sinon, il est défini sur 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

Voir aussi