Lotus Software logo
IBM Lotus Domino Designer 8.5
  Versions 8.5 and 8.5.1






@DocChildren

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."

zero-string

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

one-string

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

Return value

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.

childString

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.

Usage

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

See examples

Examples: @DocChildren
Related topics
@DocDescendants
@DocLevel
@DocNumber
@DocParentNumber
@DocSiblings
Window title and column formula @functions
Working with @functions




Library | Support | Terms of use |

Last updated: Monday, October 5, 2009