| Paquete | flash.text.engine |
| Clase | public final class FontDescription |
| Herencia | FontDescription  Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Se aplica un objeto FontDescription a ElementFormat. A su vez, éste se aplica a un elemento ContentElement en un bloque TextBlock. Una vez aplicado el objeto FontDescription al elemento ElementFormat, su propiedad locked se establece como true. Las propiedades de un objeto FontDescription bloqueado no se pueden modificar. En su lugar, utilice el método clone() para crear una copia sin clonar del objeto. Luego podrá modificarla y asignarla a ElementFormat.
Nota: el FTE (Motor de texto de Flash) no admite fuentes de Tipo 1 o fuentes de mapa de bits, como las de Tipo 3, ATC, sfnt-wrapped CID o Naked CID.
Elementos de API relacionados
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
| cffHinting : String
Tipo de sugerencia CFF utilizada para este texto. | FontDescription | ||
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| fontLookup : String
Especifica cómo se debe buscar la fuente. | FontDescription | ||
| fontName : String
Nombre de la fuente que se va a utilizar o una lista de nombres de fuentes separados por comas. | FontDescription | ||
| fontPosture : String
Especifica la postura de fuente. | FontDescription | ||
| fontWeight : String
Especifica el grosor de fuente. | FontDescription | ||
| locked : Boolean
Indica si FontDescription está bloqueado o no. | FontDescription | ||
| renderingMode : String
Modo de representación utilizado para este texto. | FontDescription | ||
| Método | Definido por | ||
|---|---|---|---|
FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")
Crea un objeto FontDescription. | FontDescription | ||
Construye una copia clonada y sin bloquear de FontDescription. | FontDescription | ||
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
[estática]
Devuelve true si hay disponible una fuente de dispositivo utilizable con los valores fontName, fontWeight y fontPosture especificados. | FontDescription | ||
[estática]
Devuelve true si hay disponible una fuente incorporada con los valores fontName, fontWeight y fontPosture especificados donde Font.fontType es flash.text.FontType.EMBEDDED_CFF. | FontDescription | ||
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
cffHinting | propiedad |
cffHinting:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Tipo de sugerencia CFF utilizada para este texto. Utilice constantes CFFHinting para esta propiedad. Esta propiedad sólo se aplica si la propiedad RenderingMode del texto se define como RenderingMode.CFF.
El tipo de sugerencia CFF (Formato de fuente compacto) utilizada determina si el motor de ejecución de Flash hará que las líneas horizontales fuertes se ajusten cuadrícula de subpíxeles o no.
Se aplica sólo a fuentes incorporadas.
El valor predeterminado es CFFHinting.HORIZONTAL_STEM.
Para la propiedad CFFHinting puede utilizar los siguientes constantes de la clase CFFHinting:
| Valor de la cadena | Descripción |
|---|---|
CFFHinting.NONE | No especifica ninguna sugerencia CFF. Las líneas horizontales de los glifos no se ajustan a la cuadrícula de subpíxeles. Es una buena opción para animación o tamaños de fuente grandes. |
CFFHinting.HORIZONTAL_STEM | Especifica una sugerencia CFF. Las líneas horizontales fuerets se ajustan a la cuadrícula de subpíxeles en una pantalla. Para utilizar esta configuración, la propiedad RenderingMode se debe establecer en RenderingMode.CFF. |
Implementación
public function get cffHinting():String public function set cffHinting(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de CFFHinting.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto FontDescription (locked es true).
|
Elementos de API relacionados
fontLookup | propiedad |
fontLookup:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Especifica cómo se debe buscar la fuente.
El valor predeterminado es FontLookup.DEVICE.
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
| Valor de la cadena | Descripción |
|---|---|
FontLookup.DEVICE | El motor de ejecución busca una fuente de dispositivo con el nombre especificado en el sistema local para poder representar el texto. |
FontLookup.EMBEDDED_CFF | El motor de ejecución busca una fuente CFF incorporada con el nombre especificado para poder representar el texto. Sólo se consideran fuentes del tipo flash.text.Font.fontType.EMBEDDED_CFF. Si la fuente CFF especificada no está incorporada en la aplicación, el motor de ejecución intenta utilizar una fuente de sustitución de dispositivo para cada glifo. Este método resulta menos eficaz que seleccionar una fuente de dispositivo desde el principio. |
Implementación
public function get fontLookup():String public function set fontLookup(value:String):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto FontDescription (locked es true).
|
Elementos de API relacionados
fontName | propiedad |
fontName:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Nombre de la fuente que se va a utilizar o una lista de nombres de fuentes separados por comas. El motor de ejecución representa el elemento con la primera fuente disponible de la lista. Por ejemplo, "Arial, Helvetica, _sans" hace que el reproductor busque Arial y, luego, Helvetica si no encuentra ninguna fuente Arial: seguidamente, busca _sans si tampoco encuentra nada.
Los motores de ejecución de Flash admiten tres fuentes de dispositivo genéricas: _sans (para fuentes sans serif), _serif (para fuentes serif) y _typewriter (para fuentes mono-space). Éstas se asignan a fuentes de dispositivo concretas en función de la plataforma utilizada.
El valor predeterminado es "_serif".
El motor de ejecución de Flash proporciona fuentes de sustitución para los glifos que no se encuentren en la fuente seleccionada. Ya se trate de una fuente incorporada o de una fuente de dispositivo, si el glifo no se encuentra en la fuente, el motor de ejecución intenta representarlo con otra fuente de dispositivo distinta que pueda contener el glifo.
Implementación
public function get fontName():String public function set fontName(value:String):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto FontDescription (locked es true).
|
Elementos de API relacionados
fontPosture | propiedad |
fontPosture:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Especifica la postura de fuente.
El valor predeterminado es FontPosture.NORMAL.
Para definir los valores de esta propiedad, utilice las siguientes constantes de la clase FontPosture:
| Valor | Descripción |
|---|---|
FontPosture.NORMAL | Postura de fuente normal. |
FontPosture.ITALIC | Postura de fuente cursiva. |
Implementación
public function get fontPosture():String public function set fontPosture(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de FontPosture.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto FontDescription (locked es true).
|
Elementos de API relacionados
fontWeight | propiedad |
fontWeight:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Especifica el grosor de fuente.
El valor predeterminado es FontWeight.NORMAL.
Para definir los valores de esta propiedad, utilice las siguientes constantes de la clase FontWeight:
| Valor de la cadena | Descripción |
|---|---|
FontWeight.NORMAL | Grosor de fuente normal. |
FontWeight.BOLD | Grosor de fuente negrita. |
Implementación
public function get fontWeight():String public function set fontWeight(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de FontWeight.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto FontDescription (locked es true).
|
Elementos de API relacionados
locked | propiedad |
locked:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Indica si FontDescription está bloqueado o no. Si es true, no es posible modificar FontDescription. Llame al método FontDescription.clone() para obtener una copia sin bloquear del objeto FontDescription.
Implementación
public function get locked():Boolean public function set locked(value:Boolean):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto FontDescription (locked es true).
|
renderingMode | propiedad |
renderingMode:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Modo de representación utilizado para este texto. Utilice constantes RenderingMode para esta propiedad.
Se aplica sólo a fuentes incorporadas.
El valor predeterminado es RenderingMode.CFF.
Para definir los valores de esta propiedad, utilice las siguientes constantes de la clase RenderingMode:
| Valor de la cadena | Descripción |
|---|---|
RenderingMode.NORMAL | Se aplica la representación de texto habitual, que coincide con el tipo de representación utilizada por Flash Player 7 y versiones anteriores. |
RenderingMode.CFF | Aplica representación de CFF (Formato de fuente compacto) que aumenta la legibilidad del texto. (Esta función pasó a estar disponible en Flash Player 10.) La representación CFF proporciona una alta calidad de representación para las fuentes de tamaño pequeño. |
Implementación
public function get renderingMode():String public function set renderingMode(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de RenderingMode.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto FontDescription (locked es true).
|
Elementos de API relacionados
FontDescription | () | Información sobre |
public function FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Crea un objeto FontDescription.
ParámetrosfontName:String (default = "_serif") | |
fontWeight:String (default = "normal") | |
fontPosture:String (default = "normal") | |
fontLookup:String (default = "device") | |
renderingMode:String (default = "cff")RenderingMode para esta propiedad.
| |
cffHinting:String (default = "horizontalStem")CFFHinting para esta propiedad.
|
Emite
ArgumentError — La propiedad fontWeight especificada no es un miembro de FontWeight.
| |
ArgumentError — La propiedad fontPosture especificada no es un miembro de FontPosture.
| |
ArgumentError — La propiedad fontLookup especificada no es un miembro de FontLookup.
| |
ArgumentError — La propiedad renderingMode especificada no es un miembro de RenderingMode.
| |
ArgumentError — La propiedad cffHinting especificada no es un miembro de CFFHinting.
|
clone | () | método |
public function clone():FontDescription| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Construye una copia clonada y sin bloquear de FontDescription.
Valor devueltoFontDescription — Copia sin bloquear del objeto FontDescription.
|
Ejemplo ( Cómo utilizar este ejemplo )
Este ejemplo crea un objeto FontDescription, le asigna una fuente de dispositivo, establece diversas propiedades de fuente y asigna el nuevo objeto (bloqueándolo, por tanto) a un objeto ElementFormat. Se crea una nueva propiedad TextElement con ElementFormat y se utiliza TextElement como contenido de TextBlock. Se crea una línea de texto a partir de TextBlock.
Para modificar el objeto FontDescription, primero compruebe su propiedad locked. Si es true, utilice el método clone() para crear una copia sin bloquear de FontDescription, modifique sus propiedades y asígnelo a un nuevo objeto ElementFormat. Seguidamente, vuelva a enlazar el nuevo objeto ElementFormat al bloque TextBlock. Cuando las líneas se vuelvan a dividir, las nuevas líneas tendrán la nueva configuración de fuente.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class FontDescription_cloneExample extends Sprite {
private var fd:FontDescription;
private var fd2:FontDescription;
public function FontDescription_cloneExample():void {
fd = new FontDescription();
fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
fd.fontName = "Palatino";
fd.fontWeight = flash.text.engine.FontWeight.BOLD;
fd.fontPosture = flash.text.engine.FontPosture.ITALIC;
var ef1:ElementFormat = new ElementFormat(fd);
var str:String = "This is flash text 0123456789";
var tb:TextBlock = new TextBlock();
var te1:TextElement = new TextElement(str, ef1);
tb.content = te1;
var line1:TextLine = tb.createTextLine(null, 600);
addChild(line1);
fd2 = (fd.locked) ? fd.clone() : fd;
fd2.fontWeight = flash.text.engine.FontWeight.NORMAL;
var ef2:ElementFormat = new ElementFormat(fd2);
tb.content.elementFormat=ef2;
var line2:TextLine = tb.createTextLine(null, 600);
addChild(line2);
}
}
}
isDeviceFontCompatible | () | método |
public static function isDeviceFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Devuelve true si hay disponible una fuente de dispositivo utilizable con los valores fontName, fontWeight y fontPosture especificados.
Las clases de flash.text.engine sólo puede utilizar fuentes de dispositivo TrueType y OpenType. Si se utiliza una fuente basada en una tecnología anterior de fuentes, el motor de ejecución restaura las fuentes de dispositivo adecuadas conocidas glifo a glifo para representar el texto
Parámetros
fontName:String — Nombre de la fuente de dispositivo que se va a comprobar.
| |
fontWeight:String — Especifica el grosor de fuente. Utilice FontWeight.
| |
fontPosture:String — Especifica la postura de fuente. Utilice FontPosture.
|
Boolean — true si hay una fuente de dispositivo compatible. En caso contrario, false.
|
Emite
ArgumentError — La propiedad fontWeight especificada no es un miembro de FontWeight.
| |
ArgumentError — La propiedad fontPosture especificada no es un miembro de FontPosture.
|
Elementos de API relacionados
isFontCompatible | () | método |
public static function isFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Devuelve true si hay disponible una fuente incorporada con los valores fontName, fontWeight y fontPosture especificados donde Font.fontType es flash.text.FontType.EMBEDDED_CFF. A partir de Flash Player 10, pueden aparecer dos tipos de fuentes incorporadas en el contenido de la aplicación. Sólo se utilizan fuentes normales incorporadas por TextField. Sólo se utilizan fuentes incorporadas CFF por las clases flash.text.engine. Los dos tipos se distinguen por la propiedad fontType de la clase Font, que se devuelve por la función enumerateFonts().
Las clases flash.text.engine no pueden utilizar una fuente de tipo EMBEDDED. Si fontLookup se establece en FontLookup.EMBEDDED_CFF y la única fuente disponible en tiempo de ejecución con el nombre, peso y posición especificados es del tipo EMBEDDED, el motor de ejecución restaura las fuentes del dispositivo glifo a glifo para representar el texto como si no hubiera fuentes incorporadas disponibles con el estilo y el nombre especificado.
Si las fuentes EMBEDDED y EMBEDDED_CFF están disponibles con el mismo nombre, peso y posición, se selecciona la fuente EMBEDDED_CFF y el texto se representa con la fuente EMBEDDED_CFF.
Parámetros
fontName:String — Nombre de la fuente incorporada que se va a comprobar.
| |
fontWeight:String — Especifica el grosor de fuente. Utilice FontWeight.
| |
fontPosture:String — Especifica la postura de fuente. Utilice FontPosture.
|
Boolean — true si hay una fuente incorporada compatible. De lo contrario, se denomina false.
|
Emite
ArgumentError — La propiedad fontWeight especificada no es un miembro de FontWeight.
| |
ArgumentError — La propiedad fontPosture especificada no es un miembro de FontPosture.
|
Elementos de API relacionados
Este ejemplo crea un objeto FontDescription, le asigna una fuente de dispositivo, establece diversas propiedades de fuente y asigna el nuevo objeto a un objeto ElementFormat. El formato de fuente adicional se lleva a cabo con ElementFormat. Se crea una nueva propiedad TextElement con ElementFormat y se utiliza TextElement como contenido de TextBlock. Se crea una línea de texto a partir de TextBlock.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class FontDescriptionExample extends Sprite {
public function FontDescriptionExample():void {
var fd:FontDescription = new FontDescription();
fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
fd.fontName = "Palatino";
fd.fontWeight = flash.text.engine.FontWeight.BOLD;
fd.fontPosture = flash.text.engine.FontPosture.ITALIC;
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize = 30;
ef1.color = 0xFF0000;
var str:String = "This is flash text 0123456789";
var tb:TextBlock = new TextBlock();
var te1:TextElement = new TextElement(str, ef1);
tb.content = te1;
var line1:TextLine = tb.createTextLine(null, 600);
addChild(line1);
}
}
}
Tue Jun 12 2018, 02:12 PM Z