4D Doc Center : ST FREEZE EXPRESSIONS

4D v14.3

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 no campo ou variável de texto com estilo definido pelo parâmetro objeto. Esta ação converte expressões dinâmicas em texto estático e tira as referências associadas ao objeto.

Para mais informação sobre expressões 4D usadas em áreas de texto multi estilo, veja a descrição do comando ST INSERT EXPRESSION.

El comando ST FREEZE EXPRESSIONS almacena el valor calculado de una expresión en un momento dado. Esta operación es necesaria antes de cada uso del objeto fuera de un área multiestilo (ej.: exporttaciones, almacenamiento, impresión, etc.) ya que solo la referencia de la expresión se mantiene en el área.

Si pasa el parámetro opcional * indica que el parámetro objeto es un nombre de objeto (cadena). Si omite el parámetro *, indica que el parámetro objeto es un campo o una variable. En este caso, se pasa una referencia de campo o variable en lugar de una cadena (variable o campo objeto únicamente).

Los parámetros opcionales inicioSel y finSel designan una selección de texto en objeto. Los valores inicioSel y finSel expresan una selección de texto plano, sin tener en cuenta etiquetas de estilo que pueden estar presentes.

Si pasa inicioSel y finSel, ST FREEZE EXPRESSIONS busca la URL dentro de esta selección.
Si pasa únicamente inicioSel o si el valor de finSel es mayor que el número total de caracteres en el objeto, el comando busca la URL entre inicioSel y el final del texto .
Si omite inicioSel y finSel, el comando busca la URL dentro de la selección de texto actual.

4D ofrece constantes predefinidas para que pueda designar automáticamente los límites de selección en los parámetros inicioSel y finSel. Estas constantes se encuentran en el 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

(*) Debe pasar un nombre de objeto en objeto para poder utilizar esta constante. Si pasa una referencia a un campo o variable, el comando se aplica a todo el texto del objeto.

Nota: si inicioSel es mayor que finSel (excepto cuando finSel es 0) , el comando no hace nada y la variable OK toma el valor 0.

Por defecto, las expresiones no son recalculadas antes de ser congenladas. Si quiere que la expresión se recalcule y luego se congele, debe pasar el segundo parámetro *.

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)