PresentationSource.AddSourceChangedHandler Método

Definição

Espaço de Nomes:

System.Windows

Assemblagem:

PresentationCore.dll

Adiciona um handler para o SourceChanged evento ao 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);

[<System.Security.SecurityCritical>]
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 para adicionar o handler.

handler

SourceChangedEventHandler

A implementação do handler para adicionar.

Atributos

SecurityCriticalAttribute

Observações

Apesar do que o bloco de sintaxe deste evento afirma, não existe um uso legítimo de propriedade associada à Extensible Application Markup Language (XAML). Não deve tentar adicionar handlers na Extensible Application Markup Language (XAML), e os handlers no código só devem ser colocados em objetos que servem como hosts para conteúdo de apresentação (PresentationSource ). Tais handlers só devem ser anexados durante a inicialização do objeto e devem ser explicitamente removidos num método Dispose ou numa limpeza equivalente de objetos.

Apesar de ser um evento encaminhado, existem restrições especiais impostas a este evento que diferem do comportamento normal de eventos encaminhados, devido ao número relativamente pequeno de elementos num cenário típico de aplicação que se preocupariam em lidar com este evento.

• Não podes usar os UIElement métodos ou ContentElementAddHandler para adicionar handlers. Você deve usar AddSourceChangedHandler.

• As sintaxes C# += e -= do handler de eventos, bem como as sintaxes de handler específicas da linguagem relacionadas, não são suportadas, porque o evento em si não é exposto como público. Apenas os PresentationSource métodos utilitários para adicionar e remover diretamente os manipuladores são suportados.

• Não são permitidos manipuladores de classe. Especificamente, não pode chamar RegisterClassHandler contra este evento num construtor de classe porque, embora exista um campo identificador para o SourceChanged, o identificador não é público.

• Todos os handlers registados receberão o evento SourceChanged mesmo que um dos handlers tente marcar os argumentos como tratados.