文書中の特定のデータを表します。

ユーザーインターフェースでは文書のアイテムはフォームのフィールドを介して表示されます。フォームのフィールドと文書のアイテムの名前が同じとき、アイテムはフィールドに表示されます。たとえば、Subject アイテムは [Subject] フィールドとして表示されます。

LotusScript を使用すると、ユーザーインターフェースでどのようなフォームが文書の表示に使用されていても、文書のすべてのアイテムにアクセスできます。

派生クラス

NotesItem クラスを継承するクラスには NotesRichTextItem があります。

包含関係

スーパークラス: NotesDocument

サブクラス: NotesDateRange、NotesDateTime、NotesMIMEEntity

プロパティ

DateTimeValue

IsAuthors

IsEncrypted

IsNames

IsProtected

IsReaders

IsSigned

IsSummary

LastModified

Name

Parent

SaveToDisk

Text

Type

ValueLength

Values

メソッド

Abstract

AppendToTextList

Contains

CopyItemToDocument

GetValueCustomDataBytes

GetValueDateTimeArray

GetMIMEEntity

New

Remove

SetValueCustomDataBytes

作成方法

NotesItem オブジェクトを新規に作成する方法は 2 つあります。

• オブジェクトをまったく新規に作成するには NotesDocument の New または ReplaceItemValue のいずれかを使用します。

• 既存のオブジェクトをもとに NotesItem オブジェクトを新規に作成するには、CopyItemToDocument または NotesDocument の CopyItem か ReplaceItemValue を使用します。

変更した文書をディスクに保存するには、文書で Save を呼び出さなければなりません。文書のフォームにアイテムと同じ名前のフィールドがないときは、新規に作成されたアイテムはユーザーインターフェースには表示されません。

構文

Dim variableName As New NotesItem( notesDocument, name$, value
[, specialType% ] )

または

Set notesItem = New NotesItem( notesDocument, name$, value [, specialType% ] )

パラメータ

notesDocument

アイテムを作成する文書です。

String 型。新規アイテムの名前です。

新規アイテムに割り当てる値です。value のデータ型は作成されるアイテムの種類に応じて変わります。

	value のデータ型	作成される Lotus Notes アイテム
	String 型	value を含むテキストアイテム (specialType% を使った場合、Names、Readers、Authors のいずれかになります)
	String 型の配列	value の各要素を含むテキストアイテム (specialType% を使った場合、Names、Readers、Authors のいずれかになります)
	Long 型、Integer 型、Double 型、Single 型、または Currency 型	value を含む数値アイテム
	Long 型、Integer 型、Double 型、Single 型、または Currency 型の配列	value の各要素を含む数値アイテム
	DATE 形式の Variant 型、または NotesDateTime 型	value を含む日時アイテム
	DATE 形式の Variant 型の配列、または NotesDateTime 型の配列	value の各要素を含む日時アイテム
	NotesItem 型	データ型と値が NotesItem と一致するアイテム

必要に応じて、データ型の変換が行われます。たとえば、浮動小数点数値アイテムは倍精度であるため、Single 型の値は Double 型に変換されてから保存されます。

省略可能。Integer 型の定数。テキストアイテムの種類を Names、Readers、Authors のどれにするのかを指定します。次のいずれかの定数です。NAMES、READERS、または AUTHORSspecialType% を使用するには value パラメータに文字列か文字列の配列が指定されていなければなりません。

New で NotesItem を作成するとき、アイテムの IsSummary プロパティにはデフォルトで False が設定されます。そのため、アイテムの値はビューまたはフォルダに表示されません。

アクセス方法

既存の NotesItem オブジェクトにアクセスするには次に示すいくつかの方法があります。

• アイテムにアクセスするときにその名前が分かっている場合は、NotesDocument の GetFirstItem を使用します。
• 文書のすべてのアイテムにアクセスするには、NotesDocument の Items を使用します。

NotesDocument は、NotesItem オブジェクトを宣言せずにアイテムに直接アクセスできるメソッドを提供します。これに必要なものはアイテム名だけです。

• アイテムの値を取得するには GetItemValue を使用します。
• アイテムの値を設定するには ReplaceItemValue を使用します。
• 文書に特定のアイテムがあるかどうかを調べるには HasItem を使用します。
• 文書からアイテムを削除するには RemoveItem を使用します。

doc.Subject = "Hello"

リッチテキストフィールド

NotesRichTextItem は NotesItem のプロパティとメソッドを継承し、さらに、リッチテキストフィールドの操作に使用されるプロパティとメソッドを持ちます。

変更を保存する

アイテムを作成または変更した後は、親文書の Save メソッドを呼び出して変更を保存しなければなりません。

Save を呼び出さないでスクリプトを終了したときは、NotesItem オブジェクトに加えたすべての変更が失われます。

例
関連項目

LotusScript: クラスリファレンス
LotusScript のクラスでアイテムを作成して値を代入する
Lotus Domino のクラスを使用する

用語集