4D v14.3

ST COMPUTE EXPRESSIONS

Página Inicial

 
4D v14.3
ST COMPUTE EXPRESSIONS

ST COMPUTE EXPRESSIONS 


 

ST COMPUTE EXPRESSIONS ( {* ;} objeto {; inicioSel {; fimSel}} )  
Parâmetro Tipo   Descrição
Operador in Se especificado, objeto é um nome de objeto (cadeia) Se omitido, objeto é um campo ou uma variável
objeto  Objeto de formulário in Nome de objeto (se * for especificado) ou
Campo ou variável (se * for omitido)
inicioSel  Inteiro longo in Inicio da seleção
fimSel  Inteiro longo in Fim da seleção

O comando ST COMPUTE EXPRESSIONS atualiza as expressões dinâmicas 4D encontradas no campo ou variável com texto enriquecido definido pelo parâmetro objeto.

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

O comando torna a avaliar o resultado das expressões presentes no objeto em função do contexto atual e mostra o resultado obtido. Por exemplo, se a expressão introduzida é a hora, o valor se modifica cada vez que se chama ao comando ST COMPUTE EXPRESSIONS. As expressões também se calculam:

  • quando se inserem
  • cuando se carrega o objeto
  • quando estão "congeladas" com o comando ST FREEZE EXPRESSIONS, se passar o segundo parâmetro *.

ST COMPUTE EXPRESSIONS Não modifica o texto com estilo (que contém etiquetas span), e sim só o texto sem formato mostrado em objeto. Os valores calculados não se armazenam no texto com estilo, só sua referência se armazena ali.

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

Não é necessário que objeto tenha o foco, no entanto, o objeto deve estar incluído em um formulário, ou caso contrário o comando ST COMPUTE EXPRESSIONS não tem nenhum efeito.

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 as etiquetas de estilo ou referências que possam estar presentes. Tenha em conta que uma referência é equivalente a um único caractere.

  • Se passar inicioSel e fimSel, ST COMPUTE EXPRESSIONS só atualiza as expressões situadas dentro desta seleção.
  • Se passar unicamente inicioSel ou se o valor de fimSel é maior que o número total de caracteres no objeto, todas as expressões entre inicioSel e o final do texto se calculam.
  • Se omite inicioSel e fimSel, todas as expressões incluídas na seleção usuário de objeto se calculam.
4D oferece constantes pré definidas 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 de campo ou de 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.

Exemplo  

Você deseja atualizar as referências incluídas na seleção de texto:

 ST COMPUTE EXPRESSIONS(*;"myText";ST Start highlight;ST End highlight)

 
PROPRIEDADES 

Produto: 4D
Tema: Texto multi estilo
Número 1285

Este comando modifica a variável sistema OK

 
HISTÓRIA 

New
Criado por: 4D v14

 
VER TAMBÉM 

ST FREEZE EXPRESSIONS

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)