CanExecuteRoutedEventArgs 類別

定義

命名空間:

System.Windows.Input

組件:

PresentationCore.dll

為 CanExecute 和 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

繼承

Object

EventArgs

RoutedEventArgs

CanExecuteRoutedEventArgs

範例

下列範例會建立 ， CanExecuteRoutedEventHandler 只有在命令目標為 控制項時，才會傳回 true 。 首先， Source 會轉換成 Control。 如果 Source 是 Control， CanExecute 則會設定為 true，否則會設定為 false。

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

備註

一般而言，這類 MenuItem的命令來源會呼叫 CanExecute 上的 RoutedCommand 方法，以判斷命令是否可以或無法在目前的命令目標上執行。 如果 CanExecute 從事件處理程式設定為 false ，命令來源將會停用本身。 例如，如果 MenuItem 做為命令的命令來源，而且命令無法在目前的命令目標上執行，則 MenuItem 會呈現灰色本身。

當命令執行的能力可能已變更時，事件 CanExecuteChanged 會通知命令來源。

屬性

CanExecute	取得或設定值，這個值會指出與這個事件相關聯的 RoutedCommand 是否可以在命令目標上執行。
Command	取得與這個事件相關聯的命令。
ContinueRouting	判斷叫用命令的輸入路由事件是否應繼續透過元素樹狀結構路由。
Handled	取得或設定值，這個值表示路由事件在傳送路由時之事件處理的目前狀態。 (繼承來源 RoutedEventArgs)
OriginalSource	在父類別進行任何可能的 Source 調整之前，取得純點擊測試所判定的原始報告來源。 (繼承來源 RoutedEventArgs)
Parameter	取得命令特有的資料。
RoutedEvent	取得或設定與這個 RoutedEventArgs 執行個體相關聯的 RoutedEvent。 (繼承來源 RoutedEventArgs)
Source	取得或設定引發事件之物件的參考。 (繼承來源 RoutedEventArgs)

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InvokeEventHandler(Delegate, Object)	在衍生類別中覆寫時，提供以特定類型方式叫用事件處理常式的方式，這可透過基底實作來提高效率。 (繼承來源 RoutedEventArgs)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnSetSource(Object)	在衍生類別中覆寫時，每當執行個體的 Source 屬性值變更，便會提供通知回呼進入點。 (繼承來源 RoutedEventArgs)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• CanExecuteRoutedEventHandler
• CommandBinding
• CommandManager