Configuration

Paquete	flashx.textLayout.elements
Clase	public class Configuration
Herencia	Configuration Object
Implementa	IConfiguration

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

La clase Configuration es, fundamentalmente, un punto de integración entre Text Layout Framework y una aplicación. Puede incluir un objeto Configuration como un parámetro del constructor TextFlow() cuando cree una nueva instancia de TextFlow. Permite que la aplicación controle inicialmente cómo se comporta Text Layout Framework.

La clase Configuration permite especificar formatos iniciales de párrafo y de contenedor para flujo de texto mediante la propiedad textFlowInitialFormat. También permite especificar atributos de formato inicial para vínculos, selección, desplazamiento y para gestionar las teclas Tabulador e Intro.

Ver los ejemplos

Más ejemplos

Applying styles with the Configuration class

Elementos de API relacionados

ITextLayoutFormat
SelectionFormat
TextFlow

Propiedades públicas

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
		defaultLinkActiveFormat : flashx.textLayout.formats:ITextLayoutFormat Especifica los atributos de formato de caracteres activos que se aplican inicialmente a todos los vínculos (objetos LinkElement) del flujo de texto.	Configuration
		defaultLinkHoverFormat : flashx.textLayout.formats:ITextLayoutFormat Especifica los atributos de formato de caracteres iniciales que se aplican a un vínculo (LinkElement) en el flujo de texto cuando el cursor pasa por encima.	Configuration
		defaultLinkNormalFormat : flashx.textLayout.formats:ITextLayoutFormat Especifica los atributos de vínculo iniciales para todos los objetos LinkElement del flujo de texto.	Configuration
		defaultListMarkerFormat : IListMarkerFormat Especifica los atributos de formato de caracteres activos que se aplican inicialmente a todos los objetos ListItems del flujo de texto.	Configuration
		enableAccessibility : Boolean Especifica si el soporte de accesibilidad está activado o no.	Configuration
		flowComposerClass : Class Especifica el tipo de composición de flujo que se asocia a un nuevo objeto TextFlow de forma predeterminada.	Configuration
		focusedSelectionFormat : SelectionFormat El formato de selección inicial (SelectionFormat) para un flujo de texto (TextFlow) cuando su ventana tiene la selección.	Configuration
		inactiveSelectionFormat : SelectionFormat El formato de selección inicial (SelectionFormat) para un flujo de texto (TextFlow) cuando su ventana está inactiva.	Configuration
		inlineGraphicResolverFunction : Function Especifica la función callback utilizada para resolver un elemento gráfico en línea.	Configuration
		manageEnterKey : Boolean Especifica si Text Layout Framework ha introducido la tecla Intro/Retorno como texto, por ejemplo, para dividir un párrafo, o si lo gestiona el código cliente.	Configuration
		manageTabKey : Boolean Especifica si Text Layout Framework ha introducido la tecla Tabulación como texto, o bien lo gestionan Flash Player o AIR y lo convierten en un evento de panel con tabulaciones.	Configuration
		overflowPolicy : String Política utilizada para decidir si la última línea de un contenedor se ajusta a él o si lo desborda.	Configuration
		releaseLineCreationData : Boolean Solicita que el proceso de composición de texto libere datos de creación de líneas tras componer cada párrafo.	Configuration
		scrollDragDelay : Number Especifica una demora programada entre un desplazamiento y el siguiente para evitar que vaya demasiado deprisa.	Configuration
		scrollDragPixels : Number Especifica el número predeterminado de píxeles de desplazamiento cuando el usuario inicia el desplazamiento automático arrastrando la selección.	Configuration
		scrollMouseWheelMultiplier : Number Especifica el número predeterminado de píxeles de desplazamiento en eventos de rueda de ratón.	Configuration
		scrollPagePercentage : Number Especifica el porcentaje predeterminado del flujo de texto que se desplaza en el desplazamiento de páginas.	Configuration
		textFlowInitialFormat : flashx.textLayout.formats:ITextLayoutFormat Especifica la configuración inicial de formato de TextLayoutFormat para un flujo de texto (objeto TextFlow).	Configuration
		unfocusedSelectionFormat : SelectionFormat El formato de selección inicial que utiliza Text Layout Framework para dibujar la selección cuando la ventana está activa pero ninguno de los contenedores del objeto TextFlow tiene la selección.	Configuration

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		Configuration(initializeWithDefaults:Boolean = true) Constructor: crea una configuración predeterminada.	Configuration
		clone():Configuration Crea un clon del objeto Configuration.	Configuration
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object

Información sobre propiedades

defaultLinkActiveFormat

propiedad

