CanExecuteRoutedEventArgs Classe

Referência

Definição

Namespace:: System.Windows.Input

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece dados para os eventos roteados CanExecute e PreviewCanExecute.

public ref class CanExecuteRoutedEventArgs sealed : System::Windows::RoutedEventArgs

public sealed class CanExecuteRoutedEventArgs : System.Windows.RoutedEventArgs

type CanExecuteRoutedEventArgs = class
    inherit RoutedEventArgs

Public NotInheritable Class CanExecuteRoutedEventArgs
Inherits RoutedEventArgs

Herança: Object

EventArgs

RoutedEventArgs
CanExecuteRoutedEventArgs

Exemplos

O exemplo a seguir cria um CanExecuteRoutedEventHandler que retorna true somente se o destino do comando for um controle . Primeiro, Source é convertido em um Control. Se Source for um Control, CanExecute será definido truecomo ; caso contrário, ele será definido falsecomo .

// CanExecuteRoutedEventHandler that only returns true if
// the source is a control.
private void CanExecuteCustomCommand(object sender, 
    CanExecuteRoutedEventArgs e)
{
    Control target = e.Source as Control;
    
    if(target != null)
    {
        e.CanExecute = true;
    }
    else
    {
        e.CanExecute = false;
    }
}

' CanExecuteRoutedEventHandler that only returns true if
' the source is a control.
Private Sub CanExecuteCustomCommand(ByVal sender As Object, ByVal e As CanExecuteRoutedEventArgs)
    Dim target As Control = TryCast(e.Source, Control)

    If target IsNot Nothing Then
        e.CanExecute = True
    Else
        e.CanExecute = False
    End If
End Sub

Comentários

Normalmente, uma origem de comando, como um MenuItem, chamará o CanExecute método em um RoutedCommand para determinar se o comando pode ou não ser executado no destino de comando atual. Se CanExecute for definido como de false um manipulador de eventos, a origem do comando será desabilitada. Por exemplo, se um MenuItem estiver agindo como a origem do comando para um comando e o comando não puder ser executado no destino de comando atual, o MenuItem ficará esmaecido.

O CanExecuteChanged evento notifica uma fonte de comando quando a capacidade de executar um comando pode ter sido alterada.

Propriedades

CanExecute	Obtém ou define um valor que indica se o RoutedCommand associado a esse evento pode ser executado no destino de comando.
Command	Obtém o comando associado a esse evento.
ContinueRouting	Determina se os eventos roteados de entrada que invocaram o comando devem continuar roteando por meio da árvore de elementos.
Handled	Obtém ou define um valor que indica o estado atual de manipulação de eventos para um evento roteado enquanto ele trafega na rota. (Herdado de RoutedEventArgs)
OriginalSource	Obtém a origem de relatório original conforme determinada pelo teste de clique puro, antes de qualquer ajuste possível da Source por parte de uma classe pai. (Herdado de RoutedEventArgs)
Parameter	Obtém os dados específicos do comando.
RoutedEvent	Obtém ou define o RoutedEvent associado a esta instância do RoutedEventArgs. (Herdado de RoutedEventArgs)
Source	Obtém ou define uma referência ao objeto que ativou o evento. (Herdado de RoutedEventArgs)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InvokeEventHandler(Delegate, Object)	Quando substituído em uma classe derivada, fornece um modo de se invocar os manipuladores de eventos de uma maneira específica a um tipo, que pode aumentar a eficiência com relação à implementação base. (Herdado de RoutedEventArgs)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnSetSource(Object)	Quando substituído em uma classe derivada, fornece um ponto de entrada de retorno de chamada de notificação sempre que o valor da propriedade Source de uma instância muda. (Herdado de RoutedEventArgs)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Partilhar via