TextField.setTextFormat()

Disponibilidad

Flash Player 6.

Sintaxis

my_txt.setTextFormat (textFormat)
my_txt.setTextFormat (index, textFormat)
my_txt.setTextFormat (beginIndex, endIndex, textFormat)

Parámetros

textFormat Objeto TextFormat que contiene información sobre el formato de los caracteres y los párrafos.

index Número entero que especifica un carácter dentro de my_txt.

beginIndex Un número entero.

endIndex Número entero que especifica el primer carácter después del espacio de texto deseado.

Valor devuelto

Ninguno.

Descripción

Método; establece un objeto TextFormat para una parte especificada del texto de un campo de texto. Puede asignar un formato de texto a cada carácter de un campo de texto. El formato de texto del primer carácter de un párrafo se examina para asignar formato de párrafo a todo el párrafo. El método setTextFormat() cambia el formato de texto aplicado a caracteres individuales, a grupos de caracteres o a todo el cuerpo del texto de un campo de texto.

El formato de texto se establece en un nuevo objeto TextFormat. Contiene información de formato de carácter y de párrafo. La información de formato de carácter describe el aspecto de cada carácter; por ejemplo, el nombre de fuente, el tamaño en puntos, el color y la URL asociada. La información de formato de párrafo describe el aspecto de un párrafo, como por ejemplo, el margen izquierdo, el margen derecho, la sangría de la primera línea y la alineación a la izquierda, a la derecha o centrada.

Sintaxis 1: aplica las propiedades del parámetro textFormat a todo el texto del campo de texto.

Sintaxis 2: aplica las propiedades del parámetro textFormat al carácter de la posición index.

Sintaxis 3: aplica las propiedades del parámetro textFormat al espacio de texto desde el parámetro beginIndex hasta el parámetro endIndex.

Debe tener en cuenta que el texto insertado manualmente por el usuario o sustituido mediante TextField.replaceSel(), no adquiere el formato especificado en una llamada a setTextFormat(). Para establecer el formato predeterminado de un objeto TextField, utilice TextField.setNewTextFormat().

Ejemplo

Este ejemplo crea un nuevo objeto TextFormat llamado myTextFormat y establece su propiedad bold en true. A continuación llama a setTextFormat() y aplica el nuevo formato de texto al campo de texto my_txt.

myTextFormat = new TextFormat();
myTextFormat.bold = true;
my_txt.setTextFormat(myTextFormat);

Véase también

TextField.setNewTextFormat(), Clase TextFormat