Metodo IWMPMedia::getMarkerTime

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo getMarkerTime restituisce l'ora del marcatore in corrispondenza dell'indice specificato.

Sintassi

public System.Double getMarkerTime(
  System.Int32 MarkerNum
);

Public Function getMarkerTime( _
  ByVal MarkerNum As System.Int32 _
) As System.Double
Implements IWMPMedia.getMarkerTime

Parametri

MarkerNum [in]

Oggetto System.Int32 che rappresenta l'indice dell'indicatore.

Valore restituito

Oggetto System.Double che rappresenta l'ora del marcatore.

Commenti

Questo metodo restituisce NULL se il marcatore specificato non esiste.

Alcuni elementi multimediali non contengono marcatori. Usare markerCount per scoprire quanti marcatori si trovano nell'elemento multimediale corrente.

I numeri di indice marcatori iniziano da 1.

Prima di chiamare questo metodo, è necessario disporre dell'accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Esempio

Nell'esempio di codice seguente viene usato getMarkerTime per riempire una casella di testo a più righe con la posizione di ogni marcatore. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata player.

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

// Create an array to store the list of marker times.
string[] markers = new string[mcount];

// Verify that at least one marker exists in the current media.
if (mcount > 0)
{
    // Loop through the marker list.
    for (int i = 1; i < mcount + 1; i++)
    {
        // Store the marker information in the array.
        markers[i] = "Marker number " + i + " occurs at ";
        markers[i] += player.currentMedia.getMarkerTime(i).ToString();
        markers[i] += " second(s).";
    }

    // Display the marker times in the text box.
    markerTimes.Lines = markers;
}

' Get the number of markers in the current media item.
Dim mcount As Integer = player.currentMedia.markerCount

' Create an array to store the list of marker times.
Dim markers(mcount) As String

' Verify that at least one marker exists in the current media.
If (mcount > 0) Then

    ' Loop through the marker list.
    For i As Integer = 1 To mcount

        ' Store the marker information in the array.
        markers(i) = ("Marker number " + i + " occurs at ")
        markers(i) += player.currentMedia.getMarkerTime(i).ToString()
        markers(i) += " second(s)."

    Next i

    ' Display the marker times in the text box.
    markerTimes.Lines = markers

End If

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows serie 9 o successive
Spazio dei nomi	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Vedi anche

Interfaccia IWMPMedia (VB e C#)

IWMPMedia.markerCount (VB e C#)