defaultLinkActiveFormat:flashx.textLayout.formats:ITextLayoutFormat

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica los atributos de formato de caracteres activos que se aplican inicialmente a todos los vínculos (objetos LinkElement) del flujo de texto. Estos son los valores predeterminados para nuevos objetos LinkElement que no especifiquen valores para estos atributos.

El valor predeterminado es null.

Implementación
public function get defaultLinkActiveFormat():flashx.textLayout.formats:ITextLayoutFormat
public function set defaultLinkActiveFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Elementos de API relacionados

FlowElement.linkActiveFormat
ITextLayoutFormat
LinkElement

defaultLinkHoverFormat

propiedad

defaultLinkHoverFormat:flashx.textLayout.formats:ITextLayoutFormat

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica los atributos de formato de caracteres iniciales que se aplican a un vínculo (LinkElement) en el flujo de texto cuando el cursor pasa por encima. Estos son los valores predeterminados para nuevos objetos LinkElement que no especifiquen valores para estos atributos.

El valor predeterminado es null.

Implementación
public function get defaultLinkHoverFormat():flashx.textLayout.formats:ITextLayoutFormat
public function set defaultLinkHoverFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Elementos de API relacionados

FlowElement.linkHoverFormat
ITextLayoutFormat
LinkElement

defaultLinkNormalFormat

propiedad

defaultLinkNormalFormat:flashx.textLayout.formats:ITextLayoutFormat

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica los atributos de vínculo iniciales para todos los objetos LinkElement del flujo de texto. Estos son los valores predeterminados para nuevos objetos LinkElement que no especifiquen valores para estos atributos. El formato normal predeterminado muestra el vínculo en azul con subrayado.

Implementación
public function get defaultLinkNormalFormat():flashx.textLayout.formats:ITextLayoutFormat
public function set defaultLinkNormalFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Elementos de API relacionados

FlowElement.linkNormalFormat
ITextLayoutFormat
LinkElement

defaultListMarkerFormat

propiedad

defaultListMarkerFormat:IListMarkerFormat

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica los atributos de formato de caracteres activos que se aplican inicialmente a todos los objetos ListItems del flujo de texto. Estos son los valores predeterminados para nuevos objetos ListItemElement que no especifiquen valores para estos atributos.

El valor predeterminado es null.

Implementación
public function get defaultListMarkerFormat():IListMarkerFormat
public function set defaultListMarkerFormat(value:IListMarkerFormat):void

Elementos de API relacionados

FlowElement.listMarkerFormat
IListMarkerFormat
LinkElement

enableAccessibility

propiedad

enableAccessibility:Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica si el soporte de accesibilidad está activado o no. Si es true, los lectores de pantalla pueden leer el contenido de TextFlow.

El valor predeterminado es false.

Implementación
public function get enableAccessibility():Boolean
public function set enableAccessibility(value:Boolean):void

Elementos de API relacionados

TextFlow

flowComposerClass

propiedad

flowComposerClass:Class

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica el tipo de composición de flujo que se asocia a un nuevo objeto TextFlow de forma predeterminada. El valor predeterminado es StandardFlowComposer.

Implementación
public function get flowComposerClass():Class
public function set flowComposerClass(value:Class):void

Elementos de API relacionados

StandardFlowComposer
TextFlow

focusedSelectionFormat

propiedad

focusedSelectionFormat:SelectionFormat

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

El formato de selección inicial (SelectionFormat) para un flujo de texto (TextFlow) cuando su ventana tiene la selección. Text Layout Framework utiliza focusedSelectionFormat para dibujar la selección cuando la ventana está activa y uno de los contenedores del objeto TextFlow tiene la selección. Puede anular este formato si lo desea utilizando SelectionManager.focusedSelectionFormat.

La clase SelectionFormat especifica los valores predeterminados que invierten el color del texto y su fondo.

Implementación
public function get focusedSelectionFormat():SelectionFormat
public function set focusedSelectionFormat(value:SelectionFormat):void

Elementos de API relacionados

SelectionFormat
SelectionManager.focusedSelectionFormat
TextFlow

inactiveSelectionFormat

propiedad

inactiveSelectionFormat:SelectionFormat

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

El formato de selección inicial (SelectionFormat) para un flujo de texto (TextFlow) cuando su ventana está inactiva. Text Layout Framework utiliza inactiveSelectionFormat para dibujar la selección cuando la ventana está inactiva. Puede anular este formato si lo desea utilizando SelectionManager.inactiveSelectionFormat.

Si no se anula unfocusedSelectionFormat se utilizan los valores de SelectionFormat:

color = 0xffffff (blanco)
alpha = 0
blendMode = flash.display.BlendMode.DIFFERENCE

El resultado: no se visualiza ninguna selección.

Implementación
public function get inactiveSelectionFormat():SelectionFormat
public function set inactiveSelectionFormat(value:SelectionFormat):void

Elementos de API relacionados

