Metodo IWMPQuery::beginNextGroup

Articolo
06/21/2023

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo beginNextGroup inizia un nuovo gruppo di condizioni.

Sintassi

public void beginNextGroup();


Public Sub beginNextGroup()
Implements IWMPQuery.beginNextGroup

Parametri

Questo metodo non presenta parametri.

Valore restituito

Questo metodo non restituisce valori.

Commenti

L'inizio di un nuovo gruppo di condizioni implica che il gruppo di condizioni corrente è stato completato. Il nuovo gruppo di condizioni viene sempre concatenato al gruppo di condizioni precedente usando la logica OR .

Esempio

Nell'esempio seguente viene creata una query complessa eseguendo il combing di due gruppi ognuno contenente una condizione. I risultati della query vengono estratti come raccolta di stringhe e visualizzati in una casella di riepilogo. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata player.

// Get a new Query interface.
WMPLib.IWMPMediaCollection2 mc = (WMPLib.IWMPMediaCollection2)player.mediaCollection;
WMPLib.IWMPQuery q = mc.createQuery();

// Add a condition to the Query. 
q.addCondition("WM/Composer", "Equals", "Antonio Vivaldi");

// Begin another Query group.
q.beginNextGroup();

// Add a condition to the new group understanding that it will be combined with the
// first group using OR logic.
q.addCondition("Title", "Contains", "Capriol");

// Query the media collection and get a string collection containing the result.
// In this case, the string collection will contain the titles of all audio items that
// match the query.
WMPLib.IWMPStringCollection2 result = (WMPLib.IWMPStringCollection2)mc.getStringCollectionByQuery("Title", q, "audio", "", false);

// Display the results by adding them to a list box.
for (int i = 0; i < result.count; i++)
{
    complexQueryResults.Items.Add(result.Item(i));
}


' Get a new Query interface.
Dim mc As WMPLib.IWMPMediaCollection2 = player.mediaCollection
Dim q As WMPLib.IWMPQuery = mc.createQuery()

' Add a condition to the Query. 
q.addCondition("WM/Composer", "Equals", "Antonio Vivaldi")

' Begin another Query group.
q.beginNextGroup()

' Add a condition to the new group understanding that it will be combined with the
' first group using OR logic.
q.addCondition("Title", "Contains", "Capriol")

' Query the media collection and get a string collection containing the result.
' In this case, the string collection will contain the titles of all audio items that
' match the query.
Dim result As WMPLib.IWMPStringCollection2 = mc.getStringCollectionByQuery("Title", q, "audio", "", False)

' Display the results by adding them to a list box.
For i As Integer = 0 To (result.count - 1)

    complexQueryResults.Items.Add(result.Item(i))

Next i

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows 11.
Spazio dei nomi	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Vedi anche

IWMPMediaCollection2.createQuery (VB e C#)
IWMPMediaCollection2.getPlaylistByQuery (VB e C#)
IWMPMediaCollection2.getStringCollectionByQuery (VB e C#)
Interfaccia IWMPQuery (VB e C#)

Share via