ATL のコレクションと列挙子
collection
は、データ項目のグループ (生データまたはその他のオブジェクト) にアクセスするインターフェイスを提供する COM オブジェクトです。 オブジェクトのグループにアクセスする標準に準拠したインターフェイスは、コレクション インターフェイスと呼ばれます。
コレクション インターフェイスには、少なくとも、コレクション内の項目の数を返す Count
プロパティ、インデックスに基づいてコレクションから項目を返す Item
プロパティ、およびコレクションの列挙子を返す _NewEnum
プロパティが必要です。 コレクション インターフェイスには、必要に応じて、コレクションに項目を挿入または削除したりする Add
および Remove
メソッド、およびすべての項目を削除する Clear
メソッドも備えることができます。
enumerator
は、コレクション内の項目を反復するインターフェイスを提供する COM オブジェクトです。 列挙子インターフェイスは、Next
、Skip
、Reset
、および Clone
の 4 つの必須メソッドを使用して、コレクションの要素へのシリアル アクセスを提供します。
列挙子インターフェイスの詳細については、IEnumString インターフェイスに関する参照コンテンツをお読みください。
このセクションの内容
ATL のコレクションと列挙子クラス
コレクションと列挙子の実装に役立つ ATL クラスについて簡単に説明し、リンクを提供します。
コレクションと列挙子インターフェイスのデザインの原則
インターフェイスの種類ごとの異なる設計原則について説明します。
C++ 標準ライブラリに基づくコレクションの実装
C++ 標準ライブラリに基づくコレクションの実装について詳しい例を説明します。
関連セクション
ATL
Active Template Library を使用してプログラミングする方法に関する概念説明のトピックへのリンクを提供します。
ATLCollections サンプル
ICollectionOnSTLImpl
と CComEnumOnSTL
の使用例、およびカスタム コピー ポリシー クラスの実装を示します。