ST INSERT EXPRESSION

4D v20.6


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

Se passar o parâmetro opcional * indica que o parâmetro objeto é um nome de objeto (cadeia). Se omitir o parâmetro *, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, se passar uma referência de campo ou variável em vez de uma cadeia (variável ou campo objeto unicamente).

No parâmetro expressao, se passar a expressão 4D a avaliar no objeto. A expressão deve ser posta entre aspas duplas ("").

Uma expressão válida 4D é uma cadeia que retorna um valor. A expressao pode ser um campo, uma variável, um comando 4D, uma instrução que retorne um valor, um método de projeto,uma expressão especial 4D Write Pro (ver Gestão de fórmulas), etc.

Notas:

Inserir expresões de imagem (por exemplo variáveis do tipo Imagem) é compatível com áreas 4D Write Pro (ver Inserir expressões de imagem) mas não é compatível com áreas multi-estilo.
Este comando espera nomes "reais" para os campos e as tabelas, mesmo se tiver sido definida uma estrutura "virtual" usando os comandos SET TABLE TITLES e SET FIELD TITLES.

Se expressao retorna um valor que contém retornos de carro e tabulações, 4D formata o texto de acordo ao objeto que alberga a expressão; caracteres de retorno de carro se interpretam como rupturas de linha.

Pode dar formato a expressão mediante a inclusão de informação de formato no parâmetro de expressão. Neste caso, o parâmetro deve ser na forma:

"String(valor;formato)"

... onde valor contém a expressão mesma e formato contém o formato a aplicar. O parâmetro formato pode ter os seguintes valores:

para os números: por exemplo "###,##" qualquer formato de visualização do número (existente ou não).
para datas: um número que designa um formato de data existente. Pode utilizar as constantes do tema "Formatos de saída de datas" , por exemplo, System date short .
para os tempos: um número que designa um formato de hora existente. Pode utilizar as constantes do tema "Formatos de saída de hora" , por exemplo, System time short .

Por exemplo:

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

Por padrão, os valores de expressão são mostrados nas áreas de texto multiestilo. Pode forçar a visualização das referências utilizando o comando ST SET OPTIONS.

Os parâmetros opcionais inicioSel e fimSel designam uma seleção de texto em objeto. Os valores inicioSel e fimSel expressam uma seleção de texto plano, sem ter em conta etiquetas de estilo que podem estar presentes.

Se passar unicamente inicioSel, o resultado da expressão se insere na localização especificada.
Se omitir inicioSel e fimSel, o resultado da expressão se insere na localização do cursor.
Se passar inicioSel e fimSel, ST INSERT EXPRESSION substitui o texto nesta seleção com o resultado da expressao. Se o valor de fimSel é maior que o número total de caracteres no objeto, todos os caracteres entre inicioSel e o final do texto são substituídos pelo resultado da expressao.

4D oferece constantes predefinidas para que possa designar automaticamente os limites de seleção nos parâmetros inicioSel e fimSel. Estas constantes se encontram 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 de objeto em objeto para poder utilizar esta constante. Se passar uma referência a um campo ou variável, o comando se aplica a todo o texto do objeto.

Nota: se inicioSel é maior que fimSel (exceto quando fimSel é 0) , o comando não faz nada e a variável OK toma o valor 0.K toma o 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)

Ver também

ST COMPUTE EXPRESSIONS
ST FREEZE EXPRESSIONS
ST Get expression
ST INSERT URL