通常は互いのオブジェクトの関連付けに使用される、非順序のコンポーネントペアのコレクション
祖先 - コレクション (PRIM_COLL) オブジェクト (PRIM_OBJT)
詳細
ディクショナリコレクションは、キー値コンポーネントのペアが不規則に並んでおり、重複するキーはありません。
ディクショナリコレクションはオブジェクト型のインスタンスによってキーインされ、各コレクション項目に一意の識別子を与えます。
例
辞書コレクションを定義する。 このコレクションは、コントロールによって識別されるレイアウト項目のインスタンスを格納します。
Define_Com Class(#Prim_dcol<#Prim_tblo #Prim_ctrl>) Name(#LayoutItems)
コレクション項目は存在する参照か以下の新しくできた割り当てによって作られます。
#LayoutItems<#Button1> <= (*New #Prim_TBLO)
コレクション項目は、キーとして指定されたクラスから継承する任意のオブジェクトタイプを使用してアクセスできます。
#LayoutItems<#Button1>.Manage <= #Button1
全てのコレクション項目は次のように入力されます。ここでは、すべてのレイアウト項目に親が割り当てられています。
#LayoutItems<>.Parent <= #LayoutManager
FOR コマンドはコレクションコンテンツを通して、反復にも使われています。項目は、キー値の順に返されます。この場合、事実上キーのメモリアドレスです。
For each(#LayoutItem) in (#Layoutitems)
...
Endfor
コレクションのあらゆる例からのイベントをモニターチェックするために、<> EVTROUTINE を追加できます。COM_SENDER パラメータは インスタンスのイベント起動へのアクセスをします。
この例では、フォームのコレクションの closing イベントが監視され、イベントが記録されます。
Evtroutine Handling(#Forms<>.Closing) Com_Sender(#Sender)
#Com_owner.AddEvent(("&1 closed").Substitute(#Sender.Caption))
Endroutine
プロパティ
名前 |
記述 |
AllowsDuplicatesは、コレクションが複製を許すかどうかを示します コレクション (PRIM_COLL) より継承 |
|
集められるオブジェクトのクラス |
|
コンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承 |
|
このコンポーネントの全てにアクセスできるようにします。 オブジェクト (PRIM_OBJT) より継承 |
|
コンポーネントのクラスを制限します。 オブジェクト (PRIM_OBJT) より継承 |
|
インスタンス用に値を格納できる汎用スペース オブジェクト (PRIM_OBJT) より継承 |
|
ComponentTypeではコンポーネントのタイプ情報にアクセスできます。 オブジェクト (PRIM_OBJT) より継承 |
|
ComponentTypeName十分適格なコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承 |
|
IsEmptyは、コレクション内に項目があるかどうかを示します。 コレクション (PRIM_COLL) より継承 |
|
IsOrderedは、コレクションが配列かどうかを示します。 コレクション (PRIM_COLL) より継承 |
|
Itemプロパティはコレクション内の特定の項目へのアクセスを提供します |
|
ItemCountはコレクション内の項目数です コレクション (PRIM_COLL) より継承 |
|
KeyedByプロパティにフォームのキーになるフィールド名を指定します。 |
|
KeyOfはコレクション内の項目のキーを返します |
|
コンポーネントの名前 オブジェクト (PRIM_OBJT) より継承 |
|
コンポーネントのオーナーです。 オブジェクト (PRIM_OBJT) より継承 |
|
このインスタンスが添付されているコンポーネントインスタンス。コントロールのビジュアルコンテナまたは子インスタンスのコレクション オブジェクト (PRIM_OBJT) より継承 |
イベント
名前 |
記述 |
コンポーネントを作成する時にCreateInstanceのイベントを実行します。 オブジェクト (PRIM_OBJT) より継承 |
|
コンポーネントが解除される前にDestroyInstanceのイベントを実行します。 オブジェクト (PRIM_OBJT) より継承 |
|
Hashはコレクション編成のために整数値が決定された時に発生します Subject, Hash |
|
コレクションで2つのアイテムを比較する必要がある時はかならず起動されます。 Object, Subject, Equal |
メソッド
名前 |
記述 |
CalculateHashはハッシュ値を計算します。 コレクション (PRIM_COLL) より継承 Result, Value |
|
提供のインスタンスがコレクション内に存在するかどうか Result, Key |
|
ContainsItemはコレクション内の項目を検索します Result, Item |
|
コレクションにリードオンリーでアクセスするアクセサーコンポーネントを作ります。 Result |
|
コレクションを通して繰り返しを可能にする反復子コンポーネントを作ります。 Result |
|
Findメソッドは、コレクションの中の項目への参照を返します。 Result, Key |
|
Insertメソッドはコレクションに項目を追加します。 Result, Item, Key |
|
Removeメソッドは項目を削除します Result, Key |
|
RemoveAllはコレクションの全項目を除去します |