通常各オブジェクトを関連付けるために使用される、固有のコンポーネントペアの非順序のコレクション

祖先 - コレクション (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

プロパティ

イベント

メソッド

参照

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

テクニカルリファレンス

EPC150060 - December 2023