WP New

4D v16

WP New


WP New {( fonte )} -> Resultado

Parâmetro	Tipo	Descrição
fonte	String, BLOB, Objeto	Fonte HTML 4D ou Blob 4D Write
Resultado	Objeto	Objeto 4D Write Pro

Descrição

O comando WP New cria e devolve um objeto 4D Write Pro.

Por padrão, se omitir o parâmetro fonte, o comando devolve um objeto 4D Write Pro vazio.

Também pode utilizar o parâmetro fonte, em cujo caso o novo objeto 4D Write Pro será preenchido com o conteúdo da fonte. Pode passar:

um parâmetro cadeia: Neste caso, passe uma fonte HTML 4D, ou seja, um texto exportado por WP EXPORT VARIABLE com a opção wk web page html 4D. Este texto pode conter referências (etiquetas e expressões 4D) e imagens aninhadas).
ou um parâmetro blob: Neste caso, deve passar ou:
- um formato de documento 4D Write Pro (.4wp) armazenado em um BLOB. Para saber mais sobre o formato 4D Write Pro, veja formato de documento .4wp.
- uma área de legado 4D Write carregada em um BLOB (Blobs contendo documentos .4w7 ou .4wt são suportados). Para uma lista detalhada de propriedades de 4D Write suportadas em documentos 4D Write Pro, veja a seção Importar documentos 4D Write
- Se deseja importar um documento 4D Write (.4w7 ou .4wt) armazenado no disco, também pode considerar o uso do comando WP Import document.
- um parâmetro objeto : Neste caso, pode pasasr um objeto faixa 4D Write Pro. WP New vai retornar um novo documento criado da faixa especificada. Note que, se a faixa não for igual à faixa do documento completo, apenas a primeira seção é exportada e as bookmarks não são exportadas, se houver.
O objeto retornado é um documento completo que pode ser passada ao comando WP INSERT DOCUMENT , por exemplo

Exemplo 1

Deseja criar um objeto 4D Write Pro vazio:

myWPObject:=WP New

Exemplo 2

Deseja criar um objeto 4D Write Pro que contém uma referência de expressão 4D simples:

 C_TEXT(myText)

 myText:="Today is "

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

 myWPA:=WP New(myText)

Exemplo 3

Você deseja inicializar sua área 4D Write Pro com um modelo criado previamente:

  //Exportar modelo desde uma área existente

 C_TEXT(wpTemplate)

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

 

  // Utilizar o modelo para uma nova área

 C_OBJECT(myNewWPA)

 myNewWPA:=WP New(wpTemplate)

Exemplo 4

Você deseja importar um documento 4D Write armazenado em um campo 4D do registro atual a área nova 4D Write Pro:

 C_OBJECT(wpArea)

 wpArea=WP New([Templates]Reference_)

Se definir um documento modelo com partes pré-formatadas diferentemente, cada uma das quais sendo armazenadas como uma bookmark. Quando produzir um documento final do modelo, pode extrair qualquer bookmark como um novo documento e inserir a bookmark no documento final.

 ARRAY TEXT($_BookmarkNames;0)

 WP GET BOOKMARKS([TEMPLATES]WP;$_BookmarkNames) //obtém as bookmarks do modelo

 $targetRange:=WP New //criar um documento vazio (será o documento final)

 

 $p:=Find in array($_BookmarkNames;"Main_Header") //gerencia a parte principal cabeçalho 

 If($p>0)

    $Range:=WP Get bookmark range(WParea;$_BookmarkNames{$p}) //seleciona a faixa

    $RangeDoc:=WP New($Range) //cria um novo documento da faixa

    WP INSERT DOCUMENT($buildRange;$RangeDoc;wk prepend+wk freeze expressions) //wk prepend=after replacement, $buildRange é igual ao fim do texto substituído

 End if

Ver também

WP Import document
WP INSERT DOCUMENT

4D v16

WP New

WP New

Descrição

Exemplo 1

Exemplo 2

Exemplo 3

Exemplo 4

Exemplo 5