4D Doc Center : OBJECT Get styled text

4D v12.4

OBJECT Get styled text


OBJECT Get styled text ( {* ;} objeto {; inicioSel {; fimSel}} ) -> Resultado

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

Descrição

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

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (string). Se não passa este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, se passa um campo ou uma variável de referência ao invés de uma string.

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 finSel oferecem uma seleção de texto sem formato, sem considerar nenhum tipo de etiquetas de estilo no texto.

Se omitir inicioSel e endSel, OBJECT Get styled text devolve todo o texto no objeto,
Se passa inicioSel e fimSel, OBJECT Get styled text devolve a seleção de texto definida por estes límites.

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

Variáveis e conjuntos do sistema

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.