4D Doc Center : OBJECT SET PLAIN TEXT

4D v12.4

OBJECT SET PLAIN TEXT


OBJECT SET PLAIN 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 (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 PLAIN TEXT inserta el texto pasado en el parámetro nuevTexto en el campo o la variable de texto con estilo designado por el parámetro objeto . Este comando aplica únicamente al texto plano del parámetro objeto, sin modificar las posibles etiquetas de estilo que contiene.

A diferencia del comando OBJECT SET STYLED TEXT, OBJECT SET PLAIN TEXT inserta únicamente texto plano. No debe pasar texto con etiquetas de estilo en nuevTexto. Si contiene los caracteres <, > o &, se consideran como caracteres estándar y se convierten en entidades HTML:

'&' se convierte en &
'<' se convierte en <
'>' se convierte en >

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 nuevTexto, pase el texto plano a insertar.

Los parámetros opcionales inicioSel y finSel permiten designar una selección de texto en objeto. Los valores de inicioSel y finSel dan 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 PLAIN TEXT reemplaza todo el texto de objeto por nuevTexto ,
Si pasa únicamente inicioSel o si los valores de inicioSel y finSel son iguales, OBJECT SET PLAIN TEXT inserta el texto nuevTexto en objeto a partir de inicioSel,
Si pasa inicioSel y finSel, OBJECT SET PLAIN TEXT sustituye el texto sin formato definido por estos límites por el texto nuevTexto.

El estilo del primer carácter reemplazado se utilizará para todo el texto nuevTexto.

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

Ejemplo

Dada la siguiente variable texto multiestilo:

Usted quiere insertar nombres de empresas guardadas en un campo texto. Estos nombres pueden contener, por ejemplo el carácter "&". En este caso, deberá utilizar el comando OBJECT SET PLAIN TEXT:

OBJECT SET PLAIN TEXT(miTextoEstilo;[Empresa]Nombre;33;34)

Este es el resultado:

Este es el texto sin formato contenido en la variable:

Puede constatar que el texto insertado se encapsuló dentro de un par de etiquetas de estilo adicionales. Estas etiquetas corresponden al estilo de los caracteres antes de la inserción. Este mecanismo permite garantizar una visualización correcta de los campos multiestilos en todos los casos.

Nota: si utiliza el comando OBJECT SET STYLED TEXT en este caso, 4D no inserta nada porque la presencia del carácter "&" no codificado evita la interpretación de las etiquetas de estilo presentes en la variable. Para mayor información, consulte la descripción de este comando.

Variables y conjuntos del sistema

Después de la ejecución de este comando, la variable OK toma el valor 1 si no hay errores, de lo contrario toma el valor 0. Este es el caso en particular cuando las etiquetas de estilo no se evalúan correctamente (etiqueta incorrecta o falta).

En caso de un error, la variable no cambia. Cuando se produce un error en una variable cuando el texto está siendo evaluado, 4D transforma el texto en texto sin formato, como resultado, los caracteres <, > e & se convierten en entidades HTML.