Listコレクション (PRIM_LCOL)
インデックス経由でアクセス可能なオブジェクトのシーケンシャルコレクション
祖先 - コレクション (PRIM_COLL) オブジェクト (PRIM_OBJT)
詳細
リスト・コレクションでは、規則どおりに並んだコンポーネントの集まりが提供されます。
リスト・コンポーネントの特徴は、指定された索引またはリストの開始や終了を参照して実際の位置を決めることです。 常に索引は1に対する値が付けられます。
List コレクションと Array コレクションは通常とてもよく似ています。ひとつ違うことは、ウィンドズで割り当てメモリの方法です。
例
リストコレクションを定義する。 このコレクションは限られた顧客ユーザーデータオブジェクトの例を集めます。
Define_Com Class(#Prim_Lcol<#Customer>) Name(#Customers)
コレクション項目は存在する参照か以下の新しくできた割り当てによって作られます。
#Customers.Insert((*New #Customer))
コレクション項目は新しいコレクションの位置によってアクセスできます。
#Customers<123>.CustomerName := #CustomerName
全てのコレクションアイテムは次のように扱うことができます。ここにコレクションの全ての顧客が増加したプロパティ―値を持っています。
#Customers<>.CreditLimit += 1000
FOR コマンドはコレクションコンテンツを通して、反復にも使われています。項目はコレクションに格納されたオーダーに返します。
For each(#Customer) in (#Customers)
...
Endfor
コレクションのあらゆる例からのイベントをモニターチェックするために、<> EVTROUTINE を追加できます。COM_SENDER パラメータは インスタンスのイベント起動へのアクセスをします。
この例のようにお客様例の変更事項はチェックされています。
Evtroutine Handling(#Customers<>.Changed) Com_Sender(#Sender)
#Com_owner.AddEvent(("&1 changed").Substitute(#Sender.CustomerName))
Endroutine
プロパティ
名前 | 記述 |
|---|---|
AllowsDuplicatesは、コレクションが複製を許すかどうかを示します コレクション (PRIM_COLL) より継承 | |
Collectsプロパティにフォームを指定します。 | |
コンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承 | |
このコンポーネントの全てにアクセスできるようにします。 オブジェクト (PRIM_OBJT) より継承 | |
コンポーネントのクラスを制限します。 オブジェクト (PRIM_OBJT) より継承 | |
インスタンス用に値を格納できる汎用スペース オブジェクト (PRIM_OBJT) より継承 | |
ComponentTypeではコンポーネントのタイプ情報にアクセスできます。 オブジェクト (PRIM_OBJT) より継承 | |
ComponentTypeName十分適格なコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承 | |
Firstはコレクションの最初の項目です | |
IndexOfは、コレクションの項目のインデックス番号を返します | |
IsEmptyは、コレクション内に項目があるかどうかを示します。 コレクション (PRIM_COLL) より継承 | |
IsOrderedは、コレクションが配列かどうかを示します。 コレクション (PRIM_COLL) より継承 | |
Itemプロパティはコレクション内の特定の項目へのアクセスを提供します | |
ItemCountはコレクション内の項目数です コレクション (PRIM_COLL) より継承 | |
Lastは、コレクションの最後の項目です | |
コンポーネントの最後の発生を探してリストを検索します。 | |
コンポーネントの名前 オブジェクト (PRIM_OBJT) より継承 | |
コンポーネントのオーナーです。 オブジェクト (PRIM_OBJT) より継承 | |
このインスタンスが添付されているコンポーネントインスタンス。コントロールのビジュアルコンテナまたは子インスタンスのコレクション オブジェクト (PRIM_OBJT) より継承 |
イベント
名前 | 記述 |
|---|---|
コンポーネントを作成する時にCreateInstanceのイベントを実行します。 オブジェクト (PRIM_OBJT) より継承 | |
コンポーネントが解除される前にDestroyInstanceのイベントを実行します。 オブジェクト (PRIM_OBJT) より継承 | |
IsEqualイベントは、コレクションがイコールである時に発生します。 Object, Subject, Equal |
メソッド
名前 | 記述 |
|---|---|
Appendメソッドは、コンポーネントをコレクションの最後に挿入します。 OtherList | |
CalculateHashはハッシュ値を計算します。 コレクション (PRIM_COLL) より継承 Result, Value | |
2つのコレクションを結合させて、新規コレクションを作成します Result, OtherList | |
提供されたインスタンスはコレクション内に存在するかどうか Result, Object | |
コレクションにリードオンリーでアクセス出来るアクセサーコンポーネントを作ります。 Result | |
コレクションを通して繰り返しを可能にする反復子コンポーネントを作ります。 Result | |
Insertメソッドはコレクションに項目を追加します。 Item | |
指定されたコレクション項目の後ろに項目を追加します。 Item, Index | |
Insertbeforeは指定された項目の前に、項目を追加します Item, Index | |
InsertFirstコレクションの先頭に項目を追加します Item | |
InsertLastはコレクションの最後に項目を追加します Item | |
コレクション内のインスタンスの発生数を検索します Result, Object | |
Removeメソッドは項目を削除します Result, Object | |
RemoveAllはコレクションの全項目を削除します | |
指定された位置の項目を削除します Result, Index | |
コレクションから最初の項目を削除します。 Result | |
コレクションから最後の項目を削除します。 Result | |
指定された位置のインスタンスを別のオブジェクトと置換します。 Result, Item, Index |