Méthode Media. setItemInfo

La méthode setItemInfo définit la valeur de l’attribut spécifié pour l’élément multimédia actuel.

Syntaxe

Media.setItemInfo(
  attribute,
  value
)

Paramètres

attribut [ dans]

Chaîne contenant le nom de l’attribut. pour plus d’informations sur les attributs pris en charge par Lecteur Windows Media, consultez la référence d’attributLecteur Windows Media.

valeur [ dans]

Chaîne contenant la nouvelle valeur.

Valeur de retour

Cette méthode ne retourne pas de valeur.

Notes

La propriété attributeCount contient le nombre d’attributs disponibles pour un objet 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.

Pour utiliser cette méthode, l’accès complet à la bibliothèque est requis. 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. Si vous utilisez le contrôle dans une application distante écrite en C++, les attributs de fichier que vous modifiez seront écrits dans le fichier multimédia numérique peu après que vous avez apporté les modifications. Dans les deux cas, les modifications sont immédiatement disponibles pour votre code via la bibliothèque.

Lecteur Windows Media 10 Mobile : Cette méthode n’est pas implémentée.

Exemples

l’exemple de JScript suivant utilise un média. setItemInfo pour modifier la valeur de l’attribut genre pour l’élément multimédia actuel. Un élément d’entrée de texte HTML nommé genText permet à l’utilisateur d’entrer une chaîne de texte, qui est ensuite utilisée pour modifier les informations d’attribut. L’objet Player a été créé avec 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);
    } 
">

Configuration requise

Condition requise Valeur
Version
Lecteur Windows Media version 7,0 ou ultérieure.
DLL
Wmp.dll

Voir aussi

Objet Media

Media. getItemInfo

Media. isReadOnlyItem

Paramètres. mediaAccessRights

Paramètres. requestMediaAccessRights