CAtlList Class

Diese Klasse stellt Methoden zum Erstellen und Verwalten eines Listenobjekts bereit.

template< 
   typename E, 
   class ETraits = CElementTraits< E > 
> 
class CAtlList

Parameter

• E
  Der Elementtyp.

• ETraits
  Der Code verwendet, um Elemente zu kopieren oder verschieben. Siehe CElementTraits-Klasse für weitere Details.

Mitglieder

Öffentliche Typedefs

Name	Description
CAtlList::INARGTYPE

Öffentliche Konstruktoren

Name	Description
CAtlList::CAtlList	Der -Konstruktor.
CAtlList::~CAtlList	Der Destruktor.

Öffentliche Methoden

Name	Description
CAtlList::AddHead	Rufen Sie diese Methode auf, um ein Element am Anfang der Liste hinzuzufügen.
CAtlList::AddHeadList	Rufen Sie diese Methode auf, um eine vorhandene Liste den Kopf der Liste hinzuzufügen.
CAtlList::AddTail	Rufen Sie diese Methode auf, um ein Element am Ende dieser Liste hinzuzufügen.
CAtlList::AddTailList	Rufen Sie diese Methode auf, um eine vorhandene Liste dem Ende der Liste hinzuzufügen.
CAtlList::AssertValid	Rufen Sie diese Methode auf, um die Liste zu bestätigen ist gültig.
CAtlList::Find	Rufen Sie diese Methode auf, um die Liste für das angegebene Element zu suchen.
CAtlList::FindIndex	Rufen Sie diese Methode auf, erhält die Position eines Elements, Indexwert angegeben.
CAtlList::GetAt	Rufen Sie diese Methode auf, um das Element in einer angegebenen Position in der Liste zurückgegeben.
CAtlList::GetCount	Rufen Sie diese Methode auf, um die Anzahl von Objekten in der Liste zurückgegeben.
CAtlList::GetHead	Rufen Sie diese Methode auf, um das Element am Anfang der Liste zurückzugeben.
CAtlList::GetHeadPosition	Rufen Sie diese Methode auf, um zum Abrufen der Position des Kopfes der Liste.
CAtlList::GetNext	Rufen Sie diese Methode auf, um das folgende Element aus der Liste zurückgegeben.
CAtlList::GetPrev	Rufen Sie diese Methode auf, um das vorherige Element aus der Liste zurückgegeben.
CAtlList::GetTail	Rufen Sie diese Methode auf, um das Element am Ende der Liste zurückgegeben.
CAtlList::GetTailPosition	Rufen Sie diese Methode auf, um zum Abrufen der Position des Stapelrahmens der Liste.
CAtlList::InsertAfter	Rufen Sie diese Methode auf, um ein neues Element in die Liste einzufügen nach den angegebenen Speicherort.
CAtlList::InsertBefore	Rufen Sie diese Methode auf, um ein neues Element in die Liste einzufügen bevor die angegebene Position.
CAtlList::IsEmpty	Rufen Sie diese Methode auf, um zu bestimmen, ob die Liste leer ist.
CAtlList::MoveToHead	Rufen Sie diese Methode auf, um das angegebene Element auf den Anfang der Liste zu verschieben.
CAtlList::MoveToTail	Rufen Sie diese Methode auf, um das angegebene Element auf das Ende der Liste zu verschieben.
CAtlList::RemoveAll	Rufen Sie diese Methode auf, um alle Elemente aus der Liste zu entfernen.
CAtlList::RemoveAt	Rufen Sie diese Methode auf, um ein einzelnes Element aus der Liste zu entfernen.
CAtlList::RemoveHead	Rufen Sie diese Methode auf, um das Element am Anfang der Liste zu entfernen.
CAtlList::RemoveHeadNoReturn	Rufen Sie diese Methode auf, um das Element am Anfang der Liste zu entfernen, ohne einen Wert zurückzugeben.
CAtlList::RemoveTail	Rufen Sie diese Methode auf, um das Element am Ende der Liste zu entfernen.
CAtlList::RemoveTailNoReturn	Rufen Sie diese Methode auf, um das Element am Ende der Liste zu entfernen, ohne einen Wert zurückzugeben.
CAtlList::SetAt	Rufen Sie diese Methode auf, um den Wert des Elements in einer angegebenen Position in der Liste.
CAtlList::SwapElements	Rufen Sie diese Methode auf, um Elemente in der Liste auszulagern.

Hinweise

Die Klasse unterstützt CAtlList sortierte Listen von den nonunique Objekten, die sequenziell zugegriffen werden kann oder durch einen Wert. CAtlList Listen verhalten sich wie doppelt verknüpfte Listen. Jede Liste hat einen Anfang und Ende ein, und neue Elemente (oder Listen in einigen Fällen) können am Ende der Liste hinzugefügt werden, oder vor oder nach bestimmten Elementen eingefügt werden.

Die meisten CAtlList-Methoden nutzen einen Positionswert aus. Dieser Wert wird durch die Methoden verwendet, um die eigentliche Speicheradresse zu verweisen, in der die Elemente gespeichert werden, und sollte nicht direkt abgeleitet werden oder vorhergesagt werden. Wenn es erforderlich ist, auf das n-te-Element in der Liste zuzugreifen, gibt die Methode CAtlList::FindIndex den entsprechenden Positionswert für einen angegebenen Index zurück. Die Methoden CAtlList::GetNext und CAtlList::GetPrev können verwendet werden, um durch die Objekte in der Liste zu durchlaufen.

Weitere Informationen zu den Auflistungsklassen, die mit ATL verfügbar sind, finden Sie unter ATL-Auflistungsklassen.

Anforderungen

Header: atlcoll.h

Siehe auch

Referenz

CList-Klasse

Weitere Ressourcen

ATL Class Overview