Метод Media.setItemInfo

Статья
06/21/2023

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

Метод setItemInfo задает значение указанного атрибута для текущего элемента мультимедиа.

Синтаксис

Media.setItemInfo(
  attribute,
  value
)

Параметры

attribute [in]: Строка , содержащая имя атрибута. Сведения об атрибутах, поддерживаемых Медиаплеер Windows, см. в справочнике по атрибутам Медиаплеер Windows.
value [in]: Строка , содержащая новое значение.

Возвращаемое значение

Этот метод не возвращает значение.

Свойство attributeCount содержит количество атрибутов, доступных для данного объекта Media . Затем номера индексов можно использовать с методом getAttributeName для определения имен встроенных атрибутов, которые можно использовать с этим методом.

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

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

Примечание

При внедрении элемента управления Медиаплеер Windows в приложение измененные атрибуты файла не будут записываться в файл цифрового мультимедиа, пока пользователь не запустит Медиаплеер Windows. Если вы используете элемент управления в удаленном приложении, написанном на C++, измененные атрибуты файла будут записаны в файл цифрового носителя вскоре после внесения изменений. В любом случае изменения сразу же доступны для кода через библиотеку.

Медиаплеер Windows 10 Mobile: этот метод не реализован.

Примеры

В следующем примере JScript используется media. setItemInfo для изменения значения атрибута Genre для текущего элемента мультимедиа. Элемент ввода HTML TEXT с именем genText позволяет пользователю ввести текстовую строку, которая затем используется для изменения сведений об атрибутах. Объект Player был создан с идентификатором " Player".

<!-- Create the button element. -->
<INPUT type = "BUTTON"  id = "NEWGEN"  name = "NEWGEN"  value = "Change Genre" 
onClick = "
    /* Store the current media item. */
    var cm = Player.currentMedia;

    /* Get the user input from the text box. */
    var atValue = genText.value;

    /* Test for read-only status of the attribute. */
    if(cm.isReadOnlyItem('Genre') == false){

        /* Change the attribute value. */
        cm.setItemInfo('Genre' ,atValue);
    } 
">

Требования

Требование	Значение
Версия	Медиаплеер Windows версии 7.0 или более поздней.
DLL	Wmp.dll

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

Объект мультимедиа
Media.getItemInfo
Media.isReadOnlyItem
Settings.mediaAccessRights
Settings.requestMediaAccessRights