Метод Media.getItemInfoByType
Метод getItemInfoByType извлекает значение атрибута, соответствующее указанному имени атрибута, языку и индексу.
Синтаксис
retVal = Media.getItemInfoByType(
name,
language,
index
)
Параметры
-
name [in]
-
Строка , содержащая имя атрибута. Сведения об атрибутах, поддерживаемых Медиаплеер Windows, см. в справочнике по атрибутам Медиаплеер Windows.
-
язык [in]
-
Строка , представляющая язык. Если для значения задано значение NULL или "" (пустая строка), используется текущая строка языкового стандарта. В противном случае значение должно быть допустимой строкой языка RFC 1766, например en-us.
-
index [in]
-
Число (long), содержащее отсчитываемый от нуля индекс значения, извлекаемого из атрибута.
Возвращаемое значение
Этот метод возвращает объект Number, String, MetadataPicture или Объект MetadataText , как показано в следующей таблице.
| attribute | Возвращаемое значение |
|---|---|
| SyncState | Number (unsigned long) |
| WM/Lyrics_Synchronised | Объект MetadataText |
| WM/Picture | Объект MetadataPicture |
| WM/UserWebURL | Объект MetadataText |
| Все остальные атрибуты | String |
Для атрибутов, базовые значения которых являются логическими, этот метод возвращает строку "true" или "false".
Remarks
Этот метод извлекает метаданные для отдельного цифрового элемента мультимедиа или элемента мультимедиа, который является частью списка воспроизведения.
Этот метод поддерживает атрибуты с несколькими значениями и атрибутами со сложными значениями. Метод getItemInfo не поддерживает атрибуты с несколькими значениями и атрибутами со сложными значениями.
Свойство attributeCount содержит количество имен атрибутов, доступных для заданного объекта Media . Затем номера индекса можно использовать с методом getAttributeName для определения имени каждого доступного атрибута. Отдельные имена атрибутов можно передать в параметр nameобъекта getItemInfoByType.
Метод getAttributeCountByType возвращает количество атрибутов, соответствующих определенному имени атрибута для заданного объекта Media . Затем номера индекса можно передать в параметр индексаgetItemInfoByType. Это полезно, если элемент цифрового мультимедиа классифицируется по нескольким жанрам, например.
Для использования этого метода требуется доступ на чтение к библиотеке. Дополнительные сведения см. в разделе "Доступ к библиотекам".
Этот метод может вызвать ошибки. При вызове этого метода следует включить код обработки ошибок. Например, в JScript можно реализовать обработку ошибок с помощью try... Поймать... Наконец, структура.
Медиаплеер Windows 10 Mobile: этот метод не поддерживается.
Требования
| Требование | Значение |
|---|---|
| Версия |
Медиаплеер Windows серии 9 или более поздней версии. |
| DLL |
|