Cómo: Habilitar un comando

En el ejemplo siguiente se muestra cómo usar comandos en Windows Presentation Foundation (WPF). El ejemplo muestra cómo asociar un RoutedCommand a un Button, crear un CommandBinding, y crear los controladores de eventos que implementan el RoutedCommand. Para obtener más información sobre el comando, vea Información general sobre comandos.

Ejemplo

La primera sección de código crea la interfaz de usuario (UI), que consta de Button y StackPanel, y crea un CommandBinding que asocia los controladores de comandos con RoutedCommand.

La Command propiedad de Button está asociada al Close comando .

CommandBinding se agrega a CommandBindingCollection de la raíz Window. Los controladores de eventos Executed y CanExecute están vinculados a este enlace y asociados al comando Close.

Sin CommandBinding, no hay lógica de comandos, solo un mecanismo para invocar el comando. Cuando se hace clic en Button, PreviewExecutedRoutedEvent se genera en el destino del comando seguido de ExecutedRoutedEvent. Estos eventos atraviesan el árbol de elementos buscando un CommandBinding para ese comando determinado. Vale la pena señalar que debido a que los elementos RoutedEvent se transmiten y circulan a través del árbol, se debe tener cuidado al colocar CommandBinding donde corresponde. Si el CommandBinding está en un elemento relacionado con el destino del comando o en otro nodo que no está en la ruta de RoutedEvent, no se tendrá acceso a CommandBinding.

<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 siguiente sección de código implementa los Executed controladores de eventos y CanExecute .

El Executed controlador llama a un método para cerrar el archivo abierto. El CanExecute controlador llama a un método para determinar si un archivo está abierto. Si un archivo está abierto, CanExecute se establece en true; de lo contrario, se establece en 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

Consulte también

• Información general sobre comandos