Méthode IWMPMedia::isReadOnlyItem

[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 isReadOnlyItem retourne une valeur indiquant si les attributs de l’élément multimédia spécifié peuvent être modifiés.

Syntaxe

public System.Boolean isReadOnlyItem(
  System.String bstrItemName
);

Public Function isReadOnlyItem( _
  ByVal bstrItemName As System.String _
) As System.Boolean
Implements IWMPMedia.isReadOnlyItem

Paramètres

bstrItemName [in]

System.String qui est le nom de l’élément multimédia.

Valeur retournée

Valeur System.Boolean qui indique si les attributs sont en lecture seule.

Notes

Si un attribut est en lecture seule, il ne peut pas être défini avec la méthode setItemInfo . Notez que cette méthode peut retourner des valeurs différentes pour un attribut particulier lorsqu’elle est utilisée avec différentes versions de Lecteur multimédia Windows.

Avant d’appeler cette méthode, vous devez disposer d’un accès en lecture à la bibliothèque. Pour plus d’informations, consultez Accès à la bibliothèque.

Exemples

L’exemple suivant utilise isReadOnlyItem pour remplir une zone de texte multiligne avec des informations sur l’élément multimédia actif. Le code affiche chaque attribut de l’élément multimédia actuel, ainsi que du texte indiquant si l’attribut est en lecture seule ou en lecture/écriture. L’objet AxWMPLib.AxWindowsMediaPlayer est représenté par la variable nommée player.

// Store a WMPLib.IWMPMedia3 interface to the current media item.
WMPLib.IWMPMedia3 cm = (WMPLib.IWMPMedia3)player.currentMedia;

// Get the number of attributes in the current media item.
int attCount = player.currentMedia.attributeCount;

// Create an array to store the list of attribute information.
string[] atInfo = new string[attCount];

// Create a variable to hold each attribute name.
string atName;

// Loop through the attribute list.
for (int i = 0; i < cm.attributeCount; i++)
{
    // Get the attribute name.
    atName = cm.getAttributeName(i);

    // Test whether the attribute is read-only.
    string test = ((cm.isReadOnlyItem(atName)) ? "Read-Only" : "Read/Write");

    // Store the attribute information in the array.
    atInfo[i] = (atName + " is " + test);
}

// Display the attribute information in the text box.
rwText.Lines = atInfo;

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

' Get the number of attributes in the current media item.
Dim attCount As Integer = player.currentMedia.attributeCount

' Create an array to store the list of attribute information.
Dim atInfo(attCount) As String

' Create a variable to hold each attribute name.
Dim atName As String

' Loop through the attribute list.
For i As Integer = 0 To (cm.attributeCount - 1)

    ' Get the attribute name.
    atName = cm.getAttributeName(i)

    ' Test whether the attribute is read-only.
    If (cm.isReadOnlyItem(atName)) Then

        atInfo(i) = (atName + " is Read-Only")

    Else

        atInfo(i) = (atName + " is Read/Write")

    End If

Next i

' Display the attribute information in the text box.
rwText.Lines = atInfo

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows série 9 ou ultérieure
Espace de noms	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Voir aussi

Interface IWMPMedia (VB et C#)

IWMPMedia.setItemInfo (VB et C#)