ElementFormat  - AS3

Gibt den Typ der Grundlinie im enthaltenden Element an, mit der die dominanten Grundlinien von Elementen mit diesem Format ausgerichtet werden. Verwenden Sie TextBaseline-Konstanten für diese Eigenschaft.

Das größte vertikale Element in der Zeile bestimmt die Ausrichtung der Grundlinie, es sei denn, dieser Grundsatz wird durch die Festsetzung von TextBlock.baselineFontDescription und TextBlock.baselineFontSize aufgehoben.

Der Standardwert ist TextBaseline.USE_DOMINANT_BASELINE.

Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:

Verwandte API-Elemente

Gibt die Transparenz der Linienelemente an, die von diesem Objekt betroffen sind. Die zulässigen Werte liegen zwischen 0 (vollständig transparent) und 1 (vollständig undurchsichtig). Anzeigeobjekte mit einem alpha-Wert von 0 sind aktiv, auch wenn sie nicht sichtbar sind.

Der Standardwert ist 1.

Verwandte API-Elemente

Gibt die Grundlinienverschiebung für das Element in Pixeln an.

Das Element wird um diesen Betrag von der dominantBaseline verschoben. Die Verschiebung wird der y-Position der Mitglieder des Elements hinzugefügt, sodass in nicht gedrehtem Text eine positive Grundlinienverschiebung das Element nach unten verschiebt und eine negative Grundlinienverschiebung das Element nach oben verschiebt.

Der Standardwert ist 0,0, was bedeutet, das keine Verschiebung erfolgt.

Die Zeilenumbruchmöglichkeit, die auf diesen Text angewendet wird. Diese Eigenschaft bestimmt, welche Zeichen für einen Umbruch in Frage kommen, wenn Text über mehrere Zeilen verteilt wird. Verwenden Sie BreakOpportunity-Konstanten für diese Eigenschaft.

Der Standardwert lautet BreakOpportunity.AUTO.

Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:

Verwandte API-Elemente

Gibt die Textfarbe an. Eine Ganzzahl mit drei 8-Bit-RGB-Komponenten; 0xFF0000 ist beispielsweise Rot und 0x00FF00 ist Grün.

Der Standardwert lautet 0x000000, was schwarz ist.

Die Ziffernschreibweise, die für diesen Text verwendet wird. Die Ziffernschreibweise wirkt sich auf den Stil und die Platzierung von numerischen Zeichengruppen aus. Verwenden Sie DigitCase-Konstanten für diese Eigenschaft.

Der Standardwert lautet DigitCase.DEFAULT.

Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:

Verwandte API-Elemente

Die Ziffernbreite, die für diesen Text verwendet wird. Verwenden Sie DigitWidth-Konstanten für diese Eigenschaft.

Der Standardwert lautet DigitWidth.DEFAULT.

Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:

Verwandte API-Elemente

Gibt den Typ der Grundlinie an, die als dominante Grundlinie verwendet wird. Die dominante Grundlinie wird mit der Ausrichtungsgrundlinie ausgerichtet, um die vertikale Position des Elements in der Zeile zu bestimmen. Verwenden Sie TextBaseline-Konstanten für diese Eigenschaft.

Der Inhalt des Elements bestimmt die Grundlinien. Bei einem TextElement bestimmen Schriftart und Schriftgrad die Grundlinien. Bei einem GraphicElement bestimmt die Höhe des Elements die Grundlinien.

Der Standardwert ist TextBaseline.ROMAN.

Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:

Verwandte API-Elemente

Ein Objekt, dessen Eigenschaften eine Schriftart beschreiben.

Der Standardwert ist ein standardmäßig konstruiertes FontDescription-Objekt.

Wenn die fontDescription-Eigenschaft eingestellt ist, ist das bereitgestellte FontDescription-Objekt gesperrt, d. h. seine lockedEigenschaft ist auf true eingestellt. Ein gesperrtes FontDescription-Objekt kann nicht geändert werden.

Verwandte API-Elemente

Die Größe des Texts in Pixeln.

Der Standardwert ist 12,0.

Beim Kerning werden die Pixel zwischen bestimmten Zeichenpaaren angepasst, um die Lesbarkeit zu verbessern. Kerning wird für alle Schriftarten unterstützt, die über Kerningtabellen verfügen.

Der Standardwert lautet Kerning.ON.

Um Werte für diese Eigenschaft festzulegen, verwenden Sie die folgenden Konstanten in der Kerning-Klasse:

Verwandte API-Elemente

