CObList::InsertBefore

Artikel
06/10/2015

Fügt ein Element dieser Liste vor dem Element an der angegebenen Position hinzu.

POSITION InsertBefore( 
   POSITION position, 
   CObject* newElement  
);

Parameter

position
Ein Wert POSITION zurückgegebenen Daten vorhergehendes GetNext, GetPrev oder Suchen-Memberfunktionsaufruf zurück.
newElement
Der zu dieser Liste hinzugefügt werden Objektzeiger.

Rückgabewert

Ein Wert, der POSITION für Iteration oder Objektzeigerabruf verwendet werden kann, NULL, wenn die Liste leer ist.

In der folgenden Tabelle werden andere Memberfunktionen auf, die mit CObList::InsertBefore ähneln.

Klasse	Memberfunktion
CPtrList	POSITION InsertBefore( POSITION Position, void* newElement);
CStringList	POSITION InsertBefore( POSITION Position, const CString& newElement); POSITION InsertBefore( POSITION Position, LPCTSTR newElement);

CPtrList

POSITION InsertBefore( POSITION Position, void* newElement);

CStringList

POSITION InsertBefore( POSITION Position, const CString& newElement);

POSITION InsertBefore( POSITION Position, LPCTSTR newElement);

Beispiel

Siehe CObList::CObList für Listen der CAge-Klasse.

CObList list;
POSITION pos1, pos2;
list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21). 
if ((pos1 = list.GetTailPosition()) != NULL)
{
    pos2 = list.InsertBefore(pos1, new CAge(65));
}
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("InsertBefore example: ") << &list << _T("\n");
#endif

Die Ergebnisse dieses Programms sind, wie folgt:

InsertBefore example: A CObList with 3 elements

a CAge at $4AE2 40

a CAge at $4B02 65

a CAge at $49E6 21