4D v17

WP New

Inicio

 
4D v17
WP New

WP New 


 

WP New {( fuente )} -> Resultado 
Parámetro Tipo   Descripción
fuente  Cadena, BLOB, Objeto in Fuente HTML 4D o documento Blob 4D Write o documento 4D Write Pro o rango o referencia del elemento
Resultado  Objeto in Objeto 4D Write Pro

El comando WP New crea y devuelve un objeto 4D Write Pro.

Por defecto, si se omite el parámetro fuente, el comando devuelve un objeto 4D Write Pro vacío.

Si se utiliza el parámetro fuente, el nuevo objeto 4D Write Pro se llenará con el contenido del la fuente. Puede pasar:
  • un parámetro cadena: en este caso, pase una fuente HTML 4D, es decir, un texto exportado por WP EXPORT VARIABLE con la opción wk web page html 4D. Este texto puede contener referencias (etiquetas y expresiones 4D e imágenes anidadas).
  • un parámetro blob: en este caso, pase:
    • un documento en formato 4D Write Pro (.4wp) almacenado en un BLOB.
      Para mayor información sobre el formato del documento 4D Write Pro, consulte Formato del documento .4wp.
    • una antigua área 4D Write cargada en un BLOB (los Blobs que contienen documentos .4w7 o .4wt son soportados).
      Para una lista detallada de las funcionalidades 4D Write que actualmente son soportadas en objetos 4D Write Pro, consulte la sección Importar documentos 4D Write.
      Si desea importar un documento 4D Write (.4w7 o .4wt) almacenado en el disco, también puede considerar el uso del comando WP Import document.
  • un parámetro objeto: en este caso, pase:
    • un rango.
      En este caso WP New devolverá un nuevo documento creado desde el rango especificado. Tenga en cuenta que, si el rango no es igual al rango del documento completo, sólo la primera sección se exporta y los marcadores no se exportan, si los hay.
    • o una referencia de elemento (tabla / fila / párrafo / imagen en línea/ encabezado / pie).
      En este caso WP New devolverá un nuevo documento que contiene el contenido de la referencia del elemento en la parte del cuerpo (para una fila, el nuevo documento contendrá un elemento de tabla con la fila).
El objeto devuelto es un documento completo que se puede pasar al comando WP INSERT DOCUMENT, por ejemplo.

Desea crear un objeto 4D Write Pro vacío:

 myWPObject:=WP New

Desea crear un nuevo objeto 4D Write Pro utilizando un documento 4D Write Pro almacenado en el disco:

 C_BLOB($BlobDoc)
 C_OBJECT(myWPArea)
 DOCUMENT TO BLOB("myDoc.4wp";$BlobDoc//cargar el documento en un Blob
 myWPArea:=WP New($BlobDoc)

Desea crear un objeto 4D Write Pro que contiene una referencia de expresión 4D simple:

 C_TEXT(myText)
 myText:="Today is "
 ST INSERT EXPRESSION(myText;"string(current date;System date long)";ST End text)
 myWPA:=WP New(myText)

Usted desea inicializar su área 4D Write Pro con una plantilla creada previamente:

  //Exportar plantilla desde un área existente
 C_TEXT(wpTemplate)
 WP EXPORT VARIABLE(myWPArea;wpTemplate;wk web page html 4D)
 
  // Utilizar la plantilla para una nueva área
 C_OBJECT(myNewWPA)
 myNewWPA:=WP New(wpTemplate)

Usted desea importar un documento almacenado en un campo BLOB del registro actual del anterior plug-in 4D Write en una nueva área 4D Write Pro:

 C_OBJECT(wpArea)
 wpArea=WP New([Templates]Reference_)

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 Import document
WP INSERT DOCUMENT

 
PROPIEDADES 

Producto: 4D
Tema: Lenguaje 4D Write Pro
Número 1317

This command can be run in preemptive processes

 
HISTORIA 

Creado por: 4D v14 R5
Modificado: 4D v15 R2
Modificado: 4D v16
Modificado: 4D v16 R5

 
ARTICLE USAGE

Referencia 4D Write Pro ( 4D v17)