Compartilhar via


CObList::InsertBefore

Adiciona um elemento em esta lista antes que o elemento na posição especificada.

POSITION InsertBefore(
   POSITION position,
   CObject* newElement 
);

Parâmetros

  • posição
    Um valor de POSIÇÃO retornado por GetNextanterior, por GetPrev, ou pela chamada de função de membro de Localizar .

  • newElement
    O ponteiro do objeto a ser adicionado à lista.

Valor de retorno

Um valor de POSIÇÃO que pode ser usado para recuperação de iteração ou ponteiro do objeto; NULO se a lista estiver vazia.

A tabela a seguir mostra outras funções de membro que são semelhantes a CObList::InsertBefore.

Classe

Função de membro

CPtrList

POSITION InsertBefore( POSITION posição, void* newElement );

CStringList

POSITION InsertBefore( POSITION posição, const CString& newElement );

POSITION InsertBefore( POSITION posição, LPCTSTR newElement );

Exemplo

Consulte CObList::CObList para uma listagem da classe de CAge .

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      

Os resultados do programa é a seguinte:

InsertBefore example: A CObList with 3 elements

a CAge at $4AE2 40

a CAge at $4B02 65

a CAge at $49E6 21

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe de CObList

Gráfico de hierarquia

CObList::Find

CObList::InsertAfter