CList::GetNext

發行項
02/28/2013

取得清單項目所識別 rPosition，然後將 rPosition 到下一個項目的位置值清單中的。

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

參數

型別
指定項目之型別的樣板參數清單中。
rPosition
為位置值的參考是由先前 GetNext、 GetHeadPosition，或其他成員函式呼叫會傳回。

傳回值

如果清單是 const， GetNext 傳回清單項目的複本。這可讓函式在指派陳述式右邊只使用和保護清單受到修改。

如果清單不是， constGetNext 傳回套用至清單項目的參考。這可讓函式使用在指派陳述式的任一端上因此允許清單項目進行修改。

備註

例如，如果您建立與呼叫的初始位置。 GetHeadPosition 或尋找，在一個向前反覆項目迴圈可以使用 GetNext 。

您必須確定您的位置值代表清單中的有效位置。如果其無效，則 MFC 程式庫的偵錯版本的判斷提示。

如果所擷取的項目是清單中的最後一個，則 rPosition 的新值設定為 NULL。

範例

// Define myList.
CList<CString,CString&> myList;

// Add two elements to the list.
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));

// Dump the list elements to the debug window.
POSITION pos = myList.GetHeadPosition();
for (int i = 0; i < myList.GetCount(); i++)
{
   TRACE(_T("%s\r\n"), (LPCTSTR)myList.GetNext(pos));
}