CAtlList选件类

此选件类为创建和管理列表对象的方法。

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

参数

• E
  元素类型。

• ETraits
  用于的代码复制或移动元素。有关详细信息 CElementTraits选件类 参见。

成员

公共 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	调用此方法来确定列表是否为空。
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选件类概述