Condividi tramite


CTypedPtrList::GetNext

Ottiene l'elemento dell'elenco identificato da rPosition, quindi imposta rPosition al valore della posizione della voce seguente nell'elenco.

TYPE& GetNext( 
   POSITION& rPosition  
); 
TYPE GetNext( 
   POSITION& rPosition  
) const;

Parametri

  • TIPO
    Parametro di modello che specifica il tipo di elementi contenuti in questo elenco.

  • rPosition
    Un riferimento a un valore di percorso restituito da GetNextprecedente, da GetHeadPosition, o da un'altra chiamata di funzione membro.

Valore restituito

Se l'elenco viene eseguito tramite un puntatore a const CTypedPtrList, quindi GetNext restituisce un puntatore di tipo specificato da TIPO1di parametro di modello. Questo consente alla funzione da utilizzare solo nella parte destra di un'istruzione di assegnazione e quindi proteggere l'elenco di modifica.

Se l'elenco viene eseguito direttamente o tramite un puntatore a CTypedPtrList, quindi GetNext restituisce un riferimento a un puntatore di tipo specificato da TIPO1di parametro di modello. Questo consente alla funzione da utilizzare per entrambi i lati di un'istruzione di assegnazione e pertanto consente le voci di elenco da modificare.

Note

È possibile utilizzare GetNext in un ciclo di iterazione in avanti se si stabilisce la posizione iniziale con una chiamata a GetHeadPosition o a CPtrList::Find.

È necessario assicurarsi che il valore della posizione rappresenta un percorso valido nell'elenco. Se non è valido, quindi la versione di debug delle asserzioni della libreria MFC.

Se l'elemento recuperato è l'ultimo nell'elenco, il nuovo valore rPosition è impostato su NULL.

È possibile eliminare un elemento durante un'iterazione. Vedere l'esempio relativo CObList::RemoveAt.

Requisiti

Header: afxtempl.h

Vedere anche

Riferimenti

Classe CTypedPtrList

Grafico delle gerarchie

CObList::Find

CObList::GetHeadPosition

CObList::GetTailPosition

CTypedPtrList::GetPrev

CTypedPtrList::GetHead

CTypedPtrList::GetTail