Package | flash.text.engine |
Classe | public final class ElementFormat |
Héritage | ElementFormat Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Un objet ElementFormat appliqué à un ContentElement dans un TextBlock n’invalide pas le TextBlock. Après avoir appliqué un objet ElementFormat à un ContentElement, sa propriété locked
est définie sur true
. Les propriétés d’un objet ElementFormat 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 au ContentElement.
Plus d’exemples
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
alignmentBaseline : String
Spécifie le type de ligne de base dans l’élément contenant avec lequel sont alignées les lignes de base des éléments possédant ce format. | ElementFormat | ||
alpha : Number
Spécifie la transparence des éléments de ligne affectés par cet objet. | ElementFormat | ||
baselineShift : Number
Indique le décalage de la ligne de base pour l’élément, en pixels. | ElementFormat | ||
breakOpportunity : String
Opportunité de saut de ligne appliquée à ce texte. | ElementFormat | ||
color : uint
Indique la couleur du texte. | ElementFormat | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
digitCase : String
Casse de chiffres utilisée pour ce texte. | ElementFormat | ||
digitWidth : String
Largeur de chiffres utilisée pour ce texte. | ElementFormat | ||
dominantBaseline : String
Spécifie le type de ligne de base à utiliser comme ligne de base dominante. | ElementFormat | ||
fontDescription : FontDescription
Objet dont les propriétés décrivent une police. | ElementFormat | ||
fontSize : Number
La taille du texte, en pixels. | ElementFormat | ||
kerning : String
Le crènage ajuste les pixels entre certaines paires de caractères pour améliorer la lisibilité. | ElementFormat | ||
ligatureLevel : String
Niveau de ligature utilisé pour ce texte. | ElementFormat | ||
locale : String
Variable locale du texte. | ElementFormat | ||
locked : Boolean
Indique si l’objet ElementFormat est bloqué. | ElementFormat | ||
textRotation : String
Définit la rotation appliquée aux glyphes individuelles. | ElementFormat | ||
trackingLeft : Number
Interlettrage ou crénage manuel à appliquer à gauche de chaque glyphe, en pixels. | ElementFormat | ||
trackingRight : Number
Interlettrage ou crénage manuel à appliquer à droite de chaque glyphe, en pixels. | ElementFormat | ||
typographicCase : String
Casse typographique utilisée pour ce texte. | ElementFormat |
Méthode | Défini par | ||
---|---|---|---|
ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")
Crée un objet ElementFormat. | ElementFormat | ||
Crée une copie non verrouillée et clonée de l’objet ElementFormat. | ElementFormat | ||
Renvoie un objet FontMetrics avec des propriétés qui décrivent la valeur emBox, la position et l’épaisseur du barré et du soulignement pour la police spécifiée par fontDescription et fontSize.
| ElementFormat | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
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 de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | 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 |
alignmentBaseline | propriété |
alignmentBaseline:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Spécifie le type de ligne de base dans l’élément contenant avec lequel sont alignées les lignes de base des éléments possédant ce format. Utilisez les constantesTextBaseline
pour cette propriété.
Le plus grand élément vertical de la ligne détermine l’alignement des lignes de base, sauf si TextBlock.baselineFontDescription
et TextBlock.baselineFontSize
sont définis pour un autre comportement.
La valeur par défaut est TextBaseline.USE_DOMINANT_BASELINE
.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
Valeur de chaîne | Description |
---|---|
TextBaseline.ROMAN | La dominantBaseline s’aligne sur la ligne de base des caractères romains de la ligne. |
TextBaseline.ASCENT | La dominantBaseline s’aligne sur la ligne de base des caractères ascendants de la ligne. |
TextBaseline.DESCENT | La dominantBaseline s’aligne sur la ligne de base des caractères descendants de la ligne. |
TextBaseline.IDEOGRAPHIC_TOP | La dominantBaseline s’aligne sur la ligne de base du haut des caractères idéographiques de la ligne. |
TextBaseline.IDEOGRAPHIC_CENTER | La dominantBaseline s’aligne sur la ligne de base du centre des caractères idéographiques de la ligne. |
TextBaseline.IDEOGRAPHIC_BOTTOM | La dominantBaseline s’aligne sur la ligne de base du bas des caractères idéographiques de la ligne. |
TextBaseline.USE_DOMINANT_BASELINE | La dominantBaseline s’aligne sur la même ligne de base de la ligne. |
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | Définit la ligne de base de l’alignement de la ligne sur celle sur laquelle s’aligne la dominantBaseline de l’élément graphique. |
GroupElement | N’a aucun effet. |
TextElement | Définit la ligne de base de l’alignement de la ligne sur celle sur laquelle s’aligne la dominantBaseline de l’élément de texte. |
Implémentation
public function get alignmentBaseline():String
public function set alignmentBaseline(value:String):void
Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à TextBaseline .
| |
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Plus d’exemples
Eléments de l’API associés
alpha | propriété |
alpha:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Spécifie la transparence des éléments de ligne affectés par cet objet. Les valeurs disponibles sont comprises entre 0 (entièrement transparent) et 1 (entièrement opaque). Les objets d’affichage où alpha
est défini sur 0 sont actifs, même s’ils sont invisibles.
La valeur par défaut est 1
.
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | Applique l’alpha spécifié à l’élément graphique. Fait une combinaison par multiplication avec tout alpha défini sur le graphique DisplayObject lui-même ou sur la TextLine . |
GroupElement | N’a aucun effet. |
TextElement | Applique l’alpha spécifié à l’élément de texte. Fait une combinaison par multiplication avec tout alpha défini sur la TextLine . |
Implémentation
public function get alpha():Number
public function set alpha(value:Number):void
Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Plus d’exemples
Eléments de l’API associés
baselineShift | propriété |
baselineShift:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Indique le décalage de la ligne de base pour l’élément, en pixels.
L’élément est éloigné d’autant de la dominantBaseline
. Le décalage étant ajouté à la position y des membres de l’élément, dans un texte qui ne pivote pas, un décalage de ligne de base positif déplace l’élément vers le bas et un décalage de ligne de base négatif déplace l’élément vers le haut.
La valeur par défaut est 0.0
, ce qui signifie aucun décalage.
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | Eloigne le graphique de la ligne de base. |
GroupElement | N’a aucun effet. |
TextElement | Eloigne le texte de la ligne de base. |
Implémentation
public function get baselineShift():Number
public function set baselineShift(value:Number):void
Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Plus d’exemples
breakOpportunity | propriété |
breakOpportunity:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Opportunité de saut de ligne appliquée à ce texte. Cette propriété détermine quels caractères peuvent être utilisés pour effectuer un saut de ligne lorsque le texte est scindé en plusieurs lignes. Utilisez les constantes BreakOpportunity
pour cette propriété.
La valeur par défaut est BreakOpportunity.AUTO
.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
Valeur de chaîne | Description |
---|---|
BreakOpportunity.AUTO | Les possibilités de saut de ligne sont basées sur les propriétés des caractères Unicode standard, par exemple les séparations de mots et les tirets. |
BreakOpportunity.ANY | Tout caractère de l’objet ContentElement est traité comme une possibilité de saut de ligne. Cette valeur est généralement utilisée lorsque du texte Romain est intégré dans du texte asiatique et qu’il est préférable que les sauts de ligne interviennent au milieu des mots. |
BreakOpportunity.NONE | Aucun caractère de la plage n’est traité comme une possibilité de saut de ligne. |
BreakOpportunity.ALL | Tous les caractères de la plage sont traités comme des possibilités de saut de ligne, ce qui signifie qu’un saut de ligne se produit après chaque caractère. Cela est utile pour la création d’effets tels qu’un texte sur un tracé. |
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | N’a aucun effet. |
GroupElement | Détermine la possibilité de séparation entre les éléments de texte adjacents du groupe. Si l’elementFormat du groupe est null , le format du premier des éléments adjacents est utilisé. |
TextElement | Détermine la possibilité de séparation entre les caractères de l’élément de texte. |
Implémentation
public function get breakOpportunity():String
public function set breakOpportunity(value:String):void
Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à BreakOpportunity .
| |
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Plus d’exemples
Eléments de l’API associés
color | propriété |
color:uint
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Indique la couleur du texte. Nombre entier contenant trois composants RVB 8 bits ; par exemple, 0xFF0000 correspond au rouge et 0x00FF00 au vert.
La valeur par défaut est 0x000000
(noir).
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | N’a aucun effet. |
GroupElement | N’a aucun effet. |
TextElement | Définit la couleur du texte. |
Implémentation
public function get color():uint
public function set color(value:uint):void
Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
digitCase | propriété |
digitCase:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Casse numérique utilisée pour ce texte. La casse des chiffres affecte le style et le positionnement des groupes de caractères numériques. Utilisez les constantes DigitCase
pour cette propriété.
La valeur par défaut est DigitCase.DEFAULT
.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
Valeur de chaîne | Description |
---|---|
DigitCase.DEFAULT | Applique une casse de chiffres par défaut au texte. |
DigitCase.LINING | Applique la casse de chiffres des lignes au texte. |
DigitCase.OLD_STYLE | Applique l’ancienne casse de chiffres de style au texte. |
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | N’a aucun effet. |
GroupElement | N’a aucun effet. |
TextElement | Détermine le casse des chiffres utilisée pour le texte dans l’élément. |
Implémentation
public function get digitCase():String
public function set digitCase(value:String):void
Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à DigitCase .
| |
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Eléments de l’API associés
digitWidth | propriété |
digitWidth:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Largeur de chiffres utilisée pour ce texte. Utilisez les constantes DigitWidth
pour cette propriété.
La valeur par défaut est DigitWidth.DEFAULT
.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
Valeur de chaîne | Description |
---|---|
DigitWidth.DEFAULT | Applique une largeur de chiffres par défaut au texte. |
DigitWidth.PROPORTIONAL | Applique une largeur de chiffres proportionnelle au texte. |
DigitWidth.TABULAR | Applique une largeur de chiffres tabulaire au texte. |
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | N’a aucun effet. |
GroupElement | N’a aucun effet. |
TextElement | Détermine l’épaisseur des chiffres utilisée pour le texte dans l’élément. |
Implémentation
public function get digitWidth():String
public function set digitWidth(value:String):void
Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à DigitWidth .
| |
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Eléments de l’API associés
dominantBaseline | propriété |
dominantBaseline:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Spécifie le type de ligne de base à utiliser comme ligne de base dominante. La ligne de base dominante est alignée sur la ligne de base d’alignement pour déterminer la position verticale de l’élément sur la ligne. Utilisez les constantesTextBaseline
pour cette propriété.
Le contenu de l’élément détermine les lignes de base. Dans le cas d’un TextElement
, la police et la taille de la police déterminent les lignes de base. Dans le cas d’un ForeignElement
, la hauteur de l’élément détermine les lignes de base.
La valeur par défaut est TextBaseline.ROMAN
.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
Valeur de chaîne | Description |
---|---|
TextBaseline.ROMAN | La ligne de base des caractères romains de l’élément s’aligne avec alignmentBaseline . |
TextBaseline.ASCENT | La ligne de base des caractères ascendants de l’élément s’aligne avec alignmentBaseline . |
TextBaseline.DESCENT | La ligne de base des caractères descendants de l’élément s’aligne avec alignmentBaseline . |
TextBaseline.IDEOGRAPHIC_TOP | La ligne de base du haut des caractères idéographiques de l’élément s’aligne avec alignmentBaseline . |
TextBaseline.IDEOGRAPHIC_CENTER | La ligne de base du centre des caractères idéographiques de l’élément s’aligne avec alignmentBaseline . |
TextBaseline.IDEOGRAPHIC_BOTTOM | La ligne de base du bas des caractères idéographiques de l’élément s’aligne avec alignmentBaseline . |
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | Détermine quelles lignes de base de l’élément graphique s’alignent sur le alignmentBaseline . |
GroupElement | N’a aucun effet. |
TextElement | Détermine quelles lignes de base de l’élément de texte s’alignent sur le alignmentBaseline . |
Implémentation
public function get dominantBaseline():String
public function set dominantBaseline(value:String):void
Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à TextBaseline .
| |
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Plus d’exemples
Eléments de l’API associés
fontDescription | propriété |
fontDescription:FontDescription
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Objet dont les propriétés décrivent une police.
La valeur par défaut est un objet FontDescription créé par défaut.
Lorsque la propriété fontDescription est définie, l’objet FontDescription fourni est bloqué : sa propriété locked
est définie sur true
. Il est impossible de modifier un objet FontDescription bloqué.
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | N’a aucun effet. |
GroupElement | N’a aucun effet. |
TextElement | Détermine la police utilisée pour le texte dans l’élément. |
Implémentation
public function get fontDescription():FontDescription
public function set fontDescription(value:FontDescription):void
Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Eléments de l’API associés
fontSize | propriété |
fontSize:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
La taille du texte, en pixels.
La valeur par défaut est 12.0
.
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | N’a aucun effet. |
GroupElement | N’a aucun effet. |
TextElement | Détermine la taille pour le texte de l’élément, en pixels. |
Implémentation
public function get fontSize():Number
public function set fontSize(value:Number):void
Valeur émise
ArgumentError — Si défini sur une valeur inférieure à zéro.
| |
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
kerning | propriété |
kerning:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Le crénage ajuste les pixels entre certaines paires de caractères pour améliorer la lisibilité. Le crénage est pris en charge pour toutes les polices qui disposent de tables de crénage.
La valeur par défaut est Kerning.ON
.
Pour définir les valeurs pour cette propriété, utilisez les constantes suivantes dans la classe Kerning :
Valeur de chaîne | Description |
---|---|
Kerning.ON | Le crénage est activé. |
Kerning.OFF | Le crénage est désactivé. |
Kerning.AUTO | Le crènage est activé, sauf lorsque cela n’est pas nécessaire dans la typographie asiatique. Le crénage est appliqué entre deux caractères lorsque aucun d’eux n’est un caractère Kanji, Hiragana ou Katakana. |
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | N’a aucun effet. |
GroupElement | Détermine si le crénage est appliqué entre les éléments de texte adjacents du groupe. Si l’elementFormat du groupe est null , le format du premier des éléments adjacents est utilisé. |
TextElement | Détermine si le crénage est appliqué entre les caractères dans l’élément de texte. |
Implémentation
public function get kerning():String
public function set kerning(value:String):void
Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Plus d’exemples
Eléments de l’API associés
ligatureLevel | propriété |
ligatureLevel:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Niveau de ligature utilisé pour ce texte. Une ligature se produit lorsque plusieurs formes de lettres sont unies dans un seul glyphe. Les ligatures remplacent généralement des caractères consécutifs partageant des composants communs, par exemple les paires de lettres ’fi’, ’fl’ ou ’ae’. Elles sont utilisées avec les jeux de caractères latins et non latins. Utilisez les constantes LigatureLevel
pour cette propriété.
La valeur par défaut est LigatureLevel.COMMON
.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
Valeur de chaîne | Description |
---|---|
LigatureLevel.NONE | Aucune ligature n’est créée. |
LigatureLevel.MINIMUM | Des ligatures minimales sont créées. |
LigatureLevel.COMMON | Des ligatures courantes sont créées. |
LigatureLevel.UNCOMMON | Des ligatures rares sont créées. |
LigatureLevel.EXOTIC | Des ligatures exotiques sont créées. |
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | N’a aucun effet. |
GroupElement | Détermine le niveau de ligature entre les éléments de texte adjacents du groupe. Si l’elementFormat du groupe est null , le format du premier des éléments adjacents est utilisé. |
TextElement | Détermine le niveau de ligature entre les caractères de l’élément de texte. |
Implémentation
public function get ligatureLevel():String
public function set ligatureLevel(value:String):void
Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à LigatureLevel .
| |
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Eléments de l’API associés
locale | propriété |
locale:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Variable locale du texte. Contrôle les transformations de casse et de forme. Les identifiants locaux standards sont utilisés. Par exemple « en », « en_US » et « en-US » pour l’anglais, « ja » pour le japonais. Voir la liste des codes ISO 639-2 pour obtenir la liste des codes de paramètres régionaux.
La valeur par défaut est "en"
.
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | N’a aucun effet. |
GroupElement | N’a aucun effet. |
TextElement | Détermine les transformations et les formes du texte dans l’élément. |
Implémentation
public function get locale():String
public function set locale(value:String):void
Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
locked | propriété |
locked:Boolean
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Indique si l’objet ElementFormat est bloqué. Si la propriété est définie sur true
, l’objet ElementFormat ne peut pas être modifié. Appelez ElementFormat.clone()
pour obtenir une copie non verrouillée de l’objet ElementFormat.
Implémentation
public function get locked():Boolean
public function set locked(value:Boolean):void
Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Plus d’exemples
textRotation | propriété |
textRotation:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Définit la rotation appliquée aux glyphes individuelles. Utilisez les constantes définies dans la classe TextRotation pour cette propriété.
La valeur par défaut est TextRotation.AUTO
.
La rotation finale des glyphes est la somme de , ElementFormat.textRotation
, ContentElement.textRotation
et TextBlock.lineRotation
.
Vous devez normalement utiliser cette propriété pour le texte asiatique, dont les caractères doivent pivoter pour s’afficher verticalement. Pour ce faire, utilisez TextRotation.AUTO
avec TextBlock.lineRotation = TextRotation.ROTATE_90
.
La définition de cette propriété sur des polices qui ne contiennent pas d’informations de disposition verticale risque de donner des résultats inattendus. Les polices qui contiennent une table vmtx ou VORG, telles que la police japonaise « MS Mincho », fonctionnent correctement. En effet, ces tables fournissent les données dont le moteur de disposition a besoin pour effectuer une mise en forme appropriée. Les polices comme Verdana, qui ne contiennent pas les informations nécessaires, ne fonctionnent pas correctement.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
Valeur de chaîne | Description |
---|---|
TextRotation.ROTATE_0 | Les glyphes ne pivotent pas. |
TextRotation.ROTATE_90 | Les glyphes pivotent de 90 degrés vers la droite. |
TextRotation.ROTATE_180 | Les glyphes pivotent de 180 degrés. |
TextRotation.ROTATE_270 | Les glyphes pivotent de 270 degrés vers la droite. |
TextRotation.AUTO | Spécifie une rotation de 90 degrés vers la gauche pour les glyphes larges et de pleine épaisseur uniquement, tels que déterminés par les propriétés Unicode du glyphe. Cette valeur est généralement utilisée avec du texte asiatique pour ne faire pivoter que les glyphes requérant une rotation. Cette rotation est uniquement appliquée au texte vertical pour orienter verticalement les caractères larges et de pleine épaisseur sans affecter les autres caractères. |
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | N’a aucun effet. |
GroupElement | N’a aucun effet. |
TextElement | Détermine la rotation des glyphes dans l’élément de texte. |
Implémentation
public function get textRotation():String
public function set textRotation(value:String):void
Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à TextRotation .
| |
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Plus d’exemples
Eléments de l’API associés
trackingLeft | propriété |
trackingLeft:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Interlettrage ou crénage manuel à appliquer à gauche de chaque glyphe, en pixels. Si kerning
est activé, la valeur trackingLeft
est ajoutée aux valeurs dans la table de crénage de la police. Si kerning
est désactivé, la valeur trackingLeft
est utilisée comme valeur de crénage manuel. Prend en charge les valeurs positives et négatives.
De façon générale, la valeur de suivi désirée est divisée entre trackingRight
et trackingLeft
. Autrement, dans le cas de texte combinant plusieurs directions, le suivi est double au niveau d’une limite bidirectionnelle et nul pour l’autre.
La valeur par défaut est 0.0
.
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | Détermine le suivi appliqué à gauche du graphique. |
GroupElement | N’a aucun effet. |
TextElement | Détermine le suivi appliqué à gauche des caractères dans l’élément de texte. |
Exemple :
//positive tracking added to kerning var ef1:ElementFormat = new ElementFormat(); ef1.kerning = flash.text.engine.Kerning.ON; ef1.trackingLeft = 0.5; //negative manual kerning var ef2:ElementFormat = new ElementFormat(); ef2.kerning = flash.text.engine.Kerning.OFF; ef2.trackingLeft = -1.0;
Implémentation
public function get trackingLeft():Number
public function set trackingLeft(value:Number):void
Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Plus d’exemples
trackingRight | propriété |
trackingRight:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Interlettrage ou crénage manuel à appliquer à droite de chaque glyphe, en pixels. Si kerning
est activé, la valeur trackingRight
est ajoutée aux valeurs dans la table de crénage de la police. Si kerning
est désactivé, la valeur trackingRight
est utilisée comme valeur de crénage manuel. Prend en charge les valeurs positives et négatives.
De façon générale, la valeur de suivi désirée est divisée entre trackingRight
et trackingLeft
. Autrement, dans le cas de texte combinant plusieurs directions, le suivi est double au niveau d’une limite bidirectionnelle et nul pour l’autre.
La valeur par défaut est 0.0
.
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | Détermine le suivi appliqué à droite du graphique. |
GroupElement | N’a aucun effet. |
TextElement | Détermine le suivi appliqué à droite des caractères dans l’élément de texte. |
Exemple :
//positive tracking added to kerning var ef1:ElementFormat = new ElementFormat(); ef1.kerning = flash.text.engine.Kerning.ON; ef1.trackingRight = 0.5; //negative manual kerning var ef2:ElementFormat = new ElementFormat(); ef2.kerning = flash.text.engine.Kerning.OFF; ef2.trackingRight = -1.0;
Implémentation
public function get trackingRight():Number
public function set trackingRight(value:Number):void
Valeur émise
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Plus d’exemples
typographicCase | propriété |
typographicCase:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Casse typographique utilisée pour ce texte. Utilisez les constantes définies dans la classe TypographicCase pour cette propriété.
La valeur par défaut est TypographicCase.DEFAULT
.
Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :
Valeur de chaîne | Description |
---|---|
TypographicCase.DEFAULT | Indique que le style de casse normal est utilisé pour tous les caractères. |
TypographicCase.TITLE | Spécifie que les caractères majuscules utilisent des glyphes de titre en sortie. |
TypographicCase.CAPS | Spécifie que l’espacement est ajusté pour les caractères majuscules en sortie. |
TypographicCase.SMALL_CAPS | Spécifie que les caractères majuscules utilisent des glyphes de petites majuscules en sortie. |
TypographicCase.UPPERCASE | Spécifie que tous les caractères utilisent des glyphes majuscules en sortie. |
TypographicCase.LOWERCASE | Spécifie que tous les caractères utilisent des glyphes minuscules en sortie. |
TypographicCase.CAPS_AND_SMALL_CAPS | Spécifie que les caractères minuscules utilisent des glyphes de petites majuscules en sortie. |
Sous-classe | Effet de la définition des propriétés |
---|---|
GraphicElement | N’a aucun effet. |
GroupElement | N’a aucun effet. |
TextElement | Détermine la casse typographique utilisée pour le texte dans l’élément. |
Implémentation
public function get typographicCase():String
public function set typographicCase(value:String):void
Valeur émise
ArgumentError — Si la propriété est définie sur une valeur n’appartenant pas à TypographicCase .
| |
IllegalOperationError — Si elle est définie une fois l’objet ElementFormat bloqué (la propriété locked est définie sur true ).
|
Plus d’exemples
Eléments de l’API associés
ElementFormat | () | Constructeur |
public function ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Crée un objet ElementFormat.
ParamètresfontDescription:FontDescription (default = null ) — Objet FontDescription identifiant la police utilisée avec cette mise en forme d’élément. La valeur par défaut est null . Lorsque aucune description de police n’est fournie, une description de police par défaut est construite.
| |
fontSize:Number (default = 12.0 ) — La taille du texte, en pixels.
| |
color:uint (default = 0x000000 ) — Couleur du texte. Nombre hexadécimal contenant trois composants RVB 8 bits ; par exemple, 0xFF0000 correspond au rouge et 0x00FF00 au vert.
| |
alpha:Number (default = 1.0 ) — Propriété alpha appliquée à tous les atomes de ligne sur la base de la mise en forme des éléments.
| |
textRotation:String (default = "auto ") — rotation appliquée aux glyphes individuelles. Utilisez les constantes TextRotation pour cette propriété.
| |
dominantBaseline:String (default = "roman ") — Ligne de base à laquelle les glyphes du texte s’accrochent. Utilisez les constantes TextBaseline pour cette propriété.
| |
alignmentBaseline:String (default = "useDominantBaseline ") — Ligne de base sur la ligne conteneur à laquelle la ligne de base dominante s’accroche. Utilisez les constantes TextBaseline pour cette propriété.
| |
baselineShift:Number (default = 0.0 ) — Décalage de la ligne de base pour le texte, en pixels em.
| |
kerning:String (default = "on ") — Crénage utilisé pour ce texte. Utilisez les constantes définies dans la classe Kerning.
| |
trackingRight:Number (default = 0.0 ) — Interlettrage ou crénage manuel à appliquer à droite de chaque glyphe, en pixels.
| |
trackingLeft:Number (default = 0.0 ) — Interlettrage ou crénage manuel à appliquer à gauche de chaque glyphe, en pixels.
| |
locale:String (default = "en ") — Variable locale du texte.
| |
breakOpportunity:String (default = "auto ") — Opportunité de saut de ligne appliquée à ce texte. Utilisez les constantes BreakOpportunity pour cette propriété.
| |
digitCase:String (default = "default ") — Casse numérique utilisée pour ce texte. Utilisez les constantes DigitCase pour cette propriété.
| |
digitWidth:String (default = "default ") — Largeur de chiffres utilisée pour ce texte. Utilisez les constantes DigitWidth pour cette propriété.
| |
ligatureLevel:String (default = "common ") — Niveau de ligature utilisé pour ce texte. Utilisez les constantes LigatureLevel pour cette propriété.
| |
typographicCase:String (default = "default ") — Casse typographique utilisée pour ce texte. Utilisez les constantes TypographicCase pour cette propriété.
|
Valeur émise
ArgumentError — Le paramètre fontSize spécifié est inférieur à 0.
| |
ArgumentError — Le paramètre textRotation spécifié n’appartient pas à TextRotation .
| |
ArgumentError — Le paramètre dominantBaseline spécifié n’appartient pas àTextBaseline .
| |
ArgumentError — Le paramètre alignmentBaseline spécifié n’appartient pas àTextBaseline .
| |
ArgumentError — Le paramètre kerning spécifié n’appartient pas à Kerning .
| |
ArgumentError — Le paramètre breakOpportunity spécifié n’appartient pas à BreakOpportunity .
| |
ArgumentError — Le paramètre digitCase spécifié n’appartient pas à DigitCase .
| |
ArgumentError — Le paramètre digitWidth spécifié n’appartient pas à DigitWidth .
| |
ArgumentError — Le paramètre ligatureLevel spécifié n’appartient pas à LigatureLevel .
| |
ArgumentError — Le paramètre typographicCase spécifié n’appartient pas à TypographicCase .
|
clone | () | méthode |
public function clone():ElementFormat
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Crée une copie non verrouillée et clonée de l’objet ElementFormat.
Valeur renvoyéeElementFormat — Une copie non verrouillée de l’objet ElementFormat .
|
Plus d’exemples
Exemple ( Comment utiliser cet exemple )
Cet exemple crée un objet ElementFormat
et définit la propriété FontSize
. Un nouvel objet TextElement
est créé (et bloqué), à 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 ElementFormat
, 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 l’objet ElementFormat
, modifiez ses propriétés, puis 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 ElementFormat_cloneExample extends Sprite { private var ef1:ElementFormat; private var ef2:ElementFormat; public function ElementFormat_cloneExample():void { var fd:FontDescription = new FontDescription(); fd.fontLookup = flash.text.engine.FontLookup.DEVICE; fd.fontName = "Palatino"; var ef1:ElementFormat = new ElementFormat(fd); ef1.fontSize=20; 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); ef2 = (ef1.locked) ? ef1.clone() : ef1; ef2.fontSize = 32; tb.content.elementFormat=ef2; var line2:TextLine = tb.createTextLine(null, 600); addChild(line2); } } }
getFontMetrics | () | méthode |
public function getFontMetrics():FontMetrics
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Renvoie un objet FontMetrics
avec des propriétés qui décrivent la valeur emBox, la position et l’épaisseur du barré et du soulignement pour la police spécifiée par fontDescription
et fontSize
.
FontMetrics — Objet FontMetrics décrivant les propriétés de la police spécifiée par fontDescription .
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
ElementFormat
avec un FontDescription
affecté et utilise la méthode getFontMetrics
pour afficher les mesures de la police choisie (24 points).
package { import flash.display.Sprite; import flash.text.engine.*; public class FontMetricsExample extends Sprite { public function FontMetricsExample():void { var fd:FontDescription = new FontDescription(); fd.fontName = "Garamond"; fd.fontWeight = flash.text.engine.FontWeight.BOLD; var ef1:ElementFormat = new ElementFormat(fd); ef1.fontSize = 24; var fm1:FontMetrics = ef1.getFontMetrics(); trace(fm1.emBox); trace(fm1.strikethroughOffset); trace(fm1.strikethroughThickness); trace(fm1.subscriptScale); trace(fm1.subscriptOffset); trace(fm1.superscriptScale); trace(fm1.superscriptOffset); trace(fm1.underlineOffset); trace(fm1.underlineThickness); } } }
Cet exemple crée deux objets ElementFormat
et définit plusieurs de leurs propriétés. Il affecte ensuite le nouvel ElementFormats à un objet TextElement
, qui a été affecté en tant que contenu d’un TextBlock
. Notez que la modification du ElementFormat
d’un TextElement
n’affecte pas les TextLines créés précédemment par le TextBlock parent.
package { import flash.display.Sprite; import flash.text.engine.*; public class ElementFormatExample extends Sprite { public function ElementFormatExample():void { var fd:FontDescription = new FontDescription(); fd.fontName = "Garamond"; fd.fontWeight = flash.text.engine.FontWeight.BOLD; var ef1:ElementFormat = new ElementFormat(fd); ef1.fontSize = 30; ef1.color = 0xFF0000; ef1.alpha = 100; ef1.kerning = flash.text.engine.Kerning.ON; ef1.trackingRight = 2; ef1.typographicCase = flash.text.engine.TypographicCase.UPPERCASE; ef1.alignmentBaseline = flash.text.engine.TextBaseline.DESCENT; ef1.ligatureLevel = flash.text.engine.LigatureLevel.EXOTIC; var ef2:ElementFormat = new ElementFormat(fd); ef2.fontSize = 30; ef2.color = 0xFF0000; ef2.alpha = 0.3; ef2.kerning = flash.text.engine.Kerning.OFF; ef2.typographicCase = flash.text.engine.TypographicCase.LOWERCASE; ef2.digitCase = flash.text.engine.DigitCase.OLD_STYLE; ef2.textRotation = flash.text.engine.TextRotation.ROTATE_180; 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); line1.x = 15; line1.y = 30; tb.content.elementFormat = ef2; var line2:TextLine = tb.createTextLine(null, 600); addChild(line2); line2.x = 15; line2.y = 60; } } }
Tue Jun 12 2018, 09:30 AM Z