繰り返しグループのインスタンスを参照、除外またはソース要素として使用
以下の選択に要素選択ダイアログボックスを使用できます:
- 要素プロパティダイアログボックスの関係タブで参照要素
- 要素プロパティダイアログボックスの検索制限タブで除外要素
- ブロックプロパティダイアログボックスでソース要素
単純要素では、その名前が使用されます。繰り返しグループ要素では、繰り返しグループの仮説への参照(インスタンス数を考慮)が関係を作成するために使用されます。
FlexiLayoutを合致させる時、繰り返しグループの仮説のいくつかのインスタンスは、要素ツリーの1つの繰り返しグループ要素に対応します。従って、繰り返しグループと他の要素の関係を指定する時、どのインスタンスを使用するかを指定する必要があります。フルネームではなく仮説への参照を指定する場合、繰り返しグループの名前の後に完全停止と参照インスタンスの記述が続きます。
インスタンスには以下のようなものがあります:
- LastFound- 所定のサブ要素で仮説が生成された時、繰り返しグループの最後に検出されたインスタンス
- AllInstances- 繰り返しグループの検出されたすべてのインスタンス
- Instance(#)- 一定数のインスタンス
- CurrentInstance- 現在のインスタンス、繰り返しグループの現在の仮説すなわちツリーで所定のサブ要素の上に位置する検出済みの繰り返しグループのサブ要素を参照するために繰り返しグループのサブ要素間の関係を指定する時に使用
要素選択ダイアログボックスの参照構文は、繰り返しグループとそのサブ要素のインスタンスにアクセスするために高度で入力するコードで使用される構文と同じです。例:
SearchElements.RepeatingGroup.LastFound.RepeatingGroup1.Instance(1).StaticText.
グループのインスタンスは、参照要素または除外要素を選択するダイアログボックスで選択されます。選択ツリーでは、インスタンス数が繰り返しグループの名前の隣に表示されます。繰り返しグループを選択する時、所望のインスタンスを選択できる繰り返しインスタンスフィールドが使用可能になります。変更は、ツリーと結果文字列の両方に反映されます。
子グループでCurrentInstanceを選択すると、CurrentInstanceはその上にあるすべてのグループで自動的に設定されます。親グループのCurrentInstanceを別のものに変更すると、すべての子グループのインスタンスがLastFoundのデフォルト値にリセットされます。
親グループのAllInstancesを選択すると、すべての子グループでAllInstancesが自動的に設定されます。子グループのAllInstancesを別のものに変更すると、親グループのAllInstancesがLastFoundのデフォルト値にリセットされます。
参照を高度コードで手動作成する場合、念頭に置いておくこととして、CurrentInstanceは親グループでしか指定できず、グループでCurentInstanceを指定する場合には、その上のすべてのグループでもCurrentInstanceを指定しなければなりません。AllInstancesがグループで指定されている場合、その下のすべてのグループでもAllInstancesが指定されている必要があります。ダイアログボックスでグループインスタンスを選択すると、正しい値が自動的に適用されます。
以下もご参照ください:
12.04.2024 18:16:07