getNth (ViewNavigator - Java™)

ビューナビゲータの最上位レベルの指定した位置にあるエントリを返します。

定義位置

ViewNavigator

構文

public ViewEntry getNth(int n)
    throws NotesException

パラメータ

int n

エントリの位置です。1 が最初のエントリです。

戻り値

ViewEntry

n 番目の最上位レベルのエントリです。n 番目の最上位レベルエントリがない場合は null を返します。

使用法

このメソッドは、戻り値が null でない限り、取得されたエントリに現在のポインタを移動します。

指定した文書に対する読み取りアクセス権がない場合、このメソッドは読み取りアクセス権がある次の文書を返します。 n をインクリメントする場合、インクリメントはアクセスされた文書に対してではなく、n の実際の値に対して相対的に行われます。 そのため、その文書が実際に n 番目の文書になるまで、同じ文書に繰り返しアクセスすることになります。

パフォーマンス上の理由により、getNth を使用してループを繰り返すことは避けてください。推奨されるループ構造については、getNextgetNextCategorygetNextDocumentgetNextSiblinggetPrevgetPrevCategorygetPrevDocumentgetPrevSibling を参照してください。

クロスリファレンス

LotusScript® NotesViewNavigator クラスの GetNth メソッド