Media.name

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

name 属性指定或检索媒体项的名称。

语法

玩家。currentMedia。名字

可能的值

此属性是包含媒体项名称的读/写 String 。

备注

若要检索此属性的值，需要对库的读取访问权限。 若要指定此属性的值，需要对库的完全访问权限。 有关详细信息，请参阅 库访问。

在使用此方法指定媒体项的名称之前，请使用 isReadOnlyItem 确定是否可以设置名称。

Windows 媒体播放器 10 移动版：此属性为只读。

示例

以下 JScript 示例使用 媒体。name ：更改当前媒体项的名称。 名为 NameText 的 HTML 文本输入元素允许用户为新名称输入文本字符串。 创建的 Player 对象 ID 为“Player”。

<!<entity type="mdash"/>-Create an HTML BUTTON element to execute the name change. -->
<INPUT type = "BUTTON"  id = "NewName"  name = "NewName"  value = "Change Name" 
    onClick = "

        /* Store the current media item. */
        var cm = Player.currentMedia;

        /* Change the name. */
        cm.name = NameText.value;
">

要求

要求	值
版本	Windows 媒体播放器版本 7.0 或更高版本。
DLL	Wmp.dll

另请参阅

媒体对象

Settings.mediaAccessRights

Settings.requestMediaAccessRights