TextFlow  - AS3

El objeto Configuration para este objeto TextFlow. El objeto Configuration especifica los formatos de caracteres iniciales y de párrafo, el formato de contenedor inicial y los atributos para la selección de resaltado, vínculos, activación y desplazamiento.

Si no especifica ningún objeto Configuration, Text Layout Framework utiliza un objeto Configuration predeterminado al que hace referencia la propiedad defaultConfiguration.

Elementos de API relacionados

Configuración predeterminada para todos los nuevos objetos TextFlow si no se especifica configuración.

Elementos de API relacionados

Administra los contenedores para este elemento.

Los objetos TextLine creados a partir del elemento se muestran como elementos secundarios del contenedor. flowComposer administra los contenedores y, a medida que se edita el texto, añade o elimina líneas de los contenedores. flowComposer también lleva un seguimiento de algunos atributos vitales, como la anchura y la altura de composición, si hay desplazamiento, etc.

El contenedor y flowComposer están íntimamente relacionados. Si restaura flowComposer, el contenedor se restaura también según el nuevo contenedor de flowComposer. Del mismo modo, si se restaura el contenedor, flowComposer se restaura también según el nuevo flowComposer del contenedor.

Elementos de API relacionados

Una función callback para resolver estilos de elementos. Puede utilizarla para proporcionar estilos con CSS o estilos existentes, por ejemplo.

Elementos de API relacionados

El número de generación para este objeto TextFlow. Las operaciones Deshacer y Rehacer utilizan este número de generación para validar que están permitidas las acciones para deshacer y rehacer. Los números de generación deben coincidir.

Cada cambio de modelo hace que la generación se incremente, por lo que si el número de generación cambia, sabrá que el modelo de TextFlow ha cambiado.

El objeto TextLayoutFormat para este objeto TextFlow. Esto permite diversas optimizaciones para reutilizar formatos host. Por ejemplo;

        textFlowA.hostFormat = textFlowB.hostFormat
        

        format = new TextLayoutFormat()
        textFlow.hostFormat = format
        format.fontSize = 24;
        

Elementos de API relacionados

El elemento InteractionManager asociado a este objeto TextFlow.

Controla toda la selección y edición del texto. Si el objeto TextFlow no se puede seleccionar, interactionManager es null. Para que TextFlow se pueda editar, asigne un elemento interactionManager que sea tanto ISelectionManager como IEditManager. Para crear un objeto TextFlow de sólo lectura y que permita selección, asigne un interactionManager que sea solamente ISelectionManager.

Elementos de API relacionados

Constructor: crea una nueva instancia de TextFlow.

Si proporciona un parámetro config, el contenido del objeto Configuration se copiará y no podrá realizar cambios. Puede acceder a los valores de configuración, no obstante, a través de la propiedad configuration. Si el parámetro config es null, puede acceder a los valores de configuración predeterminados a través de la propiedad defaultConfiguration.

El objeto Configuration proporciona un mecanismo para establecer atributos predeterminados configurables en un objeto TextFlow. Aunque no es posible hacer cambios en el objeto Configuration, puede anular los atributos predeterminados si es necesario y establecer los de TextFlow y sus elementos secundarios.

Elementos de API relacionados

Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. Puede registrar detectores de eventos en todos los nodos de la lista de visualización para un tipo concreto de evento, fase y prioridad.

Una vez registrado correctamente un detector de eventos, no puede cambiar su prioridad mediante llamadas adicionales a addEventListener(). Para cambiar la prioridad de un detector, en primer lugar debe llamar a removeEventListener(). Seguidamente, puede volver a registrar el nuevo nivel de prioridad.

Una vez registrado el detector, las siguientes llamadas a addEventListener() con un valor type o useCapture distinto tendrán como resultado la creación de un registro independiente del detector. Por ejemplo, si registra primero un detector con useCapture definido como true, detectará únicamente durante la fase de captura. Si vuelve a llamar a addEventListener() con el mismo objeto detector, pero con useCapture definido como false, tendrá dos detectores independientes: uno que detecta durante la fase de captura y otro que lo hace durante las fases de destino y de propagación.

No es posible registrar un detector de eventos únicamente para la fase de destino o la fase de propagación. Dichas fases se acoplan durante el registro, ya que la propagación sólo se aplica a los ascendientes del nodo de destino.

Si ya no necesita ningún detector de eventos, elimínelo llamando a EventDispatcher.removeEventListener(); en caso contrario, podrían surgir problemas de memoria. Los objetos con detectores de eventos registrados no se eliminan automáticamente de la memoria, ya que el recolector de datos innecesarios no elimina objetos que aún tienen referencias.

Al copiar una instancia EventDispatcher no se copian los detectores de eventos asociados. (Si el nodo recién creado necesita un detector de eventos, debe asociarlo después de crear el nodo.) Sin embargo, si mueve una instancia EventDispatcher, los detectores de eventos asociados se moverán también.

Si el detector de eventos se registra en un nodo mientras se procesa un evento en dicho nodo, el detector de eventos no se desencadenará durante la fase actual, aunque sí se desencadenará en una fase posterior del flujo del evento, por ejemplo, en la fase de propagación.

Si un detector de eventos se elimina de un nodo mientras se procesa un evento en dicho nodo, las acciones actual seguirán desencadenándolo. Una vez eliminado, el detector de eventos ya no se vuelve a invocar nunca más (a no ser que se registre de nuevo para otro proceso).

