| Package | flashx.textLayout.elements |
| Classe | public class Configuration |
| Héritage | Configuration  Object |
| Implémente | IConfiguration |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
TextFlow() lorsque vous créez une nouvelle occurrence TextFlow. Cela permet à l’application de contrôler initialement la façon dont Text Layout Framework se comporte.
La classe de configuration vous permet de spécifier les formats initiaux, de paragraphe et de conteneur pour l’enchaînement de texte via la propriété textFlowInitialFormat. Elle permet aussi de spécifier les attributs de mise en forme initiale pour les liens, la sélection, les propriétés pour le défilement et les paramètres de traitement des touches de tabulation et d’Entrée.
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| defaultLinkActiveFormat : flashx.textLayout.formats:ITextLayoutFormat
Spécifie les attributs du format de caractère actif qui s’appliquent initialement à tous les liens (objets LinkElement) dans l’enchaînement de texte. | Configuration | ||
| defaultLinkHoverFormat : flashx.textLayout.formats:ITextLayoutFormat
Spécifie les attributs de format de caractère initial qui s’appliquent à un lien (LinkElement) dans l’enchaînement de texte lorsque le curseur le survole. | Configuration | ||
| defaultLinkNormalFormat : flashx.textLayout.formats:ITextLayoutFormat
Spécifie les attributs du lien initial qui s’appliquent à tous les objets LinkElement dans l’enchaînement de texte. | Configuration | ||
| defaultListMarkerFormat : IListMarkerFormat
Spécifie les attributs de format de caractère actif qui s’appliquent initialement à tous les objets ListItem dans l’enchaînement de texte. | Configuration | ||
| enableAccessibility : Boolean
Spécifie si la prise en charge de l’accessibilité est activée ou non. | Configuration | ||
| flowComposerClass : Class Spécifie le type de composeur d’enchaînement à associer à un nouvel objet TextFlow par défaut. | Configuration | ||
| focusedSelectionFormat : SelectionFormat
Le format de sélection initial (SelectionFormat) pour un enchaînement de texte (TextFlow) lorsque la fenêtre a le focus. | Configuration | ||
| inactiveSelectionFormat : SelectionFormat
Le format de sélection initial (SelectionFormat) pour un enchaînement de texte (TextFlow) lorsque la fenêtre est inactive. | Configuration | ||
| inlineGraphicResolverFunction : Function Spécifie le rappel utilisé pour résoudre un élément graphique intégré. | Configuration | ||
| manageEnterKey : Boolean
Spécifie si la touche Entrée / Retour est entrée comme du texte par Text Layout Framework, pour diviser un paragraphel, par exemple, ou le code client qui le gère. | Configuration | ||
| manageTabKey : Boolean
Spécifie si la touche de tabulation est indiquée comme du texte par Text Layout Framework, ou Flash Player ou AIR le gère et le transforme en un événement de panneau à onglet. | Configuration | ||
| overflowPolicy : String
Stratégie utilisée pour déterminer si la dernière ligne d’un conteneur tient dans le conteneur, ou si elle déborde. | Configuration | ||
| releaseLineCreationData : Boolean Demande à ce que le processus de composition de texte émette les données de création de ligne après la composition de chaque paragraphe. | Configuration | ||
| scrollDragDelay : Number
Spécifie un délai entre un défilement et le suivant pour empêcher que le défilement ne soit trop rapide. | Configuration | ||
| scrollDragPixels : Number Spécifie le nombre de pixels par défaut à faire défiler lorsque l’utilisateur initialise le défilement automatique en faisant glisser la sélection. | Configuration | ||
| scrollMouseWheelMultiplier : Number Spécifie le nombre de pixels par défaut à faire défiler pour les événements de molette de la souris. | Configuration | ||
| scrollPagePercentage : Number
Spécifie le pourcentage par défaut d’enchaînement de texte à faire défiler pour faire défiler les pages. | Configuration | ||
| textFlowInitialFormat : flashx.textLayout.formats:ITextLayoutFormat
Spécifie la configuration de format initial TextLayoutFormat pour un enchaînement de texte (objet TextFlow). | Configuration | ||
| unfocusedSelectionFormat : SelectionFormat
Le format de sélection initial utilisé par Text Layout Framework pour tracer la sélection lorsque la fenêtre est active, mais qu’aucun conteneur de l’objet TextFlow n’a le focus. | Configuration | ||
| Méthode | Défini par | ||
|---|---|---|---|
Configuration(initializeWithDefaults:Boolean = true) Constructeur : crée une configuration par défaut. | Configuration | ||
Crée un clone de l’objet Configuration. | Configuration | ||
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
defaultLinkActiveFormat | propriété |
defaultLinkActiveFormat:flashx.textLayout.formats:ITextLayoutFormat| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie les attributs du format de caractère actif qui s’appliquent initialement à tous les liens (objets LinkElement) dans l’enchaînement de texte. Ces valeurs sont les valeurs par défaut pour les nouveaux objets LinkElement qui ne spécifient pas les valeurs de ces attributs.
La valeur par défaut est null.
Implémentation
public function get defaultLinkActiveFormat():flashx.textLayout.formats:ITextLayoutFormat public function set defaultLinkActiveFormat(value:flashx.textLayout.formats:ITextLayoutFormat):voidEléments de l’API associés
defaultLinkHoverFormat | propriété |
defaultLinkHoverFormat:flashx.textLayout.formats:ITextLayoutFormat| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie les attributs de format de caractère initial qui s’appliquent à un lien (LinkElement) dans l’enchaînement de texte lorsque le curseur le survole. Ces valeurs sont les valeurs par défaut pour les nouveaux objets LinkElement qui ne spécifient pas les valeurs de ces attributs.
La valeur par défaut est null.
Implémentation
public function get defaultLinkHoverFormat():flashx.textLayout.formats:ITextLayoutFormat public function set defaultLinkHoverFormat(value:flashx.textLayout.formats:ITextLayoutFormat):voidEléments de l’API associés
defaultLinkNormalFormat | propriété |
defaultLinkNormalFormat:flashx.textLayout.formats:ITextLayoutFormat| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie les attributs du lien initial qui s’appliquent à tous les objets LinkElement dans l’enchaînement de texte. Ces valeurs sont les valeurs par défaut pour les nouveaux objets LinkElement qui ne spécifient pas les valeurs de ces attributs. Le format normal par défaut affiche le lien en bleu souligné.
Implémentation
public function get defaultLinkNormalFormat():flashx.textLayout.formats:ITextLayoutFormat public function set defaultLinkNormalFormat(value:flashx.textLayout.formats:ITextLayoutFormat):voidEléments de l’API associés
defaultListMarkerFormat | propriété |
defaultListMarkerFormat:IListMarkerFormat| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie les attributs de format de caractère actif qui s’appliquent initialement à tous les objets ListItem dans l’enchaînement de texte. Ces valeurs sont les valeurs par défaut pour les nouveaux objets ListItemElements qui ne spécifient pas les valeurs de ces attributs.
La valeur par défaut est null.
Implémentation
public function get defaultListMarkerFormat():IListMarkerFormat public function set defaultListMarkerFormat(value:IListMarkerFormat):voidEléments de l’API associés
enableAccessibility | propriété |
enableAccessibility:Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie si la prise en charge de l’accessibilité est activée ou non. Si la valeur est true, les lecteurs d’écran peuvent lire le contenu de l’objet TextFlow.
La valeur par défaut est false.
Implémentation
public function get enableAccessibility():Boolean public function set enableAccessibility(value:Boolean):voidEléments de l’API associés
flowComposerClass | propriété |
flowComposerClass:Class| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie le type de composeur d’enchaînement à associer à un nouvel objet TextFlow par défaut. La valeur par défaut est StandardFlowComposer.
Implémentation
public function get flowComposerClass():Class public function set flowComposerClass(value:Class):voidEléments de l’API associés
focusedSelectionFormat | propriété |
focusedSelectionFormat:SelectionFormat| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Le format de sélection initial (SelectionFormat) pour un enchaînement de texte (TextFlow) lorsque la fenêtre a le focus. Text Layout Framework utilise le format focusedSelectionFormat pour tracer la sélection lorsque la fenêtre est active et que l’un des conteneurs dans l’objet TextFlow a le focus. Vous pouvez remplacer ce format à l’aide de SelectionManager.focusedSelectionFormat, si vous le souhaitez.
La classe SelectionFormat indique les valeurs par défaut, qui inversent la couleur du texte et de son arrière-plan.
Implémentation
public function get focusedSelectionFormat():SelectionFormat public function set focusedSelectionFormat(value:SelectionFormat):voidEléments de l’API associés
inactiveSelectionFormat | propriété |
inactiveSelectionFormat:SelectionFormat| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Le format de sélection initial (SelectionFormat) pour un enchaînement de texte (TextFlow) lorsque la fenêtre est inactive. Text Layout Framework utilise le format inactiveSelectionFormat pour tracer la sélection lorsque la fenêtre est inactive. Vous pouvez remplacer ce format à l’aide de SelectionManager.inactiveSelectionFormat, si vous le souhaitez.
Si vous ne remplacez pas le format unfocusedSelectionFormat, les valeurs de la classe SelectionFormat utilisées sont :
color = 0xffffff(blanc)alpha = 0blendMode = flash.display.BlendMode.DIFFERENCE
Le résultat est qu’aucune sélection n’est affichée.
Implémentation
public function get inactiveSelectionFormat():SelectionFormat public function set inactiveSelectionFormat(value:SelectionFormat):voidEléments de l’API associés
inlineGraphicResolverFunction | propriété |
inlineGraphicResolverFunction:Function| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie le rappel utilisé pour résoudre un élément graphique intégré. Le rappel prend un objet flashx.textLayout.elements.InlineGraphicElement et renvoie la valeur à utiliser en tant que source flashx.textLayout.elements.InlineGraphicElement#source de l’élément. Ce rappel fournit un mécanisme retardant la mise à disposition de la source de l’élément graphique intégré juste avant sa composition.
Remarque : ce rappel n’est invoqué que si une source d’espace réservé de type String est déjà définie. En outre, il peut être invoqué plusieurs fois.
Implémentation
public function get inlineGraphicResolverFunction():Function public function set inlineGraphicResolverFunction(value:Function):voidEléments de l’API associés
manageEnterKey | propriété |
manageEnterKey:Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie si la touche Entrée/Retour est entrée comme du texte par Text Layout Framework, pour diviser un paragraphe, par exemple, ou le code client qui le gère. Le code client peut gérer cela en enregistrant un formulaire qui a un bouton par défaut à cet effet, par exemple.
La valeur par défaut est true.
Implémentation
public function get manageEnterKey():Boolean public function set manageEnterKey(value:Boolean):voidmanageTabKey | propriété |
manageTabKey:Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie si la touche de tabulation est indiquée comme du texte par Text Layout Framework, ou Flash Player ou AIR le gère et le transforme en un événement de panneau à onglet.
La valeur par défaut est false.
Implémentation
public function get manageTabKey():Boolean public function set manageTabKey(value:Boolean):voidoverflowPolicy | propriété |
overflowPolicy:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Stratégie utilisée pour déterminer si la dernière ligne d’un conteneur tient dans le conteneur, ou si elle déborde. Utilisez les valeurs constantes de la classe OverflowPolicy pour définir cette propriété.
La valeur par défaut est OverflowPolicy.FIT_DESCENDERS, qui s’adapte à la ligne dans la zone de composition si la zone à partir du haut de la ligne de base est adaptée.
Implémentation
public function get overflowPolicy():String public function set overflowPolicy(value:String):voidEléments de l’API associés
releaseLineCreationData | propriété |
releaseLineCreationData:Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Demande à ce que le processus de composition de texte émette les données de création de ligne après la composition de chaque paragraphe. Cette demande économise de la mémoire mais ralentit le processus de composition.
La valeur par défaut est false.
Implémentation
public function get releaseLineCreationData():Boolean public function set releaseLineCreationData(value:Boolean):voidEléments de l’API associés
scrollDragDelay | propriété |
scrollDragDelay:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie un délai entre un défilement et le suivant pour empêcher que le défilement ne soit trop rapide. Cette valeur indique ce que le délai doit être en millisecondes. La valeur par défaut est 35.
Implémentation
public function get scrollDragDelay():Number public function set scrollDragDelay(value:Number):voidscrollDragPixels | propriété |
scrollDragPixels:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie le nombre de pixels par défaut à faire défiler lorsque l’utilisateur initialise le défilement automatique en faisant glisser la sélection. La valeur par défaut est 20.
Implémentation
public function get scrollDragPixels():Number public function set scrollDragPixels(value:Number):voidscrollMouseWheelMultiplier | propriété |
scrollMouseWheelMultiplier:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie le nombre de pixels par défaut à faire défiler pour les événements de molette de la souris. La valeur par défaut est 20.
Implémentation
public function get scrollMouseWheelMultiplier():Number public function set scrollMouseWheelMultiplier(value:Number):voidscrollPagePercentage | propriété |
scrollPagePercentage:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie le pourcentage par défaut d’enchaînement de texte à faire défiler pour faire défiler les pages. La valeur par défaut est 7,0 / 8,0 ou ,875.
Implémentation
public function get scrollPagePercentage():Number public function set scrollPagePercentage(value:Number):voidtextFlowInitialFormat | propriété |
textFlowInitialFormat:flashx.textLayout.formats:ITextLayoutFormat| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie la configuration de format initial TextLayoutFormat pour un enchaînement de texte (objet TextFlow).
La valeur par défaut est null.
Implémentation
public function get textFlowInitialFormat():flashx.textLayout.formats:ITextLayoutFormat public function set textFlowInitialFormat(value:flashx.textLayout.formats:ITextLayoutFormat):voidEléments de l’API associés
unfocusedSelectionFormat | propriété |
unfocusedSelectionFormat:SelectionFormat| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Le format de sélection initial utilisé par Text Layout Framework pour tracer la sélection lorsque la fenêtre est active, mais qu’aucun conteneur de l’objet TextFlow n’a le focus. Vous pouvez remplacer ce format à l’aide de SelectionManager.unfocusedSelectionFormat, si vous le souhaitez.
Si vous ne remplacez pas le format unfocusedSelectionFormat, les valeurs de la classe SelectionFormat utilisées sont :
color = 0xffffff(blanc)alpha = 0blendMode = flash.display.BlendMode.DIFFERENCE
Le résultat est qu’aucune sélection n’est affichée.
Implémentation
public function get unfocusedSelectionFormat():SelectionFormat public function set unfocusedSelectionFormat(value:SelectionFormat):voidEléments de l’API associés
Configuration | () | Constructeur |
public function Configuration(initializeWithDefaults:Boolean = true)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur : crée une configuration par défaut.
ParamètresinitializeWithDefaults:Boolean (default = true)true. Si définie sur false, s’initialise sans les valeurs par défaut, épargnant ainsi certains objets. La méthode clone() définit cette valeur sur false et copie les propriétés de l’objet d’origine.
|
Eléments de l’API associés
clone | () | méthode |
public function clone():Configuration| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Crée un clone de l’objet Configuration.
Valeur renvoyéeConfiguration |
hasTouchScreen | Constante |
tlf_internal static const hasTouchScreen:Boolean
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();
}
}
}
Tue Jun 12 2018, 09:30 AM Z