PresentationSource.AddSourceChangedHandler 方法

定義

命名空間:

System.Windows

組件:

PresentationCore.dll

將 SourceChanged 事件的處理程式新增至提供的 元素。

public:
 static void AddSourceChangedHandler(System::Windows::IInputElement ^ element, System::Windows::SourceChangedEventHandler ^ handler);

public static void AddSourceChangedHandler (System.Windows.IInputElement element, System.Windows.SourceChangedEventHandler handler);

static member AddSourceChangedHandler : System.Windows.IInputElement * System.Windows.SourceChangedEventHandler -> unit

Public Shared Sub AddSourceChangedHandler (element As IInputElement, handler As SourceChangedEventHandler)

參數

element

IInputElement

要加入處理程序的專案。

handler

SourceChangedEventHandler

要加入的處理程序實作。

備註

儘管此事件狀態的語法區塊為何，但沒有任何合法的Extensible Application Markup Language （XAML） 附加屬性使用方式。 您不應該嘗試在 Extensible Application Markup Language （XAML） 中新增處理程式，而程式代碼中的處理程式應該只放在做為簡報 （PresentationSource） 內容的主機的物件上。 這類處理程式應該只在物件初始化期間附加，而且應該在 Dispose 方法或對等物件清除中明確移除。

即使這是路由事件，但此事件有與一般路由事件行為不同的特殊限制，因為一般應用程式案例中相對較少的元素會擔心處理此事件。

• 您無法使用 UIElement 或 ContentElementAddHandler 方法來新增處理程式。 您必須使用 AddSourceChangedHandler。

• 不支援 C# += 和 -= 事件處理程式語法，以及相關的語言特定處理程式語法，因為事件本身不會公開為公用。 僅支援直接新增和移除處理程式 PresentationSource 公用程式方法。

• 不允許類別處理程式。 具體而言，您無法針對類別建構函式中的這個事件呼叫 RegisterClassHandler，因為雖然 SourceChanged 的標識符字段存在，但標識元不是公用的。

• 即使其中一個處理程式嘗試將自變數標示為已處理，所有已註冊的處理程式仍會收到SourceChanged事件。