Freigeben über


BeginStoryboard Klasse

Definition

Eine Triggeraktion, die ein Storyboard beginnt. Nicht häufig verwendet. Siehe Hinweise.

public ref class BeginStoryboard sealed : TriggerAction
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
/// [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 BeginStoryboard final : TriggerAction
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
[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 BeginStoryboard : TriggerAction
Public NotInheritable Class BeginStoryboard
Inherits TriggerAction
<BeginStoryboard ...>
  singleStoryboard
</BeginStoryboard>
Vererbung
Object Platform::Object IInspectable DependencyObject TriggerAction BeginStoryboard
Attribute

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 jedem element unter Verwendung ihrer XAML-Inhaltseigenschaftssyntax und nicht benötigter Eigenschaftselementtags (z. B. BeginStoryboard.Storyboard) an.

<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 besteht hauptsächlich aus Gründen der Kompatibilität in XAML, die ursprünglich für Microsoft Silverlight verwendet wurde. Für die meisten Szenarien, in denen Ereignistrigger zuvor verwendet wurden, sollten Sie entweder visuelle Zustände verwenden oder Animationen starten, indem Sie einen geladenen Handler schreiben, der eine Animation in Ressourcen auf Seitenebene sucht und dann Begin im Standard Storyboard der Animation aufruft. Weitere Informationen finden Sie unter XAML-Steuerelementvorlagen oder Storyboardanimationen.

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 EventTriggers verwendet werden kann, FrameworkElement.Loaded. Da dies sowohl das Standard- als auch das einzige aktivierte Verhalten ist, legen Sie RoutedEvent nicht fest, und verwenden Sie einfach den XAML-Code <EventTrigger>. Weitere Informationen finden Sie unter Trigger.

Konstruktoren

BeginStoryboard()

Initialisiert eine neue instance der BeginStoryboard-Klasse.

Eigenschaften

Dispatcher

Gibt immer in einer Windows App SDK-App zurücknull. Verwenden Sie stattdessen DispatcherQueue .

(Geerbt von DependencyObject)
DispatcherQueue

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

(Geerbt von DependencyObject)
Storyboard

Ruft das Storyboard ab , das dieses BeginStoryboard startet, oder legt es fest.

StoryboardProperty

Gibt die Abhängigkeitseigenschaft BeginStoryboard.Storyboard an.

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 festgelegt wurde, was 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 registriert wurde, indem RegisterPropertyChangedCallback aufgerufen wurde.

(Geerbt von DependencyObject)

Gilt für:

Weitere Informationen