4D Doc Center : OBJECT GET STYLED TEXT ATTRIBUTES

4D v13.4

OBJECT GET STYLED TEXT ATTRIBUTES


OBJECT GET 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 o un campo
objeto	Objeto de formulario	Nombre del objeto (se se especifica ) o Variable o campo (si se omite )
inicioSel	Entero largo	Inicio de la selección de texto
finSel	Entero largo	Fin de la selección de texto
nomAtrib	Entero largo	Atributo a leer
valorAtrib	Variable	Valor actual del atributo

Descripción

El comando OBJECT GET STYLED TEXT ATTRIBUTES se utiliza para recuperar el valor actual de un atributo de estilo en una selección de texto del objeto de formulario designado por objeto.

Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (cadena). Durante la ejecución, si el objeto tiene el foco, el comando devuelve información sobre el objeto que está siendo editado, sin embargo, cuando el objeto no tiene el foco, el comando devuelve información sobre la fuente de datos (campo o variable) del objeto.
Si omite el parámetro *, indica que el parámetro objeto es un campo o una variable. En este caso, pase una referencia campo o variable en lugar de una cadena y durante la ejecución, el comando devuelve información sobre este campo o variable.

Los parámetros inicioSel y finSel se utilizan para designar la selección de texto del cual leer el atributo de estilo. Pase la posición del primer carácter de la selección en inicioSel y la posición más uno del último carácter de la selección en finSel. 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 los valores de inicioSel y finSel son iguales o si inicioSel es mayor que finSel, se devuelve un error (excepto si finSel vale 0).
Los valores inicioSel y finSel no tienen en cuenta ningún tipo de etiquetas de estilo ya presentes en el área. Se evalúan sobre la base de texto sin formato (texto del cual se han filtrado las etiquetas de estilo).

Pase el nombre del atributo a obtener en el parámetro nomAtrib y pase una variable que debe recuperar el valor actual del atributo en el parámetro valorAtrib. Para definir el parámetro nomAtrib, debe utilizar una de las constantes del tema Atributos de texto multiestilo.

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

Puede pasar tantos pares de atributos/valores como quiera.

Si el valor del atributo nomAtrib es el mismo para todos los de la selección, se devuelve en valorAtrib. Si este valor es diferente o si objeto no contiene etiquetas SPAN, se devuelven los siguientes valores:

nomAtrib	valorAtrib si atributo heterogéneo en la selección o no etiquetas SPAN
Attribute background color	FFFFFFFF
Attribute bold style	2
Attribute font name	"" (empty string)
Attribute italic style	2
Attribute strikethrough style	2
Attribute text color	FFFFFFFF
Attribute text size	-1
Attribute underline style	2

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.