Metodo IWMPMedia::setItemInfo

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

Sintassi

public void setItemInfo(
  System.String bstrItemName,
  System.String bstrVal
);

Public Sub setItemInfo( _
  ByVal bstrItemName As System.String, _
  ByVal bstrVal As System.String _
)
Implements IWMPMedia.setItemInfo

Parametri

bstrItemName [in]

Oggetto System.String che corrisponde al nome dell'attributo.

bstrVal [in]

Oggetto System.String che rappresenta il nuovo valore.

Valore restituito

Questo metodo non restituisce valori.

Commenti

La proprietà attributeCount ottiene il numero di attributi disponibili per un determinato elemento multimediale. 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 utilizzare questo metodo, utilizzare il metodo isReadOnlyItem per determinare se è possibile impostare un attributo specifico.

Prima di chiamare questo metodo, è necessario avere 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 esegue Lettore multimediale Windows.

Esempio

Nell'esempio seguente viene utilizzato setItemInfo per modificare il valore dell'attributo Genre per l'elemento multimediale corrente. Una casella di testo consente all'utente di immettere una stringa, che viene quindi usata per modificare le informazioni sull'attributo in risposta all'evento Click di un pulsante. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata player.

private void setNewGenre_Click(object sender, System.EventArgs e)
{
    // Store a WMPLib.IWMPMedia3 interface to the current media item. 
    WMPLib.IWMPMedia3 cm = (WMPLib.IWMPMedia3)player.currentMedia;

    // Get the user input from the TextBox. 
    string atValue = genText.Text;

    // Test for read-only status of the attribute. 
    if( cm.isReadOnlyItem("Genre") == false )
    {
        // Change the attribute value. 
        cm.setItemInfo("Genre", atValue);
    } 
}

Public Sub setNewGenre_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles setNewGenre.Click

    ' Store a WMPLib.IWMPMedia3 interface to the current media item. 
    Dim cm As WMPLib.IWMPMedia3 = player.currentMedia

    ' Get the user input from the TextBox. 
    Dim atValue = genText.Text

    ' Test for read-only status of the attribute. 
    If (cm.isReadOnlyItem("Genre") = False) Then

        ' Change the attribute value. 
        cm.setItemInfo("Genre", atValue)

    End If

End Sub

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.attributeCount (VB e C#)

IWMPMedia.getAttributeName (VB e C#)

IWMPMedia.isReadOnlyItem (VB e C#)