Package | flashx.textLayout.factory |
Classe | public class StringTextLineFactory |
Héritage | StringTextLineFactory TextLineFactoryBase Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
compositionBounds : 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 | ||
constructor : 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 | ||
horizontalScrollPolicy : String
Spécifie comment les lignes sont créées lorsque les limites de composition ne sont pas assez grandes. | TextLineFactoryBase | ||
isTruncated : 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 | ||
swfContext : 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 | ||
truncationOptions : flashx.textLayout.factory:TruncationOptions
Indique les options de troncation de texte s’il ne correspond pas aux limites de composition. | TextLineFactoryBase | ||
verticalScrollPolicy : String
Spécifie comment les lignes sont créées lorsque les limites de composition ne sont pas assez grandes. | TextLineFactoryBase |
Méthode | Défini par | ||
---|---|---|---|
StringTextLineFactory(configuration:IConfiguration = null)
Crée un objet StringTextLineFactory. | StringTextLineFactory | ||
Crée des objets TextLine en utilisant le texte actuellement affecté à cet objet de fabrique. | StringTextLineFactory | ||
Plus petit rectangle dans lequel le contenu mis en forme s’adapte. | TextLineFactoryBase | ||
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 |
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
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ètresconfiguration: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.
|
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éé.
|
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 ); } } }
Tue Jun 12 2018, 09:30 AM Z