IWMPMedia :: setItemInfo, méthode
La méthode setItemInfo définit la valeur de l’attribut spécifié pour l’élément multimédia.
Syntaxe
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
Paramètres
-
bstrItemName [ dans]
-
System. String qui est le nom de l’attribut.
-
bstrVal [ dans]
-
System. String qui est la nouvelle valeur.
Valeur de retour
Cette méthode ne retourne pas de valeur.
Notes
La propriété attributeCount obtient le nombre d’attributs disponibles pour un élément multimédia donné. Les numéros d’index peuvent ensuite être utilisés avec la méthode getAttributeName pour déterminer les noms des attributs intégrés qui peuvent être utilisés avec cette méthode.
Avant d’utiliser cette méthode, utilisez la méthode isReadOnlyItem pour déterminer si un attribut particulier peut être défini.
Avant d’appeler cette méthode, vous devez disposer d’un accès complet à la bibliothèque. Pour plus d’informations, consultez accès à la bibliothèque.
Remarque
si vous incorporez le contrôle Lecteur Windows Media dans votre application, les attributs de fichier que vous modifiez ne seront pas écrits dans le fichier multimédia numérique tant que l’utilisateur n’aura pas exécuté Lecteur Windows Media.
Exemples
L’exemple suivant utilise setItemInfo pour modifier la valeur de l’attribut genre pour l’élément multimédia actuel. Une zone de texte permet à l’utilisateur d’entrer une chaîne, qui est ensuite utilisée pour modifier les informations d’attribut en réponse à l’événement de clic d’un bouton. L’objet AxWMPLib. AxWindowsMediaPlayer est représenté par la variable 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
Spécifications
| Condition requise | Valeur |
|---|---|
| Version |
Lecteur Windows Media série 9 ou version ultérieure |
| Espace de noms |
WMPLib |
| Assembly |
|