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...
flash.text.engine 

SpaceJustifier  - AS3

Paketflash.text.engine
Klassepublic final class SpaceJustifier
VererbungSpaceJustifier Inheritance TextJustifier Inheritance Object

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

Die SpaceJustifier-Klasse repräsentiert Eigenschaften, die die Blocksatzoptionen für die Textzeilen in einem Textblock steuern.

Bevor Sie die Eigenschaften eines SpaceJustifier-Objekts einstellen können, erstellen Sie das Objekt mithilfe des Konstruktors new SpaceJustifier(). Das Einstellen der Eigenschaften eines SpaceJustifier-Objekts, nachdem Sie es auf einen TextBlock angewendet haben, macht den TextBlock nicht ungültig.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  letterSpacing : Boolean
Gibt an, ob Zeichenabstand während der Ausrichtung verwendet werden soll.
SpaceJustifier
 InheritedlineJustification : String
Gibt die Zeilenausrichtung im Blocksatz für den Text in einem Textblock an.
TextJustifier
 Inheritedlocale : String
[schreibgeschützt] Gibt das Gebietsschema an, das die Blocksatzregeln für den Text in einem Textblock bestimmt.
TextJustifier
  maximumSpacing : Number
Legt den maximalen Abstand (als Vielfaches der Breite einer normalen Leerstelle) zwischen Wörtern fest, der beim Blocksatz verwendet wird.
SpaceJustifier
  minimumSpacing : Number
Legt den Mindestabstand (als Vielfaches der Breite einer normalen Leerstelle) zwischen Wörtern fest, der beim Blocksatz verwendet wird.
SpaceJustifier
  optimumSpacing : Number
Legt den optimalen Abstand (als Vielfaches der Breite einer normalen Leerstelle) zwischen Wörtern fest, der beim Blocksatz verwendet wird.
SpaceJustifier
Öffentliche Methoden
 MethodeDefiniert von
  
SpaceJustifier(locale:String = "en", lineJustification:String = "unjustified", letterSpacing:Boolean = false)
Erstellt ein SpaceJustifier-Objekt.
SpaceJustifier
  
[override] Erstellt eine geklonte Kopie von SpaceJustifier.
SpaceJustifier
 Inherited
[statisch] Erstellt eine standardmäßige TextJustifier-Unterklasse, die für das angegebene Gebietsschema geeignet ist.
TextJustifier
 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

letterSpacing

Eigenschaft
letterSpacing:Boolean

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

Gibt an, ob Zeichenabstand während der Ausrichtung verwendet werden soll.

Der Standardwert ist false



Implementierung
    public function get letterSpacing():Boolean
    public function set letterSpacing(value:Boolean):void

maximumSpacing

Eigenschaft 
maximumSpacing:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2

Legt den maximalen Abstand (als Vielfaches der Breite einer normalen Leerstelle) zwischen Wörtern fest, der beim Blocksatz verwendet wird. Wenn letterSpacing den Wert true hat, wird nach den Abständen zwischen den Wörtern der Sperrsatz verwendet, bis der Höchstwert erreicht ist. Wenn letterSpacing den Wert false hat, werden die Abstände zwischen den Wörtern über den Höchstwert hinaus vergrößert.

Der Standardwert ist 1.5



Implementierung
    public function get maximumSpacing():Number
    public function set maximumSpacing(value:Number):void

Auslöser
ArgumentError — Der angegebene value ist kleiner als optimumSpacing.

minimumSpacing

Eigenschaft 
minimumSpacing:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2

Legt den Mindestabstand (als Vielfaches der Breite einer normalen Leerstelle) zwischen Wörtern fest, der beim Blocksatz verwendet wird.

Der Standardwert ist 0.5



Implementierung
    public function get minimumSpacing():Number
    public function set minimumSpacing(value:Number):void

Auslöser
ArgumentError — Der angegebene value ist kleiner als null oder größer als optimumSpacing.

optimumSpacing

Eigenschaft 
optimumSpacing:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2

Legt den optimalen Abstand (als Vielfaches der Breite einer normalen Leerstelle) zwischen Wörtern fest, der beim Blocksatz verwendet wird.

Der Standardwert ist 1,0



Implementierung
    public function get optimumSpacing():Number
    public function set optimumSpacing(value:Number):void

Auslöser
ArgumentError — Der angegebene value ist kleiner als minimumSpacing oder größer als maximumSpacing.
Konstruktordetails

SpaceJustifier

()Konstruktor
public function SpaceJustifier(locale:String = "en", lineJustification:String = "unjustified", letterSpacing:Boolean = false)

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

Erstellt ein SpaceJustifier-Objekt. Die LineJustification-Klasse enthält Konstanten für die Angabe der Zeilenausrichtungstypen, die Sie anwenden können.

Parameter
locale:String (default = "en") — Das Gebietsschema, das die Regeln für den Blocksatz bestimmt. Der Standardwert ist "en".
 
lineJustification:String (default = "unjustified") — Der Typ der Zeilenausrichtung im Blocksatz für den Text in einem Textblock. Verwenden Sie LineJustification-Konstanten für diese Eigenschaft. Der Standardwert ist LineJustification.UNJUSTIFIED.
 
letterSpacing:Boolean (default = false) — Gibt an, ob Zeichenabstand während der Ausrichtung verwendet werden soll. Der Standardwert ist false.

Auslöser
ArgumentError — Die angegebene locale ist entweder null oder zu kurz, um ein gültiges Gebietsschema anzugeben.
 
ArgumentError — Die angegebene lineJustification ist kein Mitglied von LineJustification.

Verwandte API-Elemente

Methodendetails

clone

()Methode
override public function clone():flash.text.engine:TextJustifier

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

Erstellt eine geklonte Kopie von SpaceJustifier.

Rückgabewerte
flash.text.engine:TextJustifier — Eine Kopie des SpaceJustifier-Objekts.
SpaceJustifierExample.as

Im folgenden Beispiel wird der Zeichenabstand verwendet und ein Textblock mit Ausnahme der letzten Zeile im Blocksatz ausgerichtet.
package {
    import flash.display.Sprite;
    import flash.text.engine.TextBlock;
    import flash.text.engine.TextElement;
    import flash.text.engine.TextLine;
    import flash.text.engine.ElementFormat;
    import flash.text.engine.SpaceJustifier;
    import flash.text.engine.LineJustification;
    
    public class SpaceJustifierExample extends Sprite {
        
        public function SpaceJustifierExample():void {
            var str:String = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, " +
            "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut " +
            "enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut " +
            "aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit " +
            "in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur " +
            "sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt " +
            "mollit anim id est laborum.";
            
            var format:ElementFormat = new ElementFormat(null, 12, 0xCC0000);
            var textElement:TextElement = new TextElement(str, format);
            var spaceJustifier:SpaceJustifier = new SpaceJustifier("en", LineJustification.ALL_BUT_LAST);
            spaceJustifier.letterSpacing = true;
            var textBlock:TextBlock = new TextBlock();
            textBlock.content = textElement;
            textBlock.textJustifier = spaceJustifier;
            createLines(textBlock);
        }
        
        private function createLines(textBlock:TextBlock):void {
        
            var yPos = 20;
            var textLine:TextLine = textBlock.createTextLine (null, 150);
 
            while (textLine)
            {
                addChild(textLine);
                textLine.x = 15;
                yPos += textLine.textHeight+2;
                textLine.y = yPos;
                textLine = textBlock.createTextLine(textLine, 150);
            }        
        }
    }
}




[ 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.