用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
flash.text 

Font  - AS3

flash.text
public class Font
继承Font Inheritance Object
子类 FontAsset

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

Font 类可用来管理 SWF 文件中的嵌入字体。嵌入字体表示为 Font 类的子类。Font 类当前只适用于查找有关嵌入字体的信息,您无法使用此类来更改字体。无法单独使用 Font 类来加载外部字体,或创建 Font 对象的实例。Font 类用作抽象基类。



公共属性
 属性由以下参数定义
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  fontName : String
[只读] 嵌入字体的名称。
Font
  fontStyle : String
[只读] 字体的样式。
Font
  fontType : String
[只读] 字体的类型。
Font
公共方法
 方法由以下参数定义
  
enumerateFonts(enumerateDeviceFonts:Boolean = false):Array
[静态] 指定是否提供当前可用嵌入字体列表。
Font
  
指定能否使用当前指定的字体显示提供的字符串。
Font
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
  
[静态] 在全局字体列表中注册一个字体类。
Font
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
属性详细信息

fontName

属性
fontName:String  [只读]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

嵌入字体的名称。



实现
    public function get fontName():String

示例  ( 如何使用本示例 )
以下示例说明了如何通过设置 textFormat 和 embedFonts 样式,将嵌入字体与 Flash Professional ActionScript 3.0 复选框控件一起使用。ActionScriptExamples.com 提供的示例。
// Requires:
// - A CheckBox control UI component in Flash library.
// - An embedded font in Flash library with linkage class "MyFont" and Export for ActionScript checked.
//
import fl.controls.CheckBox;
 
var embeddedFont:Font = new MyFont();
 
var textFormat:TextFormat = new TextFormat();
textFormat.font = embeddedFont.fontName;
textFormat.size = 24;
 
var checkBox:CheckBox = new CheckBox();
checkBox.setStyle("textFormat", textFormat);
checkBox.setStyle("embedFonts", true);
checkBox.label = "The quick brown fox jumps over the lazy dog.";
checkBox.textField.autoSize = TextFieldAutoSize.LEFT;
checkBox.move(10, 10);
checkBox.validateNow();
addChild(checkBox);

fontStyle

属性 
fontStyle:String  [只读]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

字体的样式。此值可以是 FontStyle 类中定义的任何值。



实现
    public function get fontStyle():String

相关 API 元素

fontType

属性 
fontType:String  [只读]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

字体的类型。此值可以是 FontType 类中定义的任何常数。



实现
    public function get fontType():String

相关 API 元素

方法详细信息

enumerateFonts

()方法
public static function enumerateFonts(enumerateDeviceFonts:Boolean = false):Array

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

指定是否提供当前可用嵌入字体列表。

参数

enumerateDeviceFonts:Boolean (default = false) — 表示是否要将列表限制为仅当前可用的嵌入字体。如果设置为 true,则返回一个包括所有字体(设备字体和嵌入字体)的列表。如果设置为 false,则返回一个只包括嵌入字体的列表。

返回
Array — 一个作为 Font 对象数组的可用字体列表。

示例  ( 如何使用本示例 )

此示例首先调用静态方法 Font.enumerateFonts() 来获取包括所有设备字体和嵌入字体的列表。然后此示例按 fontName 属性对生成的 Array 的 Font 对象进行排序。

接下来,此示例显示如何调用 enumerateDeviceFonts 参数设置为 false 时的 Font.enumerateFonts() 方法。生成的 Array 只包括嵌入的 Font 对象。(如果在不包含任何嵌入字体的应用程序中运行此代码,则 embeddedFonts 数组将为空。)

 
import flash.text.Font;

var allFonts:Array = Font.enumerateFonts(true);
allFonts.sortOn("fontName", Array.CASEINSENSITIVE);

var embeddedFonts:Array = Font.enumerateFonts(false);
embeddedFonts.sortOn("fontName", Array.CASEINSENSITIVE);

hasGlyphs

()方法 
public function hasGlyphs(str:String):Boolean

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

指定能否使用当前指定的字体显示提供的字符串。

参数

str:String — 要针对当前字体进行测试的字符串。

返回
Boolean — 如果可使用此字体完全显示指定的字符串,则值为 true

registerFont

()方法 
public static function registerFont(font:Class):void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

在全局字体列表中注册一个字体类。

参数

font:Class — 要添加到全局字体列表中的类。





[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。