BeginStoryboard Classe

Définition

Espace de noms:

Windows.UI.Xaml.Media.Animation

Action de déclencheur qui commence un Storyboard. Ce n’est pas couramment utilisé. Consultez la section Notes.

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>

Héritage

Object Platform::Object IInspectable DependencyObject TriggerAction BeginStoryboard

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple XAML montre la structure de base pour l’utilisation de FrameworkElement.Triggers avec son comportement de déclencheur FrameworkElement.Loaded par défaut pour exécuter une animation de table de montage séquentiel. Ce code XAML montre les éléments conteneur EventTrigger et BeginStoryboard dans une relation appropriée avec chacun d’eux à l’aide de leur syntaxe de propriété de contenu XAML et des balises d’élément de propriété inutiles (telles que BeginStoryboard.Storyboard) omises.

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

Remarques

Les déclencheurs, EventTrigger, Actions et BeginStoryboard ne sont pas couramment utilisés. Ces API existent principalement pour la compatibilité dans XAML utilisé à l’origine pour Microsoft Silverlight. Pour la plupart des scénarios où des déclencheurs d’événement ont été utilisés précédemment, vous devez utiliser des états visuels ou démarrer des animations en écrivant un gestionnaire Chargé qui recherche une animation dans les ressources au niveau de la page, puis appelle Begin sur le storyboard main de l’animation. Pour plus d’informations, consultez Démarrage rapide : Modèles de contrôle ou animations de storyboard.

Si vous choisissez d’utiliser des déclencheurs, dans Windows Runtime XAML, le comportement par défaut des déclencheurs d’événements et le seul événement qui peut être utilisé pour appeler un EventTrigger est FrameworkElement.Loaded. Étant donné qu’il s’agit à la fois du comportement par défaut et du seul comportement activé, vous ne définissez pas RoutedEvent et utilisez simplement le code XAML <EventTrigger>. Pour plus d’informations, consultez Déclencheurs.

Constructeurs

BeginStoryboard()

Initialise une nouvelle instance de la classe BeginStoryboard.

Propriétés

Dispatcher	Obtient le CoreDispatcher auquel cet objet est associé. CoreDispatcher représente une fonctionnalité qui peut accéder à DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur. (Hérité de DependencyObject)
Storyboard	Obtient ou définit le Storyboard que ce BeginStoryboard démarre.
StoryboardProperty	Identifie la propriété de dépendance BeginStoryboard.Storyboard .

Méthodes

ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Retourne toute valeur de base établie pour une propriété de dépendance, qui s’appliquerait dans les cas où une animation n’est pas active. (Hérité de DependencyObject)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un DependencyObject. (Hérité de DependencyObject)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject)

Voir aussi

• TriggerAction
• Triggers
• Storyboard
• Démarrage rapide : Modèles de contrôle