Classe CBaseList

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Gerarchia di classi cbaselist

Il metodo CBaseList implementa un elenco abtract. Il modello di classe CGenericList , che deriva da CBaseList, fornisce il controllo dei tipi e un'interfaccia più semplice rispetto alla classe CBaseList .

La classe CBaseList viene modellata dopo la classe CObList nella libreria MFC (Microsoft Foundation Classes). Le posizioni all'interno dell'elenco sono rappresentate da una struttura POSITION. Il chiamante non deve accedere ai membri interni della struttura POSITION; considerarlo come puntatore a un nodo elenco. La posizione di un oggetto nell'elenco rimane valida fino a quando l'oggetto non viene eliminato.

L'elenco non richiede alcun supporto per gli oggetti in esso contenuti. Non esegue alcuna gestione dell'archiviazione o copia sugli oggetti. Gli oggetti possono trovarsi in più elenchi.

Circa la metà dei metodi di questa classe agisce su singoli oggetti. Questi metodi hanno il suffisso - I nel nome del metodo. Gli altri metodi agiscono su interi elenchi. Ad esempio, il metodo CBaseList::AddAfter aggiunge un elenco a un altro elenco. Le operazioni a oggetto singolo restituiscono valori POSITION o NULL in caso di errore. Le operazioni di elenco restituiscono TRUE se l'operazione riesce o FALSE in caso contrario.

Variabili membro protette Descrizione
m_Count Numero di elementi nell'elenco.
m_pFirst Puntatore al primo nodo nell'elenco.
m_pLast Puntatore all'ultimo nodo nell'elenco.
Metodi protetti Descrizione
GetNextI Recupera l'elemento nella posizione specificata e sposta in avanti la posizione.
GetI Recupera l'elemento nella posizione specificata.
FindI Recupera la prima posizione che contiene l'elemento specificato.
RemoveHeadI Rimuove il primo elemento nell'elenco.
RemoveTailI Rimuove l'ultimo elemento nell'elenco.
RemoveI Rimuove l'elemento nella posizione specificata.
AddTailI Aggiunge un elemento alla fine dell'elenco.
AddHeadI Aggiunge un elemento alla parte anteriore dell'elenco.
AddAfterI Inserisce un elemento dopo la posizione specificata.
AddBeforeI Inserisce un elemento prima della posizione specificata.
Metodi pubblici Descrizione
CBaseList Metodo del costruttore.
~ CBaseList Metodo distruttore.
RemoveAll Rimuove tutti i nodi dall'elenco.
GetHeadPositionI Recupera la posizione del primo elemento nell'elenco.
GetTailPositionI Recupera la posizione dell'ultimo elemento dell'elenco.
GetCountI Recupera il numero di elementi nell'elenco.
Avanti Recupera la posizione successiva nell'elenco.
Prev Recupera la posizione precedente nell'elenco.
AddHead Inserisce un altro elenco all'inizio dell'elenco.
AddTail Aggiunge un altro elenco alla fine di questo elenco.
AddAfter Inserisce un elenco dopo la posizione specificata.
AddBefore Inserisce un elenco prima della posizione specificata.
MoveToTail Divide l'elenco e aggiunge la parte head alla parte finale di un altro elenco.
MoveToHead Suddivide l'elenco e inserisce la parte finale all'inizio di un altro elenco.
Invertire Inverte l'ordine dell'elenco.

Requisiti

Requisito Valore
Intestazione
Wxlist.h (include Streams.h)
Libreria
Strmbase.lib (build retail);
Strmbasd.lib (build di debug)

Vedi anche

Classi di base DirectShow