Sobre o objeto Query

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O objeto Query representa uma consulta composta. Você cria um novo objeto Query vazio chamando mediaCollection. createQuery. Depois de criar um objeto Query , você pode chamar addCondition para adicionar uma condição à consulta composta. Cada chamada subsequente para addCondition acrescenta uma nova condição à consulta existente usando a lógica AND.

Por exemplo, suponha que você queira criar uma consulta que represente todas as mídias digitais em que WM/Gênero é igual a "Jazz" e Author contém "Jim". Você pode criar uma consulta composta para representar essas condições usando o seguinte código JScript:

// Create the query object.
var Query = player.mediaCollection.createQuery();

// Add the conditions.
Query.addCondition("WM/Genre", "Equals", "Jazz");
Query.addCondition("Author", "Contains", "Jim");

Para adicionar uma condição a uma consulta composta usando a lógica OR, você deve chamar Query.beginNextGroup. Esse método sinaliza que o grupo de condições anterior foi concluído e que a próxima chamada para addCondition representa o início de um novo grupo de condições.

Por exemplo, para criar uma consulta que represente todas as mídias digitais em que WM/Gênero é igual a "Jazz" e Author contém "Jim" ou Author contém "Dave", você pode usar o seguinte código de exemplo:

// Create the query object.
var Query = player.mediaCollection.createQuery();

// Add the conditions.
Query.addCondition("WM/Genre", "Equals", "Jazz");
Query.addCondition("Author", "Contains", "Jim");

// Start the next condition group. This group will be
// combined with the previous group using a logical OR operation.
Query.beginNextGroup();

// Add the conditions.
Query.addCondition("WM/Genre", "Equals", "Jazz");
Query.addCondition("Author", "Contains", "Dave");

Para executar sua consulta composta, chame MediaCollection.getPlaylistByQuery.

Tópicos relacionados

MediaCollection.getPlaylistByQuery

Modelo de objeto do player para linguagens de script

Objeto Query