En una fórmula de columna o de título de ventana, da como resultado el número total de documentos subordinados que posee el documento o a la categoría actual. Mientras que @DocChildren sólo tiene en cuenta los documentos de nivel inferior, @DocDescendants tiene en cuenta todos los documentos subordinados.

Sintaxis

@DocDescendants
@DocDescendants( cadena-predeterminada )
@DocDescendants( cadena-cero; cadena-predeterminada )
@DocDescendants( cadena-cero; cadena-uno; cadena-predeterminada )

Parámetros

cadena-predeterminada

Texto. Opcional. La cadena que ha de mostrar como resultado. Si se emplea % en la cadena, este símbolo será sustituido por el número de documentos subordinados hallados. Por ejemplo, " Hay % respuestas".

Texto. Opcional. La cadena que ha de mostrar como resultado si el documento o la categoría carece de subordinados; por ejemplo, "Sin respuestas".

Texto. Opcional. La cadena que ha de mostrar como resultado si el documento o la categoría sólo tiene un subordinado; por ejemplo, "Una respuesta".

El resultado puede ser texto o texto especial.

número

Texto especial. Si @DocDescendants se utiliza sin parámetros, la función da como resultado el número de subordinados que posee el documento o a la categoría actual. El texto especial no puede convertirse en un número.

Texto especial. Si @DocDescendants se utiliza con uno o varios parámetros, la función da como resultado la cadena adecuada en base al número de documentos hallados. El texto especial no puede convertirse en un número.

Utilice @DocDescendants en fórmulas de título de ventana y de columna cuando desee indicar el número de respuestas (de cualquier nivel) que tiene un documento determinado, o el número de documentos existentes en una categoría determinada. No funciona con ningún otro tipo de fórmula.

Esta función @ se calcula cuando se abre el documento. En el caso de que éste no se abra, por ejemplo al imprimir desde una vista, los resultados serán indefinidos.

Esta función no se puede utilizar en las aplicaciones para Web, excepto en las fórmulas de columna.

Equivalencias en otros lenguajes

Propiedad DescendantCount de la clase NotesView de LotusScript

Propiedad DescendantCount de la clase View de Java

Ejemplo
Véase también

@DocChildren
@DocLevel
@DocNumber
@DocParentNumber
@DocSiblings
Window title and column formula @functions
Working with @functions