FormattedDocumentItemCollection.Insertar

FormattedDocumentItemCollection

Insertar

Disponible desde la versión 8.3.1.

Sintaxis:

Insertar(<Índice>, <Valor>, <TipoElemento>)

Parámetros:

<Índice> (obligatorio)

Tipo: Número.
Posición en el documento formateado donde se debe insertar el elemento.

<Valor> (opcional)

Tipo: Arbitrario.
Contiene el valor que se inserta en la colección.
Dependiendo del valor del parámetro <TipoElemento> del método actual, el valor se puede leer de varias formas.
Si el valor del parámetro es FormattedDocumentText, entonces se insertará la presentación en forma de cadena del valor transferido a la colección.
Si el valor es FormattedDocumentPicture, entonces el tipo de <Valor> debe ser Picture, o BinaryData, o Cadena, que contenga la URL de la imagen. De lo contrario, se generará una excepción.
Si el valor del parámetro es FormattedDocumentLinefeed, entonces se ignora el valor del parámetro y se inserta la transferencia de cadena en la colección.
Si el valor del parámetro es Undefined, y la colección de elementos del documento formateado solo contiene párrafos, entonces se inserta un párrafo vacío en la colección.
Valor predeterminado: Undefined.

<TipoElemento> (opcional)

Tipo: Tipo.
Especifica el tipo de elemento que se va a insertar. El parámetro <Valor> de este método se interpreta según el valor de este parámetro.
Una colección puede contener los siguientes objetos:
1) FormattedDocumentText
2) FormattedDocumentPicture
3) FormattedDocumentLinefeed
El parámetro <Valor> de este método se interpreta según el valor de este parámetro.
Valor predeterminado: FormattedDocumentText.

Valor devuelto:

Tipo: FormattedDocumentParagraph, FormattedDocumentText, FormattedDocumentLinefeed, FormattedDocumentPicture.
Devuelve el elemento insertado.

Descripción:

Inserta un elemento en la posición especificada del documento formateado.

Disponibilidad:

Cliente ligero, cliente web, servidor, cliente grueso, conexión externa.

Nota:

La inserción de imágenes solo está disponible en el servidor.
La imagen debe ser absoluta.

Disponible desde:

Disponible desde la versión 8.3.1.

Descripción cambiada en la versión 8.3.21.