Freigeben über


EventTrigger Klasse

Definition

Stellt einen Trigger dar, der eine Reihe von Aktionen (Animations-Storyboards) als Reaktion auf ein Ereignis anwendet. Nicht häufig verwendet. Siehe Hinweise.

public ref class EventTrigger sealed : TriggerBase
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
class EventTrigger final : TriggerBase
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class EventTrigger final : TriggerBase
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
public sealed class EventTrigger : TriggerBase
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class EventTrigger : TriggerBase
Public NotInheritable Class EventTrigger
Inherits TriggerBase
<EventTrigger>
  oneOrMoreBeginStoryboards
</EventTrigger>
 
Vererbung
Object Platform::Object IInspectable DependencyObject TriggerBase EventTrigger
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Dieses XAML-Beispiel zeigt die grundlegende Struktur für die Verwendung von FrameworkElement.Triggers mit dem standardmäßigenFrameworkElement.Loaded-Triggerverhalten zum Ausführen einer Storyboardanimation. Dieser XAML-Code zeigt die EventTrigger- und BeginStoryboard-Containerelemente in einer ordnungsgemäßen Beziehung zu beiden an, wobei die XAML-Inhaltseigenschaftensyntax und nicht benötigte Eigenschaftselementtags verwendet werden.

<Canvas Width="200" Height="200" x:Name="animatedcanvas" Background="Red">
    <Canvas.Triggers>
        <EventTrigger>
            <BeginStoryboard>
                <Storyboard x:Name="ColorStoryboard">
                   <!-- Animate the background of the canvas to green over 4 seconds. -->
                    <ColorAnimation Storyboard.TargetName="animatedcanvas"
                      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"
                      To="Green" Duration="0:0:4"/>
                </Storyboard>
            </BeginStoryboard>
        </EventTrigger>
    </Canvas.Triggers>
</Canvas>

Hinweise

Trigger, EventTrigger, Actions und BeginStoryboard werden häufig nicht verwendet. Diese API ist hauptsächlich aus Kompatibilitätsgründen in XAML vorhanden, die ursprünglich für Microsoft Silverlight verwendet wurde. Führen Sie für die meisten Szenarien, in denen zuvor Ereignistrigger verwendet wurden, eine der folgenden Aktionen aus:

Wenn Sie sich für die Verwendung von Triggern entscheiden, ist in Windows-Runtime XAML das Standardverhalten für Ereignistrigger, und das einzige Ereignis, das zum Aufrufen eines EventTrigger verwendet werden kann, ist FrameworkElement.Loaded. Da dies sowohl das Standardverhalten als auch das einzige aktivierte Verhalten ist, legen Sie das RoutedEvent-Attribut nicht fest. Verwenden Sie einfach den XAML-Code <EventTrigger>. Wenn Sie RoutedEvent explizit festlegen (nicht empfohlen), ist <EventTrigger RoutedEvent="FrameworkElement.Loaded">der einzige XAML-Code, der funktioniert. Nicht qualifiziertes "Loaded" oder ein anderer Wert löst eine Analyseausnahme aus. Weitere Informationen finden Sie unter Trigger.

Konstruktoren

EventTrigger()

Initialisiert eine neue instance der EventTrigger-Klasse.

Eigenschaften

Actions

Ruft die Auflistung von BeginStoryboard-Objekten ab, die von diesem EventTrigger verwaltet werden.

Dispatcher

Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das DependencyObject im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird.

(Geerbt von DependencyObject)
RoutedEvent

Ruft den Namen des Ereignisses ab, das den Trigger initiiert, oder legt diesen fest. Nicht häufig festgelegt, siehe Hinweise.

Methoden

ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Abhängigkeitseigenschaft.

(Geerbt von DependencyObject)
GetAnimationBaseValue(DependencyProperty)

Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, der in Fällen gilt, in denen eine Animation nicht aktiv ist.

(Geerbt von DependencyObject)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück.

(Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist.

(Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest.

(Geerbt von DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert wurde.

(Geerbt von DependencyObject)

Gilt für:

Weitere Informationen