MediaElement.Position Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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 ».