WP INSERT DOCUMENT

4D v16

WP INSERT DOCUMENT


WP INSERT DOCUMENT ( objRango ; docWP ; modo {; actRango} )

Parámetro	Tipo	Descripción
objRango	Objeto	Rango 4D Write Pro
docWP	Objeto	Documento 4D Write Pro
modo	Entero largo	Modo de inserción
actRango	Entero largo	Modo de actualización del rango

Descripción

El comando WP INSERT DOCUMENT inserta el documento docWP en el rango objRango de acuerdo con el modo de inserción especificado y el parámetro actRango.

En objRango, pase un rango de selección 4D Write Pro válido. Un objRango es una parte de un documento 4D Write Pro; puede ser creado usando el comando , WP Get bookmark range o WP Get range.

El documento insertado docWP puede ser cualquier documento 4D Write Pro creado con el comando WP New o WP Import document. Sólo se insertan los elementos del cuerpo de texto (secciones y marcadores en el rango de destino se conservan). Además, los elementos se copian, por lo que docWP se pueden volver a utilizar varias veces.

En el parámetro modo, pase una o una combinación de las siguientes constantes del tema Constantes 4D Write Pro para indicar el modo de inserción a ser utilizado para el documento en el rango objRango del documento de destino:

Constante	Tipo	Valor	Comentario
wk append	Entero largo	2	Insertar contenidos al final del rango
wk prepend	Entero largo	1	Insertar contenidos al principio del rango
wk replace	Entero largo	0	Remplazar el contenido de la página

Puede combinar una de las constantes anteriores con las siguientes opciones de inserción:

Constante	Tipo	Valor	Comentario
wk freeze expressions	Entero largo	64	Congelar las expresiones durante la inserción
wk inherit style from paragraph	Entero largo	32	El contenido insertado hereda los estilos de caracteres por defecto del párrafo.
wk keep paragraph styles	Entero largo	128	Conservar los estilos del párrafo de destino

En el parámetro opcional actRango, puede pasar una de las siguientes constantes para especificar si los contenidos insertados están incluidos en el rango resultante:

Constante	Tipo	Valor	Comentario
wk exclude from range	Entero largo	1	Contenidos insertados no incluidos en el rango actualizado
wk include in range	Entero largo	0	Contenido insertado incluido en el rango actualizado (predeterminado)

Si no pasa un parámetro actRango, por defecto los contenidos insertados están incluidos en el rango resultante.

Ejemplo 1

Usted desea remplazar los contenidos de un documento por el texto seleccionado de otro documento:

 $tempRange:=WP Get selection(WPTemplate) //recuperamos la selección de usuario en el documento WPTemplate

 $doctoCopy:=WP New($tempRange) //creamos un nuevo documento basado en WPTemplate

 WP INSERT DOCUMENT(WPDoc;$doctoCopy;wk replace) //remplazamos el contenido de WPDoc por el contenido del nuevo documento

Ejemplo 2

Se ha definido un documento de plantilla con diferentes partes con formato previo, cada una de ellas se almacena como un marcador. Al producir un documento final de la plantilla, puede extraer cualquier marcador como un nuevo documento e insertarlo en el documento final.

 ARRAY TEXT($_BookmarkNames;0)

 WP GET BOOKMARKS([TEMPLATES]WP;$_BookmarkNames) //obtener los marcadores de la plantilla

 $targetRange:=WP New //crear un documento vacio (será el documento final)

 

 $p:=Find in array($_BookmarkNames;"Main_Header") //manejar la parte principal del encabezado

 If($p>0)

    $Range:=WP Get bookmark range(WParea;$_BookmarkNames{$p}) //seleccionar el rango

    $RangeDoc:=WP New($Range) //crear un nuevo documento del rango

    WP INSERT DOCUMENT($targetRange;$RangeDoc;wk append+wk freeze expressions) //wk append=después de la sustitución, $targetRange es igual al final del texto reemplazado

 End if

Ver también

WP INSERT BREAK
WP INSERT PICTURE
WP New