Méthode Media.setItemInfo

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

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

Syntaxe

Media.setItemInfo(
  attribute,
  value
)

Paramètres

attribut [in]

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

value [in]

Chaîne contenant la nouvelle valeur.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

La propriété attributeCount contient le nombre d’attributs disponibles pour un objet Media 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, un 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 multimédia Windows 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 multimédia Windows. 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 de temps après avoir apporté les modifications. Dans les deux cas, les modifications sont immédiatement disponibles pour votre code via la bibliothèque.

Lecteur multimédia Windows 10 Mobile : cette méthode n’est pas implémentée.

Exemples

L’exemple JScript suivant utilise Media. setItemInfo pour modifier la valeur de l’attribut Genre pour l’élément multimédia actif. Un élément d’entrée HTML TEXT 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 l’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 multimédia Windows version 7.0 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Objet Media

Media.getItemInfo

Media.isReadOnlyItem

Settings.mediaAccessRights

Settings.requestMediaAccessRights