@DocDescendants (式言語)

列式やウィンドウタイトル式で、現在の文書やカテゴリに属する派生文書や派生カテゴリの合計数を返します。@DocChildren が直接派生するものだけを数えるのに対して、@DocDescendants はレベルに関係なく、派生するものをすべて数えます。

構文

@DocDescendants @DocDescendants( defaultString ) @DocDescendants( zero-string ; defaultString ) @DocDescendants( zero-string ; one-string ; defaultString )

パラメータ

defaultString

文字列。オプション。返される文字列。文字列内で「%」を使用すると、「%」は派生文書または派生カテゴリの数で置き換えられます。例: "% Responses"

zero-string

文字列。オプション。"No Responses" のように、文書またはカテゴリに派生するものがない場合に返される文字列を指定します。

one-string

文字列。オプション。"One Response" のように、文書またはカテゴリに派生するものが 1 つだけある場合に返される文字列を指定します。

戻り値

戻り値は、特殊文字列または文字列です。

numChildren

特殊文字列。パラメータを指定しないで @DocDescendants を呼び出すと、現在の文書やカテゴリに属する派生文書の数が返されます。特殊文字列は数値には変換できません。

childString

特殊文字列。パラメータを指定して @DocChildren を呼び出すと、現在の文書やカテゴリに属する派生文書の数に基づいて該当する文字列が返されます。特殊文字列は数値には変換できません。

使用法

@DocDescendants は、ウィンドウタイトル式や列式で、ある文書に対するすべてのレベルの返答文書の合計数を表示する場合や、あるカテゴリ内の文書の合計数を表示する場合などに使用します。この関数は、これ以外の式では使用できません。

この @関数は文書を開いたときに計算されます。ビューから印刷するときなどのように、文書が開いてない場合は、返される結果は予測できません。

列式での場合を除いて、この関数は、Web アプリケーションでは使用できません。

例

次の例では、3 が返されます。
```
@DocDescendants
```
次の例では、3 Response(s) が返されます。
```
@DocDescendants("% Response(s)")
```
次の例では、3 Responses が返されます。文書に返答文書がない場合は、No Responses が返されます。
```
@DocDescendants("No Responses";"% Responses")
```
次の例では、There are 3 Responses. が返されます。文書に返答文書が 1 つあるとき、返されるメッセージは 1 Response です。文書に返答文書がないときは、No Responses というメッセージが返されます。
```
@DocDescendants("No Responses";"1 Response";
"There are % Responses.")
```

クロスリファレンス

LotusScript® NotesView クラスの DescendantCount プロパティ

Java™ View クラスの DescendantCount プロパティ