Media.getItemInfoByType 方法

getItemInfoByType 方法检索对应于指定属性名称、语言和索引的属性的值。

语法

retVal = Media.getItemInfoByType(
  name,
  language,
  index
)

参数

name [in]

包含属性名称的字符串。 有关Windows 媒体播放器支持的属性的信息,请参阅Windows 媒体播放器属性参考

语言 [in]

表示语言的字符串。 如果值设置为 null 或“” (空字符串) 使用当前区域设置字符串。 否则,该值必须是有效的 RFC 1766 语言字符串,例如“en-us”。

索引 [in]

数字 () 包含要从属性中检索的值的从零开始的索引。

返回值

此方法返回 NumberStringMetadataPicture 对象或 MetadataText 对象,如下表所示。

Attribute 返回值
SyncState 符号长) 的数字 (
WM/Lyrics_Synchronised MetadataText 对象
WM/图片 MetadataPicture 对象
WM/UserWebURL MetadataText 对象
所有其他特性 字符串

对于基础值为 布尔值的属性,此方法返回字符串“true”或“false”。

注解

此方法检索单个数字媒体项或属于播放列表的媒体项的元数据。

此方法支持具有多个值的属性以及具有复杂值的属性。 getItemInfo 方法不支持具有多个值的属性和具有复杂值的属性。

attributeCount 属性包含给定 Media 对象可用的属性名称数。 然后,可以将索引号与 getAttributeName 方法一起使用,以确定每个可用属性的名称。 单个属性名称可以传递给 getItemInfoByType的名称参数。

getAttributeCountByType 方法返回对应于给定 Media 对象的特定属性名称的属性数。 然后,可以将索引号传递给 getItemInfoByType索引参数。 例如,当数字媒体项目被分类为多个流派时,这非常有用。

若要使用此方法,需要对库进行读取访问权限。 有关详细信息,请参阅 库访问

此方法可能会导致错误。 调用此方法时,应包含错误处理代码。 例如,在JScript,可以使用 try... 实现错误处理...抓住。。。最后结构。

Windows 媒体播放器 10 移动版:不支持此方法。

要求

要求
版本
Windows Media Player 9 系列或更高版本。
DLL
Wmp.dll

另请参阅

媒体对象

Media.attributeCount

Media.getAttributeCountByType

Media.getAttributeName

Media.getItemInfo

Media.setItemInfo

MetadataPicture 对象

MetadataText 对象

读取属性值

设置.mediaAccessRights

设置.requestMediaAccessRights