Packageflash.text
Classpublic class Font
InheritanceFont Inheritance Object
Subclasses FontAsset

Language Version: ActionScript 3.0
Runtime Versions: Flash Player 9, AIR 1.0

The Font class is used to manage embedded fonts in SWF files. Embedded fonts are represented as a subclass of the Font class. The Font class is currently useful only to find out information about embedded fonts; you cannot alter a font by using this class. You cannot use the Font class to load external fonts, or to create an instance of a Font object by itself. Use the Font class as an abstract base class.


Public Properties
 PropertyDefined By
 Inheritedconstructor : 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
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
Public Methods
 MethodDefined 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
 Inherited
hasOwnProperty(name:String):Boolean
Indicates whether an object has a specified property defined.
Object
 Inherited
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
 Inherited
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
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
toLocaleString():String
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
toString():String
Returns the string representation of the specified object.
Object
 Inherited
valueOf():Object
Returns the primitive value of the specified object.
Object
Property Detail
fontNameproperty
fontName:String  [read-only]

Language Version: ActionScript 3.0
Runtime Versions: Flash Player 9, AIR 1.0

The name of an embedded font.



Implementation
    public function get fontName():String
fontStyleproperty 
fontStyle:String  [read-only]

Language Version: ActionScript 3.0
Runtime Versions: Flash Player 9, AIR 1.0

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.FontStyle
fontTypeproperty 
fontType:String  [read-only]

Language Version: ActionScript 3.0
Runtime Versions: Flash Player 9, AIR 1.0

The type of the font. This value can be any of the constants defined in the FontType class.



Implementation
    public function get fontType():String

See also

flash.text.FontType
Method Detail
enumerateFonts()method
public static function enumerateFonts(enumerateDeviceFonts:Boolean = false):Array

Language Version: ActionScript 3.0
Runtime Versions: Flash Player 9, AIR 1.0

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 Versions: Flash Player 9, AIR 1.0

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 Versions: Flash Player 9, AIR 1.0

Registers a font class in the global font list.

Parameters

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




© 2009 Adobe Systems Incorporated. All rights reserved.
Fri Aug 14 2009, 04:09 PM +05:30