WP INSERT FORMULA

4D v19

WP INSERT FORMULA


WP INSERT FORMULA ( alvoObj ; formula ; modo {; atualizaRange} )

Parâmetro	Tipo	Descrição
alvoObj	Objeto	Range de elementos ou elemento ou documento 4D Write Pro
formula	Objeto	Objeto fórmula
modo	Número	Modo de inserção
atualizaRange	Número	Inclui ou exclui o conteúdo inserido dentro da range de seleção

Descrição

O comando WP INSERT FORMULA insere uma formula em alvoObj de acordo com um mode de inserção especificado.

No parâmetro alvoObj, pode passar:

uma range, ou
um elemento (tabela /linha / células / parágrafo / corpo / cabeçalho / rodapé / seção / subseção / imagem inline), ou
um documento 4D Write Pro.

No parâmetro formula, passe 4D formula para avaliar em um objeto criado pelos comandos Formula ou Formula from string.

No parâmetro modo, passe uma das constantes abaixo para indicar o modo de inserção a ser usado:

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.

se alvoObj for uma range, pode usar o parâmetro opcional AtualizaRange para passar uma das constantes abaixo para especificar se a formula inserida está ou não incluida na range 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 atualizaRange, por padrão a formula inserida está incluida na range resultante.

se alvoObj não for uma range, atualizaRange é ignorado.

Nota: Lembre que quando chamado, o objeto formula é avaliado dentro do contexto do banco de dados ou componente que o criar

Exemplo

Para substituir todas as fórmulas atuais de data com strings formatadas:

 C_COLLECTION($_formulas)

 C_OBJECT($find;$newFormula)

 

  // define a fórmula a ser encontrada

 $find:=Formula(Current date)

 

  // define a fórmula de substituição

 $newFormula:=Formula(String(Current date;System date long))

 

  // encontra todas as fórmulas no documento

 $_formulas:=WP Get formulas(WriteProArea)

 

  // pesquisa a coleção de WP Get formulas

 $_formulas:=$_formulas.query("formula.source =:1";$find.source)&NBSP;&NBSP;

 

  // daí substitui cada fórmula

 For each($formula;$_formulas)

    WP INSERT FORMULA($formula.range;$newFormula;wk replace)

 End for each

Ver também

Gestão de fórmulas
WP COMPUTE FORMULAS
WP FREEZE FORMULAS
WP Get formulas