4D Doc Center : OBJECT SET STYLED TEXT ATTRIBUTES

4D v13.4

OBJECT SET STYLED TEXT ATTRIBUTES


OBJECT SET STYLED TEXT ATTRIBUTES ( {* ;} objeto ; inicioSel ; finSel ; nomAtrib ; valorAtrib {; nomAtrib2 ; valorAtrib2 ; ... ; nomAtribN ; valorAtribN} )

Parámetro	Tipo	Descripción
*	Operador	Si se especifica, objeto es un nombre de objeto (cadena) Si se omite, objeto es una variable
objeto	Objeto de formulario	Nombre del objeto (si se especifica ), o Variable o campo Texto (si se omite )
inicioSel	Entero largo	Inicio de la nueva selección de texto
finSel	Entero largo	Fin de la nueva selección de texto
nomAtrib	Cadena	Atributo a definir
valorAtrib	Cadena, Entero largo	Nuevo valor del atributo

Descripción

El comando OBJECT SET STYLED TEXT ATTRIBUTES permite modificar uno o más atributos de estilo en el(los) objeto(s) de formulario designado(s) por objeto.

Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (una cadena). Durante la ejecución, si el objeto tiene el foco, el comando sólo se aplica al objeto que se está editando y no a su fuente de datos (campo o variable). Los cambios sólo se transfieren a la fuente (y a cualquier otro objeto con esta misma fuente) cuando el objeto que se está editando se valida, ya sea por perder el foco o con la tecla Intro. Si el objeto no tiene el foco, el comando se aplica directamente a la fuente de datos y los cambios son inmediatamente trasladados a otros objetos con la misma fuente.
Si se omite el parámetro *, indica que el parámetro objeto es un campo o una variable y se pasa una referencia de campo o variable en lugar de una cadena. El comando se aplica directamente al campo o a la variable y los cambios son transferidos inmediatamente a todos los objetos que utilizan esta fuente, incluyendo el objeto con el foco.

Nota: sólo puede utilizar los atributos de estilo con campos de tipo texto. Dado que los campos de tipo Alfa tienen una longitud predefinida, la adición de etiquetas de estilo podría llevar a una pérdida de datos.

La definición de un atributo se efectúa a través de la inserción o modificación de etiquetas HTML de estilo al interior del texto (para obtener más información acerca de este punto, consulte el Manual de Diseño). Tenga en cuenta que OBJECT SET STYLED TEXT ATTRIBUTES inserta etiquetas de estilo en todos los casos, aunque objeto designe los objetos de texto del formulario que no tengan la propiedad Multistyle.

Los parámetros inicioSel y finSel se pueden utilizar para designar a la selección de texto al que desea aplicar la modificación de estilo al interior de objeto. En inicioSel pase la posición del primer carácter a modificar y en finSel, pase la posición del último carácter a modificar más uno (el último carácter pasado no se incluye en la modificación). Puede pasar 0 en finSel para designar automáticamente el último carácter del texto (pase 1 en inicioSel para designar el primer carácter del texto).
Si el valor de inicioSel es superior al número de caracteres del objeto, todos los caracteres entre inicioSel y el final del texto se modifican. Si el valor de inicioSel es mayor que el de finSel (excepto cuando finSel vale 0, ver arriba), el comando no hace nada y la variable OK toma el valor 0.
Los valores de inicioSel y finSel no tienen en cuenta las etiquetas de estilo presentes en el área. Son evaluados sobre la base de texto sin formato (texto donde las etiquetas de estilo han sido filtradas).

Pase en los parámetros nomAtrib y valorAtrib respectivamente el nombre y el valor del atributo a modificar. Puede pasar tantos pares de atributos/valores como quiera. Para definir el parámetro nomAtrib, utilice las constantes predefinidas del tema . El valor a pasar en el parámetro valorAtrib depende del parámetro nomAtrib:

Constante	Tipo	Valor	Comentario
Attribute background color	Entero largo	8	attValue=Valor hexadecimal o nombre del color HTML (Windows únicamente)
Attribute bold style	Entero largo	1	attValue=0: elimina el atributo negrita de la selección attValue=1: aplica el atributo negrita a la selección
Attribute font name	Entero largo	5	attValue=nombre de la familia de la fuente (cadena)
Attribute italic style	Entero largo	2	attValue=0: elimina el atributo itálica de la selección attValue=1: aplica el atributo itálica a la selección.
Attribute strikethrough style	Entero largo	3	attValue=0: elimina el atributo tachado de la selección attValue=1: aplica el atributo tachado a la selección
Attribute text color	Entero largo	7	attValue=valores hexadecimales o nombre de color HML
Attribute text size	Entero largo	6	attValue=número de puntos(número)
Attribute underline style	Entero largo	4	attValue=0: elimina el atributo subrayado de la selección attValue=1: aplica el atributo subrayado a la selección

Colores
Si pasa las constantes Attribute text color o Attribute background en nomAtrib, debe pasar en valorAtrib una cadena que contenga un nombre de color HTML o un valor de color hexadecimal:

Nombre de color HTML	Valor hexadecimal
Aqua	#00FFFF
Black	#000000
Blue	#0000FF
Fushia	#FF00FF
Gray	#808080
Green	#008000
Lime	#00FF00
Maroon	#800000
Navy	#000080
Olive	#808000
Purple	#800080
Red	#FF0000
Silver	#C0C0C0
Teal	#008080
White	#FFFFFF
Yellow	#FFFF00

Ejemplo

En este ejemplo, modificamos el tamaño y el color de texto como también los atributos negrita y subrayado de los caracteres 2 a 4 del campo:

 OBJECT SET STYLED TEXT ATTRIBUTES([MyTable]MyField;2;5;Attribute font name;"Arial";Attribute text size;10;Attribute underline style;1;Attribute bold style;1;Attribute text color;"Blue")

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.