| Paquete | flash.text.engine |
| Clase | public final class ElementFormat |
| Herencia | ElementFormat  Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Un objeto ElementFormat aplicado a un elemento ContentElement en un bloque TextBlock no invalida el bloque TextBlock. Una vez aplicado el objeto ElementFormat al elemento ContentElement, su propiedad locked se establece como true. Las propiedades de un objeto ElementFormat bloqueado no se pueden modificar. En su lugar, utilice el método clone() para crear una copia del objeto sin bloquear, que puede modificarse y asignarse al elemento ContentElement.
Elementos de API relacionados
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
| alignmentBaseline : String
Especifica el tipo de línea base en el elemento contenedor con el que se alinean las líneas de base dominantes de los elementos con este formato. | ElementFormat | ||
| alpha : Number
Especifica la transparencia de los elementos de línea afectados por este objeto. | ElementFormat | ||
| baselineShift : Number
Indica el cambio de línea base del elemento, en píxeles. | ElementFormat | ||
| breakOpportunity : String
Oportunidad de salto de línea aplicada al texto. | ElementFormat | ||
| color : uint
Indica el color del texto. | ElementFormat | ||
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| digitCase : String
Caja de dígitos para este texto. | ElementFormat | ||
| digitWidth : String
Anchura de dígitos para este texto. | ElementFormat | ||
| dominantBaseline : String
Especifica el tipo de línea de base que se utiliza como línea de base dominante. | ElementFormat | ||
| fontDescription : FontDescription
Un objeto cuyas propiedades describen una fuente. | ElementFormat | ||
| fontSize : Number
El tamaño del texto, en píxeles. | ElementFormat | ||
| kerning : String
El ajuste entre caracteres ajusta los píxeles entre determinados pares de caracteres para que puedan leerse mejor. | ElementFormat | ||
| ligatureLevel : String
Nivel de ligadura utilizado en este texto. | ElementFormat | ||
| locale : String
Configuración regional del texto. | ElementFormat | ||
| locked : Boolean
Indica si ElementFormat está bloqueado. | ElementFormat | ||
| textRotation : String
Establece la rotación aplicada a glifos individuales. | ElementFormat | ||
| trackingLeft : Number
El espaciado o el ajuste entre caracteres manual que se aplica a la derecha de cada glifo en píxeles. | ElementFormat | ||
| trackingRight : Number
El espaciado o el ajuste entre caracteres manual que se aplica a la derecha de cada glifo en píxeles. | ElementFormat | ||
| typographicCase : String
Caja tipográfica para este texto. | ElementFormat | ||
| Método | Definido por | ||
|---|---|---|---|
ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")
Crea un objeto ElementFormat. | ElementFormat | ||
Construye una copia clonada y sin bloquear de ElementFormat. | ElementFormat | ||
Devuelve un objeto FontMetrics con propiedades que describen la caja emBox, la posición y el grosor del tachado, y la posición y el grosor del subrayado para la fuente especificada por fontDescription y fontSize.
| ElementFormat | ||
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
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 | |
alignmentBaseline | propiedad |
alignmentBaseline: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 tipo de línea base en el elemento contenedor con el que se alinean las líneas de base dominantes de los elementos con este formato. Utilice constantes TextBaseline para esta propiedad.
El elemento vertical de mayor tamaño de la línea determina la alineación de las líneas base a menos que TextBlock.baselineFontDescription y TextBlock.baselineFontSize se establezcan para suplantar esa lógica.
El valor predeterminado es TextBaseline.USE_DOMINANT_BASELINE.
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
| Valor de la cadena | Descripción |
|---|---|
TextBaseline.ROMAN | La propiedad dominantBaseline alinea la anchura con la línea base Roman de la línea. |
TextBaseline.ASCENT | La propiedad dominantBaseline alinea la anchura con la línea base ascendente de la línea. |
TextBaseline.DESCENT | La propiedad dominantBaseline alinea la anchura con la línea base descendente de la línea. |
TextBaseline.IDEOGRAPHIC_TOP | La propiedad dominantBaseline alinea la anchura con la línea base superior ideográfica de la línea. |
TextBaseline.IDEOGRAPHIC_CENTER | La propiedad dominantBaseline alinea la anchura con la línea base ideográfica central de la línea. |
TextBaseline.IDEOGRAPHIC_BOTTOM | La propiedad dominantBaseline alinea la anchura con la línea base ideográfica inferior de la línea. |
TextBaseline.USE_DOMINANT_BASELINE | La propiedad dominantBaseline alinea la anchura con la misma línea base de la línea. |
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Establece la línea base de alineación de la línea alineada por la propiedad dominantBaseline del elemento gráfico. |
GroupElement | Ningún efecto. |
TextElement | Establece la línea base de alineación de la línea alineada por la propiedad dominantBaseline del elemento de texto. |
Implementación
public function get alignmentBaseline():String public function set alignmentBaseline(value:String):voidEmite
ArgumentError — Si se establece en cualquier valor que no sea miembro de TextBaseline.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
Elementos de API relacionados
alpha | propiedad |
alpha:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Especifica la transparencia de los elementos de línea afectados por este objeto. Los valores válidos oscilan entre 0 (totalmente transparente) y 1 (totalmente opaco). Los objetos de visualización que tienen alpha configurado con el valor 0 están activos, aunque no sean visibles.
El valor predeterminado es 1.
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Aplica el valor alfa especificado al elemento gráfico. Se combina multiplicativamente con cualquier conjunto de valores alfa del propio objeto DisplayObject o del objeto TextLine. |
GroupElement | Ningún efecto. |
TextElement | Aplica el valor alfa especificado al elemento de texto. Se combina multiplicativamente con cualquier conjunto de valores alfa del objeto TextLine. |
Implementación
public function get alpha():Number public function set alpha(value:Number):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
Elementos de API relacionados
baselineShift | propiedad |
baselineShift:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Indica el cambio de línea base del elemento, en píxeles.
El elemento se aleja de dominantBaseline según la cantidad especificada. El desplazamiento se añade a la posición y de los miembros del elemento de forma que, en texto no girado, un cambio de línea base positivo mueve el elemento hacia abajo y un cambio de línea base negativo mueve el elemento hacia arriba.
El valor predeterminado es 0.0, lo que indica que no hay ningún cambio.
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Cambia la posición del gráfico con respecto a la línea base. |
GroupElement | Ningún efecto. |
TextElement | Cambia la posición del texto con respecto a la línea base. |
Implementación
public function get baselineShift():Number public function set baselineShift(value:Number):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
breakOpportunity | propiedad |
breakOpportunity:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Oportunidad de salto de línea aplicada al texto. Esta propiedad determina los caracteres que se pueden utilizar para establecer saltos cuando el texto de ajuste se divide en varias líneas. Utilice constantes BreakOpportunity para esta propiedad.
El valor predeterminado es BreakOpportunity.AUTO.
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
| Valor de la cadena | Descripción |
|---|---|
BreakOpportunity.AUTO | Las oportunidades de salto de línea se basan en propiedades estándar de caracteres Unicode, como la división entre palabras y los guiones. |
BreakOpportunity.ANY | Trata cualquier carácter del objeto ContentElement como una oportunidad de salto de línea. Este valor se suele utilizar con texto Roman incorporado en texto asiático, y se recomienda que los saltos se produzcan en la mitad de las palabras. |
BreakOpportunity.NONE | Ningún carácter del rango se trata como oportunidad de salto de línea. |
BreakOpportunity.ALL | Todos los caracteres del rango se tratarán como oportunidades de salto de línea, lo que significa que tendrá lugar un salto de línea después de cada carácter. Resulta útil para crear efectos como texto en un trazado. |
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Ningún efecto. |
GroupElement | Determina la oportunidad de salto de línea entre elementos de texto adyacentes en el grupo. Si la propiedad elementFormat del grupo es null, se utiliza el formato del primero de los elementos adyacentes. |
TextElement | Determina la oportunidad de salto de línea entre los caracteres del elemento de texto. |
Implementación
public function get breakOpportunity():String public function set breakOpportunity(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de BreakOpportunity.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
Elementos de API relacionados
color | propiedad |
color:uint| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Indica el color del texto. Entero que contiene tres componentes RGB de 8 bits; por ejemplo, 0xff0000 es rojo y 0x00FF00, verde.
El valor predeterminado es 0x000000 (negro).
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Ningún efecto. |
GroupElement | Ningún efecto. |
TextElement | Establece el color del texto. |
Implementación
public function get color():uint public function set color(value:uint):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
digitCase | propiedad |
digitCase:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Caja de dígitos para este texto. La caja de dígitos afecta al estilo y a la colocación de grupos de caracteres numéricos. Utilice constantes DigitCase para esta propiedad.
El valor predeterminado es DigitCase.DEFAULT.
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
| Valor de la cadena | Descripción |
|---|---|
DigitCase.DEFAULT | Aplica la caja de dígitos predeterminada al texto. |
DigitCase.LINING | Aplica la caja de dígitos de alineación al texto. |
DigitCase.OLD_STYLE | Aplica la caja de dígitos de estilo antiguo al texto. |
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Ningún efecto. |
GroupElement | Ningún efecto. |
TextElement | Determina la caja de dígitos empleada para el texto en el elemento. |
Implementación
public function get digitCase():String public function set digitCase(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de DigitCase.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
Elementos de API relacionados
digitWidth | propiedad |
digitWidth:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Anchura de dígitos para este texto. Utilice constantes DigitWidth para esta propiedad.
El valor predeterminado es DigitWidth.DEFAULT.
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
| Valor de la cadena | Descripción |
|---|---|
DigitWidth.DEFAULT | Aplica la anchura de dígitos predeterminada al texto. |
DigitWidth.PROPORTIONAL | Aplica la anchura de dígitos proporcional al texto. |
DigitWidth.TABULAR | Aplica la anchura de dígitos tabular al texto. |
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Ningún efecto. |
GroupElement | Ningún efecto. |
TextElement | Determina la anchura de dígitos empleada para el texto en el elemento. |
Implementación
public function get digitWidth():String public function set digitWidth(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de DigitWidth.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
Elementos de API relacionados
dominantBaseline | propiedad |
dominantBaseline: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 tipo de línea de base que se utiliza como línea de base dominante. La línea de base dominante se alinea con la línea de base de alineación para determinar la posición vertical del elemento en la línea. Utilice constantes TextBaseline para esta propiedad.
El contenido del elemento determina las líneas base. En el caso de una propiedad TextElement, el tamaño de fuente y de punto determina las líneas base. En el caso de una propiedad GraphicElement, la altura del elemento determina las líneas base.
El valor predeterminado es TextBaseline.ROMAN.
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
| Valor de la cadena | Descripción |
|---|---|
TextBaseline.ROMAN | La línea base Roman del elemento se alinea con alignmentBaseline. |
TextBaseline.ASCENT | La línea base ascendente del elemento se alinea con alignmentBaseline. |
TextBaseline.DESCENT | La línea base descendente del elemento se alinea con alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_TOP | La línea base superior ideográfica del elemento se alinea con alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_CENTER | La línea base ideográfica central del elemento se alinea con alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_BOTTOM | La línea base ideográfica inferior del elemento se alinea con alignmentBaseline. |
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Determina qué líneas base del elemento gráfico se alinean con alignmentBaseline. |
GroupElement | Ningún efecto. |
TextElement | Determina qué líneas base del elemento de texto se alinean con alignmentBaseline. |
Implementación
public function get dominantBaseline():String public function set dominantBaseline(value:String):voidEmite
ArgumentError — Si se establece en cualquier valor que no sea miembro de TextBaseline.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
Elementos de API relacionados
fontDescription | propiedad |
fontDescription:FontDescription| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Un objeto cuyas propiedades describen una fuente.
El valor predeterminado es un objeto FontDescription construido predeterminado.
Cuando se establece la propiedad fontDescription, el objeto FontDescription suministrado se bloquea: su propiedad locked se establece como true. Un elemento FontDescription bloqueado no es modificable.
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Ningún efecto. |
GroupElement | Ningún efecto. |
TextElement | Determina la fuente empleada para el texto en el elemento. |
Implementación
public function get fontDescription():FontDescription public function set fontDescription(value:FontDescription):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
Elementos de API relacionados
fontSize | propiedad |
fontSize:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
El tamaño del texto, en píxeles.
El valor predeterminado es 12.0.
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Ningún efecto. |
GroupElement | Ningún efecto. |
TextElement | Determina el tamaño en píxeles del texto en el elemento. |
Implementación
public function get fontSize():Number public function set fontSize(value:Number):voidEmite
ArgumentError — Si se establece en un valor menor que cero.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
kerning | propiedad |
kerning:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
El ajuste entre caracteres ajusta los píxeles entre determinados pares de caracteres para que puedan leerse mejor. Todas las fuentes con tablas de ajuste entre caracteres admiten ajuste entre caracteres.
El valor predeterminado es Kerning.ON.
Para definir los valores de esta propiedad, utilice las siguientes constantes de la clase Kerning:
| Valor de la cadena | Descripción |
|---|---|
Kerning.ON | El ajuste entre caracteres está activado. |
Kerning.OFF | El ajuste entre caracteres está desactivado. |
Kerning.AUTO | El ajuste entre caracteres está activado excepto si no es apropiado en tipografía asiática. Se aplica ajuste entre caracteres entre dos caracteres si no son Kanji, Hiragana o Katakana. |
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Ningún efecto. |
GroupElement | Determina si se aplica ajuste entre caracteres entre elementos de texto adyacentes del grupo. Si la propiedad elementFormat del grupo es null, se utiliza el formato del primero de los elementos adyacentes. |
TextElement | Determina si se aplica ajuste entre caracteres entre los caracteres del elemento de texto. |
Implementación
public function get kerning():String public function set kerning(value:String):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
Elementos de API relacionados
ligatureLevel | propiedad |
ligatureLevel:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Nivel de ligadura utilizado en este texto. Se produce una ligadura cuando se unen dos o más formatos de carta en un único glifo. Las ligaduras normalmente sustituyen a los caracteres consecutivos que comparten componentes comunes, como parejas de letras 'fi', 'fl' o 'ae'. Se utilizan con conjuntos de caracteres latinos y no latinos. Utilice constantes LigatureLevel para esta propiedad.
El valor predeterminado es LigatureLevel.COMMON.
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
| Valor de la cadena | Descripción |
|---|---|
LigatureLevel.NONE | No se crea ninguna ligadura. |
LigatureLevel.MINIMUM | Se crean ligaturas mínimas. |
LigatureLevel.COMMON | Se crean ligaduras comunes. |
LigatureLevel.UNCOMMON | Se crean ligaduras no comunes |
LigatureLevel.EXOTIC | Se crean ligaduras exóticas. |
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Ningún efecto. |
GroupElement | Determina el nivel de ligadura entre elementos de texto adyacentes en el grupo. Si la propiedad elementFormat del grupo es null, se utiliza el formato del primero de los elementos adyacentes. |
TextElement | Determina el nivel de ligadura entre los caracteres del elemento de texto. |
Implementación
public function get ligatureLevel():String public function set ligatureLevel(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de LigatureLevel.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
Elementos de API relacionados
locale | propiedad |
locale:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Configuración regional del texto. Controla las transformaciones de la caja y su forma. Se utilizan identificadores estándar de configuración regional. Por ejemplo"en", "en_US" y "en-US" se refieren a inglés y "ja" a japonés. Consulte la lista de códigos iso639-2 para obtener una lista de códigos de configuración regional.
El valor predeterminado es "en".
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Ningún efecto. |
GroupElement | Ningún efecto. |
TextElement | Determina las transformaciones y la forma del texto en el elemento. |
Implementación
public function get locale():String public function set locale(value:String):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
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 ElementFormat está bloqueado. Si es true, ElementFormat no es modificable. Llame al método ElementFormat.clone() para obtener una copia sin bloquear del objeto ElementFormat.
Implementación
public function get locked():Boolean public function set locked(value:Boolean):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
textRotation | propiedad |
textRotation:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Establece la rotación aplicada a glifos individuales. Utilice las constantes definidas en la clase TextRotation para esta propiedad.
El valor predeterminado es TextRotation.AUTO.
La rotación final de cualquier glifo es la suma de ElementFormat.textRotation, ContentElement.textRotation y TextBlock.lineRotation.
Se suele utilizar esta propiedad para texto asiático en el que se deben girar los caracteres para mostrarlos adecuadamente en posición vertical. Utilice TextRotation.AUTO en combinación con TextBlock.lineRotation = TextRotation.ROTATE_90 para lograr esto.
Si se establece esta propiedad en fuentes que no contengan información de disposición vertical, puede arrojar resultados no deseados. Las fuentes que contienen una tabla vmtx o VORG, como la fuente japonesa "MS Mincho", funcionan correctamente porque dichas tablas suministran los datos que necesita el motor de visualización para mostrar un diseño correcto. Las fuentes como Verdana, que no contienen la información necesaria, no pueden realizar esta función.
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
| Valor de la cadena | Descripción |
|---|---|
TextRotation.ROTATE_0 | Los glifos no se giran. |
TextRotation.ROTATE_90 | Los glifos se giran 90 grados en sentido horario. |
TextRotation.ROTATE_180 | Los glifos se giran 180 grados. |
TextRotation.ROTATE_270 | Los glifos se giran 270 grados en sentido horario. |
TextRotation.AUTO | Especifica una rotación en sentido de las agujas del reloj de 90º sólo para los glifos anchos o de máxima anchura, según se haya especificado en las propiedades Unicode del glifo. Este valor se utiliza normalmente con texto asiático para girar sólo glifos que requieren rotación. Esta rotación sólo se aplica en texto vertical para devolver caracteres anchos o de máxima anchura a una orientación vertical sin que se vean afectados otros caracteres. |
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Ningún efecto. |
GroupElement | Ningún efecto. |
TextElement | Determina la rotación de los glifos en el elemento de texto. |
Implementación
public function get textRotation():String public function set textRotation(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de TextRotation.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
Elementos de API relacionados
trackingLeft | propiedad |
trackingLeft:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5., Flash Lite 4 |
El espaciado o el ajuste entre caracteres manual que se aplica a la derecha de cada glifo en píxeles. Si Ajuste entre caracteres está activado, el valor de trackingLeft se añade a los valores de la tabla de ajuste entre caracteres de la fuente. Si Ajuste entre caracteres está desactivado, el valor trackingLeft se utiliza como valor manual de ajuste entre caracteres. Admite tanto valores positivos como negativos.
Normalmente, el valor de espaciado deseado se divide entre trackingRight y trackingLeft. De lo contrario, en texto de direccionalidad combinado, se hace dos veces el espaciado en un límite bidi y ninguno en el otro.
El valor predeterminado es 0.0.
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Determina el espaciado entre caracteres aplicado a la parte izquierda del gráfico. |
GroupElement | Ningún efecto. |
TextElement | Determina espaciado entre caracteres aplicado a la parte izquierda de los caracteres del elemento de texto. |
Ejemplo:
//positive tracking added to kerning
var ef1:ElementFormat = new ElementFormat();
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingLeft = 0.5;
//negative manual kerning
var ef2:ElementFormat = new ElementFormat();
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.trackingLeft = -1.0;
Implementación
public function get trackingLeft():Number public function set trackingLeft(value:Number):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
trackingRight | propiedad |
trackingRight:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5., Flash Lite 4 |
El espaciado o el ajuste entre caracteres manual que se aplica a la derecha de cada glifo en píxeles. Si Ajuste entre caracteres está activado, el valor trackingRight se añade a los valores de la tabla de ajuste entre caracteres de la fuente. Si Ajuste entre caracteres está desactivado, el valor trackingRight se utiliza como valor manual de ajuste entre caracteres. Admite tanto valores positivos como negativos.
Normalmente, el valor de espaciado deseado se divide entre trackingRight y trackingLeft. De lo contrario, en texto de direccionalidad combinado, se hace dos veces el espaciado en un límite bidi y ninguno en el otro.
El valor predeterminado es 0.0.
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Determina el espaciado entre caracteres aplicado a la parte derecha del gráfico. |
GroupElement | Ningún efecto. |
TextElement | Determina espaciado entre caracteres aplicado a la parte derecha de los caracteres del elemento de texto. |
Ejemplo:
//positive tracking added to kerning
var ef1:ElementFormat = new ElementFormat();
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingRight = 0.5;
//negative manual kerning
var ef2:ElementFormat = new ElementFormat();
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.trackingRight = -1.0;
Implementación
public function get trackingRight():Number public function set trackingRight(value:Number):voidEmite
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
typographicCase | propiedad |
typographicCase:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Caja tipográfica para este texto. Utilice las constantes definidas en la clase TypographicCase para esta propiedad.
El valor predeterminado es TypographicCase.DEFAULT.
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
| Valor de la cadena | Descripción |
|---|---|
TypographicCase.DEFAULT | Especifica que se utiliza la caja normal para todos los caracteres. |
TypographicCase.TITLE | Especifica que los caracteres en mayúscula utilizan glifos de título en su salida. |
TypographicCase.CAPS | Especifica que el espaciado se ajusta en los caracteres en mayúscula en su salida. |
TypographicCase.SMALL_CAPS | Especifica que los caracteres en mayúscula utilizan glifos en minúscula en su salida. |
TypographicCase.UPPERCASE | Especifica que todos los caracteres utilizan glifos en mayúscula en su salida. |
TypographicCase.LOWERCASE | Especifica que todos los caracteres utilizan glifos en minúscula en su salida. |
TypographicCase.CAPS_AND_SMALL_CAPS | Especifica que todos los caracteres en minúscula utilizan glifos en minúscula en su salida. |
| Subclase | Efecto al configurar la propiedad |
|---|---|
GraphicElement | Ningún efecto. |
GroupElement | Ningún efecto. |
TextElement | Determina la caja tipográfica empleada para el texto en el elemento. |
Implementación
public function get typographicCase():String public function set typographicCase(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de TypographicCase.
| |
IllegalOperationError — Si se establece una vez bloqueado el objeto ElementFormat (locked es true).
|
Elementos de API relacionados
ElementFormat | () | Información sobre |
public function ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")| 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 ElementFormat.
ParámetrosfontDescription:FontDescription (default = null)null. Si no se proporciona ninguna descripción de fuente, se construye una descripción predeterminada.
| |
fontSize:Number (default = 12.0) | |
color:uint (default = 0x000000) | |
alpha:Number (default = 1.0)alpha que se aplica a todos los átomos de la línea según el formato de elemento.
| |
textRotation:String (default = "auto") | |
dominantBaseline:String (default = "roman") | |
alignmentBaseline:String (default = "useDominantBaseline") | |
baselineShift:Number (default = 0.0) | |
kerning:String (default = "on") | |
trackingRight:Number (default = 0.0) | |
trackingLeft:Number (default = 0.0) | |
locale:String (default = "en") | |
breakOpportunity:String (default = "auto") | |
digitCase:String (default = "default") | |
digitWidth:String (default = "default") | |
ligatureLevel:String (default = "common") | |
typographicCase:String (default = "default") |
Emite
ArgumentError — La propiedad fontSize especificada es menor que 0.
| |
ArgumentError — La propiedad textRotation especificada no es un miembro de flash.text.engine.TextRotation.
| |
ArgumentError — La propiedad dominantBaseline especificada no es un miembro de TextBaseline.
| |
ArgumentError — La propiedad alignmentBaseline especificada no es un miembro de TextBaseline.
| |
ArgumentError — La propiedad kerning especificada no es un miembro de Kerning.
| |
ArgumentError — La propiedad breakOpportunity especificada no es un miembro de breakOpportunity.
| |
ArgumentError — La propiedad digitCase especificada no es un miembro de DigitCase.
| |
ArgumentError — La propiedad digitWidth especificada no es un miembro de DigitWidth.
| |
ArgumentError — La propiedad ligatureLevel especificada no es un miembro de LigatureLevel.
| |
ArgumentError — La propiedad typographicCase especificada no es un miembro de TypographicCase.
|
clone | () | método |
public function clone():ElementFormat| 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 ElementFormat.
Valor devueltoElementFormat — Una copia sin bloquear del objeto ElementFormat.
|
Ejemplo ( Cómo utilizar este ejemplo )
Este ejemplo crea un objeto ElementFormat y establece el valor de FontSize. Se crea un nuevo objeto TextElement con ElementFormat (y, por tanto, se bloquea). TextElement se utiliza como contenido de un bloque TextBlock. Se crea una línea de texto a partir de TextBlock.
Para modificar el objeto ElementFormat, primero compruebe su propiedad locked. Si es true, utilice el método clone() para crear una copia sin bloquear de ElementFormat, modifique sus propiedades y, después, vuelva a enlazar el nuevo objeto ElementFormat con el 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 ElementFormat_cloneExample extends Sprite {
private var ef1:ElementFormat;
private var ef2:ElementFormat;
public function ElementFormat_cloneExample():void {
var fd:FontDescription = new FontDescription();
fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
fd.fontName = "Palatino";
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize=20;
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);
ef2 = (ef1.locked) ? ef1.clone() : ef1;
ef2.fontSize = 32;
tb.content.elementFormat=ef2;
var line2:TextLine = tb.createTextLine(null, 600);
addChild(line2);
}
}
}
getFontMetrics | () | método |
public function getFontMetrics():FontMetrics| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Devuelve un objeto FontMetrics con propiedades que describen la caja emBox, la posición y el grosor del tachado, y la posición y el grosor del subrayado para la fuente especificada por fontDescription y fontSize.
FontMetrics — Un objeto FontMetrics que describe las propiedades de la fuente especificada por fontDescription.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
ElementFormat con una valor de FontDescription asignado y utiliza el método getFontMetrics para visualizar la métrica de la fuente seleccionada a 24 puntos.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class FontMetricsExample extends Sprite {
public function FontMetricsExample():void {
var fd:FontDescription = new FontDescription();
fd.fontName = "Garamond";
fd.fontWeight = flash.text.engine.FontWeight.BOLD;
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize = 24;
var fm1:FontMetrics = ef1.getFontMetrics();
trace(fm1.emBox);
trace(fm1.strikethroughOffset);
trace(fm1.strikethroughThickness);
trace(fm1.subscriptScale);
trace(fm1.subscriptOffset);
trace(fm1.superscriptScale);
trace(fm1.superscriptOffset);
trace(fm1.underlineOffset);
trace(fm1.underlineThickness);
}
}
}
Este ejemplo crea dos objetos ElementFormat y establece algunas de sus propiedades. Seguidamente, asigna los nuevos formatos ElementFormat a un objeto TextElement que se ha asignado como contenido de un bloque TextBlock. Tenga en cuenta que cambiar el formato ElementFormat de un elemento TextElement no afecta a las líneas de texto creadas previamente por el bloque TextBlock principal.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class ElementFormatExample extends Sprite {
public function ElementFormatExample():void {
var fd:FontDescription = new FontDescription();
fd.fontName = "Garamond";
fd.fontWeight = flash.text.engine.FontWeight.BOLD;
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize = 30;
ef1.color = 0xFF0000;
ef1.alpha = 100;
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingRight = 2;
ef1.typographicCase = flash.text.engine.TypographicCase.UPPERCASE;
ef1.alignmentBaseline = flash.text.engine.TextBaseline.DESCENT;
ef1.ligatureLevel = flash.text.engine.LigatureLevel.EXOTIC;
var ef2:ElementFormat = new ElementFormat(fd);
ef2.fontSize = 30;
ef2.color = 0xFF0000;
ef2.alpha = 0.3;
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.typographicCase = flash.text.engine.TypographicCase.LOWERCASE;
ef2.digitCase = flash.text.engine.DigitCase.OLD_STYLE;
ef2.textRotation = flash.text.engine.TextRotation.ROTATE_180;
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);
line1.x = 15;
line1.y = 30;
tb.content.elementFormat = ef2;
var line2:TextLine = tb.createTextLine(null, 600);
addChild(line2);
line2.x = 15;
line2.y = 60;
}
}
}
Tue Jun 12 2018, 02:12 PM Z