Метод 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 |
|
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по