Windows Dev Center

RepeatBehavior Structure

Décrit comment une Timeline répète sa durée simple.

Syntaxe


public struct RepeatBehavior


<object property="iterationsx"/>
- or -
<object property="[days.]hours:minutes:seconds[.fractionalSeconds]"/>
- or -
<object property="Forever"/>

XAML Values

iterationsx

L'espace réservé d'iterationsdans le formulaire d'itérations est un entier, qui spécifie le nombre de fois qu'une animation doit se répéter. Le x est un caractère littéral x en minuscules. (Pour vous souvenir de cette convention, vous pouvez penser au signe de multiplication x ; autrement dit, "3x" signifie "3 fois".) Les itérations définissent les données Count ; une valeur TimeSpan ne définit pas les données Count.

days

Facultatif. Valeur entière supérieure ou égale à 0 qui indique le nombre de jours.

hours

Requis, même si 0. Valeur entière entre 0 et 23 qui spécifie le nombre d'heures.

minutes

(Facultatif) Si seules les heures sont souhaitées, mais doivent être définies sur au moins 0 pour pouvoir définir une valeur de seconds. Entier entre 0 et 59 qui spécifie le nombre de minutes.

seconds

Facultatif si seules les heures/minutes sont souhaitées. Entier entre 0 et 59 qui spécifie le nombre de secondes.

fractionalSeconds

Facultatif. Valeur composée d'une précision décimale de 1 à 7 chiffres qui spécifie une durée en fractions de seconde.

Forever

Littéral "Forever". Consultez la section Notes.

Attributs

[Version(0x06020000)]
[WebHostHidden()]

Membres

RepeatBehaviorStructure possède ces types de membres :

Constructeurs

RepeatBehaviorStructure possède ces constructeurs.

ConstructeurDescription
RepeatBehavior(Double) Initializes a new instance of the RepeatBehavior structure with the specified iteration count.
RepeatBehavior(TimeSpan) Initializes a new instance of the RepeatBehavior structure with the specified repeat duration.

 

Champs

RepeatBehaviorStructure possède ces champs.

ChampType de donnéesDescription
Count

System.Double [.NET] | float64 [C++]

Nombre de fois que le Timeline doit se répéter.

Duration

System.TimeSpan [.NET] | Windows::Foundation::TimeSpan [C++]

Intervalle de temps pour lequel un Timeline doit se répéter.

Type

RepeatBehaviorType

Mode ou type de comportement de répétition représenté par cette instance, comme valeur de l'énumération.

 

Méthodes

The RepeatBehavior Structure a les méthodes suivantes. Elle hérite également des méthodes de Object Classe.

