Array コレクション (PRIM_ACOL)
インデックスでアクセスできるオオブジェクトの順次コレクション
祖先 - コレクション (PRIM_COLL) オブジェクト (PRIM_OBJT)
詳細
Array コレクションは動的にサイズ調整され整列されたコンポーネントのコレクションです。
Array コンポーネントは、指定された索引またはリストの先頭や末尾を参照して位置づけられています。索引は常に 1 を基準とした値が付けられます。
Array コレクションと List コレクションは本質的にとてもよく似ていますが、ひとつ大きく違う点は、 Windows のメモリ割り当ての方法です。
例
Array コレクションを定義します。 このコレクションにはユーザー定義の顧客データオオブジェクトのインスタンスが格納されています。
Define_Com Class(#Prim_Acol<#Customer>) Name(#Customers)
コレクション項目は既存の参照もしくは以下のように新しく作成した参照に割り当てることにより作成することができます。
#Customers.Insert((*New #Customer))
コレクション項目はコレクション内の位置によってアクセスすることができます。
#Customers<123>.CustomerName := #CustomerName
全てのコレクション項目は以下のように指定することができます。ここでは、コレクション内の全ての顧客のプロパティ値を増やしています。
#Customers<>.CreditLimit += 1000
FOR コマンドも、コレクション内容の反復に使用することができます。項目はコレクションに格納されている順番で返されます。
For each(#Customer) in (#Customers)
...
Endfor
コレクションの全てのインスタンスからのイベントを監視するために、EVTROUTINE に<> を追加できます。COM_SENDER パラメータを使用して、イベントを起動したインスタンスにアクセスすることができます。
この例では、顧客インスタンスの changed イベントが監視されています。
Evtroutine Handling(#Customers<>.Changed) Com_Sender(#Sender)
#Com_owner.AddEvent(("&1 changed").Substitute(#Sender.CustomerName))
Endroutine
プロパティ
名前 | 記述 |
|---|---|
AllowsDuplicates は、コレクションが複製を許すかどうかを示します コレクション (PRIM_COLL) より継承 | |
コレクトされるオオブジェクトのクラス | |
コンポーネントのクラス名です。 オブジェクト (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 |
メソッド
名前 | 記述 |
|---|---|
CalculateHash はハッシュ値を計算します。 コレクション (PRIM_COLL) より継承 Result, Value | |
提供のインスタンスがコレクションに存在するかどうか Result, Object | |
CreateAccessor は コレクション にリードオンリーでアクセス出来る accessor コンポーネントを作ります。 Result | |
CreateIterator メソッドは、コレクションを通して繰り返しを可能にする反復子コンポーネントを作ります。 Result | |
Insert メソッドはコレクションに項目を追加します。 Item | |
InsertAfter は、指定されたコレクション項目の後ろに項目を追加します Item, Index | |
Insertbefore は指定された項目の前に項目を追加します Item, Index | |
InsertFirst コレクションの先頭に項目を追加します Item | |
InsertLast はコレクションの最後に項目を追加します Item | |
コレクションのインスタンス発生数を探します Result, Object | |
Remove メソッドは項目を削除します Result, Object | |
RemoveAll はコレクションの全項目を削除します | |
RemoveAt メソッドは指定されたインデックスの項目を削除します Result, Index | |
コレクションから最初の項目を削除 Result | |
コレクションから最後の項目を削除 Result | |
ReplaceAt は指定されたインデックス番号の項目を置き換えます Result, Item, Index |