Parámetros

Distribuye un evento en el flujo del evento. El destino del evento es el objeto EventDispatcher en el que se llama dispatchEvent().

Parámetros

Devuelve un elemento cuya propiedad id coincide con el parámetro idName. Permite aplicar un estilo basado en el id.

Por ejemplo, la línea siguiente establece el estilo "color" como 0xFF0000 (rojo) para el elemento con id span1.

         textFlow.getElementByID("span1").setStyle("color", 0xFF0000);
         

Nota: en el código siguiente, p.addChild(s) elimina s de su elemento principal original y lo añade a p, el nuevo elemento principal.

         var s:SpanElement = new SpanElement();
         var p:ParagraphElement = new ParagraphElement();
         ...
         s = textFlow.getElementByID("span3") as SpanElement;
         p.addChild(s);
         textFlow.addChild(p);
         

Parámetros

Elementos de API relacionados

package flashx.textLayout.elements.examples {
    import flash.display.Sprite;
    
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class TextFlow_getElementByIDExample extends Sprite
    {
        public function TextFlow_getElementByIDExample()
        {    
            // create the TextFlow object
            var textFlow:TextFlow = new TextFlow();
            
            // xml markup that defines the attributes and contents of a text flow
            var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
            "<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
                "<flow:p>"+
                    "<flow:span id='span1'>In the first paragraph of the </flow:span>"+
                    "<flow:span id='span2' fontStyle=\"italic\">cheap </flow:span>"+
                    "<flow:span id='span3'>Western novel, a cowboy meets a saloon girl.</flow:span>"+
                "</flow:p>"+
            "</flow:TextFlow>";
            var s:SpanElement = new SpanElement();
            var s2:SpanElement = new SpanElement();
            var p:ParagraphElement = new ParagraphElement();
            // import the xml markup into a TextFlow object and display it on the stage
            textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
            // get element with ID of span3, make a copy of it
            textFlow.getElementByID("span3").setStyle("color", 0xFF0000); 
            textFlow.flowComposer.addController(new ContainerController(this, 200, 800));
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

            
            

Devuelve todos los elementos con styleName establecido como styleNameValue.

Parámetros

Elementos de API relacionados

Devuelve todos los elementos con typeName como typeNameValue.

Parámetros

Elementos de API relacionados

Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. De este modo, es posible determinar en qué lugar de la jerarquía del flujo del evento un objeto EventDispatcher ha alterado el control de un tipo de evento. Para determinar si un tipo de evento concreto realmente desencadenará un detector de eventos, utilice IEventDispatcher.willTrigger().

La diferencia entre hasEventListener() y willTrigger() reside en que hasEventListener() examina sólo el objeto al que pertenece, mientras que willTrigger() examina todo el flujo del evento especificado por el parámetro type.

Parámetros

Invalida toda la información de formato de TextFlow y obliga a volver a calcularla. Llame a este método si han cambiado los estilos.

Elementos de API relacionados

Elimina un detector del objeto EventDispatcher. Si no hay ningún detector coincidente registrado con el objeto EventDispatcher, la llamada a este método no surtirá ningún efecto.

Parámetros

Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. Este método devuelve true si se desencadena un detector de eventos durante cualquier fase del flujo del evento cuando se distribuye un evento del tipo especificado a este objeto EventDispatcher o a cualquiera de sus descendientes.

La diferencia entre hasEventListener() y willTrigger() reside en que hasEventListener() examina sólo el objeto al que pertenece, mientras que willTrigger() examina todo el flujo del evento especificado por el parámetro type.

Parámetros

Se distribuye cuando se hace clic en cualquier vínculo.

Se distribuye tras cualquier recomposición.

Distribuido por un objeto TextFlow cada vez que se daña. Puede usar este evento para saber qué ha cambiado en TextFlow, pero no para acceder al propio objeto TextFlow cuando se envíe este evento. Este evento se envía cuando los cambios de TextFlow han concluido parcialmente. Por ello, puede tener un estado incoherente: algunos cambios ya se han registrado y otros siguen pendientes. Obtenga la información que necesite del evento y lleve a cabo los cambios necesarios cuando el control vuelva a su aplicación.

Cambiar una operación en este momento (una vez ejecutada) es probable que falle.

Se distribuye cuando cambia el tamaño de un elemento InlineGraphicElement debido al ajuste automático o porcentual de la anchura y la altura y cuando el gráfico termina de cargarse.

Se distribuye cuando el ratón se pulsa encima de algún vínculo.

Se distribuye cuando el ratón pasa por encima de algún vínculo.

Se distribuye cuando el ratón se suelta encima de algún vínculo.

Se distribuye cuando el ratón sale de cualquier vínculo.

Se distribuye cuando el ratón entra en el vínculo por primera vez.

Distribuido por un objeto TextFlow después del desplazamiento de texto dentro de un contenedor del controlador.

Se distribuye siempre que cambia la selección. Se utiliza fundamentalmente para actualizar la interfaz de usuario dependiente de la selección. También se puede utilizar para modificar la selección, pero no puede utilizarse para modificar el objeto TextFlow en sí mismo.

Distribuido por un objeto TextFlow cada vez que se añaden o se actualizan objetos DisplayObjects al contenedor como resultado de la composición.