Oggetto Player

[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.

L'oggetto Player è l'oggetto radice per il controllo Lettore multimediale Windows. Supporta le proprietà, i metodi e gli eventi elencati nelle tabelle seguenti.

L'oggetto Player supporta le proprietà seguenti. Le proprietà contrassegnate con un asterisco (*) non sono accessibili alle interfacce.

Proprietà Descrizione
cdromCollection Recupera l'oggetto CdromCollection .
closedCaption Recupera l'oggetto ClosedCaption .
Controlli Recupera l'oggetto Controls .
currentMedia Specifica o recupera l'oggetto Media corrente.
currentPlaylist Specifica o recupera l'oggetto Playlist corrente.
Dvd Recupera l'oggetto DVD .
enableContextMenu * Specifica o recupera un valore che indica se abilitare il menu di scelta rapida, che viene visualizzato quando si fa clic sul pulsante destro del mouse.
Abilitato * Specifica o recupera un valore che indica se il controllo Lettore multimediale Windows è abilitato.
error Recupera l'oggetto Error .
Fullscreen * Specifica o recupera un valore che indica se il contenuto video viene riprodotto in modalità schermo intero.
isOnline Recupera un valore che indica se l'utente è connesso a una rete.
isRemote * Recupera un valore che indica se il controllo Lettore multimediale Windows è in esecuzione in modalità remota.
mediaCollection Recupera l'oggetto MediaCollection .
Rete Recupera l'oggetto Network .
openState Recupera un valore che indica lo stato dell'origine del contenuto.
playerApplication * Recupera l'oggetto PlayerApplication quando è in esecuzione un controllo Lettore multimediale Windows remoto.
playlistCollection Recupera l'oggetto PlaylistCollection .
playState Recupera un valore che indica lo stato dell'operazione di Lettore multimediale Windows.
impostazioni Recupera l'oggetto Settings .
Stato Recupera un valore che indica lo stato corrente di Lettore multimediale Windows.
stretchToFit * Specifica o recupera un valore che indica se il video verrà esteso per adattarsi alla dimensione della visualizzazione video del controllo Lettore multimediale Windows.
uiMode * Specifica o recupera un valore che indica quali controlli vengono visualizzati nell'interfaccia utente quando Lettore multimediale Windows è incorporato in una pagina Web.
URL Specifica o recupera il nome del clip da riprodurre.
versionInfo Recupera un valore String che specifica la versione del Lettore multimediale Windows.
windowlessVideo * Specifica o recupera un valore che indica se il controllo Lettore multimediale Windows esegue il rendering del video in modalità senza finestra.

 

* Non accessibile alle pelli.

L'oggetto Player supporta i metodi seguenti.

Metodo Descrizione
close Rilascia Lettore multimediale Windows risorse.
launchURL Invia un URL al browser predefinito dell'utente per il rendering.
Newmedia Crea un nuovo oggetto Media .
newPlaylist Crea un nuovo oggetto Playlist .
openPlayer Apre Lettore multimediale Windows usando l'URL specificato.

 

L'oggetto Player supporta gli eventi seguenti. Gli eventi contrassegnati con un asterisco (*) non sono accessibili alle interfacce. Per informazioni sulla gestione degli eventi del mouse e della tastiera nelle interfacce, vedere Eventi esterni.

Event Descrizione
AudioLanguageChange Si verifica quando cambia la lingua audio corrente.
responseBuffering Si verifica quando il controllo Lettore multimediale Windows inizia o termina il buffering.
CdromMediaChange Si verifica quando un CD o un DVD viene inserito o espulso da un CD o un'unità DVD.
Fare clic su * Si verifica quando l'utente fa clic su un pulsante del mouse.
CurrentItemChange Si verifica quando i controlli. currentItem cambia.
CurrentMediaItemAvailable Si verifica quando un elemento di metadati grafici nell'elemento multimediale corrente diventa disponibile.
CurrentPlaylistChange Si verifica quando qualcosa cambia all'interno della playlist corrente.
CurrentPlaylistItemAvailable Si verifica quando l'elemento della playlist corrente diventa disponibile.
Disconnetti Riservato per utilizzi futuri.
DomainChange Si verifica quando il dominio DVD cambia.
Doubleclick * Si verifica quando l'utente fa doppio clic su un pulsante del mouse.
DurationUnitChange Riservato per utilizzi futuri.
EndOfStream Riservato per utilizzi futuri.
Error (Errore) (Error (Errore)e) Si verifica quando il controllo Lettore multimediale Windows ha una condizione di errore.
Keydown * Si verifica quando un tasto viene premuto.
Keypress * Si verifica quando viene premuto un tasto e quindi rilasciato.
Keyup * Si verifica quando si rilascia un tasto.
MarkerHit Si verifica quando viene raggiunto un marcatore.
MediaChange Si verifica quando un elemento multimediale cambia.
MediaCollectionAttributeStringAdded Si verifica quando viene aggiunto un valore di attributo alla libreria.
MediaCollectionAttributeStringChanged Si verifica quando viene modificato un valore di attributo nella libreria.
MediaCollectionAttributeStringRemoved Si verifica quando viene rimosso un valore di attributo dalla libreria.
MediaCollectionChange Si verifica quando la raccolta multimediale cambia.
MediaCollectionMediaAdded Si verifica quando viene aggiunto un elemento multimediale alla libreria locale.
MediaCollectionMediaRemoved Si verifica quando un elemento multimediale viene rimosso dalla libreria locale.
MediaError Si verifica quando l'oggetto Media ha una condizione di errore.
ModeChange Si verifica quando viene modificata una modalità di Lettore multimediale Windows.
Mousedown * Si verifica quando viene premuto un pulsante del mouse.
Mousemove * Si verifica quando viene spostato il puntatore del mouse.
Mouseup * Si verifica quando viene rilasciato un pulsante del mouse.
NewStream Riservato per utilizzi futuri.
OpenPlaylistSwitch Si verifica quando inizia a riprodurre un titolo in un DVD.
OpenStateChange Si verifica quando il controllo Lettore multimediale Windows cambia stato.
PlaylistChange Si verifica quando una playlist cambia.
PlaylistCollectionChange Si verifica quando cambia qualcosa nella raccolta di playlist.
PlaylistCollectionPlaylistAdded Si verifica quando una playlist viene aggiunta alla raccolta di playlist.
PlaylistCollectionPlaylistRemoved Si verifica quando una playlist viene rimossa dalla raccolta di playlist.
PlaylistCollectionPlaylistSetAsDeleted Riservato per utilizzi futuri.
PlayStateChange Si verifica quando lo stato di riproduzione del controllo Lettore multimediale Windows cambia.
PositionChange Si verifica quando la posizione corrente dell'elemento multimediale è stata modificata.
ScriptCommand Si verifica quando viene ricevuto un comando o un URL sincronizzati.
StatusChange Si verifica quando la proprietà di stato cambia valore.
StringCollectionChange Si verifica quando viene modificata una raccolta di stringhe.
Warning Riservato per utilizzi futuri.

 

* Non accessibile alle pelle. Per informazioni sulla gestione degli eventi del mouse e della tastiera nelle interfacce, vedere Gestori eventi ambient.

Quando incorporato in una pagina Web, è possibile accedere all'oggetto Player usando il valore ID specificato nel tag OBJECT. All'interno di un file di definizione dell'interfaccia utente viene eseguito l'accesso usando l'attributo globale del lettore . Ai fini dell'illustrazione, il lettore verrà usato come ID oggetto nelle sezioni della sintassi di riferimento.

Vedi anche

Riferimento al modello a oggetti per lo scripting