Media.getMarkerName-Methode

Die getMarkerName-Methode ruft den Namen des Markers am angegebenen Index ab.

Syntax

strRetVal = Media.getMarkerName(
  markerNum
)

Parameter

markerNum [ In]

Number (long), die einen Markerindex angibt.

Rückgabewert

Diese Methode gibt eine Zeichenfolge zurück.

Hinweise

Diese Methode gibt NULL zurück, wenn der angegebene Marker nicht vorhanden ist.

Einige digitale Medienelemente enthalten keine Marker. Verwenden Sie markerCount, um herauszufinden, wie viele Marker sich im aktuellen Clip befinden.

Markerindexnummern beginnen bei 1.

Um diese Methode zu verwenden, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.

Beispiele

Im folgenden JScript Beispiel wird Media verwendet. getMarkerName, um ein HTML TEXTAREA-Element mit dem Namen MNAMES mit den Namen der Marker im aktuellen Medienelement zu füllen. Das Player-Objekt wurde mit der ID = "Player" erstellt.

// Get the number of markers in the current media item.
var mcount = Player.currentMedia.markerCount;

// Verify that at least one marker exists in the current media.
if (mcount > 0){

// Loop through the marker list.
for (var i = 1; i < mcount + 1; i++){

   // Print the marker name to the text area.
   MNAMES.value += Player.currentMedia.getMarkerName(i);
   MNAMES.value += "\n";
}

Anforderungen

Anforderung Wert
Version
Windows Media Player Version 7.0 oder höher.
DLL
Wmp.dll

Weitere Informationen

Medienobjekt

Media.getMarkerTime

Media.markerCount

Einstellungen.mediaAccessRights

Einstellungen.requestMediaAccessRights