Controls.currentMarker

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La propriété currentMarker spécifie ou récupère le numéro de marqueur actuel.

player.controls.currentMarker
      

Valeurs possibles

Cette propriété est un nombre en lecture/écriture (long) avec une valeur par défaut de zéro.

Notes

La définition de currentMarker entraîne le démarrage de la lecture à partir du marqueur spécifié. Avant de tenter de définir currentMarker, déterminez si un fichier comporte des marqueurs et leur nombre à l’aide de markerCount. Si un fichier n’a pas de marqueurs, la définition de currentMarker sur autre chose que zéro génère une erreur. La définition de currentMarker sur un nombre supérieur à markerCount génère également une erreur.

La propriété currentMarker renvoie toujours le marqueur actuel ou le dernier marqueur, ce qui signifie que la position réelle du fichier peut être au niveau du marqueur actuel ou avant le marqueur suivant. Les marqueurs étant numérotés à partir de 1, si un fichier comporte des marqueurs, vous pouvez définir currentMarker sur zéro pour modifier la position du fichier sur zéro.

Jusqu’à ce que l’élément multimédia actuel soit défini (à l’aide du Lecteur.URL ou Lecteur. currentMedia), currentMarker retourne zéro.

Exemples

L’exemple JScript suivant utilise currentMarker pour démarrer la lecture vidéo à partir du marqueur qui correspond à la propriété selectedIndex d’un élément HTML SELECT. L’objet Player a été créé avec ID = « Player ».

<SELECT ID = "markers"  NAME = "markers"  LANGUAGE = "JScript"

    /* Seek to the marker number that corresponds to the SELECT element
       selectedIndex value when the list selection changes. */
    onChange = "Player.controls.currentMarker = markers.selectedIndex + 1;
">

    /* Fill the SELECT element with the marker identifiers. */
    <OPTION SELECTED>Sunrise
    <OPTION>Car chase 
    <OPTION>Happy ending
</SELECT>

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Controls, objet

Media.markerCount

Player.currentMedia

Player.URL