gotoPos (NotesViewNavigator - JavaScript™)

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

Defined in

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();
}