LotusScript for Visual Basic Programmers - IBM Redbooks

NotesItem
In the user interface, Notes displays items in a document through fields on
a form. When a field on a form and an item in a document have the same
name, the field displays the item (for example, the Subject field displays the
Subject item). All of the items in a document are accessible through
LotusScript, regardless of what form is used to display the document in the
user interface.
The NotesItem class is contained by NotesDocument. You can create
a new NotesItem object from one that already exists using the
CopyItemToDocument method of NotesItem or using the CopyItem or
ReplaceItemValue methods of NotesDocument. You can also create one
from scratch using the New method of NotesItem or using the
AppendItemValue or ReplaceItemValue methods of NotesDocument.
You must call Save on the document if you want the modified document to
be saved to disk. The document will not display the new item in the user
interface unless there is a field of the same name on the form used to
display the document.
Method Description
New Creates a new NotesItem object.
Abstract Abbreviates the contents of a text item.
AppendToTextList For an item that’s a text list, adds a new value to the
item without erasing any existing values.
Contains Given a value, checks if the value matches at least
one of the item’s values exactly.
CopyItemToDocument Copies an item to a specified document.
Remove Permanently deletes an item from a document.
Property Description
DateTimeValue Read-Write. For a date-time item, returns a
NotesDateTime object representing the value of the
item. For items of other types, returns Nothing.
IsAuthors Read-only. Indicates whether or not an item is of
type Authors. An Authors item contains a list of
Notes user names, indicating people who have
Author access to a particular document.
IsEncrypted Read-Write. Indicates if an item is encrypted.
Continued
Chapter 3: LotusScript Notes Classes 67