PresentationSource.AddSourceChangedHandler Método

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Adiciona um manipulador para o evento SourceChanged para o elemento fornecido.

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)

Parâmetros

element

IInputElement

O elemento ao qual adicionar o manipulador.

handler

SourceChangedEventHandler

A implementação do manipulador a adicionar.

Atributos

SecurityCriticalAttribute

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 na 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 do 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 UIElement métodos ou ContentElement AddHandler adicionar manipuladores. É necessário usar AddSourceChangedHandler.

• Não há suporte para 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. Há suporte apenas para os PresentationSource métodos utilitários para adicionar e remover os manipuladores diretamente.

• Manipuladores de classe não são permitidos. Especificamente, você não pode chamar RegisterClassHandler 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.