4D Doc Center : ST INSERT EXPRESSION

4D v14.3

ST INSERT EXPRESSION


ST INSERT EXPRESSION ( {* ;} objeto ; expressao {; 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	Object	Nome de objeto (se * for especificado) ou Campo ou variável (se * for omitido)
expressao	Texto	Expressão e (opcional) formato a inserir
inicioSel	Inteiro longo	Início da seleção
fimSel	Inteiro longo	Fim da seleção

Descrição

O comando ST INSERT EXPRESSION insere uma referência a expressão no campo ou a variável de texto multi estilo designada pelo parâmetro objeto.

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).

En el parámetro expresión, se pasa la expresión 4D a evaluar en el objeto. Una expresión válida 4D es una cadena que retorna un valor. La expresión puede ser una campo, una variable, un comando 4D, una instrucción que retorne un valor, un método de proyecto, etc.

La expresión debe ser puesta entre comillas dobles ("").

Nota: El parámetro expresión no puede ser de tipo Imagen.

Si expresión retorna un valor que contiene retornos de carro y tabulaciones, 4D formatea el texto de acuerdo al objeto que alberga la expresión; caracteres de retorno de carro se interpretan como rupturas de línea.

Puede dar formato a la expresión mediante la inclusión de información de formato en el parámetro de expresión. En este caso, el parámetro debe ser en la forma:

"String(valor;formato)"

... donde valor contiene a la expresión misma y formato contiene el formato a aplicar. El parámetro formato puede tener los siguientes valores:

para los números: por ejemplo "###,##" cualquier formato de visualización del número (existente o no).
para fechas: un número que designa un formato de fecha existente. Puede utilizar las constantes del tema "Formatos de saída de datas" , por ejemplo, System date short .
para los tiempos: un número que designa un formato de hora existente. Puede utilizar las constantes del tema "Formatos de saída de hora" , por ejemplo, System time short .

Por ejemplo:

"String ([tabla_1]Campo_1;System date short)"

Por defecto, los valores de expresión se muestran en las áreas de texto multiestilo. Puede forzar la visualización de las referencias utilizando el comando ST SET OPTIONS.

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 INSERT EXPRESSION 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.

Exemplo

Deseja substituir o texto selecionado com o resultado de um método projeto:

ST INSERT EXPRESSION(*;"meuTexto";"meuMetodo";ST Start highlight;ST End highlight)