RoutedCommand.CanExecute(Object, IInputElement) Método

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Determina se este RoutedCommand pode ser executado em seu estado atual.

public:
 bool CanExecute(System::Object ^ parameter, System::Windows::IInputElement ^ target);

public bool CanExecute (object parameter, System.Windows.IInputElement target);

member this.CanExecute : obj * System.Windows.IInputElement -> bool

Public Function CanExecute (parameter As Object, target As IInputElement) As Boolean

Parâmetros

parameter

Object

Um tipo de dados definido pelo usuário.

target

IInputElement

O destino do comando.

Retornos

Boolean

true se o comando puder ser executado no destino de comando atual; caso contrário, false.

Exceções

InvalidOperationException

target não é um UIElement ou ContentElement.

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

A lógica real que determina se um RoutedCommand pode ser executado no destino de comando atual não está contido nos CanExecute métodos, em vez disso CanExecute gera o PreviewCanExecute e os CanExecute eventos que túnel e bolha através da árvore de elementos procurando um objeto com um CommandBinding. Se um CommandBinding for RoutedCommand encontrado, o CanExecuteRoutedEventHandler anexado será CommandBinding chamado. Esses manipuladores fornecem a lógica de programação para determinar se o RoutedCommand pode ser executado ou não.

Os PreviewCanExecute eventos e PreviewExecuted são gerados no CommandTarget. Se o CommandTarget não estiver definido no ICommandSource, os PreviewCanExecute eventos e CanExecute serão gerados no elemento com foco no teclado.