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

ユーザーインターフェースでは文書のアイテムはフォームのフィールドを介して表示されます。フォームのフィールドと文書のアイテムの名前が同じとき、アイテムはフィールドに表示されます。たとえば、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 パラメータに文字列か文字列の配列が指定されていなければなりません。

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

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

doc.Subject = "Hello"

リッチテキストフィールドNotesRichTextItem は NotesItem のプロパティとメソッドを継承し、さらに、リッチテキストフィールドの操作に使われるプロパティとメソッドを持ちます。
変更を保存するアイテムを作成または変更した後は、親文書の Save メソッドを呼び出して変更を保存しなければなりません。
Save を呼び出さないでスクリプトを終了したときは、NotesItem オブジェクトに加えたすべての変更が失われます。

例
関連項目

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

用語集