Die Ligaturstufe, die für diesen Text verwendet wird. Als Ligatur bezeichnet man zwei oder Buchstabenformen, die zu einer einzelnen Glyphe verbunden werden. Ligaturen ersetzen in der Regel aufeinanderfolgende Zeichen, die gemeinsame Komponenten aufweisen, beispielsweise die Buchstabenpaare fi, fl und ae. Sie werden sowohl für lateinische als auch nicht-lateinische Zeichensätze verwendet. Verwenden Sie LigatureLevel-Konstanten für diese Eigenschaft.

Der Standardwert lautet LigatureLevel.COMMON.

Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:

Verwandte API-Elemente

Das Gebietsschema des Texts. Steuert die Transformation und Form von Groß- und Kleinschreibung. Es werden Standardkennzeichner für Gebietsschemas verwendet. So sind „en“, „en_US“ und „en-US“ zum Beispiel alle Englisch, „ja“ ist Japanisch. Eine Liste der Gebietsschemacodes finden Sie unter iso639-2 code list.

Der Standardwert ist "en".

Gibt an, ob das ElementFormat gesperrt ist. Falls der Wert true lautet, kann ElementFormat nicht geändert werden. Rufen Sie ElementFormat.clone() auf, um eine nicht gesperrte Kopie des ElementFormat-Objekts zu erstellen.

Legt die Drehung fest, die auf einzelne Glyphen angewendet wird. Verwenden Sie für diese Eigenschaft die in der TextRotation-Klasse definierten Konstanten.

Der Standardwert lautet TextRotation.AUTO.

Die endgültige Drehung jeder Glyphe ist die Summe von ElementFormat.textRotation, ContentElement.textRotation und TextBlock.lineRotation.

Sie verwenden diese Eigenschaft typischerweise für asiatischen Text, in dem Zeichen für die korrekte Anzeige im vertikalen Layout gedreht werden müssen. Verwenden Sie TextRotation.AUTO zusammen mit TextBlock.lineRotation = TextRotation.ROTATE_90, um dies zu erreichen.

Wenn Sie diese Eigenschaft für Schriftarten einstellen, die keine Informationen zu vertikalem Layout enthalten, kann dies zu unerwünschten Ergebnissen führen. Schriftarten, wie die japanische Schrift MS Mincho, die eine vmtx- oder VORG-Tabelle enthalten, funktionieren ordnungsgemäß, da diese Tabellen die Daten bereitstellen, die die Layout-Engine für das richtige Layout benötigt. Bei Schriftarten wie Verdana, die die notwendigen Informationen nicht erhalten, ist dies hingegen nicht der Fall.

Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:

Verwandte API-Elemente

Die Laufweite bzw. manuelles Kerning, das links neben jeder Glyphe angewendet wird, als Pixelwert. Wenn kerning aktiviert ist, wird der trackingLeft-Wert den Werten in der Kerningtabelle dieser Schriftart hinzugefügt. Wenn kerning deaktiviert ist, wird der trackingLeft-Wert als manueller Kerningwert verwendet. Unterstützt sowohl positive als auch negative Werte.

Der gewünschte Laufweitenwert wird in der Regel auf trackingRight und trackingLeft aufgeteilt. In Text mit gemischter Direktionalität tritt ansonsten an der einen bidirektionalen Grenze eine doppelte Laufweite auf und an der anderen Grenze keine.

Der Standardwert ist 0,0.

Beispiel:

          //positive tracking added to kerning
          var ef1:ElementFormat = new ElementFormat();
          ef1.kerning = flash.text.engine.Kerning.ON;
          ef1.trackingLeft = 0.5;
     
          //negative manual kerning
          var ef2:ElementFormat = new ElementFormat();
          ef2.kerning = flash.text.engine.Kerning.OFF;
          ef2.trackingLeft = -1.0;
     

Die Laufweite bzw. manuelles Kerning, das rechts neben jeder Glyphe angewendet wird, als Pixelwert. Wenn kerning aktiviert ist, wird der trackingRight-Wert den Werten in der Kerningtabelle dieser Schriftart hinzugefügt. Wenn kerning deaktiviert ist, wird der trackingRight-Wert als manueller Kerningwert verwendet. Unterstützt sowohl positive als auch negative Werte.

Der gewünschte Laufweitenwert wird in der Regel auf trackingRight und trackingLeft aufgeteilt. In Text mit gemischter Direktionalität tritt ansonsten an der einen bidirektionalen Grenze eine doppelte Laufweite auf und an der anderen Grenze keine.

Der Standardwert ist 0,0.

Beispiel:

          //positive tracking added to kerning
          var ef1:ElementFormat = new ElementFormat();
          ef1.kerning = flash.text.engine.Kerning.ON;
          ef1.trackingRight = 0.5;
     
          //negative manual kerning
          var ef2:ElementFormat = new ElementFormat();
          ef2.kerning = flash.text.engine.Kerning.OFF;
          ef2.trackingRight = -1.0;
     