MéthodeDescription
Equals(Object) [C#, VB]Determines whether the specified object is equal to a RepeatBehavior.
Equals(RepeatBehavior) [C#, VB]Compares two RepeatBehavior structures for equality.
Equals(RepeatBehavior,RepeatBehavior) [C#, VB]Compares two RepeatBehavior structures for equality, as a static helper method.
GetHashCode [C#, VB]Gets a hash code for this object.
ToString [C#, VB]Converts a RepeatBehavior to a String representation.
ToString(IFormatProvider) [C#, VB]Creates a String representation of this RepeatBehavior.

 

Opérateurs

RepeatBehaviorStructure possède ces opérateurs.

OpérateurDescription
Equality Compares two RepeatBehavior structures for equality.
Inequality Compares two RepeatBehavior structures for inequality.

 

Propriétés

Le RepeatBehaviorStructure a les propriétés suivantes.

PropriétéType d'accèsDescription

Count

Lecture/écritureGets or sets the number of times that a Timeline should repeat.

Duration

Lecture/écritureGets or sets the total length of time that a Timeline should play.

Forever

En lecture seuleGets a RepeatBehavior that specifies an infinite number of repetitions.

HasCount

En lecture seuleGets a value that indicates whether the repeat behavior has a specified iteration count.

HasDuration

En lecture seuleGets a value that indicates whether the repeat behavior has a specified repeat duration.

Type

Lecture/écritureGets or sets one of the RepeatBehaviorType values that describes the way behavior repeats.

 

Remarques

Il existe trois types de comportements RepeatBehavior :

  • Intervalle de temps : spécifie la durée active d'une Timeline, en répétant éventuellement l'animation si la Timeline.Duration est plus courte. Par exemple, Timeline avec une valeur Timeline.Duration simple de 1 seconde et une valeur RepeatBehavior.Duration de 2,5 secondes est exécuté à raison de 2,5 itérations pendant 2,5 secondes.
  • Nombre d'itérations : spécifie le nombre de répétitions de la durée simple d'un Timeline. Le nombre d'itérations par défaut est 1.0. Cela signifie que Timeline est actif pendant exactement l'une de ses durées simples. Lorsque le nombre d'itérations équivaut à 0,5, cela signifie que la chronologie est active pour la moitié de sa durée simple. Lorsque le nombre d'itérations équivaut à 2, cela signifie que la chronologie répète deux fois sa durée simple. Pour plus d'informations, consultez Count.
  • Forever : Timeline se répète indéfiniment.

RepeatBehavior doit contenir des valeurs différentes de zéro pour une de ses deux propriétés de données possibles Count ou Duration. Si RepeatBehaviorType a la valeur Count, le membre Count d'un RepeatBehavior a la valeur appropriée. Si RepeatBehaviorType a la valeur Duration, le membre Duration d'un RepeatBehavior a la valeur appropriée. Si RepeatBehaviorType est Forever, alors ni Count, ni Duration ne sont appropriés ; le comportement de répétition est telle que l'animation ciblée sera répété continuellement sans limite.

Remarques sur la syntaxe XAML

Vous ne pouvez pas déclarer de RepeatBehavior comme un objet utilisable, partageable dans un ResourceDictionary.

Projection et membres de RepeatBehavior

Si vous utilisez un langage Microsoft .NET (C# ou Microsoft Visual Basic), RepeatBehavior possède des données non membres, et ses données membres Count, Duration et Type sont exposées en tant que propriétés en lecture/écriture et non en tant que champs.

Si vous utilisez les extensions de composants Visual C++ (C++/CX), RepeatBehavior possède des membres qui ne sont pas des données et ses membres de données Count, Duration et Type sont exposés en tant que propriétés en lecture seule et non en tant que champs.

Si vous programmez en C++ à l'aide de la bibliothèque de modèles Windows Runtime (WRL), seuls les champs des données membres Count, Duration et Type existent en tant que membres de RepeatBehavior, et vous ne pouvez pas utiliser les méthodes ou propriétés utilitaires répertoriées dans le tableau des membres. Le code WRL peut accéder aux méthodes utilitaires semblables qui existent dans la classe RepeatBehaviorHelper.

Exemples

Cet exemple illustre plusieurs méthodes différentes pour définir le RepeatBehavior d'une animation et la façon dont ces paramètres peuvent affecter votre animation.


<StackPanel Margin="20">
    <StackPanel.Resources>
        <Storyboard x:Name="myStoryboard">

            <!-- Create an animation that repeats indefinitely. -->
            <DoubleAnimation 
              Storyboard.TargetName="ForeverRepeatingTransform" 
              Storyboard.TargetProperty="ScaleX" 
              From="1" To="5" Duration="0:0:2" RepeatBehavior="Forever" />

            <!-- Create an animation that repeats for four seconds. Because
                 the animation is 2 seconds each, you get two repeats. -->
            <DoubleAnimation 
              Storyboard.TargetName="FourSecondsRepeatingTransform" 
              Storyboard.TargetProperty="ScaleX"
              From="1" To="5" Duration="0:0:2" RepeatBehavior="0:0:4" 
              EnableDependentAnimation="True"/>

            <!-- Create an animation that repeats twice. -->
            <DoubleAnimation 
              Storyboard.TargetName="TwiceRepeatingTransform" 
              Storyboard.TargetProperty="ScaleX" 
              From="1" To="5" Duration="0:0:2" RepeatBehavior="2x" 
              EnableDependentAnimation="True"/>

            <!-- Create an animation that repeats 0.5 times. The resulting animation
                 plays for one second, half of its Duration. It animates from 50 to 150. -->
            <DoubleAnimation 
              Storyboard.TargetName="HalfRepeatingTransform" 
              Storyboard.TargetProperty="ScaleX" 
              From="1" To="5" Duration="0:0:2" RepeatBehavior="0.5x" 
              EnableDependentAnimation="True"/>

            <!-- Create an animation that repeats for one second. The resulting animation
                 plays for one second, half of its Duration. It animates from 50 to 150. -->
            <DoubleAnimation 
              Storyboard.TargetName="OneSecondRepeatingTransform" 
              Storyboard.TargetProperty="ScaleX" 
              From="1" To="5" Duration="0:0:2" RepeatBehavior="0:0:1" 
              EnableDependentAnimation="True"/>
        </Storyboard>
    </StackPanel.Resources>

    <!-- Create several rectangles to animate. -->
    <Rectangle Fill="Red" Width="50" Height="20" >
        <Rectangle.RenderTransform>
            <ScaleTransform x:Name="ForeverRepeatingTransform" />
        </Rectangle.RenderTransform>
   </Rectangle>
   <Rectangle Fill="Blue" Width="50" Height="20" >
       <Rectangle.RenderTransform>
           <ScaleTransform x:Name="FourSecondsRepeatingTransform" />
       </Rectangle.RenderTransform>
   </Rectangle>
   <Rectangle Fill="Yellow" Width="50" Height="20" >
       <Rectangle.RenderTransform>
           <ScaleTransform x:Name="TwiceRepeatingTransform" />
       </Rectangle.RenderTransform>
   </Rectangle>
   <Rectangle Fill="Green" Width="50" Height="20" >
       <Rectangle.RenderTransform>
           <ScaleTransform x:Name="HalfRepeatingTransform" />
       </Rectangle.RenderTransform>
   </Rectangle>
   <Rectangle Fill="Orange" Width="50" Height="20" >
       <Rectangle.RenderTransform>
           <ScaleTransform x:Name="OneSecondRepeatingTransform" />
       </Rectangle.RenderTransform>
   </Rectangle>

        <!-- Create buttons to restart and stop the animations. -->
   <Button Margin="10" Content="Restart Animation" Click="Start_Animation" />


</StackPanel>



private void Start_Animation(object sender, RoutedEventArgs e)
{
    myStoryboard.Begin();
}


Conditions requises

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.UI.Xaml.Media.Animation
Windows::UI::Xaml::Media::Animation [C++]

Métadonnées

Windows.winmd
Platform.winmd

Assembly

System.Runtime.WindowsRuntime.UI.Xaml.dll

 

 

Afficher:
© 2015 Microsoft