Метод MediaCollection.getAttributeStringCollection
[Функция, связанная с этой страницей, Медиаплеер Windows SDK, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Метод getAttributeStringCollection извлекает объект StringCollection, представляющий набор всех значений для указанного атрибута в пределах указанного типа носителя.
Синтаксис
retVal = MediaCollection.getAttributeStringCollection(
attribute,
mediaType
)
Параметры
-
attribute [in]
-
Строка , указывающая атрибут .
-
mediaType [in]
-
Строка , представляющая тип носителя. Содержит одно из следующих значений: "Audio", "Video", "Playlist" или "Other".
Возвращаемое значение
Этот метод возвращает объект StringCollection .
Комментарии
Для использования этого метода требуется доступ на чтение к библиотеке. Дополнительные сведения см. в разделе Доступ к библиотеке.
Сведения об атрибутах, поддерживаемых Медиаплеер Windows, см. в разделе Справочник по атрибутам.
Примеры
В следующем примере JScript используется MediaCollection. getAttributeStringCollection для отображения списка значений, соответствующих определенному атрибуту для звуковых элементов в коллекции мультимедиа. Элемент HTML SELECT, созданный с идентификатором ="Attribute", позволяет пользователю выбрать атрибут, например "Исполнитель", "Жанр" или "Альбом". Результат отображается в элементе HTML TEXTAREA, созданном с идентификатором "AttributeVals". Объект Player был создан с идентификатором " Player".
// Clear the text in the display area.
AttributeVals.value = "";
// Store the mediaCollection object.
var library = Player.mediaCollection;
// Get the string collection for the attribute type the user selects.
var all = library.getAttributeStringCollection(Attribute.value, "Audio");
// Loop through the string collection.
for (i = 0; i < all.count; i++){
// Display the items one line at a time.
AttributeVals.value += all.item(i);
AttributeVals.value += "\n";
}
Требования
Требование | Значение |
---|---|
Версия |
Медиаплеер Windows версии 7.0 или более поздней. |
DLL |
|
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе:Отправить и просмотреть отзыв по