Die Groß-/Kleinschreibung, die für diesen Text verwendet wird. Verwenden Sie für diese Eigenschaft die in der TypographicCase-Klasse definierten Konstanten.

Der Standardwert lautet TypographicCase.DEFAULT.

Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:

Verwandte API-Elemente

Erstellt ein ElementFormat-Objekt.

Erstellt eine nicht gesperrte geklonte Kopie von ElementFormat.

package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class ElementFormat_cloneExample extends Sprite {
        private var ef1:ElementFormat;
        private var ef2:ElementFormat;
        
        public function ElementFormat_cloneExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
            fd.fontName = "Palatino";

            var ef1:ElementFormat = new ElementFormat(fd);
            ef1.fontSize=20;
            
            var str:String = "This is flash text 0123456789";
            var tb:TextBlock = new TextBlock();
            var te1:TextElement = new TextElement(str, ef1);
            tb.content = te1;
            var line1:TextLine = tb.createTextLine(null, 600);
            addChild(line1);
            
            ef2 = (ef1.locked) ? ef1.clone() : ef1;    
            ef2.fontSize = 32;

            tb.content.elementFormat=ef2;
            var line2:TextLine = tb.createTextLine(null, 600);
            addChild(line2);
            
        }
    }    
}

Gibt ein FontMetrics-Objekt mit Eigenschaften zurück, die die emBox, die Position der Durchstreichen-Linie, die Stärke der Durchstreichen-Linie, die Position der Unterstreichen-Linie und die Stärke der Unterstreichen-Linie für die mit fontDescription und fontSize angegebene Schriftart beschreiben.

Verwandte API-Elemente

package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class FontMetricsExample extends Sprite {
        
        public function FontMetricsExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontName = "Garamond";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;

            var ef1:ElementFormat = new ElementFormat(fd);
            ef1.fontSize = 24;            
            var fm1:FontMetrics = ef1.getFontMetrics();

            trace(fm1.emBox);
            trace(fm1.strikethroughOffset);
            trace(fm1.strikethroughThickness);
            trace(fm1.subscriptScale);
            trace(fm1.subscriptOffset);
            trace(fm1.superscriptScale);
            trace(fm1.superscriptOffset);
            trace(fm1.underlineOffset);
            trace(fm1.underlineThickness);
            
            
        }
    }    
}

In diesem Beispiel werden zwei ElementFormat-Objekte erstellt und verschiedene ihrer Eigenschaften festgelegt. Die neuen ElementFormat-Objekte werden dann einem TextElement-Objekt zugewiesen, das als Inhalt eines TextBlock zugewiesen wurde. Beachten Sie, dass das Ändern des ElementFormat eines TextElement sich nicht auf TextLines auswirkt, die zuvor vom übergeordneten TextBlock erstellt wurden.

package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class ElementFormatExample extends Sprite {
        
        public function ElementFormatExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontName = "Garamond";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;

            var ef1:ElementFormat = new ElementFormat(fd);
            ef1.fontSize = 30;
            ef1.color = 0xFF0000;
            ef1.alpha = 100;
            ef1.kerning = flash.text.engine.Kerning.ON;
            ef1.trackingRight = 2;
            ef1.typographicCase = flash.text.engine.TypographicCase.UPPERCASE;
            ef1.alignmentBaseline = flash.text.engine.TextBaseline.DESCENT;
            ef1.ligatureLevel = flash.text.engine.LigatureLevel.EXOTIC;
            
            var ef2:ElementFormat = new ElementFormat(fd);
            ef2.fontSize = 30;
            ef2.color = 0xFF0000;
            ef2.alpha = 0.3;
            ef2.kerning = flash.text.engine.Kerning.OFF;
            ef2.typographicCase = flash.text.engine.TypographicCase.LOWERCASE;
            ef2.digitCase = flash.text.engine.DigitCase.OLD_STYLE;
            ef2.textRotation = flash.text.engine.TextRotation.ROTATE_180;
            
            var str:String = "This is flash text 0123456789";
            var tb:TextBlock = new TextBlock();
            var te1:TextElement = new TextElement(str, ef1);
            tb.content = te1;
            var line1:TextLine = tb.createTextLine(null, 600);
            addChild(line1);
            line1.x = 15;
            line1.y = 30;

            tb.content.elementFormat = ef2;
            var line2:TextLine = tb.createTextLine(null, 600);
            addChild(line2);
            line2.x = 15;
            line2.y = 60;
            
        }
    }    
}