| Paquete | flash.text.engine |
| Clase | public class ContentElement |
| Herencia | ContentElement  Object |
| Subclases | GraphicElement, GroupElement, TextElement |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
ContentElement es una clase base abstracta; por consiguiente, no puede crear instancias de ContentElement directamente. Al llamar a new ContentElement() se emite una excepción ArgumentError.
Puede asignar un elemento ContentElement a exactamente un GroupElement o a la propiedad content de exactamente un bloque de texto.
Elementos de API relacionados
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| elementFormat : ElementFormat
El objeto ElementFormat utilizado para el elemento. | ContentElement | ||
| eventMirror : EventDispatcher
El objeto EventDispatcher que recibe copias de cada evento distribuido en las líneas de texto válidas según este elemento de contenido. | ContentElement | ||
| groupElement : GroupElement [solo lectura]
El objeto GroupElement que contiene este elemento o null si no se encuentra en ningún grupo. | ContentElement | ||
| rawText : String [solo lectura]
Una copia del texto en el elemento, incluidos los caracteres U+FDEF. | ContentElement | ||
| text : String [solo lectura]
Una copia del texto en el elemento, sin incluir los caracteres U+FDEF que representan elementos gráficos en la cadena. | ContentElement | ||
| textBlock : flash.text.engine:TextBlock [solo lectura]
Objeto TextBlock al que pertenece el elemento. | ContentElement | ||
| textBlockBeginIndex : int [solo lectura]
Índice del bloque de texto del primer carácter de este elemento. | ContentElement | ||
| textRotation : String
La rotación aplicada al elemento como una unidad. | ContentElement | ||
| userData : *
Permite a la aplicación asociar datos arbitrarios al elemento. | ContentElement | ||
| Método | Definido por | ||
|---|---|---|---|
ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
La llamada al nuevo constructor ContentElement() emite una excepción ArgumentError. | ContentElement | ||
|
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 | |
| Constante | Definido por | ||
|---|---|---|---|
| GRAPHIC_ELEMENT : uint = 0xFDEF [estática]
Indica la presencia de un elemento gráfico en el texto. | ContentElement | ||
elementFormat | propiedad |
elementFormat:ElementFormat| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
El objeto ElementFormat utilizado para el elemento.
El valor predeterminado es null.
Cuando se establece la propiedad elementFormat, el objeto ElementFormat suministrado se bloquea: su propiedad locked se establece como true. Un elemento ElementFormat bloqueado no es modificable.
Implementación
public function get elementFormat():ElementFormat public function set elementFormat(value:ElementFormat):voidElementos de API relacionados
eventMirror | propiedad |
eventMirror:EventDispatcher| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
El objeto EventDispatcher que recibe copias de cada evento distribuido en las líneas de texto válidas según este elemento de contenido. El objeto especificado se puede utilizar para definir detectores de vínculos de texto o de cualquier otra forma de texto interactiva, ya que puede ser difícil determinar en tiempo de ejecución qué partes de las líneas provienen de qué elementos en línea. También se pueden utilizar detectores para aplicar formato decorativo (por ejemplo, subrayado) cuya métrica no se puede determinar hasta la publicación del texto. El valor predeterminado es null, lo que significa que no se distribuye ningún evento reflejado.
Los reflejos de eventos se manifiestan en las líneas de texto como instancias de la clase TextLineMirrorRegion. En función del procesado bidireccional y de los saltos de línea, es posible producir una o varias regiones de reflejos.
El valor predeterminado es null.
Implementación
public function get eventMirror():EventDispatcher public function set eventMirror(value:EventDispatcher):voidElementos de API relacionados
groupElement | propiedad |
groupElement:GroupElement [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
El objeto GroupElement que contiene este elemento o null si no se encuentra en ningún grupo.
El valor predeterminado es null.
Implementación
public function get groupElement():GroupElementElementos de API relacionados
rawText | propiedad |
rawText:String [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Una copia del texto en el elemento, incluidos los caracteres U+FDEF. El carácter Unicode U+FDEF marca la ubicación de un elemento gráfico en la cadena.
Implementación
public function get rawText():Stringtext | propiedad |
text:String [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Una copia del texto en el elemento, sin incluir los caracteres U+FDEF que representan elementos gráficos en la cadena.
Implementación
public function get text():StringElementos de API relacionados
textBlock | propiedad |
textBlock:flash.text.engine:TextBlock [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Objeto TextBlock al que pertenece el elemento.
El valor predeterminado es null.
Implementación
public function get textBlock():flash.text.engine:TextBlockElementos de API relacionados
textBlockBeginIndex | propiedad |
textBlockBeginIndex:int [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Índice del bloque de texto del primer carácter de este elemento. Este valor no se guarda en caché: se calcula cada vez que se llama al método.
El valor predeterminado es -1.
Implementación
public function get textBlockBeginIndex():inttextRotation | 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 |
La rotación aplicada al elemento como una unidad. Utilice constantes TextRotation para esta propiedad.
El valor predeterminado es TextRotation.ROTATE_0.
La rotación final de cualquier glifo es la suma de ElementFormat.textRotation, ContentElement.textRotation y TextBlock.lineRotation.
ContentElement.textRotation se utiliza para crear un ciclo corto de texto cuya rotación no coincide con la línea que la contiene. Un ejemplo son los ciclos TCY de texto en japonés. Las siglas TCY corresponden a Tate-Chu-Yoko y se refieren a una pequeña ejecución de texto horizontal (normalmente un número) en texto vertical en japonés. Para crear un párrafo de texto vertical en japonés que contenga un ciclo TCY, haga lo siguiente:
- Defina
TextBlock.lineRotation=TextRotation.ROTATE_90 - Establezca
TextBlock.contenten un GroupElement formado por tres objetos TextElement. El primero de estos elementos debe ser el texto en japonés antes del ciclo TCY, el segundo debe ser el texto Latin del ciclo TCY y el tercero debe ser el texto en japonés tras el ciclo TCY. - Establezca la propiedad
textRotationde TCY TextElement enTextRotation.ROTATE_270. El elemento de texto TCY gira como una unidad. Comienza con una rotación de 90 grados heredada de la línea. Si añade otros 270 grados, pasa a horizontal.
No es posible anidar elementos de contenido girados. En cualquier jerarquía de elementos de contenido, independientemente de su complejidad, sólo un elemento de contenido puede tener su propiedad textRotation establecida. Los siguientes configuradores de métodos y de propiedades emiten un error de argumento si detectan rotaciones anidadas:
ContentElement.textRotationGroupElement.setElementsGroupElement.replaceElements
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
| Valor de la cadena | Descripción |
|---|---|
TextRotation.ROTATE_0 | El elemento no se gira. |
TextRotation.ROTATE_90 | El elemento se gira 90 grados en sentido horario. |
TextRotation.ROTATE_180 | El elemento se gira 180 grados. |
TextRotation.ROTATE_270 | El elemento se gira 270 grados en sentido horario. |
TextRotation.AUTO | No se admite. |
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.
| |
ArgumentError — Si se establece en TextRotation.AUTO.
| |
ArgumentError — Si la operación tiene como resultado rotaciones anidadas en GroupElement.
|
Elementos de API relacionados
userData | propiedad |
public var userData:*| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Permite a la aplicación asociar datos arbitrarios al elemento.
El valor predeterminado es null.
ContentElement | () | Información sobre |
public function ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
La llamada al constructor new ContentElement() emite una excepción ArgumentError. No obstante, puede llamar a los constructores para las siguientes subclases de ContentElement:
new GraphicElement()new GroupElement()new TextElement()
elementFormat:ElementFormat (default = null)null.
| |
eventMirror:EventDispatcher (default = null)EventDispatcher que recibe copias de cada evento distribuido en las líneas de texto creados en base a este elemento de contenido. El valor predeterminado es null.
| |
textRotation:String (default = "rotate0")TextRotation para esta propiedad. El valor predeterminado es TextRotation.ROTATE_0.
|
GRAPHIC_ELEMENT | Constante |
Tue Jun 12 2018, 02:12 PM Z