IWMPQuery::beginNextGroup method
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The beginNextGroup method begins a new condition group.
Syntax
public void beginNextGroup();
Public Sub beginNextGroup()
Implements IWMPQuery.beginNextGroup
Parameters
This method has no parameters.
Return value
This method does not return a value.
Remarks
Beginning a new condition group implies that you have completed the current condition group. The new condition group is always concatenated to the previous condition group by using OR logic.
Examples
The following example creates a complex query by combing two groups that each contain a condition. The results of the query are extracted as a string collection and displayed in a list box. The AxWMPLib.AxWindowsMediaPlayer object is represented by the variable named 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
Requirements
| Requirement | Value |
|---|---|
| Version |
Windows Media Player 11. |
| Namespace |
WMPLib |
| Assembly |
|