Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
flashx.textLayout.factory 

StringTextLineFactory  - AS3

Packageflashx.textLayout.factory
Classepublic class StringTextLineFactory
HéritageStringTextLineFactory Inheritance TextLineFactoryBase Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

La classe StringTextLineFactory permet de créer simplement des objets TextLine à partir d’une chaîne.

Les lignes de texte sont statiques et sont créées à l’aide d’un seul format et un seul paragraphe. Les lignes sont créées pour correspondre au rectangle de délimitation spécifié.

La classe StringTextLineFactory permet de créer des objets TextLine de façon efficace, car elle réutilise des objets TextFlow, ParagraphElement, SpanElement et ContainerController uniques sur toutes les invocations répétées. Vous pouvez créer une fabrique unique et la réutiliser de façon répétée. Vous pouvez également réutiliser toutes les parties qui sont identiques à chaque appel. Par exemple, vous pouvez réutiliser les divers formats et les limites.

Remarque : pour créer des lignes statiques qui utilisent plusieurs formats ou paragraphes, ou qui comprennent des graphiques intégrés, utilisez une classe TextFlowTextLineFactory et un objet TextFlow.

Remarque : la classe StringTextLineFactory ne tient pas compte de la propriété truncationIndicatorFormat définie dans truncationOptions lors de la troncature du texte.

Consulter les exemples

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 InheritedcompositionBounds : Rectangle
Rectangle dans lequel sont créées les lignes de texte.
TextLineFactoryBase
  configuration : IConfiguration
[lecture seule] Configuration utilisée par l’objet TextFlow interne.
StringTextLineFactory
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  defaultConfiguration : IConfiguration
[statique] [lecture seule] Configuration par défaut qui est utilisée par cette fabrique si aucune n’est spécifiée.
StringTextLineFactory
 InheritedhorizontalScrollPolicy : String
Spécifie comment les lignes sont créées lorsque les limites de composition ne sont pas assez grandes.
TextLineFactoryBase
 InheritedisTruncated : Boolean
[lecture seule] Indique si le texte a été tronqué lors de la dernière création de lignes.
TextLineFactoryBase
  paragraphFormat : flashx.textLayout.formats:ITextLayoutFormat
Format de paragraphe.
StringTextLineFactory
  spanFormat : flashx.textLayout.formats:ITextLayoutFormat
Format de caractère.
StringTextLineFactory
 InheritedswfContext : ISWFContext
L’occurrence ISWFContext utilisée pour effectuer des appels FTE le cas échéant.
TextLineFactoryBase
  text : String
Texte à convertir en objets TextLine.
StringTextLineFactory
  textFlowFormat : flashx.textLayout.formats:ITextLayoutFormat
Format de l’enchaînement de texte.
StringTextLineFactory
 InheritedtruncationOptions : flashx.textLayout.factory:TruncationOptions
Indique les options de troncation de texte s’il ne correspond pas aux limites de composition.
TextLineFactoryBase
 InheritedverticalScrollPolicy : String
Spécifie comment les lignes sont créées lorsque les limites de composition ne sont pas assez grandes.
TextLineFactoryBase
Méthodes publiques
 MéthodeDéfini par
  
Crée un objet StringTextLineFactory.
StringTextLineFactory
  
Crée des objets TextLine en utilisant le texte actuellement affecté à cet objet de fabrique.
StringTextLineFactory
 Inherited
Plus petit rectangle dans lequel le contenu mis en forme s’adapte.
TextLineFactoryBase
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Détails de la propriété

configuration

propriété
configuration:IConfiguration  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Configuration utilisée par l’objet TextFlow interne.



Implémentation
    public function get configuration():IConfiguration

defaultConfiguration

propriété 
defaultConfiguration:IConfiguration  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Configuration par défaut qui est utilisée par cette fabrique si aucune n’est spécifiée.



Implémentation
    public static function get defaultConfiguration():IConfiguration

paragraphFormat

