MediaElement.Position Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit la position actuelle dans la progression en temps de lecture du média.

public:
 property TimeSpan Position { TimeSpan get(); void set(TimeSpan value); };

TimeSpan Position();

void Position(TimeSpan value);

public System.TimeSpan Position { get; set; }

var timeSpan = mediaElement.position;
mediaElement.position = timeSpan;

Public Property Position As TimeSpan

Valeur de propriété

TimeSpan TimeSpan

Temps écoulé depuis le commencement du média. La valeur par défaut est timeSpan avec la valeur « 0:0:0 ».

Remarques

Définissez cette propriété pour définir une position de démarrage-lecture spécifique dans le média.

Un TimeSpan est représenté sous la forme de différents types en fonction du langage de programmation que vous utilisez.

C# ou Microsoft Visual Basic Utilisez une structure System.TimeSpan . System.TimeSpan a des membres utilitaires tels que Parse(String) qui facilitent la création, la modification ou la comparaison de valeurs temporelles.

Extensions de composant Visual C++ (C++/CX) Utilisez une structure Windows::Foundation::TimeSpan . Cette structure n’a qu’un seul membre de champ (Durée), qui mesure par 100 nanosecondes d’unités. Si vous envisagez d’afficher une valeur Position au format heures:minutes:secondes, vous devrez écrire votre propre logique pour la conversion vers ce format à partir des unités de durée .

Si vous n’êtes pas sûr de la source multimédia actuelle chargée en tant que MediaElement.Source, case activée d’abord CanSeek. Une source multimédia de diffusion en continu entraîne la création d’un fichier MediaElement signalant CanSeek comme false, et dans ce cas, vous ne pouvez pas utiliser Position pour définir le point de lecture.

Si Position est paramétrable, les contraintes de valeur suivantes s’appliquent :

• Si Position est défini sur une valeur négative, la valeur revient à un TimeSpan avec la valeur « 0:0:0 ».
• Si Position est défini sur une valeur supérieure à la valeur NaturalDuration du média, position devient la valeur de NaturalDuration.

Remarques sur la syntaxe XAML

La définition d’une valeur Position en XAML est techniquement possible, mais pas courante. Si vous définissez une position en XAML, simulez le comportement de conversion de type « FromString » pour un TimeSpan, en d’autres termes, spécifiez la valeur sous la forme « HH:MM:SS ».

Voir aussi

• NaturalDuration