WP New

Home

4D v15

WP New


WP New {( source )} -> Function result

Parameter	Type	Description
source	String, BLOB	4D HTML source or 4D Write Blob
Function result	Object	4D Write Pro object

Description

The WP New command creates and returns a 4D Write Pro object.

By default, if you omit the source parameter, the command returns an empty 4D Write Pro object.

You can also use the source parameter, in which case the new 4D Write Pro object will be filled with the contents of the source. You can pass:

either a string parameter: In this case, you pass a 4D HTML source, i.e. a text exported by WP EXPORT VARIABLE with the wk web page html 4D option. This text can contain references (4D tags and expressions) and embedded images.
or a blob parameter: In this case, you pass a legacy 4D Write area loaded in a BLOB (Blobs containing .4w7 or .4wt documents are supported). For a detailed list of 4D Write features that are currently supported in 4D Write Pro objects, please refer to the Importing 4D Write documents section.
If you want to import a 4D Write document (.4w7 or .4wt) stored on disk, you can also consider using the WP Import document command.

Example 1

You want to create an empty 4D Write Pro object:

myWPObject:=WP New

Example 2

You want to create a 4D Write Pro object containing a simple 4D expression reference:

 C_TEXT(myText)

 myText:="Today is "

 ST INSERT EXPRESSION(myText;"string(current date;System date long)";ST End text)

 myWPA:=WP New(myText)

Example 3

You want to initialize your Write Pro area with a previously-created template:

  //Export template from an existing area

 C_TEXT(wpTemplate)

 WP EXPORT VARIABLE(myWPArea;wpTemplate;wk web page html 4D)

 

  // use the template for a new area

 C_OBJECT(myNewWPA)

 myNewWPA:=WP New(wpTemplate)

Example 4

You want to import a 4D Write document stored in a 4D field of the current record into a new 4D Write Pro area:

 C_OBJECT(wpArea)

 wpArea=WP New([Templates]Reference_)