Метод MediaCollection.getStringCollectionByQuery

  • Статья

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

Метод getStringCollectionByQuery извлекает объект StringCollection, содержащий все строки, соответствующие условиям запроса.

Синтаксис

retVal = MediaCollection.getStringCollectionByQuery(
  attribute,
  query,
  mediaType,
  sortAttribute,
  sortAscending
)

Параметры

attribute [in]

Строка , содержащая имя атрибута.

query [in]

Объект запроса .

mediaType [in]

Строка , содержащая тип носителя. Должен содержать одно из следующих значений: "audio", "video", "photo", "playlist" или "other".

sortAttribute [in]

Строка , содержащая имя атрибута, используемого для сортировки. Пустая строка ("") означает, что сортировка не применяется.

sortAscending [in]

Логическое значение, значение true указывает, что Коллекция StringCollection должна быть отсортирована по возрастанию.

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

Этот метод возвращает объект StringCollection .

Комментарии

Составные запросы, использующие запросы, не чувствительны к регистру.

Если составной запрос, заданный параметром запроса , содержит условие, созданное на основе атрибута MediaType , это условие игнорируется. Всегда используется значение параметра mediaType . Например, если составной запрос содержит условие "MediaType Equals audio", а параметр mediaType имеет значение "video", итоговый список воспроизведения будет содержать только элементы видео.

Требования

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

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

Объект MediaCollection

Атрибут MediaType

Объект запроса