NotesViewNavigator (LotusScript®)
Represents a view navigator. A view navigator provides access to all or a subset of the entries in a view.
Containment
Contained by: NotesView
Contains: NotesViewEntry
Properties
Methods
Creation
You create a view navigator through the following NotesView methods:
Returned is a NotesViewNavigator object that represents some or all of the entries in the view.
Usage
You can navigate through the documents in a view with the NotesView methods.
NotesViewNavigator differs from NotesView in the following ways:
- ViewNavigator returns a ViewEntry object instead of a document (ViewEntry contains information such as SiblingCount, view position, etc.)
- It lets you access categories and totals, as well as documents.
- Users can create navigators from subsets of views, for example, all children of an entry.
A view navigator remains associated with the parent view. A refresh of the parent view affects the view navigator.
Automatic updates: avoid
Avoid automatically updating the parent view by explicitly setting AutoUpdate to False. Automatic updates degrade performance and may invalidate entries in the navigator ("Entry not found in index"). You can update the view as needed with Refresh.
Duplicate entries
Duplicate entries exist when a document is categorized under multiple categories. Navigating over duplicate entries works except in the following situations:
- GetEntry method returns the first ViewEntry instance for the document.
- Navigators constructed from an object that did not come from the current view return the first instance of the object.