Metodo Media.setItemInfo

[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 setItemInfo imposta il valore dell'attributo specificato per l'elemento multimediale corrente.

Sintassi

Media.setItemInfo(
  attribute,
  value
)

Parametri

attributo [in]

Stringa contenente il nome dell'attributo. Per informazioni sugli attributi supportati da Lettore multimediale Windows, vedere Informazioni di riferimento sull'attributo Lettore multimediale Windows.

valore [in]

Stringa contenente il nuovo valore.

Valore restituito

Questo metodo non restituisce valori.

Commenti

La proprietà attributeCount contiene il numero di attributi disponibili per un determinato oggetto Media . I numeri di indice possono quindi essere usati con il metodo getAttributeName per determinare i nomi degli attributi predefiniti che possono essere usati con questo metodo.

Prima di usare questo metodo, usare il metodo isReadOnlyItem per determinare se è possibile impostare un determinato attributo.

Per usare questo metodo, è necessario l'accesso completo alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Nota

Se si incorpora il controllo Lettore multimediale Windows nell'applicazione, gli attributi di file modificati non verranno scritti nel file multimediale digitale finché l'utente non viene eseguito Lettore multimediale Windows. Se si usa il controllo in un'applicazione remota scritta in C++, gli attributi di file modificati verranno scritti nel file multimediale digitale poco dopo aver apportato le modifiche. In entrambi i casi, le modifiche sono immediatamente disponibili per il codice tramite la libreria.

Lettore multimediale Windows 10 Mobile: questo metodo non è implementato.

Esempio

L'esempio JScript seguente usa Media. setItemInfo per modificare il valore dell'attributo Genre per l'elemento multimediale corrente. Un elemento di input HTML TEXT denominato genText consente all'utente di immettere una stringa di testo, che viene quindi usata per modificare le informazioni sull'attributo. L'oggetto Player è stato creato con ID = "Player".

<!-- Create the button element. -->
<INPUT type = "BUTTON"  id = "NEWGEN"  name = "NEWGEN"  value = "Change Genre" 
onClick = "
    /* Store the current media item. */
    var cm = Player.currentMedia;

    /* Get the user input from the text box. */
    var atValue = genText.value;

    /* Test for read-only status of the attribute. */
    if(cm.isReadOnlyItem('Genre') == false){

        /* Change the attribute value. */
        cm.setItemInfo('Genre' ,atValue);
    } 
">

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva.
DLL	Wmp.dll

Vedi anche

Oggetto Media

Media.getItemInfo

Media.isReadOnlyItem

Settings.mediaAccessRights

Settings.requestMediaAccessRights