EventSetter Classe

  • Référence

Définition

Espace de noms:
System.Windows
Assembly:
PresentationFramework.dll

Représente une méthode setter d’événement dans un style. Les méthodes setter d’événement appellent les gestionnaires d’événements spécifiés en réponse aux événements.

public ref class EventSetter : System::Windows::SetterBase
public class EventSetter : System.Windows.SetterBase
type EventSetter = class
    inherit SetterBase
Public Class EventSetter
Inherits SetterBase
Héritage
Object
SetterBase
EventSetter

Exemples

L’exemple suivant établit un seul EventSetter style au niveau de la page.

<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>

Voici les exemples de gestionnaires d’événements :

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

Remarques

Les setters d’événements appellent les gestionnaires d’événements spécifiés en réponse aux événements routés, qui s’appliquent à tous les éléments qui font référence Style au lieu de vous obliger à attacher des gestionnaires d’instances à chaque élément individuel. Prend uniquement Style.Setters en charge les EventSetter objets.

Vous pouvez uniquement déclarer des setters d’événements pour les événements routés. Vous pouvez déclarer des setters d’événements pour les événements routés avec une stratégie de routage directe, des événements de propagation ou des événements de tunneling.

Les instances de la EventSetter classe sont généralement créées par le biais du langage XAML (Extensible Application Markup Language), en tant qu’élément objet au sein d’un style défini via XAML. Un EventSetter code peut également être instancié.

Les setters d’événements ne peuvent pas être utilisés dans un style contenu dans un dictionnaire de ressources de thème. En effet, un dictionnaire de ressources de thème au moment de l’exécution est souvent des fichiers XAML binaires libres (BAML) et n’a pas d’étendue définie où le code-behind associé qui définit les gestionnaires peut exister.

Les gestionnaires attachés via des setters d’événements sont appelés après tous les gestionnaires de classes pour un événement, ainsi qu’après tous les gestionnaires d’instances. Par conséquent, si un gestionnaire de classes ou un gestionnaire d’instances marque un événement géré dans ses arguments, le gestionnaire déclaré par un jeu d’événements n’est pas appelé, sauf si le jeu d’événements définit HandledEventsToo truespécifiquement .

Les setters d’événements peuvent également provenir de BasedOn styles. Les gestionnaires setter d’événements du style spécifié, tels qu’ils BasedOn seront appelés après les gestionnaires sur le style immédiat.

Notez que seuls Style.Setters les objets sont pris en charge EventSetter . Les déclencheurs (TriggerBase et les classes dérivées) ne prennent pas en charge EventSetter.

Constructeurs

EventSetter()

Initialise une nouvelle instance de la classe EventSetter.
EventSetter(RoutedEvent, Delegate)

Initialise une nouvelle instance de la classe EventSetter, à l’aide des paramètres d’événement et de gestionnaire fournis.

Propriétés

Event

Obtient ou définit l’événement routé particulier auquel ce EventSetter répond.
HandledEventsToo

Obtient ou définit une valeur qui détermine si le gestionnaire assigné à l'accesseur Set doit encore être appelé, même si l'événement est marqué comme géré dans ses données d'événement.
Handler

Obtient ou définit la référence à un gestionnaire pour un événement routé dans l'accesseur Set.
IsSealed

Obtient une valeur qui indique si cet objet est dans un état non modifiable.

(Hérité de SetterBase)

Méthodes

CheckSealed()

Vérifie si cet objet est en lecture seule et ne peut pas être modifié.

(Hérité de SetterBase)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi