KeyTime Structure

Spécifie quand une image clé particulière doit prendre place pendant une animation.

Syntaxe


public struct KeyTime


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

XAML Values

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.

Attributs

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

Membres

KeyTimeStructure possède ces types de membres :

Champs

KeyTimeStructure possède ces champs.

ChampType de donnéesDescription
TimeSpan

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

Composant d'heure de ce KeyTime.

 

Méthodes

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

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

 

Opérateurs

KeyTimeStructure possède ces opérateurs.

OpérateurDescription
Equality Compares two KeyTime structures for equality.
Implicit Implicitly converts a TimeSpan to a KeyTime.
Inequality Compares two KeyTime structures for inequality.

 

Propriétés

Le KeyTimeStructure a les propriétés suivantes.

PropriétéType d'accèsDescription

TimeSpan

En lecture seuleGets the time when the key frame ends, expressed as a time relative to the beginning of the animation.

 

Remarques

La propriété KeyTime de chaque image clé indique le délai au bout duquel elle arrive à son terme. Le temps clé n'indique pas la durée de lecture des images clés. La durée de lecture d'une image clé est déterminée par le moment où se termine l'image clé, le moment où se termine l'image clé qui la précède ainsi que par la durée de l'animation.

La spécification de KeyTime à l'aide d'un seul entier sans aucun caractère littéral d'intervalle de temps, tel que : ou . , génère une valeur KeyTime équivalente à ce nombre de jours. Il s'agit rarement du résultat souhaité. Généralement, vous spécifiez les intervalles de temps en secondes. Par conséquent, la chaîne KeyTime comprend en général les valeurs zéro de tête pour les heures et les minutes, ainsi que les caractères littéraux : appropriés, tels que les séparateurs entre les heures, les minutes et les secondes. Par exemple, pour spécifier une valeur KeyTime de 5 secondes, la chaîne correcte est "0:0:5" (équivalant à "0:0:05").

Remarques sur la syntaxe XAML

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

Projection et membres de KeyTime

Si vous utilisez un langage Microsoft .NET (C# ou Microsoft Visual Basic) ou les extensions de composants Visual C++ (C++/CX), KeyTime a des méthodes d'utilitaire et ses données membres TimeSpan sont exposées comme une propriété en lecture et non un champ.

Pour .NET, Duration expose TimeSpan.Parse pour sa durée TimeSpan, une méthode FromTimeSpan et un opérateur Implicit. Celles-ci ne sont pas disponibles à partir de la structure dans C++/CX, utilisez donc KeyTimeHelper.FromTimeSpan.

Si vous programmez en C++ à l'aide de la bibliothèque de modèles Windows Runtime (WRL), seul le champ de données membres TimeSpan existe en tant que membre de KeyTime. Le code WRL peut accéder à FromTimeSpan puisqu'il existe dans la classe KeyTimeHelper.

Exemples

Cet exemple utilise la syntaxe attribut XAML pour définir des valeurs KeyTime sur plusieurs types de classes DoubleAnimationUsingKeyFrames .


<Canvas>
    <Canvas.Resources>
        <Storyboard x:Name="myStoryboard">

            <!-- Animate the TranslateTransform's X property
           from 0 to 350, then 50, then 200 over 10 seconds. -->
            <DoubleAnimationUsingKeyFrames
       Storyboard.TargetName="MyAnimatedTranslateTransform"
       Storyboard.TargetProperty="X"
       Duration="0:0:10" EnableDependentAnimation="True">

                <!-- Using a LinearDoubleKeyFrame, the rectangle moves 
           steadily from its starting position to 500 over 
           the first 3 seconds.  -->
                <LinearDoubleKeyFrame Value="500" KeyTime="0:0:3" />

                <!-- Using a DiscreteDoubleKeyFrame, the rectangle suddenly 
           appears at 400 after the fourth second of the animation. -->
                <DiscreteDoubleKeyFrame Value="400" KeyTime="0:0:4" />

                <!-- Using a SplineDoubleKeyFrame, the rectangle moves 
           back to its starting point. The animation starts out slowly at 
           first and then speeds up. This KeyFrame ends after the 6th
           second. -->
                <SplineDoubleKeyFrame KeySpline="0.6,0.0 0.9,0.00" Value="0" KeyTime="0:0:6" />

            </DoubleAnimationUsingKeyFrames>
        </Storyboard>
    </Canvas.Resources>

    <Rectangle PointerPressed="Pointer_Clicked" Fill="Blue"
 Width="50" Height="50">
        <Rectangle.RenderTransform>
            <TranslateTransform x:Name="MyAnimatedTranslateTransform" />
        </Rectangle.RenderTransform>
    </Rectangle>

</Canvas>


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:
© 2014 Microsoft. Tous droits réservés.