4D v14.3

ST Get text

Página Inicial

 
4D v14.3
ST Get text

ST Get text 


 

ST Get text ( {* ;} objeto {; inicioSel {; fimSel}} ) -> Resultado 
Parâmetro Tipo   Descrição
Operador in se especificado, objeto é um nome de objeto (string), se nao, objeto é uma variável ou campo.
objeto  Objeto de formulário in Nome de objeto (se * for especificada) ou campo texto ou variável (se * for omitida)
inicioSel  Inteiro longo in Inicio da seleção
fimSel  Inteiro longo in final da seleção
Resultado  Texto in Texto incluindo etiquetas de estilo

O comando OBJECT Get styled text devolve o texto com estilo encontrado no campo ou variável de texto designado pelo parâmetro objeto.

 

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (cadeia). Durante a execução se o objeto tem o foco, o comando devolve informação sobre o objeto que está sendo editado, no entanto, quando o objeto não tem o foco, o comando devolve informação sobre a fonte de dados (campo ou variável) do objeto.

Se omite o parâmetro *, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, passe uma referencia campo ou variável em vez de uma cadeia e durante a execução, o comando devolve informação sobre este campo ou variável.

 

O comando devolve o texto com as etiquetas de estilo associadas, o que significa, por exemplo, que pode copiar e colar texto, conservando os estilos.

Os parâmetros opcionais inicioSel e fimSel permitem designar uma seleção de texto em objeto. Os valores de inicioSel e fimSel oferecem uma seleção de texto sem formato, sem considerar nenhum tipo de etiquetas de estilo no texto.

  • Se omitir inicioSel e fimSel, ST Get text devolve todo o texto no objeto,
  • Se passa inicioSel e fimSel, ST Get text devolve a seleção de texto definida por estes limites.

4D oferece constantes predefinidas para que possa designar automaticamente os limites da 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.

Se os valores de inicioSel e fimSel são iguais ou se inicioSel é maior que fimSel, um erro é devolvido.

Depois de executar este comando, a variável OK toma o valor 1 se não é apresento nenhum erro; do contrário, toma o valor 0. Este  é o caso particularmente quando as etiquetas de estilo não são avaliados corretamente (etiquetas incorretas ou faltantes).

No caso de erro, não modifica a variável. Quando ocorre um erro em uma variável quando se está avaliando o texto, 4D transforma o texto em texto plano; como resultado, os caracteres <, > e & são convertidas em entidades HTML.

 
PROPRIEDADES 

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

Este comando modifica a variável sistema OK

 
HISTÓRIA 

New
Criado por: 4D v12
Modificado: 4D v12.1
Renomear: 4D v14

 
VER TAMBÉM 

ST Get plain text
ST SET TEXT
TEXT TO ARRAY

 
PALAVRAS CHAVES 

multi-style, multistyle, multi style

 
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)

Inherited from : OBJECT Get styled text ( 4D v12.4)