BeginStoryboard Classe

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Media.Animation

Azione trigger che inizia un storyboard. Non comunemente usato. Vedere la sezione Osservazioni.

public ref class BeginStoryboard sealed : TriggerAction

/// [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="Storyboard")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BeginStoryboard final : TriggerAction

[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="Storyboard")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BeginStoryboard : TriggerAction

Public NotInheritable Class BeginStoryboard
Inherits TriggerAction

<BeginStoryboard ...>
  singleStoryboard
</BeginStoryboard>

Ereditarietà

Object Platform::Object IInspectable DependencyObject TriggerAction BeginStoryboard

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Questo esempio XAML mostra la struttura di base per l'uso di FrameworkElement.Triggers con il comportamento predefinito del trigger FrameworkElement.Loaded per eseguire un'animazione storyboard. Questo CODICE XAML mostra gli elementi del contenitore EventTrigger e BeginStoryboard in relazione appropriata con ognuno usando la sintassi della proprietà del contenuto XAML e i tag degli elementi delle proprietà non necessari (ad esempio BeginStoryboard.Storyboard) omesso.

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

Commenti

I trigger, EventTrigger, Actions e BeginStoryboard non vengono comunemente usati. Queste API esistono principalmente per la compatibilità in XAML originariamente usata per Microsoft Silverlight. Per la maggior parte degli scenari in cui sono stati usati in precedenza i trigger di eventi, è consigliabile usare gli stati visivi o avviare animazioni scrivendo un gestore caricato che cerca un'animazione nelle risorse a livello di pagina e quindi chiama Begin sullo Storyboard principale dell'animazione. Per altre informazioni, vedere Avvio rapido: Modelli di controllo o animazioni storyboard.

Se si sceglie di usare Trigger, in Windows Runtime XAML, il comportamento predefinito per i trigger di eventi e l'unico evento che può essere usato per richiamare un evento EventTrigger è FrameworkElement.Loaded. Poiché è sia il comportamento predefinito che l'unico comportamento abilitato, non si imposta RoutedEvent e si usa solo il codice XAML <EventTrigger>. Per altre informazioni, vedere Trigger.

Costruttori

BeginStoryboard()

Inizializza una nuova istanza della classe BeginStoryboard .

Proprietà

Dispatcher	Ottiene CoreDispatcher associato a questo oggetto. CoreDispatcher rappresenta una struttura che può accedere a DependencyObject nel thread dell'interfaccia utente anche se il codice viene avviato da un thread non interfaccia utente. (Ereditato da DependencyObject)
Storyboard	Ottiene o imposta lo Storyboard avviato da BeginStoryboard .
StoryboardProperty	Identifica la proprietà di dipendenza BeginStoryboard.Storyboard .

Metodi

ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva. (Ereditato da DependencyObject)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza da un oggetto DependencyObject. (Ereditato da DependencyObject)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se viene impostato un valore locale. (Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una funzione di notifica per l'ascolto delle modifiche a un'istanza di DependencyObject specifica. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza in un oggetto DependencyObject. (Ereditato da DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback. (Ereditato da DependencyObject)

Vedi anche

• TriggerAction
• Triggers
• Storyboard
• Guida introduttiva: Modelli di controllo