WP INSERT DOCUMENT

4D v16

WP INSERT DOCUMENT


WP INSERT DOCUMENT ( objFaixa ; docWP ; modo {; atualizFaixa} )

Parâmetro	Tipo	Descrição
objFaixa	Objeto	Faixa 4D Write Pro
docWP	Objeto	Documento 4D Write Pro
modo	Inteiro longo	Modo inserção
atualizFaixa	Inteiro longo	Modo atualização Faixa

Descrição

O comando WP INSERT DOCUMENT insee o documento docWP na faixa objFaixa de acordo com o modo de inserção especificado e o parâmetro atualizFaixa.

Em objFaixa, passe uma faixa de seleção 4D Write Pro válida. Um objFaixa ´ é uma parte de um documento 4D Write Pro; pode ser criado usando o comando , WP Get bookmark range ou WP Get range.

O documento inserido docWP pode ser qualquer documento 4D Write Pro criado com o comando WP New ou WP Import document. Só são inseridos os elementos de corpo de texto (seções e marcadores na faixa de destino são conservadas). Além disso, os elementos são copiados, por isso docWP podem ser utilizados várias vezes.

No parâmetro modo, passe uma ou uma combinação das seguintes constantes do tema Constantes 4D Write Pro para indicar o modo de inserção a ser utilizado para o documento na faixa objFaixa do documento de destino:

Constante	Tipo	Valor	Comentário
wk append	Inteiro longo	2	Insere conteúdos ao final da faixa e atualiza a faixa para conter tanto os conteúdos anteriores quanto os inseridos.
wk prepend	Inteiro longo	1	Conteúdos inseridos no início da faixa e atualiza a faixa para conter os conteúdos anteriores e os inseridos
wk replace	Inteiro longo	0	Substituir e atualizar conteúdos da faixa; a nova faixa contèm os conteúdos inseridos.

Po0de combinar uma das constantes anteriores com as seguintes opções de inserção:

Constante	Tipo	Valor	Comentário
wk freeze expressions	Inteiro longo	64	Congela expressoes no momento em que são inseridas
wk inherit style from paragraph	Inteiro longo	32	Conteúdos inseridos herdam o estilo de caractere do parágrafo
wk keep paragraph styles	Inteiro longo	128	Mantém o estilo dos parágrafos destino

No parâmetro opcional atualizFaixa, pode passar uma das seguintes constantes para especificar se os conteúdos inseridos estão incluídos na faixa resultante:

Constante	Tipo	Valor	Comentário
wk exclude from range	Inteiro longo	1	Insere conteùdos ao fim da faixa e atualiza a faixa para menter apenas conteúdos anteriores.
wk include in range	Inteiro longo	0	Insere conteúdos ao início da faixa e atualiza a faixa para manter apenas conteúdos anteriores

Se não passar um parâmetro atualizFaixa, como padrão os conteúdos inseridos estão incluídos na faixa resultante.

Exemplo 1

Se desejar substituir os conteúdos de um documento pelo texto selecionado de outro documento:

 $tempRange:=WP Get selection(WPTemplate) //recuperamos a seleção de usuário no documento WPTemplate

 $doctoCopy:=WP New($tempRange) //criamos um novo documento baseado em WPTemplate

 WP INSERT DOCUMENT(WPDoc;$doctoCopy;wk replace) //substituimos o conteúdo de WPDoc pelo conteúdo do novo documento

Exemplo 2

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 INSERT BREAK
WP INSERT PICTURE
WP New