Поделиться через


PresentationSource.AddSourceChangedHandler Метод

Определение

Добавляет обработчик события SourceChanged в предоставленный элемент.

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

Параметры

element
IInputElement

Элемент, в который добавляется обработчик.

handler
SourceChangedEventHandler

Добавленная реализация обработчика.

Атрибуты

Комментарии

Несмотря на то, что блок синтаксиса для этих состояний событий, нет допустимого использования присоединенного свойства расширяемого языка разметки приложений (XAML). Не следует пытаться добавлять обработчики в язык разметки расширяемых приложений (XAML), а обработчики кода должны размещаться только на объектах, которые служат в качестве узлов для презентации (PresentationSource) содержимого. Такие обработчики должны быть присоединены только во время инициализации объектов и должны быть явно удалены в методе Dispose или эквивалентной очистке объектов.

Несмотря на то, что это перенаправленное событие, существуют специальные ограничения, которые отличаются от обычного поведения перенаправленного события, из-за относительно небольшого количества элементов в типичном сценарии приложения, которые будут беспокоиться об обработке этого события.

  • Нельзя использовать методы UIElement или ContentElementAddHandler для добавления обработчиков. Необходимо использовать AddSourceChangedHandler.

  • Синтаксисы обработчиков событий на языке C +=# и -= и связанные с языком синтаксисы обработчиков не поддерживаются, так как само событие не предоставляется как общедоступное. Поддерживаются только методы PresentationSource служебной программы для добавления и удаления обработчиков напрямую.

  • Обработчики классов не допускаются. В частности, нельзя вызывать RegisterClassHandler к этому событию в конструкторе классов, так как хотя поле идентификатора существует для SourceChanged, идентификатор не является общедоступным.

  • Все зарегистрированные обработчики получат событие SourceChanged, даже если один из обработчиков пытается пометить аргументы как обрабатываемые.

Применяется к