getItemValue (NotesDocument - JavaScript)

アイテムの値を返します。

定義場所

NotesDocument

構文

getItemValue(name:string) : java.util.Vector
パラメータ 説明
name アイテムの名前。
戻り値 説明
java.util.Vector アイテムに含まれる値 (複数の場合もあり)。値のデータ型はアイテムのデータ型に応じて変わります。
Notes® アイテムの種類 戻り値の種類
リッチテキスト プレーンテキストとして表わされる string 型要素を 1 つ持つ java.util.Vector 型
文字列 (種類が Names、Authors、Readers のアイテムを含む)、または文字列リスト string 型要素を持つ java.util.Vector 型
数値または数値リスト double 型要素を持つ java.util.Vector 型
日付/時刻または日付/時刻値の範囲 NotesDateTime 型要素と NotesDateRange 型要素を持つ java.util.Vector 型

各要素はアイテム内の値に対応します。アイテムに値が 1 つしか含まれていない場合、ベクトルに含まれる要素は 1 つだけです。

使用法

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

アイテムに値がない場合、このメソッドは空のベクトルを返します。

指定した名前のアイテムが存在しない場合は、このメソッドは空のベクトルを返します。 例外はスローされません。アイテムの存在を確認するには hasItem を使用します。

このプロパティは、NotesItem の getValues と同じアイテム値を返します。

以下のボタンは、現在の文書内のアイテムの値 (複数可) を取得します。ユーザーはアイテム名を指定します。このボタンはアイテムの種類を判別し、その種類に応じた値を取得します。
try {

var itemname:string = requestScope.query;
var doc:NotesDocument = currentDocument.getDocument();
if (doc.hasItem(itemname)) {
	var itemvalues:java.util.Vector = doc.getItemValue(itemname);
	var iterator = itemvalues.iterator();
	while (iterator.hasNext()) {
		var itemvalue = iterator.next();
		if ((typeof(itemvalue)).endsWith("string")) {
			requestScope.status += "¥n" + itemvalue.left(80);
		} else if ((typeof(itemvalue)).endsWith("number")) {
			requestScope.status += "¥n" + itemvalue.toFixed();
		} else if ((typeof(itemvalue)).endsWith("DateTime")) {
			requestScope.status += "¥n" + itemvalue.getLocalTime();
		}
	}
}

} catch(e) {
	requestScope.status += "¥n" + e.toString();
}

言語間の参照

LotusScript® NotesDocument クラスの getItemValue メソッド

Java™ Document クラスの getItemValue メソッド