FontDescription  - AS3

このテキストに使用される CFF ヒンティングのタイプです。このプロパティには CFFHinting 定数を使用します。このプロパティは、テキストの RenderingMode プロパティが RenderingMode.CFF に設定されている場合にのみ適用されます。

使用されている CFF（コンパクトフォントフォーマット）ヒンティングのタイプによって、Flash ランタイムが強制的に太い水平線をサブピクセルグリッドに合わせるどうかが決まります。

埋め込みフォントにのみ適用されます。

デフォルト値は CFFHinting.HORIZONTAL_STEM です。

CFFHinting プロパティでは、CFFHinting から次の定数を使用できます。

関連する API エレメント

フォントの検索方法を指定します。

デフォルト値は FontLookup.DEVICE です。

このプロパティの値を設定するには、次のストリング値を使用します。

関連する API エレメント

使用するフォント名またはフォント名のカンマ区切りリストです。 ランタイムは、リスト内の使用できる先頭のフォントを使用してエレメントをレンダリングします。例えば、「Arial」、「Helvetica」、「_sans」の場合は、「Arial」が検索され、Arial が見つからないときは「Helvetica」が、それらがいずれも見つからないときは「_sans」が検索されます。

Flash ランタイムでは、「_sans」（sans serif フォント用）、「_serif」（serif フォント用）、「_typewriter」（等幅フォント用）の 3 つのジェネリックなデバイスフォントをサポートしています。 これらのフォント名は、プラットフォームに応じて特定のデバイスフォントにマップされます。

デフォルト値は「_serif」です。

Flash ランタイムでは、選択されたフォントで見つからない文字に対するフォントフォールバックが提供されています。 使用されているフォントが埋め込みフォントであってもデバイスフォントであっても、文字がフォントに見つからない場合、Flash ランタイムは、その文字を含むと思われる別のデバイスフォントを使用する文字をレンダリングしようとします。

関連する API エレメント

フォントの傾きを指定します。

デフォルト値は FontPosture.NORMAL です。

このプロパティの値を設定するには、FontPosture クラスから以下の定数を使用します。

関連する API エレメント

フォントの太さを指定します。

デフォルト値は FontWeight.NORMAL です。

このプロパティの値を設定するには、FontWeight クラスから以下の定数を使用します。

関連する API エレメント

FontDescription がロックされているかどうかを示します。true の場合、FontDescription を変更することはできません。FontDescription.clone() を呼び出して FontDescription オブジェクトのロックされていないコピーを取得します。

このテキストに使用されるレンダリングモードです。このプロパティには RenderingMode 定数を使用します。

埋め込みフォントにのみ適用されます。

デフォルト値は RenderingMode.CFF です。

このプロパティの値を設定するには、RenderingMode クラスから以下の定数を使用します。

関連する API エレメント

FontDescription オブジェクトを作成します。

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);
            
        }
    }    
}

使用可能なデバイス フォントを、指定された 、fontName、fontWeight および fontPosture で利用できる場合は true を返します。

flash.text.engine クラスで使用できるのは、OpenType および TrueType デバイスフォントのみです。 以前のフォント技術に基づいたフォントを使用している場合は、ランタイムはテキストの表示に文字ごとのベースで最適なデバイスフォントを使用します。

パラメーター

関連する API エレメント

指定された fontName、fontWeight、fontPosture 、Font.fontType が flash.text.FontType.EMBEDDED_CFFで利用できる埋め込みフォントがあり の場合には、true を返します。Flash Player 10 以降では、2 種類の埋め込みフォントをアプリケーションのコンテンツに表示できます。 通常の埋め込みフォントは TextField でのみ使用されます。CFF の埋め込みフォントは flash.text.engine クラスでのみ使用されます。この 2 つのタイプは、fontType プロパティ（Font クラス）で区別されます。これは、enumerateFonts() 関数で返されます。

flash.text.engine クラスは EMBEDDED タイプのフォントを使用できません。fontLookup が FontLookup.EMBEDDED_CFF に設定され、指定された名前、太さ、傾きで実行時に利用可能なフォントのタイプが EMBEDDED の場合には、ランタイムはテキストの表示に文字ごとのベースでデバイスフォントを使用します。これは、指定された名前やスタイルで使用できる埋め込みフォントがないのと同じです。

同じ名前、太さ、傾きで EMBEDDED および EMBEDDED_CFF フォントの両方が利用できる場合は、EMBEDDED_CFF フォントが選択され、テキストは EMBEDDED_CFF フォントで表示されます。

パラメーター

関連する API エレメント

この例では FontDescription オブジェクトを作成し、それにデバイスフォントを割り当て、様々なフォントプロパティを設定し、ElementFormat オブジェクトに新しいオブジェクトを割り当てます。追加フォントのフォーマットは ElementFormat 内で行われます。 新しい TextElement が作成され、ElementFormat が指定されています。また、TextElement が TextBlock のコンテンツとして使用されます。テキストの行が、TextBlock から作成されます。

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);
            
        }
    }    
}