propriété 
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Format de paragraphe.



Implémentation
    public function get paragraphFormat():flashx.textLayout.formats:ITextLayoutFormat
    public function set paragraphFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

spanFormat

propriété 
spanFormat:flashx.textLayout.formats:ITextLayoutFormat

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Format de caractère.



Implémentation
    public function get spanFormat():flashx.textLayout.formats:ITextLayoutFormat
    public function set spanFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

text

propriété 
text:String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Texte à convertir en objets TextLine.

Pour générer des objets TextLine, appelez la méthode createTextLines() après avoir défini cette propriété text et les formats requis.



Implémentation
    public function get text():String
    public function set text(value:String):void

textFlowFormat

propriété 
textFlowFormat:flashx.textLayout.formats:ITextLayoutFormat

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Format de l’enchaînement de texte.



Implémentation
    public function get textFlowFormat():flashx.textLayout.formats:ITextLayoutFormat
    public function set textFlowFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void
Détails du constructeur

StringTextLineFactory

()Constructeur
public function StringTextLineFactory(configuration:IConfiguration = null)

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Crée un objet StringTextLineFactory.

Paramètres
configuration:IConfiguration (default = null) — Objet de configuration utilisé pour définir les propriétés de l’objet TextFlow interne qui a permis de composer les lignes produites par cette fabrique.
Détails de la méthode

createTextLines

()méthode
public function createTextLines(callback:Function):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Crée des objets TextLine en utilisant le texte actuellement affecté à cet objet de fabrique.

Les lignes de texte sont créées à l’aide du texte et des formats actuellement affectés et sont composées de façon à correspondre aux limites affectées à la propriété compositionBounds. A mesure que chaque ligne est créée, la fabrique appelle la fonction spécifiée dans le paramètre callback. Cette fonction est transmise à l’objet TextLine et est chargée d’afficher la ligne.

Pour créer un ensemble de lignes différent, modifiez les propriétés requises et rappelez la méthode createTextLines().

Notez que les stratégies de défilement de la fabrique vont contrôler le nombre de lignes qui sont générées.

Paramètres

callback:Function — Fonction de rappel appelée pour chaque objet TextLine créé.

StringTextLineFactory_example.as

L’exemple suivant utilise la classe StringTextLineFactory pour créer un ensemble de lignes de texte à partir d’une chaîne. La méthode de fabrique, createTextLines(), est appelée deux fois à l’aide de la même expression. Les propriétés de fabrique sont ajustées entre chaque appel afin de créer un effet en « ombre portée ».
package flashx.textLayout.factory.examples {
    import flash.display.DisplayObject;
    import flash.display.Sprite;
    import flash.geom.Rectangle;
    
    import flashx.textLayout.factory.StringTextLineFactory;
    import flashx.textLayout.formats.TextLayoutFormat;

    public class StringTextLineFactory_example extends Sprite
    {
        public function StringTextLineFactory_example()
        {
            var factory:StringTextLineFactory = new StringTextLineFactory();
            factory.compositionBounds = new Rectangle( 100, 100, 200, 130 );
            var format:TextLayoutFormat = new TextLayoutFormat();
            format.fontFamily = "LilyUPC, Verdana, _sans";
            format.fontSize = 32;
            format.color = 0x000000;
            format.textAlpha = .5;
            factory.spanFormat = format;
            
            factory.text = "The quick brown fox jumped over the lazy dog.";
            factory.createTextLines( useTextLines );
            
            factory.compositionBounds = new Rectangle( 99, 99, 200, 130 );
            format.color = 0x990000;
            format.textAlpha = 1;
            factory.spanFormat = format;
            factory.createTextLines( useTextLines );
            
            graphics.beginFill(0x555555,.5);
            graphics.drawRect( 99, 99, 201, 131 );
            graphics.endFill();

        }
        
        private function useTextLines( line:DisplayObject ):void
        {
            var displayObject:DisplayObject = this.addChild( line );
        }
    }
}




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.