4D Doc Center : OBJECT SET STYLED TEXT

4D v12.4

OBJECT SET STYLED TEXT


OBJECT SET STYLED TEXT ( {* ;} objeto ; novoTexto {; inicioSel {; fimSel}} )

Parâmetro	Tipo	Descrição
*	Operador	Se especificado, objeto é um nome de objeto (string), se omitido, objeto é uma variável ou campo
objeto	Objeto de formulário	Nome de objeto (se * for especificado) ou campo ou variável Texto (se * for omitido)
novoTexto	Texto	Texto a inserir
inicioSel	Inteiro longo	Início da seleção
fimSel	Inteiro longo	Final da seleção

Descrição

O comando OBJECT SET STYLED TEXT insere o texto passado no parâmetro nuevText no campo ou variável de texto com estilo designado pelo parâmetro objeto. Este comando só é aplicado ao texto sem formato do parâmetro de objeto, sem modificar as etiquetas de estilo que contenha. Se pode utilizar para modificar por programação, texto com estilo na tela.

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, não passe uma referência de campo ou de variável ao invés de uma string.

Em novText, passe o texto a inserir. O comando OBJECT SET STYLED TEXT está desenhado para trabalhar com texto enriquecido (multiestilo) com etiquetas de tipo <span>. Em todos os demais casos (particularmente, quando trabalha com texto plano que contenha os caracteres <, > ou &), deve utilizar o comando OBJECT SET PLAIN TEXT. Se passa texto plano com os caracteres <, > ou & ao comando OBJECT SET STYLED TEXT, o comando no faz nada. Este princípio de funcionamento é necessário porque se inserir diretamente uma string como "a>b" dentro de um texto enriquecido, não distorcionará a análise interna das etiquetas <span>. Neste caso, o caractere "<" deve ser previamente codificado como "<", o qual pode ser feito utilizando o comando OBJECT SET PLAIN TEXT (ver também o exemplo deste comando).

Os parâmetros opcionais inicioSel e fimSel permitem designar uma seleção de texto no objeto. Os valores de inicioSel e fimSel oferecem uma seleção de texto sem formato, sem levar em consideração nenhum tipo de etiquetas de estilo no texto. A ação do comando varía segundo os parâmetros opcionais inicioSel e fimSel:

Se omite inicioSel e finSel, OBJECT SET STYLED TEXT substitui todo o texto do objeto por nuevText,
Se passa unicamente inicioSel ou se os valores de inicioSel e finSel são iguais, OBJECT SET STYLED TEXT insere o texto novText em objeto a partir de inicioSel,
Se passa ambos inicioSel e fimSel, OBJECT SET STYLED TEXT sustitui o texto sem formato definido para estes límites com o texto novText.

Se inicioSel é superior a fimSel, o texto não se modifica e a variável OK toma o valor 0.

Exemplo 1

Se quer substituir o texto com estilo selecionado pelo usuário com o conteúdo de uma variável.

Este é o texto selecionado:

O conteúdo armazenado no campo é o seguinte:

Depois da execução de este código:

 vtempo:="Demonstração"

 GET HIGHLIGHT([Productos]Notas;vInicio;vFim)

 OBJECT SET STYLED TEXT([Produtos]Notas;vtemp;vInicio;vFim)

O campo e seu conteúdo são os seguintes:

Exemplo 2

Consulte o exemplo do comando OBJECT SET PLAIN TEXT.

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.