FontDescription  - AS3

Die für diesen Text verwendete Art des CFF-Hintings. Verwenden Sie CFFHinting-Konstanten für diese Eigenschaft. Diese Eigenschaft gilt nur dann, wenn die Eigenschaft RenderingMode des Texts auf RenderingMode.CFF gesetzt ist.

Der Typ der verwendeten CFF-Hinweise (Compact Font Format) bestimmt, ob die Flash-Laufzeitumgebung breite horizontale Striche in ein Subpixelraster einpasst oder nicht.

Gilt nur für eingebettete Schriftarten.

Der Standardwert ist CFFHinting.HORIZONTAL_STEM.

Für die CFFHinting-Eigenschaft können Sie die folgenden Konstanten aus der CFFHinting-Klasse verwenden:

Verwandte API-Elemente

Gibt an, wie nach der Schriftart gesucht werden soll.

Der Standardwert lautet FontLookup.DEVICE.

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

Verwandte API-Elemente

Der Name der zu verwendenden Schriftart oder eine durch Kommas getrennte Liste mit Schriftartnamen. Die Laufzeitumgebung gibt das Element mit der ersten verfügbaren Schriftart in der Liste wieder. Beispiel: Arial, Helvetica, _sans hat zur Folge, dass der Player nach Arial und dann nach Helvetica sucht, wenn Arial nicht gefunden wurde, anschließend nach _sans, wenn keine der beiden gefunden wurde.

Flash-Laufzeitumgebungen unterstützen drei allgemeine Geräteschriftartnamen: _sans (für Schriftarten ohne Serifen), _serif (für Serifenschriftarten) und _typewriter (für nichtproportionale Schriftarten). Diese werden je nach Plattform spezifischen Geräteschriftarten zugeordnet.

Der Standardwert ist "_serif".

Flash-Laufzeitumgebungen bieten Ersatzschriftarten für Glyphen, die in der ausgewählten Schriftart nicht zu finden sind. Unabhängig davon, ob eine eingebettete Schriftart oder eine Geräteschriftart verwendet wird, versucht die Laufzeitumgebung, die Glyphe mit einer ähnlichen Schriftart wiederzugeben, wenn diese nicht in der vorgesehenen Schriftart zu finden ist.

Verwandte API-Elemente

Gibt den Schriftschnitt an.

Der Standardwert lautet FontPosture.NORMAL.

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

Verwandte API-Elemente

Gibt die Schriftstärke an.

Der Standardwert lautet FontWeight.NORMAL.

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

Verwandte API-Elemente

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

Der für diesen Text verwendete Wiedergabemodus. Verwenden Sie RenderingMode-Konstanten für diese Eigenschaft.

Gilt nur für eingebettete Schriftarten.

Der Standardwert lautet RenderingMode.CFF.

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

Verwandte API-Elemente

Erstellt ein FontDescription-Objekt.

Erstellt eine nicht gesperrte geklonte Kopie von FontDescription.

package {

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

    
    public class FontDescription_cloneExample extends Sprite {
        private var fd:FontDescription;
        private var fd2:FontDescription;
        
        public function FontDescription_cloneExample():void {
            fd = new FontDescription();
            fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
            fd.fontName = "Palatino";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;
            fd.fontPosture = flash.text.engine.FontPosture.ITALIC;

            var ef1:ElementFormat = new ElementFormat(fd);
            
            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);
            
            fd2 = (fd.locked) ? fd.clone() : fd;    
            fd2.fontWeight = flash.text.engine.FontWeight.NORMAL;
            var ef2:ElementFormat = new ElementFormat(fd2);

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

Gibt „true“ zurück, wenn eine verwendbare Geräteschriftart mit den angegebenen Werten für fontName, fontWeight und fontPostureverfügbar ist.

Die flash.text.engine-Klassen können nur OpenType- und TrueType-Geräteschriftarten verwenden. Wenn eine Schriftart verwendet wird, die auf einer älteren Schriftarttechnik basiert, verwendet die Laufzeitumgebung bekannte, gut funktionierende Geräteschriftarten auf einer Glyphe-für-Glyphe-Basis, um den Text darzustellen.

Parameter

Verwandte API-Elemente

Gibt true zurück, wenn eine eingebettete Schriftart mit dem angegebenen fontName, fontWeight und fontPosture verfügbar ist, wobei Font.fontType flash.text.FontType.EMBEDDED_CFF ist. Ab Flash Player 10 können zwei Arten von eingebetteten Schriftarten in Anwendungsinhalten erscheinen. Normale eingebettete Schriftarten werden nur von TextField verwendet. CFF-Schriftarten werden nur von den flash.text.engine-Klassen verwendet. Die beiden Arten unterscheiden sich durch die fontType-Eigenschaft der Font-Klasse, die von der enumerateFonts()-Funktion zurückgegeben wird.

Die flash.text.engine-Klassen können keine Schriftart des Typs EMBEDDED verwenden. Wenn fontLookup auf FontLookup.EMBEDDED_CFF gesetzt wurde und die einzige zur Laufzeit verfügbare Schriftart mit dem angegebenen Namen, Gewicht und Schnitt dem Typ EMBEDDED angehört, ignoriert die Laufzeitumgebung diese Schriftart und greift stattdessen für jede einzelne Glyphe auf Geräteschriftarten zurück, um den Text wiederzugeben.

Sind Schriftarten beider Arten, also EMBEDDED und EMBEDDED_CFF, mit dem gleichen Namen, Gewicht und Schnitt verfügbar, wird die Schriftart EMBEDDED_CFF ausgewählt. Der Text wird mit der Schriftart EMBEDDED_CFF wiedergegeben.

Parameter

Verwandte API-Elemente

In diesem Beispiel wird ein FontDescription-Objekt erstellt, diesem Objekt wird eine Geräteschriftart zugewiesen, es werden verschiedene Schrifteigenschaften festgelegt und das neue Objekt wird einem ElementFormat-Objekt zugewiesen. Zusätzliche Schriftformatierung erfolgt in ElementFormat. Ein neues TextElement wird mithilfe von ElementFormat erstellt und das TextElement wird als Inhalt für einen TextBlock verwendet. Im TextBlock wird eine Textzeile erstellt.

package {

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

    
    public class FontDescriptionExample extends Sprite {
        
        public function FontDescriptionExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
            fd.fontName = "Palatino";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;
            fd.fontPosture = flash.text.engine.FontPosture.ITALIC;

            var ef1:ElementFormat = new ElementFormat(fd);
            ef1.fontSize = 30;
            ef1.color = 0xFF0000;
            
            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);
            
        }
    }    
}