getItemValueArray (NotesXspDocument - JavaScript)

アイテムの値を配列として取得します。

構文

getItemValueArray(name:string) : Array

パラメータ	説明
`name`	アイテムの名前。

戻り値	説明
`Array`	アイテムの値を格納する配列。データ型は、アイテムのデータ型に応じて変わります。

使用法

複数のアイテムの名前が同じ場合、このメソッドは最初のアイテムの値を返します。

アイテムが存在しない場合、このメソッドは長さ 0 の配列を返します。

このメソッドは、アイテム内のすべての値を返します。

例

以下の複数行入力域ボックスのデータバインディングは、現在の XPage に関連付けられた文書内の Numbers アイテムの値を返します。

var array = document1.getItemValueArray("Numbers");
if (array.length == 0) {
	return "Numbers is empty or doesn't exist";
} else {
	var result = "";
	for (var i=0; i<array.length; i++) {
		result = result + array[i].toFixed() + "¥n";
	}
	return result;
}