Метод Media.isReadOnlyItem

  • Статья

[Функция, связанная с этой страницей, Медиаплеер Windows SDK, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод isReadOnlyItem возвращает значение, указывающее, можно ли изменить указанный атрибут элемента мультимедиа.

Синтаксис

bRetVal = Media.isReadOnlyItem(
  attribute
)

Параметры

attribute [in]

Строка , указывающая имя проверяемого атрибута. Сведения об атрибутах, поддерживаемых Медиаплеер Windows, см. в справочнике по атрибутам Медиаплеер Windows.

Возвращаемое значение

Этот метод возвращает логическое значение.

Комментарии

Если атрибут доступен только для чтения, его нельзя задать с помощью метода setItemInfo . Обратите внимание, что этот метод может возвращать разные значения для определенного атрибута при использовании с разными версиями Медиаплеер Windows.

Для использования этого метода требуется доступ на чтение к библиотеке. Дополнительные сведения см. в разделе Доступ к библиотеке.

Медиаплеер Windows 10 Mobile: это свойство всегда возвращает значение true.

Примеры

В следующем примере JScript используется media. isReadOnlyItem для заполнения элемента HTML TEXTAREA с именем rwText сведениями о текущем элементе мультимедиа. Код выводит каждый атрибут текущего элемента мультимедиа вместе с текстом, указывающим, доступен ли атрибут только для чтения или чтения и записи. Объект Player был создан с идентификатором " 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";
}

Требования

Требование Значение
Версия
 Медиаплеер Windows версии 7.0 или более поздней.
DLL
Wmp.dll

См. также раздел

Объект мультимедиа

Media.setItemInfo

Settings.mediaAccessRights

Settings.requestMediaAccessRights