SelectionFormat
SelectionManager.inactiveSelectionFormat
TextFlow

inlineGraphicResolverFunction

propiedad

inlineGraphicResolverFunction:Function

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica la función callback utilizada para resolver un elemento gráfico en línea. La función callback toma un objeto flashx.textLayout.elements.InlineGraphicElement y devuelve el valor que se va a utilizar como el flashx.textLayout.elements.InlineGraphicElement#origen del elemento Esta función callback proporciona el mecanismo para generar una demora del origen del elemento gráfico hasta justo antes de su composición.

Nota: esta función callback se invocará sólo si un origen de marcador de tipo String origen ya está definido. Además, puede ser invocado varias veces.

Implementación
public function get inlineGraphicResolverFunction():Function
public function set inlineGraphicResolverFunction(value:Function):void

Elementos de API relacionados

InlineGraphicElement

manageEnterKey

propiedad

manageEnterKey:Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica si Text Layout Framework ha introducido la tecla Intro/Retorno como texto, por ejemplo, para dividir un párrafo, o si lo gestiona el código cliente. El código de cliente puede gestionarlo si envía un formulario con un botón predeterminado para dicho fin, por ejemplo.

El valor predeterminado es true.

Implementación
public function get manageEnterKey():Boolean
public function set manageEnterKey(value:Boolean):void

manageTabKey

propiedad

manageTabKey:Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica si Text Layout Framework ha introducido la tecla Tabulación como texto, o bien lo gestionan Flash Player o AIR y lo convierten en un evento de panel con tabulaciones.

El valor predeterminado es false.

Implementación
public function get manageTabKey():Boolean
public function set manageTabKey(value:Boolean):void

overflowPolicy

propiedad

overflowPolicy:String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Política utilizada para decidir si la última línea de un contenedor se ajusta a él o si lo desborda. Utilice las constantes de la clase OverflowPolicy para establecer esta propiedad.

El valor predeterminado es OverflowPolicy.FIT_DESCENDERS y ajusta la línea en el área de composición si se ajusta al área superior de la línea base.

Implementación
public function get overflowPolicy():String
public function set overflowPolicy(value:String):void

Elementos de API relacionados

OverflowPolicy

releaseLineCreationData

propiedad

releaseLineCreationData:Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Solicita que el proceso de composición de texto libere datos de creación de líneas tras componer cada párrafo. Esta petición ahorra memoria pero ralentiza el proceso de composición.

El valor predeterminado es false.

Implementación
public function get releaseLineCreationData():Boolean
public function set releaseLineCreationData(value:Boolean):void

Elementos de API relacionados

StandardFlowComposer
TextBlock.releaseLineCreationData()

scrollDragDelay

propiedad

scrollDragDelay:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica una demora programada entre un desplazamiento y el siguiente para evitar que vaya demasiado deprisa. Este valor especifica la demora en milisegundos. El valor predeterminado es 35.

Implementación
public function get scrollDragDelay():Number
public function set scrollDragDelay(value:Number):void

scrollDragPixels

propiedad

scrollDragPixels:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica el número predeterminado de píxeles de desplazamiento cuando el usuario inicia el desplazamiento automático arrastrando la selección. El valor predeterminado es 20.

Implementación
public function get scrollDragPixels():Number
public function set scrollDragPixels(value:Number):void

scrollMouseWheelMultiplier

propiedad

scrollMouseWheelMultiplier:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica el número predeterminado de píxeles de desplazamiento en eventos de rueda de ratón. El valor predeterminado es 20.

Implementación
public function get scrollMouseWheelMultiplier():Number
public function set scrollMouseWheelMultiplier(value:Number):void

scrollPagePercentage

propiedad

scrollPagePercentage:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica el porcentaje predeterminado del flujo de texto que se desplaza en el desplazamiento de páginas. El valor predeterminado es 7.0/8.0 ó 0.875.

Implementación
public function get scrollPagePercentage():Number
public function set scrollPagePercentage(value:Number):void

textFlowInitialFormat

propiedad

textFlowInitialFormat:flashx.textLayout.formats:ITextLayoutFormat

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Especifica la configuración inicial de formato de TextLayoutFormat para un flujo de texto (objeto TextFlow).

El valor predeterminado es null.

Implementación
public function get textFlowInitialFormat():flashx.textLayout.formats:ITextLayoutFormat
public function set textFlowInitialFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

Elementos de API relacionados

TextFlow
ITextLayoutFormat

unfocusedSelectionFormat

propiedad

unfocusedSelectionFormat:SelectionFormat

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

El formato de selección inicial que utiliza Text Layout Framework para dibujar la selección cuando la ventana está activa pero ninguno de los contenedores del objeto TextFlow tiene la selección. Puede anular este formato si lo desea utilizando SelectionManager.unfocusedSelectionFormat.

