getNextCategory (NotesViewNavigator - JavaScript™)

Returns the next category entry in a view navigator.

Defined in

NotesViewNavigator

Syntax

getNextCategory() : NotesViewEntry
Return value Description
NotesViewEntry The category entry following the current entry. Returns null if there is no next category entry.

Usage

This method moves the current pointer to the retrieved entry unless the return value is null.

For purposes of navigation, total entries are considered category entries. This method can return either.

Examples

This button gets all the category entries in a view.
var v:NotesView = database.getView("By category and date");
var nav:NotesViewNavigator = v.createViewNav();
var entry:NotesViewEntry = nav.getFirst();
while (entry != null) {
	var tabs:string = "";
	for (var i=0; i<entry.getIndentLevel(); i++) tabs = tabs + "\t";
	requestScope.status += "\n" + tabs +
		entry.getColumnValues().elementAt(entry.getIndentLevel()).toString();
	var tmpentry:NotesViewEntry = nav.getNextCategory();
	entry.recycle();
	entry = tmpentry;
}