ST FREEZE EXPRESSIONS
ST FREEZE EXPRESSIONS ( {* ;} objeto {; inicioSel {; fimSel}}{; *} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | 🡒 | Se especificado, objeto é um nome de objeto (cadeia) Se omitido, objeto é um campo ou uma variável |
| objeto | Objeto de formulário | 🡒 | Nome de objeto (se * for especificado) ou Campo ou variável (se * for omitido) |
| inicioSel | Inteiro longo | 🡒 | Inicio da seleção |
| fimSel | Inteiro longo | 🡒 | Fim da seleção |
| * | Operador | 🡒 | Se passar = atualizar as expressões antes de congelar elas |
Descrição
O comando ST FREEZE EXPRESSIONS "congela" o conteúdo das expressões encontradas em texto mult-estilo ou no campo ou variável 4D Write Pro com estilo definido pelo parâmetro objeto. Esta ação converte expressões dinâmicas em texto estático ou (apenas para áreas 4D Write Pro) converte imagens e remove as referências associadas ao objeto.
Para mais informação sobre expressões 4D usadas em áreas de texto multi estilo, ou áreas 4D Write Pro, veja a descrição do comando ST INSERT EXPRESSION.
O comando ST FREEZE EXPRESSIONS armazena os valores computados de uma expressão num dado momento. Esta operação é particuarlmente necessária antes de cada uso de objeto fora da aréa (exportação, armazenagem em um arquivo disco, impressão) já que a referência da expressão é mantida na própria área.
Passar o parâmetro opcional * indica que o parâmetro objeto é um nome objeto (string). Se não passar este parâmetro, indica que o parâmetro objeto é um campo ou variável. Neste caso, se passar uma referência de campo ou variável ao invés de uma string (apenas campo ou objeto variável).
Os parâmetros opcionais startSel e endSel designam uma seleção de texto em objeto. Os valores startSel e endSel expresam uma seleção de texto simples, sem levar em consideração tags de estilo ou referências presentes.
- se passar startSel e endSel, ST FREEZE EXPRESSIONS congela apenas as expressões localizadas dentro da seleção.
- Se passr apenas startSel ou se o valor de endSel for maior que o número total de caracteres no objeto, todas as expressões entrestartSel e o final do texto são congeladas.
- Se omitir startSel e endSel, todas as expressões incluídas na seleção de usuário do objeto são congeladas.
4D oferece constantes pré-definidas para que possa designar a seleção de limites automaticamente nos parâmetros startSel e endSel.
Estas constantes são encontradas no tema"Texto multi estilo":
| Constante | Tipo | Valor | Comentário |
|---|---|---|---|
| ST End highlight | Inteiro longo | -1001 | Designa o último caractere da seleção atual de texto no objeto (*) |
| ST End text | Inteiro longo | 0 | Designa o último caractere do texto contido no objeto |
| ST Start highlight | Inteiro longo | -1000 | Designa o primeiro caractere da seleção atual de texto no objeto (*) |
| ST Start text | Inteiro longo | 1 | Designa o primeiro caractere do texto contido no objeto |
(*) Deve passar um nome objteo em objeto para poder usar esta constante. Se passar uma referência para um campo ou variável, o comando é aplicável a todos os textos do objeto.
Nota: Se startSel for maior que endSel (exceto quando endSel for 0), o comando não faz nada e a variável OK é estabelecida para 0.
Como padrão, expressões não são reavaliadas antes de serem congeladas. Se quiser que a expressão seja recalculada e depois congelada, pode passar o segundo parãmetro * .
Nota: ST FREEZE EXPRESSIONS não congela as expressões 4D Write Pro $wp_pageNumber e $wp_pageCount. Para saber mais, veja a seção Gestão de fórmulas.
Exemplo
Você quer inserir a hora atual ao início do texto e logo congelar ela antes de guardar o registro:
//Inserir a hora ao ínicio do texto
ST INSERT EXPRESSION(*;StyledText_t;"Current time";1)
//Congelamos a expressão
ST FREEZE EXPRESSIONS(*;"StyledText_t";1)