Metodo IWMPMediaCollection2::createQuery

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché 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 restituisce un'interfaccia createQueryIWMPQuery che rappresenta una nuova query.

Sintassi

public IWMPQuery createQuery();

Public Function createQuery() As IWMPQuery
Implements IWMPMediaCollection2.createQuery

Parametri

Questo metodo non presenta parametri.

Valore restituito

Interfaccia WMPLib.IWMPQuery che rappresenta una nuova query vuota.

Commenti

La creazione di una nuova query è il primo passaggio per la creazione di una query composta.

Esempio

Nell'esempio seguente viene createQuery usata per ottenere un'interfaccia IWMPQuery inizializzata su Null. Poiché questa query non ha condizioni aggiunte, quando viene usata come argomento nel metodo getStringCollectionByQuery , il metodo restituirà un insieme stringa contenente tutti gli elementi multimediali del tipo di supporto specificato. La raccolta di stringhe viene quindi visualizzata in una casella di riepilogo.

// Get an IWMPMediaCollection2 interface so that you can access the createQuery and
// getStringCollectionByQuery methods.
WMPLib.IWMPMediaCollection2 mc = (WMPLib.IWMPMediaCollection2)player.mediaCollection;

// Create an IWMPQuery interface with no conditions added to it.
WMPLib.IWMPQuery nullQuery = mc.createQuery();

// Get a string collection that contains the titles of all the audio items in the media
// collection.
WMPLib.IWMPStringCollection2 allTitles = (WMPLib.IWMPStringCollection2)mc.getStringCollectionByQuery("Title", nullQuery, "audio", "", false);

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

' Get an IWMPMediaCollection2 interface so that you can access
' the createQuery and getStringCollectionByQuery methods.
Dim mc As WMPLib.IWMPMediaCollection2 = player.mediaCollection

' Create an IWMPQuery interface with no conditions added to it.
Dim nullQuery As WMPLib.IWMPQuery = mc.createQuery()

' Get a string collection that contains the titles of all the audio items in the media
' collection
Dim allTitles As WMPLib.IWMPStringCollection2 = mc.getStringCollectionByQuery("Title", nullQuery, "audio", "", False)

' Display the titles by adding them to a ListBox
For i As Integer = 0 To (allTitles.count - 1)

    queryResults.Items.Add(allTitles.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

Interfaccia IWMPMediaCollection2 (VB e C#)

Interfaccia IWMPQuery (VB e C#)