WP New

4D v20 R7

WP New


WP New {( fonte {; opção} )} -> Resultado

Parâmetro	Tipo	Descrição
fonte	String, BLOB, Objeto	Fonte HTML 4D ou Blob 4D Write
opção	Inteiro longo	Opção de importação para expressões HTML
Resultado	Objeto	Objeto 4D Write Pro

Descrição

O comando WP New cria e devolve um objeto 4D Write Pro.[#/descv]. O objeto retornado é um documento completo que pode ser passado ao comando WP INSERT DOCUMENT, por exemplo.

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.
un parámetro objeto que puede ser:
- uma range.
  WP New retorna um novo documento criado a partir da range especificada. Note que, se a range não for igual a range completa do documento, só a primeira seção é exportada e bookmarks não são exportadas
- um elemento de referência (tabela / fila/ parágrafo / imagem inline / cabeçalho / rodapé/seção/subseção).
  WP New retorna um novo documento contendo só os conteúdos da referência de elementos na parte do corpo (para uma fila, o novo documento vai conter um elemento de tabela com a fila).
- um documento 4D Write Pro.
  WP New vai retornar uma cópia do documento especificado.
- um documento 4D Write Pro

Como padrão, expressões HTML inseridas em documentos 4D WRite legados não são importados (não têm compatibilidade com 4D Write Pro). Se passar a constante wk import html expressions as text no parâmetro opção, expressões HTML serão importadas como texto raw entre as tags ##htmlBegin## e ##htmlEnd## -- que exigirá depois ações de formatação. Por exemplo:

##htmlBegin##<span>Imported title<b>bold</b></span>##htmlEnd##

Nota de compatibilidade: Folhas de estilo de caracteres em documentos 4D Write "legado" usam um mecanismo proprietário, que não é mais compatível com o 4D Write Pro. Para obter os melhores resultados de textos importados, atributos de folha de estilo são convertidos para atributos de estilo "hard coded". Folhas de estilo caractere "legado" não são importadas e não são mais referenciadas no documento.

Exemplo 1

Deseja criar um objeto 4D Write Pro vazio:

myWPObject:=WP New

Exemplo 2

Se quiser criar um novo objeto 4D Write Pro além de um documento 4D Write Pro armazenado em disco :

 C_BLOB($BlobDoc)

 C_OBJET(myWPArea)

 DOCUMENT VERS BLOB("myDoc.4wp";$BlobDoc) //carrega o documento a partir de um Blob

 myWPArea:=WP Nouveau($BlobDoc)

Exemplo 3

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 4

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 5

Se quiser importar um documento armazenado em um campo BLOB do registro atual do anterior plug-in 4D Write em uma área nova 4D Write Pro e manter as expressões HTML:

 C_OBJECT(wpArea)

 wpArea=WP New([Templates]Reference_;wk import html expressions as text)

Exemplo 6

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