Media.name

[Функция, связанная с этой страницей, Медиаплеер Windows SDK, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Свойство name указывает или извлекает имя элемента мультимедиа.

Синтаксис

проигрыватель. currentMedia. Имя

Возможные значения

Это свойство представляет собой строку для чтения и записи, содержащую имя элемента мультимедиа.

Комментарии

Чтобы получить значение этого свойства, требуется доступ на чтение к библиотеке. Чтобы указать значение этого свойства, требуется полный доступ к библиотеке. Дополнительные сведения см. в разделе Доступ к библиотеке.

Перед использованием этого метода для указания имени элемента мультимедиа используйте isReadOnlyItem , чтобы определить, можно ли задать имя.

Медиаплеер Windows 10 Mobile: это свойство доступно только для чтения.

Примеры

В следующем примере JScript используется media. name для изменения имени текущего элемента мультимедиа. Элемент ввода HTML TEXT с именем NameText позволяет пользователю ввести текстовую строку для нового имени. Объект Player был создан с идентификатором " 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