コレクション (PRIM_KCOL)

祖先 - コレクション (PRIM_COLL) オブジェクト (PRIM_OBJT)

詳細

コレクション (Keyed collection) では、キー値により識別されるコンポーネントが不規則な順番で並んでいます。キー値は重複できません。 

キー付きコレクションは、リポジトリー定義フィールドによってキーインされ、各コレクション項目に一意のIDを与えます。 

保存する前にインスタンスを作成する必要がある他のすべてのコレクションタイプとは異なり、 Keyed コレクションはキー値を参照するだけで自動的にコンテンツを作成できます。

例

辞書コレクションを定義する。 このコレクションは、番号で識別される Prim_Form から継承するコンポーネントのインスタンスを格納します。 

     Define_Com Class(#Prim_kcol<#Prim_form #Std_num>) Name(#Forms) 

コレクション項目は、キーとして指定されたデータタイプと一致する任意の値を使用してアクセスできます。Style プロパティが Factory の場合、まだ存在しないコレクションアイテムインスタンスも作成されます。

     #Forms<123>.Caption := "Form 123" 

または別の変数を使用します。

     #Forms<#ID>.Caption := "Form 123" 

全てのコレクションアイテムは次のように扱うことができます。ここでは、コレクション内のすべてのフォームが閉じられています。

     #Forms<>.Close 

FOR　コマンドはコレクションコンテンツを通して、反復にも使われています。項目はキー値、この場合は数値シーケンスの順に返されます。 

     For each(#Form) in (#Forms)
        ...
     Endfor 

コレクションのあらゆる例からのイベントをモニターチェックするために、<> EVTROUTINE を追加できます。COM_SENDER パラメータは インスタンスのイベント起動へのアクセスをします。 

     Evtroutine Handling(#Forms<>.Closing) Com_Sender(#Sender) 

        #Com_owner.AddEvent(("&1 closed").Substitute(#Sender.Caption)) 

     Endroutine

プロパティ

イベント

メソッド

参照

すべてのコンポーネント クラス
テクニカルリファレンス