Метод 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
Wmp.dll

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

Объект MediaCollection

Settings.mediaAccessRights

Settings.requestMediaAccessRights

Объект StringCollection