Metodo IWMPMedia::isReadOnlyItem

[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 isReadOnlyItem restituisce un valore che indica se gli attributi dell'elemento multimediale specificato possono essere modificati.

Sintassi

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

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

Parametri

bstrItemName [in]

Oggetto System.String che corrisponde al nome dell'elemento multimediale.

Valore restituito

Valore System.Boolean che indica se gli attributi sono di sola lettura.

Commenti

Se un attributo è di sola lettura, non può essere impostato con il metodo setItemInfo . Si noti che questo metodo può restituire valori diversi per un particolare attributo se usato con versioni diverse di Lettore multimediale Windows.

Prima di chiamare questo metodo, è necessario disporre dell'accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Esempio

Nell'esempio seguente viene utilizzato isReadOnlyItem per riempire una casella di testo a più righe con informazioni sull'elemento multimediale corrente. Il codice visualizza ogni attributo dell'elemento multimediale corrente, insieme al testo che indica se l'attributo è di sola lettura o di lettura/scrittura. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata 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

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