RoutedCommand.CanExecuteChanged Evento

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Ocorre quando alterações na fonte de comando são detectadas pelo gerenciador de comandos. Geralmente, essas alterações afetam se o comando deve ser executado no destino de comando atual.

public:
 virtual event EventHandler ^ CanExecuteChanged;

public event EventHandler CanExecuteChanged;

member this.CanExecuteChanged : EventHandler 

Public Custom Event CanExecuteChanged As EventHandler 

Tipo de evento

EventHandler

Implementações

CanExecuteChanged

Exemplos

O exemplo a seguir é um CanExecuteChanged manipulador de eventos de uma implementação personalizada de ICommandSource.

this.Command neste exemplo, é a Command propriedade no ICommandSource. Se o comando não nullfor , o comando será convertido em um RoutedCommand. Se o comando for um RoutedCommand, o CanExecute método será chamado passando o CommandTarget e o CommandParameter. Se o comando não for um RoutedCommand, ele será convertido em um ICommand e o CanExecute método será chamado passando o CommandParameter.

Se o CanExecute método retornar true, o controle será habilitado; caso contrário, o controle será desabilitado.

private void CanExecuteChanged(object sender, EventArgs e)
{

    if (this.Command != null)
    {
        RoutedCommand command = this.Command as RoutedCommand;

        // If a RoutedCommand.
        if (command != null)
        {
            if (command.CanExecute(CommandParameter, CommandTarget))
            {
                this.IsEnabled = true;
            }
            else
            {
                this.IsEnabled = false;
            }
        }
        // If a not RoutedCommand.
        else
        {
            if (Command.CanExecute(CommandParameter))
            {
                this.IsEnabled = true;
            }
            else
            {
                this.IsEnabled = false;
            }
        }
    }
}

Private Sub CanExecuteChanged(ByVal sender As Object, ByVal e As EventArgs)

    If Me.Command IsNot Nothing Then
        Dim command As RoutedCommand = TryCast(Me.Command, RoutedCommand)

        ' If a RoutedCommand.
        If command IsNot Nothing Then
            If command.CanExecute(CommandParameter, CommandTarget) Then
                Me.IsEnabled = True
            Else
                Me.IsEnabled = False
            End If
            ' If a not RoutedCommand.
        Else
            If Me.Command.CanExecute(CommandParameter) Then
                Me.IsEnabled = True
            Else
                Me.IsEnabled = False
            End If
        End If
    End If
End Sub

Comentários

O RoutedCommand escuta o RequerySuggested evento , que é gerado pelo CommandManager. O RequerySuggested evento é gerado sempre que as condições são atendidas que podem alterar se o comando deve ser executado, como uma alteração no foco do teclado. Quando o comando recebe o RequerySuggested evento, ele aciona o CanExecuteChanged evento. Em geral, a origem do comando escutará esse evento e consultará o RoutedCommand por meio do CanExecute método . A maioria das fontes de comando será desabilitada se o comando não puder ser executado, como parte de sua associação de comando. Um exemplo disso é quando um MenuItem cinza se esgota quando o comando não pode ser executado.

Em algumas situações, o CommandManager desconhece uma alteração nas condições que altera a capacidade de executar um comando. Nesses casos, você pode forçar o CommandManager a gerar o RequerySuggested evento chamando o InvalidateRequerySuggested método , isso, por sua vez, fará com que o RoutedCommand gere o CanExecuteChanged evento.