CAtlList 類別

這個類別會建立和管理清單物件的方法。

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

參數

• E
  元素型別。

• ETraits
  程式碼會在執行複製或移動項目。 如需的詳細資訊請參閱 CElementTraits 類別 。

Members

公用 Typedefs

名稱	描述
CAtlList::INARGTYPE

公用建構函式

名稱	描述
CAtlList::CAtlList	建構函式。
CAtlList::~CAtlList	解構函式。

公用方法

名稱	描述
CAtlList::AddHead	呼叫這個方法將項目加入至清單的開頭。
CAtlList::AddHeadList	呼叫這個方法會將現有的清單加入至清單的開頭。
CAtlList::AddTail	呼叫這個方法將項目加入此清單的尾端。
CAtlList::AddTailList	呼叫這個方法會將現有的清單加入至這份清單尾端。
CAtlList::AssertValid	呼叫這個方法會檢查清單中有效。
CAtlList::Find	呼叫這個方法會搜尋清單中指定的項目。
CAtlList::FindIndex	呼叫這個方法會取得項目的位置將索引值。
CAtlList::GetAt	呼叫這個方法會傳回這個項目在 清單中指定的位置。
CAtlList::GetCount	呼叫這個方法會傳回物件的數目的清單。
CAtlList::GetHead	呼叫這個方法會傳回這個項目在清單的開頭。
CAtlList::GetHeadPosition	呼叫這個方法會取得清單的開頭的位置。
CAtlList::GetNext	呼叫這個方法會從清單中的下一個項目。
CAtlList::GetPrev	呼叫這個方法會從清單中前一個項目。
CAtlList::GetTail	呼叫這個方法會傳回這個項目在清單的尾端。
CAtlList::GetTailPosition	呼叫這個方法會取得清單的尾端的位置。
CAtlList::InsertAfter	呼叫這個方法會將新的項目插入至清單中的指定位置之後。
CAtlList::InsertBefore	呼叫這個方法會將新的項目插入至清單中的指定位置之前。
CAtlList::IsEmpty	呼叫這個方法會決定清單是否為 null。
CAtlList::MoveToHead	呼叫這個方法會將指定的項目移至清單的開頭。
CAtlList::MoveToTail	呼叫這個方法會將指定的項目移至清單的尾端。
CAtlList::RemoveAll	呼叫這個方法會從清單移除所有項目。
CAtlList::RemoveAt	呼叫這個方法從清單中移除單一項目。
CAtlList::RemoveHead	呼叫這個方法會移除這個項目在清單的開頭。
CAtlList::RemoveHeadNoReturn	呼叫這個方法會移除這個項目在清單的開頭，而不會傳回值。
CAtlList::RemoveTail	呼叫這個方法會移除這個項目在清單的尾端。
CAtlList::RemoveTailNoReturn	呼叫這個方法會移除這個項目在清單的尾端，而不會傳回值。
CAtlList::SetAt	呼叫這個方法會將項目的值在清單中的特定位置。
CAtlList::SwapElements	呼叫這個方法會交換清單中的項目。

備註

CAtlList 類別會依序支援可存取非唯一的物件排序清單或傳值。 CAtlList 清單的行為就像雙向連結串列。 每個清單具有開頭與尾端，一行，而在其他情況下新項目的項目 (或清單) 可以加入任一端的清單或在特定項目前後插入。

大部分 CAtlList 方法可用位置的值。 方法會使用這個值來參考項目中的實際記憶體位置，且不應直接計算或預測。 如果存取清單中的 第 n 個項目是必須的， CAtlList::FindIndex 方法會傳回指定索引中的對應位置的值。 方法 CAtlList::GetNext 和 CAtlList::GetPrev 物件可用於逐一查看清單中逐一查看的物件。

如需集合類別的詳細資訊可供 ATL，請參閱 ATL 集合類別。。

需求

Header: atlcoll.h

請參閱

參考

CList 類別

其他資源

ATL 類別概觀