FontDescription  - AS3

用於此文字的 CFF 提示類型。請針對此屬性使用 CFFHinting 常數。只有在文字的 RenderingMode 屬性設定為 RenderingMode.CFF 時，才會套用這個屬性。

使用的 CFF (壓縮字體格式) 提示類型決定 Flash 執行階段是否讓強制水平詞幹符合子像素格線。

只套用到內嵌字體。

預設值為 CFFHinting.HORIZONTAL_STEM。

對於 CFFHinting 屬性，您可以使用以下 CFFHinting 類別的值：

相關 API 元素

指定字體查詢的方式。

預設值是 FontLookup.DEVICE。

若要設定此屬性，請使用下列字串值：

相關 API 元素

要使用的字體名稱，或是以逗號分隔的字體名稱清單。執行階段會以清單中的第一個可用字體來顯示元素。例如，"Arial, Helvetica, _sans" 會讓 Player 先搜尋 Arial，如果找不到 Arial 則搜尋 Helvetica，如果這兩項都找不到，則搜尋 _sans。

Flash 執行階段支援三個一般裝置字體名稱：_sans (對於 sans serif 字體)、 _serif (對於 serif 字體) 以及 _typewriter (對於 mono-space 字體)。這些會對應到特定的裝置字體 (視平台而定)。

預設值為 "_serif"。

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 開始，可以出現在應用程式內容中的內嵌字體有兩種：一般內嵌字體只由 TextField 使用。CFF 內嵌字體只由 flash.text.engine 類別使用。這兩種類型是由 enumerateFonts() 函數所傳回之 Font 類別的 fontType 屬性所辨別。

flash.text.engine 類別無法使用 EMBEDDED 類型的字體。如果 fontLookup 是設定為 FontLookup.EMBEDDED_CFF，而且在執行階段對於指定的名稱、粗細和型態所能提供的字體屬於類型 EMBEDDED，執行階段就會針對個別字符改使用裝置字體以顯示文字，就像是未提供指定名稱和樣式的內嵌字體一樣。

如果相同的名稱、粗細和型態提供 EMBEDDED 和 EMBEDDED_CFF 字體，則會選取 EMBEDDED_CFF 字體並使用 EMBEDDED_CFF 字體來顯示文字。

參數

相關 API 元素

此範例會建立 FontDescription 物件、為其指定裝置字體、設定不同的字體屬性，並將新物件指定給 ElementFormat 物件。其他字體格式化作業則會在 ElementFormat 內完成。此範例中會使用 ElementFormat 來建立新的 TextElement，而且會使用 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);
            
        }
    }    
}