Metodo IWMPControls::stop

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché 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 stop arresta la riproduzione dell'elemento multimediale.

Sintassi

public void stop();

Public Sub stop()
Implements IWMPControls.stop

Parametri

Questo metodo non presenta parametri.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Questo metodo causa Lettore multimediale Windows rilasciare qualsiasi risorsa di sistema usata, ad esempio il dispositivo audio. L'elemento multimediale corrente, tuttavia, non viene rilasciato.

Quando Lettore multimediale Windows viene arrestato, la posizione di riproduzione corrente nell'elemento multimediale viene reimpostata all'inizio dell'elemento. Successivamente la chiamata di IWMPControls.play avvierà la riproduzione dall'inizio dell'elemento multimediale. Per arrestare un'operazione di riproduzione senza modificare la posizione corrente, usare il metodo IWMPControls.pause .

Esempio

Nell'esempio seguente viene usato stop per arrestare l'elemento multimediale corrente in risposta all'evento Click di un pulsante. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata player.

private void stopButton_Click(object o, System.EventArgs args)
{
    // To get all of the available functionality of the player controls, cast the
    // value returned by player.Ctlcontrols to a WMPLib.IWMPControls3 interface. 
    WMPLib.IWMPControls3 controls = (WMPLib.IWMPControls3)player.Ctlcontrols;

    // Check first to be sure the operation is valid. 
    if (controls.get_isAvailable("stop"))
    {
        controls.stop();
    }
}

Public Sub stopButton_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles stopButton.Click

    ' To get all of the available functionality of the player controls, Dim the
    ' value returned by player.Ctlcontrols as a WMPLib.IWMPControls3 interface.
    Dim controls As WMPLib.IWMPControls3 = player.Ctlcontrols

    ' Check first to be sure the operation is valid. 
    If (controls.isAvailable("stop")) Then

        controls.stop()

    End If

End Sub

Requisiti

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

Vedi anche

Interfaccia IWMPControls (VB e C#)

IWMPControls.next (VB e C#)

IWMPControls.pause (VB e C#)

IWMPControls.play (VB e C#)

IWMPControls.previous (VB e C#)