Metodo Media.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 l'attributo specificato dell'elemento multimediale può essere modificato.

Sintassi

bRetVal = Media.isReadOnlyItem(
  attribute
)

Parametri

attributo [in]

Stringa che indica il nome dell'attributo da testare. Per informazioni sugli attributi supportati da Lettore multimediale Windows, vedere riferimento all'attributo Lettore multimediale Windows.

Valore restituito

Questo metodo restituisce un valore Boolean.

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.

Per usare questo metodo, è necessario l'accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Lettore multimediale Windows 10 Mobile: questa proprietà restituisce sempre true.

Esempio

Nell'esempio JScript seguente viene usato Media. isReadOnlyItem per riempire un elemento TEXTAREA HTML denominato rwText con informazioni sull'elemento multimediale corrente. Il codice restituisce ogni attributo dell'elemento multimediale corrente, insieme al testo che indica se l'attributo è di sola lettura o di lettura/scrittura. L'oggetto Player è stato creato con ID = "Player".

// Store the current media item object.
var cm = Player.currentMedia;

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

// Loop through the attribute list.
for(var i = 0; i < cm.attributeCount; i++){

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

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

// Print the attribute information to the text area.
   rwText.value += atName + " is " + test;
   rwText.value += "\n";
}

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva.
DLL	Wmp.dll

Vedi anche

Oggetto Media

Media.setItemInfo

Settings.mediaAccessRights

Settings.requestMediaAccessRights