4D Doc Center : WR INSERT EXPRESSION

4D Write v14

WR INSERT EXPRESSION


WR INSERT EXPRESSION ( area ; expressao {; formatoNum {; formatoData {; formatoHora {; destino {; tamanho}}}}} )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Área 4D Write
expressao	cadeia	Expressão a inserir
formatoNum	cadeia	Formato numérico
formatoData	Inteiro	Número do formato da data
formatoHora	Inteiro	Número do formato da hora
destino	Inteiro longo	Lugar donde será localizada a imagem
tamanho	Inteiro longo	0=Tamanho fixo, 1=Tamanho ajustado

Descrição

O comando WR INSERT EXPRESSION insere uma referencia a expressão em area, substituindo todo texto selecionado.
expressao deve ser uma expressão 4D válida que devolve um valor. expressao pode ser uma variável, uma função, um método projeto, uma rotina externa ou toda expressão que devolva um valor. expressao pode também ser uma variável imagem. Se expressao é uma variavel, deve passar seu nome entre aspas duplas ("").
Se expressao devolve um valor que inclui retornos de carro e tabulações, 4D Write os considera.
O parâmetro opcional formatoNum indica o formato das expressões numéricas (ou seja, Numérico, Inteiro, ou Inteiro longo). Pode conter todo formato de saída numérico, existente ou não (por exemplo, "###,##"). Passe uma cadeia vazia quando este parâmetro não seja apropriado, ou omita se os seguintes dois parâmetros foram omitidos.
O parâmetro opcional formatoData indica o formato das expressões de tipo Data. Deve conter um número de formato de data existente. Passe 0 quando este parâmetro não seja apropriado, ou omita se o parâmetro seguinte foi omitido.
Caso contrário, utilize as seguintes constantes 4D, que se encontra no tema "Formatos de saída de datas" de 4D e o tema WR Parameters de 4D Write:

Constante	Tipo	Valor
System date short	Inteiro longo	1
System date abbreviated	Inteiro longo	2
System date long	Inteiro longo	3
Internal date short special	Inteiro longo	4
Internal date long	Inteiro longo	5
Internal date abbreviated	Inteiro longo	6
Internal date short	Inteiro longo	7

Constante	Tipo	Valor
wr no date format	Inteiro longo	0

O parâmetro opcional formatoHora indica o formato das expressões de tipo Hora. Deve conter um número que indica um formato de hora existente. Passe 0 quando este parâmetro não seja apropriado ou omite ele.
Caso contrário, utilize as seguintes constantes 4D, que se encontra no tema "Formatos de saída de datas" de 4D e o tema WR Parameters de 4D Write:

Constante	Tipo	Valor
HH MM SS	Inteiro longo	1
HH MM	Inteiro longo	2
Hour min sec	Inteiro longo	3
Hour min	Inteiro longo	4
HH MM AM PM	Inteiro longo	5

Constante	Tipo	Valor
wr no time format	Inteiro longo	0

Quando insere um campo imagem, o parâmetro opcional destino indica que a imagem deve ser inserida no documento. Pode escolher qualquer valor maior a 0 ou uma das seguintes constantes, do tema "WR Parameters":

Constante	Tipo	Valor
wr on left hand pages	Inteiro longo	-12
wr on right hand pages	Inteiro longo	-11
wr on current page	Inteiro longo	-4
wr into the text flow	Inteiro longo	0

Todo valor >0

A imagem é visível na página de número destino. O valor deve ter em conta o número de início.

Ao agregar um campo imagem, o parâmetro opcional tamanho permite definir se o retângulo de visualização será mantido ou ajustado:
Se passar 1 em tamanho, quando se calcula a expressão, o retângulo de visualização se ajusta ao tamanho da nova imagem.
Se pasar 0 em tamanho, quando se calcula a expressão, o retângulo de visualização se conserva tal qual, sem importar o tamanho da nova imagem.

Exemplo

O seguinte exemplo de duas partes mostra uma referencia a um método de projeto 4D inserido em uma área 4D Write. O método de projeto procura as faturas relacionadas com o cliente e concatena os números de fatura e as quantidades:

  `Método de proyecto MOSTRAR FATURAS

 $Tab:=Char(Tab key)

 $CR:=Char(Return key)

 RELATE MANY([Clientes])

 FIRST RECORD([Faturas])

 $0:=""

 For($i;1;Records in selection([Faturas]))

    $0:=$0+[Invoices]Number+$Tab+String([Faturas]Amount;"$###,##0.00")+$CR

    NEXT RECORD([Faturas])

 End for

A segunda parte deste exemplo mostra a inserção do método de projeto MOSTRAR FATURAS em area. Quando 4D Write mostra ou imprime area, cada fatura aparecerá em uma linha separada.

WR INSERT EXPRESSION(area;"MOSTRAR FATURAS")