EventTrigger Klasse

Definition

Namespace:: Microsoft.UI.Xaml

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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

public ref class EventTrigger sealed : TriggerBase

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Actions")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class EventTrigger final : TriggerBase

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Actions")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class EventTrigger : TriggerBase

Public NotInheritable Class EventTrigger
Inherits TriggerBase

Vererbung: Object Platform::Object IInspectable DependencyObject TriggerBase EventTrigger

Attribute: ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Dieses XAML-Beispiel zeigt die grundlegende Struktur für die Verwendung von FrameworkElement.Triggers mit dem standardmäßigen FrameworkElement.Loaded-Triggerverhalten zum Ausführen einer Storyboardanimation. Dieser XAML-Code zeigt die Containerelemente "EventTrigger" und " BeginStoryboard " in der richtigen Beziehung zu den einzelnen Elementen, die die XAML-Inhaltseigenschaftssyntax und unnötige Eigenschaftselementtags verwenden.

<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 Gründen der Kompatibilität in XAML vorhanden, die ursprünglich für Microsoft Silverlight verwendet wurde. Führen Sie für die meisten Szenarien, in denen Ereignistrigger zuvor verwendet wurden, eine der folgenden Aktionen aus:

Verwenden Sie integrierte Animationen aus der Animationsbibliothek. Siehe Animationen in XAML.
Verwenden Sie für Ereignisse in Steuerelementvorlagen visuelle Zustände und VisualStateManager. Siehe XAML-Steuerelementvorlagen.
Definieren Sie für App-spezifische UI-Animationen einen geladenen Handler auf der Seite. Dieser Handler kann auf ein Storyboard verweisen, das in Ressourcen auf Seitenebene definiert ist, und die Begin-Methode für dieses Storyboard aufrufen. Siehe Storyboardanimationen.

Wenn Sie trigger verwenden, verwenden Sie in Windows-Runtime XAML das Standardverhalten für Ereignistrigger und das einzige Ereignis, das zum Aufrufen eines EventTrigger verwendet werden kann, "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. Unqualifiziertes "Loaded" oder ein anderer Wert löst eine Analyseausnahme aus. Weitere Informationen finden Sie unter Trigger.

Konstruktoren

Name	Beschreibung
EventTrigger()	Initialisiert eine neue Instanz der EventTrigger-Klasse .

Eigenschaften

Name	Beschreibung
Actions	Ruft die Auflistung von BeginStoryboard -Objekten ab, die dieser EventTrigger verwaltet.
Dispatcher	Gibt immer in einer Windows App SDK-App zurück `null` . Verwenden Sie stattdessen DispatcherQueue . (Geerbt von DependencyObject)
DispatcherQueue	Ruft ab `DispatcherQueue` , dem dieses Objekt zugeordnet ist. Dies `DispatcherQueue` stellt eine Einrichtung dar, die auf den `DependencyObject` UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
RoutedEvent	Dient zum Abrufen oder Festlegen des Namens des Ereignisses, das den Trigger initiiert. Häufig nicht festgelegt, finden Sie weitere Informationen unter "Hinweise".

Methoden

Name	Beschreibung
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Gibt einen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, 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 wird. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen. (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

Feedback

War diese Seite hilfreich?