使用 CObArray 類別

支援某些 CObject 指標。

class CObArray : public CObject

成員

名稱	描述
CObArray::CObArray	建構 CObject 指標的空陣列。

名稱	描述
CObArray::Add	將項目加入至陣列結尾;如果需要，擴大陣列。
CObArray::Append	附加另一個陣列的陣列;如果需要，擴大陣列。
CObArray::Copy	複製到另一個陣列的陣列;如果需要，擴大陣列。
CObArray::ElementAt	傳回項目指標的暫存參考在陣列中。
CObArray::FreeExtra	釋放在目前的上限 (Upper Bound) 上的所有未使用的記憶體。
CObArray::GetAt	傳回值是在指定的索引。
CObArray::GetCount	取得項目的參數數目等於陣列中的。
CObArray::GetData	允許存取項目的存取陣列中。可以是 NULL。
CObArray::GetSize	取得項目的參數數目等於陣列中的。
CObArray::GetUpperBound	會傳回最大的有效索引。
CObArray::InsertAt	插入項目 (或另一個檔案中的所有元素的陣列) 中的指定索引。
CObArray::IsEmpty	判斷陣列是否是空的。
CObArray::RemoveAll	從陣列中移除所有項目。
CObArray::RemoveAt	移除項目中的特定索引處。
CObArray::SetAt	設定指定之索引的值;不允許的陣列成長。
CObArray::SetAtGrow	設定指定之索引的值;如果需要，擴大陣列。
CObArray::SetSize	將陣列中的元素數目。

名稱	描述
[in] CObArray::operator	設定或取得這個項目在指定之索引處的。

這些物件陣列類似於 C 陣列，但是，可以動態壓縮並視需要增加。

陣列索引永遠從位置 0 開始。當您將傳遞目前繫結的項目時，您可以決定是否修正此上限或允許陣列展開。記憶體連續配置給這個上限，，即使有些項目是空的。

在下， CObArray Win32 物件的大小只受限於可用記憶體。

與 C 語言 . 陣列， CObArray 索引項目的存取時間是常數也是陣列大小無關。

CObArray 合併 IMPLEMENT_SERIAL 巨集支援序列化和傾印其項目。如果陣列 CObject 指標儲存到檔案，則會有多載插入運算子的或 Serialize 成員函式中，每個 CObject 項目與其陣列索引，然後，序列化。

如果您在陣列需要個別項目 CObject 傾印，您必須設定 CDumpContext 物件的深度為 1 或更大。

當 CObArray 刪除物件，或，在移除其元素，，才會移除參考的 CObject 指標，而不是物件。

注意事項
在使用陣列，請使用 SetSize 建立控制項的大小和配置其記憶體。如果您不使用 SetSize，將項目加入至陣列會經常被重新配置和複製。經常重新配置和複製沒有效率，而且可能分段記憶體。