Subtract (NotesViewEntryCollection - LotusScript®)

Removes from a view entry collection any entries whose associated documents are also contained in a second collection.

Note: This method is new with Release 8.

Defined in

NotesViewEntryCollection

Syntax

C all notesViewEntryCollection .Subtract( inputNotes )

Parameters

inputNotes

String, NotesDocument, NotesDocumentCollection, NotesViewEntry or NotesViewEntryCollection. The NotesDocument, NotesDocuments, NotesViewEntry, or NotesViewEntries that the method will subtract from the NotesViewEntryCollection. A single NotesDocument can be specified by note ID (a String value) or NotesDocument object. Multiple NotesDocuments must be specified as a NotesDocumentCollection. A single NotesViewEntry object can be specified, as long as the NotesViewEntry object has a NotesDocument associated with it. Multiple NotesViewEntry objects that have NotesDocuments associated with them, can be specified as a NotesViewEntryCollection.

maintainOrder

(Optional) Boolean. Specifies that after the Subtract operation is complete, whatever order the originating view was in when the NotesEntryCollection was created will remain in force for subsequent entry processing. That is, either the default view order will be used or that last set by calling ResortView.

Usage

The document or documents (or the view entries and their associated documents) being subtracted must be in the same database as the original document collection. Otherwise, the method will return the error "the specified note or notes do not exist in the database" or, if a noteID was passed to the method that matches a noteID in the original collection's database, the method will use the unintended document.

Example