| Package | flash.text.engine |
| Classe | public final class FontDescription |
| Héritage | FontDescription Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
Un objet FontDescription est appliqué à un ElementFormat, qui à son tour est appliqué à un ContentElement dans un TextBlock. Après avoir appliqué un objet FontDescription à un ElementFormat, sa propriété locked est définie sur true. Les propriétés d'un objet FontDescription bloqué ne peuvent pas être modifiées. Utilisez plutôt la méthode clone() pour créer une copie non verrouillée de l'objet, qu'il est possible de modifier et d'affecter à ElementFormat.
Remarque : FTE ne prend pas en charge les polices Type 1 ou les polices bitmap, telles que Type 3, ATC, CID ou CID basées sur SFNT.
Voir aussi
| Propriété | Défini par | ||
|---|---|---|---|
| cffHinting : String Type de repère CFF utilisé pour ce texte. | FontDescription | ||
![]() | constructor : Object Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet. | Object | |
| fontLookup : String Spécifie comment la police doit être recherchée. | FontDescription | ||
| fontName : String Nom de la police à utiliser, ou liste de noms de police séparés par une virgule. | FontDescription | ||
| fontPosture : String Spécifie la posture de la police. | FontDescription | ||
| fontWeight : String Spécifie l'épaisseur de la police. | FontDescription | ||
| locked : Boolean Indique si l'objet FontDescription est bloqué ou non. | FontDescription | ||
![]() | prototype : Object [statique] Référence à l'objet prototype d'un objet de classe ou fonction. | Object | |
| renderingMode : String Mode de rendu utilisé pour ce texte. | FontDescription | ||
| Méthode | Défini par | ||
|---|---|---|---|
FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem") Crée un objet FontDescription. | FontDescription | ||
Crée une copie non verrouillée et clonée de l'objet FontDescription. | FontDescription | ||
![]() | Indique si la propriété spécifiée d'un objet est définie. | Object | |
[statique] Renvoie true si une police intégrée est disponible avec les paramètres fontName, fontWeight et fontPosture spécifiés, où Font.fontType correspond à flash.text.FontType.EMBEDDED_CFF. | FontDescription | ||
![]() | Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre. | Object | |
![]() | Indique si la propriété spécifiée existe et est énumérable. | Object | |
![]() | Définit la disponibilité d'une propriété dynamique pour les opérations en boucle. | Object | |
![]() | Renvoie la représentation sous forme de chaîne de l'objet spécifié. | Object | |
![]() | Renvoie la valeur primitive de l'objet spécifié. | Object | |
| cffHinting | propriété |
cffHinting:String [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
Type de repère CFF utilisé pour ce texte. Utilisez les constantes flash.text.engine.CFFHinting pour cette propriété. Cette propriété s'applique uniquement si la propriété flash.text.engine.RenderingMode du texte est définie sur flash.text.engine.RenderingMode.CFF.
Le type de repère CFF utilisé détermine si Flash Player force les épaisseurs horizontales fortes à s'aligner ou non sur une grille de sous-pixels.
S'applique uniquement aux polices intégrées.
La valeur par défaut est flash.text.engine.CFFHinting.HORIZONTAL_STEM.
Pour la propriété flash.text.engine.CFFHinting, vous pouvez utiliser les valeurs de chaînes suivantes :
| Valeur de chaîne | Description |
|---|---|
CFFHinting.NONE
| Spécifie aucun repère CFF Les épaisseurs horizontales des glyphes ne sont pas alignées sur la grille de sous-pixels. Ce paramètre convient aux animations ou aux grandes polices. |
CFFHinting.HORIZONTAL_STEM
|
Spécifie un repère CFF. Spécifie que les épaisseurs horizontales fortes sont adaptées à la grille de sous-pixels sur un écran à cristaux liquides (LCD). Pour utiliser ce paramètre, la propriété RenderingMode doit être définie sur RenderingMode.CFF.
|
public function get cffHinting():String public function set cffHinting(value:String):voidArgumentError —
Si la propriété est définie sur une valeur n'appartenant pas à flash.text.engine.CFFHinting.
| |
IllegalOperationError —
Si elle est définie une fois l'objet FontDescription bloqué (la propriété locked est définie sur true ).
|
Voir aussi
| fontLookup | propriété |
fontLookup:String [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
Spécifie comment la police doit être recherchée.
La valeur par défaut est flash.text.engine.FontLookup.DEVICE.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
| Valeur de chaîne | Description |
|---|---|
FontLookup.DEVICE
|
Flash Player recherche une police de périphérique portant le nom spécifié sur le système local et l'utilise pour restituer le texte.
|
FontLookup.EMBEDDED_CFF
|
Flash Player recherche une police CFF intégrée portant le nom à utiliser pour restituer le texte. Seules les polices de type flash.text.Font.fontType.EMBEDDED_CFF sont prises en compte. Si la police CFF spécifiée n'est pas intégrée au fichier SWF, Flash Player tente d'utiliser une police de périphérique de secours pour chaque glyphe. Cette méthode est moins efficace que la sélection directe d'une police de périphérique.
|
public function get fontLookup():String public function set fontLookup(value:String):voidIllegalOperationError —
Si elle est définie une fois l'objet FontDescription bloqué (la propriété locked est définie sur true ).
|
Voir aussi
| fontName | propriété |
fontName:String [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
Nom de la police à utiliser, ou liste de noms de police séparés par une virgule. Pour le rendu de l'élément, Flash Player sélectionne la première police disponible dans la liste. Par exemple « Arial, Helvetica, _sans » oblige le lecteur à rechercher « Arial », puis « Helvetica » si Arial est introuvable, puis _sans lorsque ces deux polices sont introuvables.
Flash prend en charge trois noms de polices de périphérique génériques : _sans (telles que Helvetica et Arial), _serif (telles que Times Roman) et _typewriter (telles que Courier). Ces noms sont associés aux polices de périphérique propres à la plate-forme.
La valeur par défaut est "_serif".
Flash Player fournit des polices de secours pour les glyphes introuvables dans la police sélectionnée. Que la police utilisée soit intégrée ou de périphérique, lorsque le glyphe à restituer y est introuvable, Flash Player tente de le restituer à l'aide d'une autre police de périphérique susceptible de le contenir.
public function get fontName():String public function set fontName(value:String):voidIllegalOperationError —
Si elle est définie une fois l'objet FontDescription bloqué (la propriété locked est définie sur true ).
|
| fontPosture | propriété |
fontPosture:String [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
Spécifie la posture de la police.
S'applique uniquement aux polices de périphériques.
La valeur par défaut est flash.text.engine.FontPosture.NORMAL.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
| Valeur de chaîne | Description |
|---|---|
FontPosture.NORMAL
| Posture de police normale. |
FontPosture.ITALIC
| Posture de police italique. |
public function get fontPosture():String public function set fontPosture(value:String):voidArgumentError —
Si la propriété est définie sur une valeur n'appartenant pas à flash.text.engine.FontPosture.
| |
IllegalOperationError —
Si elle est définie une fois l'objet FontDescription bloqué (la propriété locked est définie sur true ).
|
| fontWeight | propriété |
fontWeight:String [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
Spécifie l'épaisseur de la police.
S'applique uniquement aux polices de périphériques.
La valeur par défaut est flash.text.engine.FontWeight.NORMAL.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
| Valeur de chaîne | Description |
|---|---|
FontWeight.NORMAL
| Epaisseur de police normale. |
FontWeight.BOLD
| Epaisseur de police gras. |
public function get fontWeight():String public function set fontWeight(value:String):voidArgumentError —
Si la propriété est définie sur une valeur n'appartenant pas à flash.text.engine.FontWeight.
| |
IllegalOperationError —
Si elle est définie une fois l'objet FontDescription bloqué (la propriété locked est définie sur true ).
|
| locked | propriété |
locked:Boolean [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5. |
Indique si l'objet FontDescription est bloqué ou non. Si la propriété est définie sur true, l'objet FontDescription ne peut pas être modifié. Appelez FontDescription.clone() pour obtenir une copie non verrouillée de l'objet FontDescription.
public function get locked():Boolean public function set locked(value:Boolean):voidIllegalOperationError —
Si elle est définie une fois l'objet FontDescription bloqué (la propriété locked est définie sur true ).
|
Voir aussi
| renderingMode | propriété |
renderingMode:String [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
Mode de rendu utilisé pour ce texte. Utilisez les constantes flash.text.engine.RenderingMode pour cette propriété.
S'applique uniquement aux polices intégrées.
La valeur par défaut estflash.text.engine.RenderingMode.CFF.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
| Valeur de chaîne | Description |
|---|---|
RenderingMode.NORMAL
| Applique un rendu de texte normal, correspondant au type de rendu utilisé par Flash Player 7 et les versions précédentes. |
RenderingMode.CFF
| Applique un rendu CFF qui rend le texte plus lisible. (Cette fonctionnalité est disponible depuis Flash Player 10.) Le rendu CFF permet d'obtenir la qualité du rendu des polices de petite taille. |
public function get renderingMode():String public function set renderingMode(value:String):voidArgumentError —
Si la propriété est définie sur une valeur n'appartenant pas à flash.text.engine.RenderingMode.
| |
IllegalOperationError —
Si elle est définie une fois l'objet FontDescription bloqué (la propriété locked est définie sur true ).
|
Voir aussi
| FontDescription | () | Constructeur |
public function FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
Crée un objet FontDescription.
ParamètresfontName:String (default = "_serif") — Nom de la police à utiliser, ou liste de noms de police séparés par une virgule. | |
fontWeight:String (default = "normal") — Spécifie l'épaisseur de la police. | |
fontPosture:String (default = "normal") — Spécifie la posture de la police. | |
fontLookup:String (default = "device") — Spécifie comment rechercher la police. | |
renderingMode:String (default = "cff") —
Mode de rendu utilisé pour ce texte. Utilisez les constantes flash.text.engine.RenderingMode pour cette propriété.
| |
cffHinting:String (default = "horizontalStem") —
Type de repère CFF utilisé pour ce texte. Utilisez les constantes flash.text.engine.CFFHinting pour cette propriété.
|
ArgumentError —
Le paramètre fontWeight spécifié n'appartient pas à flash.text.engine.FontWeight.
| |
ArgumentError —
Le paramètre fontPosture spécifié n'appartient pas à flash.text.engine.FontPosture.
| |
ArgumentError —
Le paramètre fontLookup spécifié n'appartient pas à flash.text.engine.FontLookup.
| |
ArgumentError —
Le paramètre renderingMode spécifié n'appartient pas à flash.text.engine.RenderingMode.
| |
ArgumentError —
Le paramètre cffHinting spécifié n'appartient pas à flash.text.engine.CFFHinting.
|
| clone | () | méthode |
public function clone():FontDescription| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
Crée une copie non verrouillée et clonée de l'objet FontDescription.
Valeur renvoyéeFontDescription —
Une copie non verrouillée de l'objet FontDescription.
|
Voir aussi
Cet exemple crée un objet FontDescription, lui affecte une police de périphérique, définit diverses propriétés de police et affecte le nouvel objet à un objet ElementFormat tout en le bloquant. Un nouvel objet TextElement est créé, à l'aide d'ElementFormat, et TextElement est utilisé comme contenu pour un TextBlock. Une ligne de texte est créée à partir du TextBlock.
Pour modifier l'objet FontDescription, vous devez tout d'abord vérifier sa propriété locked. Si elle est définie sur true, utilisez la méthode clone() pour créer une copie non verrouillée de FontDescription, modifiez ses propriétés, puis affectez-la à un nouvel objet ElementFormat. Ensuite, associez à nouveau le nouvel objet ElementFormat au TextBlock. Lorsque les lignes sont de nouveau scindées, les nouvelles récupèrent les nouveaux paramètres de police.
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);
}
}
}| isFontCompatible | () | méthode |
public static function isFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 10, AIR 1.5 |
Renvoie true si une police intégrée est disponible avec les paramètres fontName, fontWeight et fontPosture spécifiés, où Font.fontType correspond à flash.text.FontType.EMBEDDED_CFF. Depuis Flash Player 10, un fichier SWF peut contenir deux sortes de police intégrée. Les polices intégrées normales ne sont utilisées que par les objets TextField. Les polices CFF intégrées ne sont utilisées que par les classes flash.text.engine. Les deux types sont différenciés par la propriété fontType de la classe Font, telle que renvoyée par la fonction enumerateFonts().
Les classes flash.text.engine ne peuvent pas utiliser une police de type EMBEDDED. Si fontLookup est défini sur FontLookup.EMBEDDED_CFF et que la seule police disponible au moment de l'exécution avec le nom, l'épaisseur et la posture spécifiés est de type EMBEDDED, Flash Player revient à des polices de périphériques en restituant le texte glyphe par glyphe, comme si aucune police intégrée ne correspondait au nom et au style spécifiés.
Si des polices EMBEDDED et EMBEDDED_CFF sont disponibles avec le même nom, la même épaisseur et la même posture, la police EMBEDDED_CFF est sélectionnée et le texte est restitué avec la police EMBEDDED_CFF.
Paramètres
fontName:String — Nom de la police intégrée à vérifier. | |
fontWeight:String —
Spécifie l'épaisseur de la police. Utilisez flash.text.engine.FontWeight.
| |
fontPosture:String —
Spécifie la posture de la police. Utilisez flash.text.engine.FontPosture.
|
Boolean —
true si une police intégrée compatible est disponible, sinon false.
|
ArgumentError —
Le paramètre fontWeight spécifié n'appartient pas à flash.text.engine.FontWeight.
| |
ArgumentError —
Le paramètre fontPosture spécifié n'appartient pas à flash.text.engine.FontPosture.
|
Voir aussi
Cet exemple crée un objet FontDescription, lui affecte une police de périphérique, définit diverses propriétés de police et affecte le nouvel objet à un objet ElementFormat. D'autres mises en forme de police sont effectuées dans ElementFormat. Un nouvel objet TextElement est créé, à l'aide d'ElementFormat, et TextElement est utilisé comme contenu pour un TextBlock. Une ligne de texte est créée à partir du 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);
}
}
}