4D Doc Center : OBJECT SET STYLED TEXT

4D v12.4

OBJECT SET STYLED TEXT


OBJECT SET STYLED TEXT ( {* ;} objeto ; nuevTexto {; inicioSel {; finSel}} )

Parámetro	Tipo	Descripción
*	Operador	Si se especifica, objeto es un nombre de objeto (cadena) Si se omite, objeto es una variable o un campo
objeto	Objeto de formulario	Nombre del objeto (si se especifica ) o Variable o campo Texto (si se omite )
nuevTexto	Texto	Texto a insertar
inicioSel	Entero largo	Inicio de la selección
finSel	Entero largo	Fin de la selección

Descripción

El comando OBJECT SET STYLED TEXT inserta el texto pasado en el parámetro nuevText en el campo o variable de texto con estilo designado por el parámetro objeto. Este comando sólo se aplica al texto sin formato del parámetro de objeto, sin modificar las etiquetas de estilo que contiene. Se puede utilizar para modificar por programación, texto con estilo en la pantalla.

Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (cadena). Si no pasa este parámetro, indica que el parámetro objeto es un campo o una variable. En este caso, se pasa una referencia de campo o variable en lugar de una cadena.

En nuevText, pase el texto a insertar. El comando OBJECT SET STYLED TEXT está diseñado para trabajar con texto enriquecido (multiestilo) con etiquetas de tipo <span>. En todos los demás casos (particularmente, cuando trabaja con texto plano que contiene los caracteres <, > o &), debe utilizar el comando OBJECT SET PLAIN TEXT. Si pasa texto plano con los caracteres <, > o & al comando OBJECT SET STYLED TEXT, el comando no hace nada. Este principio de funcionamiento es necesario porque si inserta directamente una cadena como "a>b" dentro de un texto enriquecido, no distorsionará el análisis interno de las etiquetas <span>. En este caso, el carácter "<" debe ser previamente codificado como "<", lo cual se puede hacer utilizando el comando OBJECT SET PLAIN TEXT (ver también el ejemplo de este comando).

Los parámetros opcionales inicioSel y finSel permiten designar una selección de texto en el objeto. Los valores de inicioSel y finSel ofrecen una selección de texto sin formato, sin tener en cuenta ningún tipo de etiquetas de estilo en el texto. La acción del comando varía según los parámetros opcionales inicioSel y finSel:

Si omite inicioSel y finSel, OBJECT SET STYLED TEXT reemplaza todo el texto del objeto por nuevText,
Si pasa únicamente inicioSel o si los valores de inicioSel y finSel son iguales, OBJECT SET STYLED TEXT inserta el texto nuevText en objeto a partir de inicioSel,
Si pasa ambos inicioSel y finSel, OBJECT SET STYLED TEXT sustituye el texto sin formato definido para estos límites con el texto nuevText.

Si inicioSel es superior a finSel, el texto no se modifica y la variable OK toma el valor 0.

Ejemplo 1

Si quiere reemplazar el texto con estilo seleccionado por el usuario con el contenido de una variable.

Este es el texto seleccionado:

El contenido almacendo en el campo es el siguiente:

Después de la ejecución de este código:

 vtempo:="Demonstración"

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

 OBJECT SET STYLED TEXT([Productos]Notas;vtemp;vInicio;vFin)

El campo y su contenido son los siguientes:

Ejemplo 2

Consulte el ejemplo del comando OBJECT SET PLAIN TEXT.

Variables y conjuntos del sistema

Después de ejecutar este comando, la variable OK toma el valor 1 si no se presenta ningún error; de lo contrario, toma el valor 0. Este es el caso particularmente cuando las etiquetas de estilo no se evalúan correctamente (etiquetas incorrectas o faltantes).

En caso de error, no cambia la variable. Cuando ocurre un error en una variable cuando se está evaluando el texto, 4D transforma el texto en texto plano; como resultado, los caracteres <, > y & se convierten en entidades HTML.