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

or using another variable

#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

ﾌﾟﾛﾊﾟﾃｨ

名前記述
AllowsDuplicatesAllowsDuplicates は、コレクションが複製を許すかどうかを示します コレクション (PRIM_COLL) より継承
CollectsCollects プロパティにフォームを指定します。
ComponentClassNameコンポーネントのクラス名です。 ブジェクト (PRIM_OBJT) より継承
ComponentMembersこのコンポーネントの全てにアクセスできるようにします。 ブジェクト (PRIM_OBJT) より継承
ComponentPatternNameコンポーネントのクラスを制限します。 ブジェクト (PRIM_OBJT) より継承
ComponentTagインスタンス用に値を格納できる汎用スペース ブジェクト (PRIM_OBJT) より継承
ComponentTypeComponentType ではコンポーネントのタイプ情報にアクセスできます。 ブジェクト (PRIM_OBJT) より継承
ComponentTypeNameComponentTypeName 十分適格なコンポーネントのクラス名です。 ブジェクト (PRIM_OBJT) より継承
IsEmptyIsEmpty は、コレクション内に項目があるかどうかを示します。 コレクション (PRIM_COLL) より継承
IsOrderedIsOrdered は、コレクションが配列かどうかを示します。 コレクション (PRIM_COLL) より継承
ItemItem プロパティはコレクション内の特定の項目へのアクセスを提供します
ItemCountItemCount はコレクション内の項目数です コレクション (PRIM_COLL) より継承
KeepLast管理されるコンポーネントのインスタンスの数を指定します。
KeyedByフォームのキーになるフィールド名を指定します。
KeyOfコレクション内の項目のキーを返します
Nameコンポーネントの名前 ブジェクト (PRIM_OBJT) より継承
Ownerコンポーネントのオーナーです。 ブジェクト (PRIM_OBJT) より継承
Parentこのインスタンスが添付されているコンポーネント インスタンス。コントロールのビジュアル コンテナまたは子インスタンスのコレクション ブジェクト (PRIM_OBJT) より継承
Style存在しないキーによってコレクションをアクセスした場合、どんな操作を行なうかを指定します

イベント

名前記述
CreateInstanceコンポーネントを作成する時に CreateInstance のイベントを実行します。 コレクション (PRIM_KCOL) より継承
DestroyInstanceコンポーネントが解除される前に DestroyInstance のイベントを実行します。 コレクション (PRIM_KCOL) より継承

ﾒｿｯﾄﾞ

名前記述
CalculateHashCalculateHash はハッシュ値を計算します。 コレクション (PRIM_COLL) より継承
Result, Value
CreateAccessorコレクションにリードオンリーでアクセス出来るアクセサー コンポーネントを作ります。
Result
CreateIteratorコレクション を通して繰り返しを可能にする反復子コンポーネントを作ります。
Result
RemoveRemove メソッドは項目を削除します
Result, Key
RemoveAllRemoveAll はコレクションの全項目を除去します

参照

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

テクニカルリファレンス

2018 - V14SP1