gotoPos (NotesViewNavigator - JavaScript)

Moves the current pointer to the entry at a specified position in a view navigator.

Defined in

NotesViewNavigator

Syntax

gotoPos(pos:string, separator:char) : boolean
Parameter Description
pos A position in decimal format, for example, 1.2.3 is the third child to the second child to the first entry using the period as a level separator.
separator The separator between position levels.
Return value Description
boolean
  • true if the operation succeeds
  • false if there is no entry at that position

Examples

This button determines whether a position input by a user is valid for a view.
var nav:NotesViewNavigator = database.getView("By category and date").createViewNav();
var pos:string = requestScope.query;
try {
	var result:boolean = nav.gotoPos(pos, ".");
} catch(e) {
	requestScope.status = "Incorrectly formed: " + pos;
	return;
}
if (result) {
	requestScope.status = "Position " + pos + " is valid in this view: " + 
		nav.getParentView().getName();
} else{
	requestScope.status = "Position " + pos + " is not valid in this view: " + 
		nav.getParentView().getName();
}