NotesActivateView (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Nested browse in different views

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

NotesActivateView (Function)

In french: NotesActiveVue

Indicates the view that must be handled in Lotus Notes. This view becomes the current view. The following searches and/or browses will be performed in this view.

To perform searches and/or browses in the entire Lotus Notes database, use NotesDeactivateView.

Example

// Open the connection
ConnectionID is int
ConnectionID = NotesOpenConnection("Password", "MarsServer", ...
"C:\Users\Julia\AppData\Local\Lotus\Notes\Data\user.id")

// Specify the Lotus Notes database to use
DatabaseID is int
DatabaseID = NotesOpenDatabase(ConnectionID, "julia.nsf")
...
// Activate the view
NotesActivateView(DatabaseID, "MyCustomers")
// This view contains the "LastName", "FirstName", "Age" and "City" columns
// Only the "LastName", "First Name", "Age" and "City" columns can be sorted
// Find in this view the customers whose last name starts with "Mar",
// whose first name starts with "John" and whose city starts with "San"
NotesViewSeekFirst(DatabaseID, notesStartsWith, "Mar", "John", "San")
// Browse the customers found
WHILE NotesOut(DatabaseID) = False
... // Processes
NotesDocumentNext(DatabaseID)
END

Syntax

<Result> = NotesActivateView(<Session identifier> , <View name>)

<Result>: Boolean

True if the view was enabled,
False otherwise. The ErrorOccurred variable is set to True if an error occurred. To get the details of the error, use ErrorInfo with the errMessage constant.

<Session identifier>: Integer

Identifier of session to use. This identifier is returned by EmailStartNotesSession or NotesOpenDatabase.

<View name>: Character string

Name of the view to activate. This view becomes the current view.

Remarks

Nested browse in different views

If a current view is found ("ViewA" for example), another view can be enabled ("ViewB" for example). In this case, the last view enabled ("ViewB" in our example) corresponds to the current view and the context of the first view ("ViewA" in our example) is stored.

To perform browses and/or searches again:

in the first view ("ViewA"), this view must be re-enabled. The context of this view will be retrieved.
in the entire Lotus Notes database, the last view enabled must be disabled ("ViewB").

Component: wd270mess.dll