PresentationSource.AddSourceChangedHandler Método

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Adiciona um manipulador para o evento SourceChanged ao elemento fornecido.

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)

Parâmetros

element

IInputElement

O elemento ao qual adicionar o manipulador.

handler

SourceChangedEventHandler

A implementação do manipulador a ser adicionada.

Comentários

Apesar do que o bloco de sintaxe para esse evento afirma, não há nenhum uso legítimo da propriedade anexada XAML (Extensible Application Markup Language). Você não deve tentar adicionar manipuladores em XAML (Extensible Application Markup Language) e os manipuladores no código só devem ser colocados em objetos que servem como hosts para conteúdo de apresentação (PresentationSource). Esses manipuladores só devem ser anexados durante a inicialização do objeto e devem ser explicitamente removidos em um método Dispose ou limpeza de objeto equivalente.

Embora esse seja um evento roteado, há restrições especiais colocadas nesse evento que diferem do comportamento normal de evento roteado, devido ao número relativamente pequeno de elementos em um cenário de aplicativo típico que se preocuparia em lidar com esse evento.

• Você não pode usar os métodos UIElement ou ContentElementAddHandler para adicionar manipuladores. Você deve usar AddSourceChangedHandler.

• Não há suporte para as sintaxes do manipulador de eventos += e -= C# e sintaxes de manipulador específicas de linguagem relacionadas, porque o evento em si não é exposto como público. Somente os PresentationSource métodos utilitários para adicionar e remover os manipuladores diretamente têm suporte.

• Manipuladores de classe não são permitidos. Especificamente, você não pode chamar RegisterClassHandler contra esse evento em um construtor de classe porque, embora exista um campo de identificador para SourceChanged, o identificador não é público.

• Todos os manipuladores registrados receberão o evento SourceChanged mesmo se um dos manipuladores tentar marcar os argumentos como tratados.