PresentationSource.AddSourceChangedHandler(IInputElement, SourceChangedEventHandler) 메서드

정의

SourceChanged 이벤트에 대한 처리기를 제공된 요소에 추가합니다.Adds a handler for the SourceChanged event to the provided element.

public:
 static void AddSourceChangedHandler(System::Windows::IInputElement ^ element, System::Windows::SourceChangedEventHandler ^ handler);
public static void AddSourceChangedHandler (System.Windows.IInputElement element, System.Windows.SourceChangedEventHandler handler);
[System.Security.SecurityCritical]
public static void AddSourceChangedHandler (System.Windows.IInputElement element, System.Windows.SourceChangedEventHandler handler);
static member AddSourceChangedHandler : System.Windows.IInputElement * System.Windows.SourceChangedEventHandler -> unit
[<System.Security.SecurityCritical>]
static member AddSourceChangedHandler : System.Windows.IInputElement * System.Windows.SourceChangedEventHandler -> unit
Public Shared Sub AddSourceChangedHandler (element As IInputElement, handler As SourceChangedEventHandler)

매개 변수

element
IInputElement

처리기를 추가할 요소입니다.The element to add the handler to.

handler
SourceChangedEventHandler

추가할 처리기 구현입니다.The handler implementation to add.

특성

설명

이 이벤트의 구문 블록에도 불구 하 고 적절 한 XAML(Extensible Application Markup Language)Extensible Application Markup Language (XAML) 연결 된 속성 사용은 없습니다.Despite what the syntax block for this event states, there is no legitimate XAML(Extensible Application Markup Language)Extensible Application Markup Language (XAML) attached property usage. 에서 처리기를 추가 하려고 해서는 안 XAML(Extensible Application Markup Language)Extensible Application Markup Language (XAML) 되며, 코드의 처리기는 프레젠테이션 () 콘텐츠의 호스트로 사용 되는 개체에만 배치 되어야 합니다 PresentationSource .You should not attempt to add handlers in XAML(Extensible Application Markup Language)Extensible Application Markup Language (XAML), and handlers in code should only be placed on objects that serve as hosts for presentation (PresentationSource ) content. 이러한 처리기는 개체를 초기화 하는 동안에만 연결 해야 하며, Dispose 메서드나 동등한 개체 정리에서 명시적으로 제거 해야 합니다.Such handlers should only be attached during object initialization, and should be explicitly removed in a Dispose method or equivalent object cleanup.

특별 한 제한이이 이벤트는 고려할이 처리 하는 일반적인 애플리케이션 시나리오에서 요소의 상대적으로 적은 수로 인해 일반적인 라우트된 이벤트 동작은 다른 가지 라우트된 이벤트 인 경우에 이벤트입니다.Even though this is a routed event, there are special restrictions placed on this event that differ from normal routed event behavior, due to the relatively small number of elements in a typical application scenario that would concern themselves with handling this event.

  • 또는 메서드를 사용 UIElement ContentElement AddHandler 하 여 처리기를 추가할 수 없습니다.You cannot use the UIElement or ContentElement AddHandler methods to add handlers. AddSourceChangedHandler을 사용해야 합니다.You must use AddSourceChangedHandler.

  • += -= 이벤트 자체가 public으로 노출 되지 않기 때문에 c # 및 이벤트 처리기 구문과 관련 언어 관련 처리기 구문은 지원 되지 않습니다.The C# += and -= event handler syntaxes, and related language-specific handler syntaxes, are not supported, because the event itself is not exposed as public. PresentationSource처리기를 직접 추가 하 고 제거 하는 유틸리티 메서드만 지원 됩니다.Only the PresentationSource utility methods for adding and removing the handlers directly are supported.

  • 클래스 처리기는 허용 되지 않습니다.Class handlers are not allowed. 특히 RegisterClassHandler SourceChanged에 대 한 식별자 필드가 존재 하지만 식별자가 public이 아니기 때문에 클래스 생성자에서이 이벤트에 대해를 호출할 수 없습니다.Specifically, you cannot call RegisterClassHandler against this event in a class constructor because although an identifier field exists for SourceChanged, the identifier is not public.

  • 처리기 중 하나가 인수를 처리 된 것으로 표시 하려고 하는 경우에도 등록 된 처리기는 모두 SourceChanged 이벤트를 수신 합니다.All registered handlers will receive the SourceChanged event even if one of the handlers attempts to mark the arguments as handled.

적용 대상