flash.text.Font (ActionScript 3.0)

	Property	Defined by
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		fontName : String [read-only] The name of an embedded font.	Font
		fontStyle : String [read-only] The style of the font.	Font
		fontType : String [read-only] The type of the font.	Font
		prototype : Object [static] A reference to the prototype object of a class or function object.	Object

	Method	Defined by
		enumerateFonts(enumerateDeviceFonts:Boolean = false):Array [static] Specifies whether to provide a list of the currently available embedded fonts.	Font
		hasGlyphs(str:String):Boolean Specifies whether a provided string can be displayed using the currently assigned font.	Font
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		registerFont(font:Class):void [static] Registers a font class in the global font list.	Font
		registerFontFromByteArray(fontData:ByteArray):void [static] Registers a font class in the global font list, using dynamic data.	Font
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the string representation of the specified object.	Object
		valueOf():Object Returns the primitive value of the specified object.	Object

Property detail

fontName

property

fontName:String [read-only]

Language version:

ActionScript 3.0

Runtime version:

The name of an embedded font.

Implementation
public function get fontName():String

Example
The following example shows how you can use an embedded font with the Flash Professional ActionScript 3.0 CheckBox control by setting the textFormat and embedFonts styles. Example provided by 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

property

fontStyle:String [read-only]

Language version:

ActionScript 3.0

Runtime version:

The style of the font. This value can be any of the values defined in the FontStyle class.

Implementation
public function get fontStyle():String

See also

flash.text.FontType

Method detail

enumerateFonts

()

method

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

Language version:

ActionScript 3.0

Runtime version:

Specifies whether to provide a list of the currently available embedded fonts.

Parameters

enumerateDeviceFonts:Boolean (default = false) — Indicates whether you want to limit the list to only the currently available embedded fonts. If this is set to true then a list of all fonts, both device fonts and embedded fonts, is returned. If this is set to false then only a list of embedded fonts is returned.

Returns

Array — A list of available fonts as an array of Font objects.

Example
This example first calls the static method Font.enumerateFonts() to get a list of all device and embedded fonts. Then it sorts the resulting Array of Font objects by the fontName property.

Next the example shows how to call the Font.enumerateFonts() method with the enumerateDeviceFonts parameter set to false. The resulting Array only includes embedded Font objects. (If you run this code within an application that does not contain any embedded fonts, the embeddedFonts array will be empty.)

 
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

()

method

public function hasGlyphs(str:String):Boolean

Language version:

ActionScript 3.0

Runtime version:

Specifies whether a provided string can be displayed using the currently assigned font.

Parameters

str:String — The string to test against the current font.

Returns

Boolean — A value of true if the specified string can be fully displayed using this font.

registerFont

()

method

public static function registerFont(font:Class):void

Language version:

ActionScript 3.0

Runtime version:

Registers a font class in the global font list.

Parameters

font:Class — The class you want to add to the global font list.

registerFontFromByteArray

()

method

public static function registerFontFromByteArray(fontData:ByteArray):void

Language version:

ActionScript 3.0

Runtime version:

AIR 51

Registers a font class in the global font list, using dynamic data.

Parameters

fontData:ByteArray — A byte array containing the font data you want to add to the global font list.

Submit Feedback

ActionScript 3.0 Language Reference	All Packages \| All Classes \| Language Elements \| Index \| Appendices \| Conventions \| Frames No Frames
Class Font	Properties \| Methods

Package	flash.text
Class	public class Font
Inheritance	Font Object