ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flashx.textLayout.factory 

StringTextLineFactory  - AS3

Paketflashx.textLayout.factory
Klassepublic class StringTextLineFactory
VererbungStringTextLineFactory Inheritance TextLineFactoryBase Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die StringTextLineFactory-Klasse stellt eine einfache Methode zur Erstellung von TextLines aus einem String bereit.

Die Textzeilen sind statisch und werden mithilfe eines einzelnen Formats und eines einzelnen Absatzes erstellt. Die Zeilen werden so erstellt, dass sie in das angegebene Begrenzungsrechteck passen.

Die StringTextLineFactory stellt eine effiziente Methode zur Erstellung von TextLines bereit, da einzelne TextFlow-, ParagraphElement-, SpanElement- und ContainerController-Objekte für zahlreiche wiederholte Aufrufe wiederverwendet werden. Sie können eine einzelne Factory erstellen und immer wieder verwenden. Außerdem können Sie die gleichartigen Teile bei jedem Aufruf erneut verwenden, z. B. können Sie die verschiedenen Formate und Begrenzungen neu verwenden.

Hinweis: Um statische Zeilen zu erstellen, die mehrere Formate oder Absätze verwenden oder Inline-Grafiken enthalten, verwenden Sie eine TextFlowTextLineFactory und ein TextFlow-Objekt.

Hinweis: StringTextLineFactory ignoriert die truncationIndicatorFormat-Eigenschaft, die in den truncationOptions festgelegt wurde, beim Kürzen von Text.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedcompositionBounds : Rectangle
Das Rechteck, in dem Textzeilen erstellt werden.
TextLineFactoryBase
  configuration : IConfiguration
[schreibgeschützt] Die vom internen TextFlow-Objekt verwendete Konfiguration.
StringTextLineFactory
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  defaultConfiguration : IConfiguration
[statisch] [schreibgeschützt] Die von dieser Factory verwendete Standardkonfiguration, falls keine angegeben ist.
StringTextLineFactory
 InheritedhorizontalScrollPolicy : String
Gibt an, wie Zeilen erstellt werden, wenn die zusammengesetzten Grenzen nicht groß genug sind.
TextLineFactoryBase
 InheritedisTruncated : Boolean
[schreibgeschützt] Gibt an, ob bei der letzten Erstellung von Zeilen Text gekürzt wurde.
TextLineFactoryBase
  paragraphFormat : flashx.textLayout.formats:ITextLayoutFormat
Das Absatzformat.
StringTextLineFactory
  spanFormat : flashx.textLayout.formats:ITextLayoutFormat
Das Zeichenformat.
StringTextLineFactory
 InheritedswfContext : ISWFContext
Die ISWFContext-Instanz für ggf. notwendige FTE-Aufrufe.
TextLineFactoryBase
  text : String
Der in TextLine-Objekte zu konvertierende Text.
StringTextLineFactory
  textFlowFormat : flashx.textLayout.formats:ITextLayoutFormat
Das Textflussformat.
StringTextLineFactory
 InheritedtruncationOptions : flashx.textLayout.factory:TruncationOptions
Gibt die Optionen zum Kürzen von Text an, falls der Text nicht in die zusammengesetzten Grenzen passt.
TextLineFactoryBase
 InheritedverticalScrollPolicy : String
Gibt an, wie Zeilen erstellt werden, wenn die zusammengesetzten Grenzen nicht groß genug sind.
TextLineFactoryBase
Öffentliche Methoden
 MethodeDefiniert von
  
Erstellt ein StringTextLineFactory-Objekt.
StringTextLineFactory
  
Erstellt TextLine-Objekte mithilfe des Texts, der derzeit dem Factory-Objekt zugewiesen ist.
StringTextLineFactory
 Inherited
Das kleinste Rechteck, in das der formatierte Inhalt passt.
TextLineFactoryBase
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

configuration

Eigenschaft
configuration:IConfiguration  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die vom internen TextFlow-Objekt verwendete Konfiguration.



Implementierung
    public function get configuration():IConfiguration

defaultConfiguration

Eigenschaft 
defaultConfiguration:IConfiguration  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die von dieser Factory verwendete Standardkonfiguration, falls keine angegeben ist.



Implementierung
    public static function get defaultConfiguration():IConfiguration

paragraphFormat

Eigenschaft 
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Das Absatzformat.



Implementierung
    public function get paragraphFormat():flashx.textLayout.formats:ITextLayoutFormat
    public function set paragraphFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

spanFormat

Eigenschaft 
spanFormat:flashx.textLayout.formats:ITextLayoutFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Das Zeichenformat.



Implementierung
    public function get spanFormat():flashx.textLayout.formats:ITextLayoutFormat
    public function set spanFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

text

Eigenschaft 
text:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Der in TextLine-Objekte zu konvertierende Text.

Um TextLines zu erstellen, rufen Sie createTextLines() auf, nachdem Sie die text-Eigenschaft und die gewünschten Formate festgelegt haben.



Implementierung
    public function get text():String
    public function set text(value:String):void

textFlowFormat

Eigenschaft 
textFlowFormat:flashx.textLayout.formats:ITextLayoutFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Das Textflussformat.



Implementierung
    public function get textFlowFormat():flashx.textLayout.formats:ITextLayoutFormat
    public function set textFlowFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void
Konstruktordetails

StringTextLineFactory

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Erstellt ein StringTextLineFactory-Objekt.

Parameter
configuration:IConfiguration (default = null) — Das zum Festlegen der Eigenschaften des internen TextFlow-Objekts verwendete Konfigurationsobjekt, das zum Zusammenstellen von Zeilen verwendet wird, die von dieser Factory erstellt wurden.
Methodendetails

createTextLines

()Methode
public function createTextLines(callback:Function):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Erstellt TextLine-Objekte mithilfe des Texts, der derzeit dem Factory-Objekt zugewiesen ist.

Die Textzeilen werden mithilfe des derzeit zugewiesenen Texts und Formats erstellt und werden so zusammengestellt, dass sie in die von der compositionBounds-Eigenschaft zugewiesenen Abgrenzungen passen. Bei der Erstellung der Zeilen ruft die Factory die im callback-Parameter festgelegte Funktion auf. Das TextLine-Objekt wird an diese Funktion übergeben und diese steuert die Anzeige der Zeile.

Um einen anderen Zeilensatz zu erstellen, ändern Sie die gewünschten Eigenschaften und rufen createTextLines() erneut auf.

Beachten Sie, dass die Bildlaufrichtlinien der Factory steuern, wie viele Zeilen generiert werden.

Parameter

callback:Function — Die für jedes erstellte TextLine-Objekt aufgerufene Rückruffunktion.

StringTextLineFactory_example.as

Das folgende Beispiel verwendet die StringTextLineFactory, um einen Textzeilensatz aus einem String zu erstellen. Die Factory-Methode createTextLines() wird zweimal mithilfe der gleichen Zeile aufgerufen. Die Factory-Eigenschaften werden zwischen Aufrufen angepasst, um einen Schlagschatteneffekt zu erstellen.
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 ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.