In a column or window title formula, returns the number of child documents or categories belonging to the current document or category. Only immediate responses count as children. For example, the responses to a main document are its children, but the responses to a response document are not.

Syntax

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

Parameters

defaultString

Text. Optional. The text to return. If a "%" is used in the string, it will be replaced with the number of children documents or categories. Example: "% Responses."

Text. Optional. The text to return if the document or category has no children, such as "No Responses."

Text. Optional. The text to return if the document or category has just one child, such as "One Response."

The return value depends on how you call @DocChildren:

numChildren

Special text. If @DocChildren is called with no parameters, then the number of child documents belonging to the current document or category is returned. You cannot convert special text to a number.

Special text. If @DocChildren is called with one or more parameters, it returns the appropriate string, based on the number of child documents belonging to the current document or category. You cannot convert special text to a number.

Use @DocChildren in window title and column formulas, when you want to indicate how many top-level responses a particular document has, or how many main documents are within a particular category. This function does not work in any other formula.

This @function is calculated when the document is opened. Results are undefined in cases where the document is not opened, such as printing from a view.

You cannot use this function in Web applications, except in column formulas.

Language cross-reference

ChildCount property of LotusScript NotesViewEntry class

ChildCount property of Java ViewEntry class

Example
See Also

@DocDescendants
@DocLevel
@DocNumber
@DocParentNumber
@DocSiblings
Window title and column formula @functions
Working with @functions
"Taking your Domino applications to the Web" on the Lotus Developer Domain

Glossary