4D v12.4OBJECT SET STYLED TEXT ATTRIBUTES |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v12.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 | |||||
El comando OBJECT SET STYLED TEXT ATTRIBUTES permite modificar uno o más atributos de estilo en el o 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 (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.
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 del 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).
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, 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 |
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 |
En este ejemplo, modificamos el tamaño y el color del texto como también los atributos negrita y subrayado de los caracteres 2 a 4 del campo:
OBJECT SET STYLED TEXT ATTRIBUTES([MiTabla]MiCampo;2;5;Attribute font name;"Arial";Attribute text size;10;Attribute underline style;1;Attribute bold style;1;Attribute text color;"Blue")
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.
Producto: 4D
Tema: Propiedades de los objetos
Número
1093
Creado por: 4D v12
Modificado: 4D v12.1
FONT LIST
OBJECT GET STYLED TEXT ATTRIBUTES