Si no se anula unfocusedSelectionFormat se utilizan los valores de SelectionFormat:

color = 0xffffff (blanco)
alpha = 0
blendMode = flash.display.BlendMode.DIFFERENCE

El resultado: no se visualiza ninguna selección.

Implementación
public function get unfocusedSelectionFormat():SelectionFormat
public function set unfocusedSelectionFormat(value:SelectionFormat):void

Elementos de API relacionados

SelectionFormat
SelectionManager.unfocusedSelectionFormat
TextFlow

Información sobre constructores

()

Información sobre

public function Configuration(initializeWithDefaults:Boolean = true)

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Constructor: crea una configuración predeterminada.

Parámetros

initializeWithDefaults:Boolean (default = true) — Especifica si se inicializa la configuración con los valores predeterminados. El valor predeterminado es true. Si se establece como false, se inicializa sin los valores predeterminados, guardando así algunos objetos. El método clone() establece esto como false y copia las propiedades del objeto original.

Elementos de API relacionados

SelectionFormat
StandardFlowComposer

Información sobre métodos

clone

()

método

public function clone():Configuration

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10, AIR 1.5

Crea un clon del objeto Configuration.

Valor devuelto

Configuration

Información sobre constantes

hasTouchScreen

Constante

tlf_internal static const hasTouchScreen:Boolean

Ejemplos Cómo utilizar este ejemplo

ConfigurationExample.as

Este ejemplo crea una configuración de formato inicial que se aplica a un objeto TextFlow formado por un párrafo y un vínculo.

package flashx.textLayout.elements.examples {
    import flash.display.Sprite;
    import flash.text.engine.FontPosture;
    import flash.text.engine.Kerning;
    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.edit.SelectionFormat;
    import flashx.textLayout.edit.SelectionManager;
    import flashx.textLayout.elements.Configuration;
    import flashx.textLayout.elements.LinkElement;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextAlign;
    import flashx.textLayout.formats.TextDecoration;
    import flashx.textLayout.formats.TextLayoutFormat;

    public class ConfigurationExample extends Sprite
    {
        public function ConfigurationExample()
        {    
            //create container for the text and add to stage
            var textContainer:Sprite = new Sprite();
            textContainer.x = 50;
            textContainer.y = 20;
            this.stage.addChild( textContainer );
            
            // create Configuration, set properties for it and add to TextFlow
            var config:Configuration = new Configuration();
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
            textLayoutFormat.fontSize = 16;
            textLayoutFormat.kerning = Kerning.ON;
            textLayoutFormat.fontStyle = FontPosture.ITALIC;
            textLayoutFormat.textAlign = TextAlign.CENTER;
            config.textFlowInitialFormat = textLayoutFormat;
            var linkNormalFormat:TextLayoutFormat = new TextLayoutFormat();
            // make links red and underlined
            linkNormalFormat.color = 0xFF0000;
            linkNormalFormat.textDecoration = TextDecoration.UNDERLINE;
            config.defaultLinkNormalFormat = linkNormalFormat;
            // set selection color to light blue
              var selectionFormat:SelectionFormat = new SelectionFormat(0x333300);
              config.focusedSelectionFormat = selectionFormat;
            var textFlow:TextFlow = new TextFlow(config);
            // make text selectable
            var selectionManager:SelectionManager = new SelectionManager();
            textFlow.interactionManager = selectionManager;
            
            // create paragraph, a span of text, and a link
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            var linkSpan:SpanElement = new SpanElement();
            var link:LinkElement = new LinkElement();
            link.href = "http://www.adobe.com";
            linkSpan.text = "Adobe's website";
            link.addChild(linkSpan);
            span.text = "The best place to go for information about Adobe products is: ";
            
            // Add span and link to paragraph; add paragraph to TextFlow
            p.addChild(span);
            p.addChild(link);
            textFlow.addChild(p);
            
            // Add a controller for the container; specify container width and height
            textFlow.flowComposer.addController(new ContainerController(textContainer, 80, 300));
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}

Avisos legales | Política de privacidad en línea

Configuration - AS3

Paquetesx

Elementos del lenguaje

Apéndices

Paquete flashx.textLayout.elements

defaultLinkActiveFormat

defaultLinkHoverFormat

defaultLinkNormalFormat

defaultListMarkerFormat

enableAccessibility

flowComposerClass

focusedSelectionFormat

inactiveSelectionFormat

inlineGraphicResolverFunction

manageEnterKey

manageTabKey

overflowPolicy

releaseLineCreationData

scrollDragDelay

scrollDragPixels

scrollMouseWheelMultiplier

scrollPagePercentage

textFlowInitialFormat

unfocusedSelectionFormat

Configuration

clone

hasTouchScreen