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

プロパティ

名前記述
AllowsDuplicatesAllowsDuplicatesは、コレクションが複製を許すかどうかを示します コレクション (PRIM_COLL) より継承
CollectsCollectsプロパティにフォームを指定します。
ComponentClassNameコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
ComponentMembersこのコンポーネントの全てにアクセスできるようにします。 オブジェクト (PRIM_OBJT) より継承
ComponentPatternNameコンポーネントのクラスを制限します。 オブジェクト (PRIM_OBJT) より継承
ComponentTagインスタンス用に値を格納できる汎用スペース オブジェクト (PRIM_OBJT) より継承
ComponentTypeComponentTypeではコンポーネントのタイプ情報にアクセスできます。 オブジェクト (PRIM_OBJT) より継承
ComponentTypeNameComponentTypeName十分適格なコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
FirstFirstはコレクションの最初の項目です
IndexOfIndexOfは、コレクションの項目のインデックス番号を返します
IsEmptyIsEmptyは、コレクション内に項目があるかどうかを示します。 コレクション (PRIM_COLL) より継承
IsOrderedIsOrderedは、コレクションが配列かどうかを示します。 コレクション (PRIM_COLL) より継承
ItemItemプロパティはコレクション内の特定の項目へのアクセスを提供します
ItemCountItemCountはコレクション内の項目数です コレクション (PRIM_COLL) より継承
LastLastは、コレクションの最後の項目です
LastIndexOfコンポーネントの最後の発生を探してリストを検索します。
Nameコンポーネントの名前 オブジェクト (PRIM_OBJT) より継承
Ownerコンポーネントのオーナーです。 オブジェクト (PRIM_OBJT) より継承
Parentこのインスタンスが添付されているコンポーネントインスタンス。コントロールのビジュアルコンテナまたは子インスタンスのコレクション オブジェクト (PRIM_OBJT) より継承

イベント

名前記述
CreateInstanceコンポーネントを作成する時にCreateInstanceのイベントを実行します。 オブジェクト (PRIM_OBJT) より継承
DestroyInstanceコンポーネントが解除される前にDestroyInstanceのイベントを実行します。 オブジェクト (PRIM_OBJT) より継承
IsEqualIsEqualイベントは、コレクションがイコールである時に発生します。
Object, Subject, Equal

メソッド

名前記述
AppendAppendメソッドは、コンポーネントをコレクションの最後に挿入します。
OtherList
CalculateHashCalculateHashはハッシュ値を計算します。 コレクション (PRIM_COLL) より継承
Result, Value
Concatenate2つのコレクションを結合させて、新規コレクションを作成します
Result, OtherList
Contains提供されたインスタンスはコレクション内に存在するかどうか
Result, Object
CreateAccessorコレクションにリードオンリーでアクセス出来るアクセサーコンポーネントを作ります。
Result
CreateIteratorコレクションを通して繰り返しを可能にする反復子コンポーネントを作ります。
Result
InsertInsertメソッドはコレクションに項目を追加します。
Item
InsertAfter指定されたコレクション項目の後ろに項目を追加します。
Item, Index
InsertBeforeInsertbeforeは指定された項目の前に、項目を追加します
Item, Index
InsertFirstInsertFirstコレクションの先頭に項目を追加します
Item
InsertLastInsertLastはコレクションの最後に項目を追加します
Item
OccurrencesOfコレクション内のインスタンスの発生数を検索します
Result, Object
RemoveRemoveメソッドは項目を削除します
Result, Object
RemoveAllRemoveAllはコレクションの全項目を削除します
RemoveAt指定された位置の項目を削除します
Result, Index
RemoveFirstコレクションから最初の項目を削除します。
Result
RemoveLastコレクションから最後の項目を削除します。
Result
ReplaceAt指定された位置のインスタンスを別のオブジェクトと置換します。
Result, Item, Index

参照

すべてのコンポーネント クラス

テクニカルリファレンス

EPC150060 - December 2023