CBaseList-Klasse
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die CBaseList-Methode implementiert eine abtract-Liste. Die CGenericList-Klassenvorlage , die von CBaseList abgeleitet ist, bietet die Typüberprüfung und eine einfachere Schnittstelle als die CBaseList-Klasse .
Die CBaseList-Klasse wird nach der CObList-Klasse in der MFC-Bibliothek (Microsoft Foundation Classes) modelliert. Positionen innerhalb der Liste werden durch eine POSITION-Struktur dargestellt. Der Aufrufer sollte nicht auf die internen Elemente der POSITION-Struktur zugreifen. behandeln sie als Zeiger auf einen Listenknoten. Die Position eines Objekts in der Liste bleibt gültig, bis das Objekt gelöscht wird.
Die Liste erfordert keine Unterstützung durch die enthaltenen Objekte. Es führt keine Speicherverwaltung oder das Kopieren der Objekte durch. Objekte können sich in mehreren Listen enthalten.
Ungefähr die Hälfte der Methoden in dieser Klasse wirken auf einzelne Objekte. Diese Methoden haben das Suffix - I im Methodennamen. Die anderen Methoden wirken auf ganze Listen. Die CBaseList::AddAfter-Methode fügt beispielsweise eine Liste an eine andere Liste an. Einzelobjektvorgänge geben POSITION-Werte oder NULL bei Einem Fehler zurück. Listenvorgänge geben TRUE zurück, wenn dies erfolgreich war, oder andernfalls FALSE .
| Geschützte Membervariablen | BESCHREIBUNG |
|---|---|
| m_Count | Anzahl der Elemente in der Liste. |
| m_pFirst | Zeiger auf den ersten Knoten in der Liste. |
| m_pLast | Zeiger auf den letzten Knoten in der Liste. |
| Geschützte Methoden | BESCHREIBUNG |
| GetNextI | Ruft das Element an der angegebenen Position ab und erhöht die Position. |
| GetI | Ruft das Element an der angegebenen Position ab. |
| FindI | Ruft die erste Position ab, die das angegebene Element enthält. |
| RemoveHeadI | Entfernt das erste Element in der Liste. |
| RemoveTailI | Entfernt das letzte Element in der Liste. |
| RemoveI | Entfernt das Element an der angegebenen Position. |
| AddTailI | Fügt am Ende der Liste ein Element hinzu. |
| AddHeadI | Fügt ein Element an der Spitze der Liste hinzu. |
| AddAfterI | Fügt ein Element nach der angegebenen Position ein. |
| AddBeforeI | Fügt ein Element vor der angegebenen Position ein. |
| Öffentliche Methoden | BESCHREIBUNG |
| CBaseList | Konstruktormethode. |
| ~ CBaseList | Destruktormethode. |
| Removeall | Entfernt alle Knoten aus der Liste. |
| GetHeadPositionI | Ruft die Position des ersten Elements in der Liste ab. |
| GetTailPositionI | Ruft die Position des letzten Elements der Liste ab. |
| GetCountI | Ruft die Anzahl der Elemente in der Liste ab. |
| Weiter | Ruft die nächste Position in der Liste ab. |
| Zurück | Ruft die vorherige Position in der Liste ab. |
| AddHead | Fügt eine weitere Liste am Anfang dieser Liste ein. |
| AddTail | Fügt am Ende dieser Liste eine weitere Liste an. |
| Addafter | Fügt eine Liste nach der angegebenen Position ein. |
| Addbefore | Fügt eine Liste vor der angegebenen Position ein. |
| MoveToTail | Teilt die Liste auf und fügt den Kopfteil an den Ende einer anderen Liste an. |
| MoveToHead | Teilt die Liste auf und fügt den Hinterteil am Anfang einer anderen Liste ein. |
| Rückwärts | Kehrt die Reihenfolge der Liste um. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|