Sorteddictionaryコレクション (PRIM_SDCO)
通常各オブジェクトを関連付けるために使用される、固有のコンポーネントペアの非順序のコレクション
祖先 - コレクション (PRIM_COLL) オブジェクト (PRIM_OBJT)
詳細
ディクショナリ・コレクションは、キー値コンポーネントのペアが不規則に並んでおり、重複するキーはありません。
ディクショナリコレクションはオブジェクト型のインスタンスによってキーインされ、各コレクションアイテムに一意の識別子を与えます。
項目がコレクションに追加されると、 Compare イベントは、ユーザー定義の並べ替えをエバリュエートできるように、必要なだけ頻繁に発生します。
例
辞書コレクションを定義する。 このコレクションは、コントロールによって識別されるレイアウト項目のインスタンスを格納します。
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) より継承 | |
Collectsプロパティにフォームを指定します。 | |
コンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承 | |
このコンポーネントの全てにアクセスできるようにします。 オブジェクト (PRIM_OBJT) より継承 | |
コンポーネントのクラスを制限します。 オブジェクト (PRIM_OBJT) より継承 | |
インスタンス用に値を格納できる汎用スペース オブジェクト (PRIM_OBJT) より継承 | |
ComponentTypeではコンポーネントのタイプ情報にアクセスできます。 オブジェクト (PRIM_OBJT) より継承 | |
ComponentTypeName十分適格なコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承 | |
IsEmptyは、コレクション内に項目があるかどうかを示します。 コレクション (PRIM_COLL) より継承 | |
IsOrderedは、コレクションが配列かどうかを示します。 コレクション (PRIM_COLL) より継承 | |
コレクション内の特定の項目へのアクセスを提供します | |
ItemCountはコレクション内の項目数です コレクション (PRIM_COLL) より継承 | |
KeyedByプロパティにフォームのキーになるフィールド名を指定します。 | |
KeyOfはコレクション内の項目のキーを返します | |
コンポーネントの名前 オブジェクト (PRIM_OBJT) より継承 | |
コンポーネントのオーナーです。 オブジェクト (PRIM_OBJT) より継承 | |
このインスタンスが添付されているコンポーネントインスタンス。コントロールのビジュアルコンテナまたは子インスタンスのコレクション オブジェクト (PRIM_OBJT) より継承 |
イベント
名前 | 記述 |
|---|---|
Compareは2つのキーコンポーネントの比較が必要な時に発生します | |
コンポーネントを作成する時にCreateInstanceのイベントを実行します。 オブジェクト (PRIM_OBJT) より継承 | |
コンポーネントが解除される前にDestroyInstanceのイベントを実行します。 オブジェクト (PRIM_OBJT) より継承 |
メソッド
名前 | 記述 |
|---|---|
CalculateHashはハッシュ値を計算します。 コレクション (PRIM_COLL) より継承 | |
提供のインスタンスがコレクション内に存在するか? | |
ContainsItemはコレクション内の項目を調べます | |
コレクションにリードオンリーでアクセス出来るアクセサーコンポーネントを作ります。 | |
コレクションを通して繰り返しを可能にする反復子コンポーネントを作ります。 | |
コレクションの中の項目への参照を返します。 | |
Insertメソッドはコレクションに項目を追加します。 | |
Removeメソッドは項目を削除します | |
RemoveAllはコレクションの全項目を除去します |