EventSetter Classe

Definição

public ref class EventSetter : System::Windows::SetterBase

public class EventSetter : System.Windows.SetterBase

type EventSetter = class
    inherit SetterBase

Public Class EventSetter
Inherits SetterBase

Herança

Object

SetterBase

EventSetter

Exemplos

O exemplo a seguir estabelece um único EventSetter em um estilo de nível de página.

<StackPanel
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.EventOvw2"
  Name="dpanel2"
  Initialized="PrimeHandledToo"
>
  <StackPanel.Resources>
    <Style TargetType="{x:Type Button}">
      <EventSetter Event="Click" Handler="b1SetColor"/>
    </Style>
  </StackPanel.Resources>
  <Button>Click me</Button>
  <Button Name="ThisButton" Click="HandleThis">
    Raise event, handle it, use handled=true handler to get it anyway.
  </Button>
</StackPanel>

O seguinte mostra os manipuladores de eventos de exemplo:

void b1SetColor(object sender, RoutedEventArgs e)
{
  Button b = e.Source as Button;
  b.Background = new SolidColorBrush(Colors.Azure);
}

void HandleThis(object sender, RoutedEventArgs e)
{
  e.Handled=true;
}

Private Sub b1SetColor(ByVal sender As Object, ByVal e As RoutedEventArgs)
  Dim b As Button = TryCast(e.Source, Button)
  b.Background = New SolidColorBrush(Colors.Azure)
End Sub

Private Sub HandleThis(ByVal sender As Object, ByVal e As RoutedEventArgs)
  e.Handled=True
End Sub

Comentários

Os setters de evento invocam os manipuladores de eventos especificados em resposta a eventos roteados, que se aplicam a todos os elementos que fazem referência à Style em vez de exigir que você anexe manipuladores de instância a cada elemento individual. Somente Style.Setters dar suporte a objetos EventSetter.

Você só pode declarar setters de eventos para eventos roteado. Você pode declarar setters de eventos para eventos roteado com uma estratégia de roteamento direto, eventos de borbulha ou eventos de túnel.

As instâncias da classe EventSetter geralmente são criadas por meio da XAML (Extensible Application Markup Language), como um elemento de objeto dentro de um estilo definido por meio de XAML. Um EventSetter também pode ser instanciado do código.

Os setters de eventos não podem ser usados em um estilo contido em um dicionário de recursos de tema. Isso ocorre porque um dicionário de recursos de tema em tempo de execução geralmente é arquivos BINÁRIOS XAML (BAML) e não tem nenhum escopo definido onde o code-behind que acompanha os manipuladores pode existir.

Os manipuladores anexados por meio de setters de eventos são invocados após qualquer manipulador de classe para um evento e também após qualquer manipulador de instância. Como resultado, se um manipulador de classe ou manipulador de instância marcar um evento tratado em seus argumentos, o manipulador declarado por um setter de eventos não será invocado, a menos que o setter de eventos defina especificamente HandledEventsTootrue.

Os setters de eventos também podem vir de estilos de BasedOn. Os manipuladores de setter de eventos do estilo especificado como BasedOn serão invocados após os manipuladores no estilo imediato.

Observe que apenas Style.Setters dá suporte a objetos EventSetter. Gatilhos (TriggerBase e classes derivadas) não dão suporte a EventSetter.

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• Handled
• AddHandler(RoutedEvent, Delegate, Boolean)