createViewNavFromChildren (View - Java™)

Creates a view navigator for the immediate children of a specified entry.

Defined in

View

Syntax

public ViewNavigator createViewNavFromChildren(Object entry)
    throws NotesException
public ViewNavigator createViewNavFromChildren(Object entry, int cacheSize)
    throws NotesException

Parameters

Object entry

A Document or ViewEntry object representing the parent entry. Cannot be null.

int cacheSize

The size of the navigator cache in view entries. Legal values are 0 (no cache) through 128 (default). Applies only to remote (IIOP) operations.

Return value


ViewNavigator

The new view navigator.

Usage

The entries in the navigator are all the entries in the view that fall hierarchically at the next level under the specified entry. The parent entry itself is excluded.

If the entry has no children, the result is an empty navigator. All navigation methods return null.

The cache enhances performance for iterative processing of entries using the navigation methods that do not take a parameter.

Example