getItemValueString (NotesDocument - JavaScript)

文字列値を 1 つだけ持つアイテムの値を返します。

定義場所

構文

getItemValueString(name:string) : string

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

戻り値	説明
`string`	アイテムの値。

使用法

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

アイテムに値がない場合、または値が数値または日付の場合、このメソッドは空ストリングを返します。

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

このメソッドは、プレーンテキストにレンダリングされたリッチテキストアイテムを返します。書式や埋め込みオブジェクトは失われます。

アイテムが複数の値を保持している場合、このメソッドは最初の値を返します。

例

このボタンは、現在の文書内のストリングのアイテムの値を取得します。

var itemname:string = "subject";
var doc:NotesDocument = currentDocument.getDocument();
if (doc.hasItem(itemname)) {
	var itemvalue:string = doc.getItemValueString(itemname);
	if (itemvalue.length > 0) {
		requestScope.status = itemvalue;
	} else {
		requestScope.status = itemname + " is empty or not a string"
	}
} else {
	requestScope.status = itemname + " does not exist";
}

言語間の参照

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