ここで使用するオブジェクトモデルの詳細は、以下のとおりです。
オブジェクト モデル内のすべてのコレクションで、次のメソッドを使用できます。
名称 | 型 | アクセス | 説明 |
|---|
Count | int | 読み取り専用 | コレクションに含まれるアイテム数 |
Item( index : int ) | ItemInterface | 読み取り専用 | 指定した index のアイテムをコレクションから取得します。 インデックスは “0” から始まります。 |
メソッド Item を使用する代わりに、選択した言語に応じて、丸括弧または角括弧を使ってコレクションのアイテムを参照することもできます。JScript、VBScript、Visual Basic.Net では丸括弧を使用します。C#.Net では角括弧のみ使用できます。JScript.Net では丸括弧と角括弧の両方を使用できます。
たとえば、
Items( 1 ).Text = "Hello" or Items[ 1 ].Text = "Hello"
すべてのコレクションは、“for each” などの構文で使用できます。
テーブルを除くすべての文書 field は、繰り返しにできます。
文書構造では、繰り返し field は、空でない Items コレクションを持つ特別なプロトタイプ field として表されます。
プロトタイプ field には、子アイテムも値もありません。これは、field の反復のセットを格納するためだけに使用されます。子 field や field values は、field インスタンスの属性としてのみ存在でき、IField object の Items メソッドを通じて利用できます。
テーブルには常に Rows コレクションがあります (Rows は Items の同義語です) 。Rows コレクションには、行の Children メソッドを通じてセルにアクセスできる行だけが含まれます。
field へのパスの構成
IDocument オブジェクトの Field、HasField、IndexedItemValue の各メソッドでは、フォーム上の field へのパスをパラメーターとして使用します。BNF (Backus-Naur Form) を使用したパスの正式な表記は、次のとおりです。
<Path> ::= <Path_component> | <Path> "" <Path_component>
<Path_component> ::= <Field_name> | <Field_name> ”[“<Field_iteration_number>”]”
ここで、Field_name は Document Definition で定義されているドキュメント field の名前を表し、Field_iteration_number は繰り返し field の反復番号 (テーブルの場合は行番号) で、“0” から始まります。
パスには、完全パスと相対パスがあります。完全パスはドキュメントセクション名から始まり、相対パスはグループ内の子アイテム名から始まります。
たとえば、“Section” セクション内にある “Table” テーブルの “Total” 列の 3 行目を指定するには、次のように記述します。
このような完全名は、IFieldオブジェクトのFullNameメソッドで作成できます。