TextLayoutFormat  - AS3

Spécifie la ligne de base sur laquelle la ligne de base dominante s’aligne. Par exemple, si vous définissez dominantBaseline sur ASCENT, la définition de alignmentBaseline sur DESCENT aligne le haut du texte sur la ligne de base DESCENT ou en dessous. Le plus grand élément de la ligne détermine en général les lignes de base.

Les valeurs valides sont TextBaseline.ROMAN, TextBaseline.ASCENT, TextBaseline.DESCENT, TextBaseline.IDEOGRAPHIC_TOP, TextBaseline.IDEOGRAPHIC_CENTER, TextBaseline.IDEOGRAPHIC_BOTTOM, TextBaseline.USE_DOMINANT_BASELINE et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur TextBaseline.USE_DOMINANT_BASELINE.

Eléments de l’API associés

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flash.text.engine.TextBaseline;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextAlign;

    public class TextLayoutFormat_alignmentBaselineExample extends Sprite
    {
        public function TextLayoutFormat_alignmentBaselineExample()
        {
            // create text flow with dominantBaseline of ASCENT and 3 spans
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();
            paragraph.fontFamily = "Helvetica";
            paragraph.fontSize = 20;
            paragraph.dominantBaseline = TextBaseline.ASCENT    
            var spanOne:SpanElement = new SpanElement();
            var spanTwo:SpanElement = new SpanElement();
            var spanThree:SpanElement = new SpanElement();
            spanOne.text = "Hello, World  ";
            spanTwo.text = "Hello, World  ";
            spanThree.text = "Hello, World";
            
            // add spans to paragraph and specify alignment baseline for each
            paragraph.addChild(spanOne);
            spanOne.alignmentBaseline = TextBaseline.USE_DOMINANT_BASELINE;    
            paragraph.addChild(spanTwo);
            spanTwo.alignmentBaseline = TextBaseline.DESCENT;
            paragraph.addChild(spanThree);
            spanThree.alignmentBaseline = TextBaseline.IDEOGRAPHIC_CENTER;
            
            // add paragraph to TextFlow and set container position
            textFlow.addChild(paragraph);
            this.x = 50;
            this.y = 100;
            
            // update controller to display on stage
            textFlow.flowComposer.addController(new ContainerController(this,400,300));
            textFlow.flowComposer.updateAllControllers();    
        }
    }
}

Valeur alpha (transparence) pour l’arrière-plan (adopte la valeur par défaut si undefined pendant la propagation en cascade). La valeur 0 est entièrement transparente et la valeur 1 est complètement opaque. Les objets d’affichage où alpha est défini sur 0 sont actifs, même s’ils sont invisibles.

Les valeurs valides sont les nombres compris entre 0 et 1, et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété aura la valeur 1.

Couleur d’arrière-plan du texte (adopte la valeur par défaut si undefined pendant la propagation en cascade). Il peut s’agir de la valeur de la constante BackgroundColor.TRANSPARENT ou d’une valeur hexadécimale qui spécifie les trois valeurs RVB à 8 bits (rouge, vert, bleu), par exemple, 0xFF0000 est rouge et 0x00FF00 est vert.

Les valeurs valides en tant que chaîne sont BackgroundColor.TRANSPARENT, FormatValue.INHERIT et les nombres uint compris entre 0x0 et 0xffffffff.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété aura la valeur BackgroundColor.TRANSPARENT.

Eléments de l’API associés

Valeur de décalage de la ligne de base par rapport à la valeur dominantBaseline. Les unités sont en pixels, ou un pourcentage de fontSize (dans ce cas, entrez une valeur de chaîne, comme 140 %). Les valeurs positives décalent la ligne vers le haut pour le texte horizontal (à droite pour le texte vertical) et les valeurs négatives décalent la ligne vers le bas pour le texte horizontal (à gauche pour le texte vertical).

Les valeurs valides sont BaselineShift.SUPERSCRIPT, BaselineShift.SUBSCRIPT et FormatValue.INHERIT.

Les valeurs valides sous forme de nombre sont comprises entre -1000 et 1000.

Les valeurs en pourcentage sont comprises entre -1000 et 1000.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura une valeur de 0.0.

Eléments de l’API associés

Spécifie la progression verticale ou horizontale du positionnement de la ligne. Les lignes sont placées de haut en bas (BlockProgression.TB, pour le texte horizontal) ou de droite à gauche (BlockProgression.RL, pour le texte vertical).

Les valeurs valides sont BlockProgression.RL, BlockProgression.TB et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur BlockProgression.TB.

Eléments de l’API associés

Contrôle l’autorisation des sauts de ligne lignes lors de la séparation de l’habillage du texte en plusieurs lignes. Défini sur BreakOpportunity.AUTO pour diviser le texte normalement. Défini sur BreakOpportunity.NONE pour ne pas diviser le texte à moins que le texte ne dépasse la mesure et qu’il n’existe pas d’autres endroits auquel diviser la ligne. Défini sur BreakOpportunity.tout pour permettre le saut de ligne à n’importe quel endroit, plutôt qu’entre les mots. Défini sur BreakOpportunity.ALL pour placer chaque groupe typographique sur une ligne distincte (utile pour le texte d’un chemin).

Les valeurs valides sont BreakOpportunity.ALL, BreakOpportunity.ANY, BreakOpportunity.AUTO, BreakOpportunity.NONE et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur BreakOpportunity.AUTO.

Eléments de l’API associés

Type de repère CFF utilisé pour ce texte. Les repères CFF déterminent si l’exécution de Flash force les souches horizontales fortes à intégrer une grille de sous-pixels ou non. Cette propriété s’applique uniquement si la propriété renderingMode est définie sur RenderingMode.CFF et que la police est intégrée (la propriété fontLookup est définie sur FontLookup.EMBEDDED_CFF). Sur des écrans de petite taille, les repères produisent un texte clair et lisible pour les lecteurs humains.

Les valeurs valides sont CFFHinting.NONE, CFFHinting.HORIZONTAL_STEM et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur CFFHinting.HORIZONTAL_STEM.

Eléments de l’API associés

Contrôle la manière dont le texte enveloppe un élément flottant. Si la valeur "none" est définie, le texte peut envelopper étroitement un élément flottant. Si la valeur "left" est définie, le texte ignore toute partie du conteneur possédant un élément flottant gauche. Si la valeur "right" est définie, le texte ignore toute partie du conteneur possédant un élément flottant droit. Si la valeur "both" est définie, le texte ignore tous les éléments flottants.

Les valeurs possibles sont les suivantes : ClearFloats.START, ClearFloats.END, ClearFloats.LEFT, ClearFloats.RIGHT, ClearFloats.BOTH, ClearFloats.NONE et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si la valeur est undefined pendant la cascade, cette propriété aura la valeur ClearFloats.NONE.

Eléments de l’API associés

Couleur du texte. Nombre hexadécimal qui spécifie les trois valeurs RVB à 8 bits (rouge, vert, bleu) ; par exemple, 0xFF0000 est rouge et 0x00FF00 est vert.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 0.

Nombre de colonnes de texte (adopte la valeur par défaut si la valeur est undefined pendant la propagation en cascade). Le numéro de la colonne prévaut sur les autres paramètres de colonne. La valeur est un nombre entier ou FormatValue.AUTO si elle n’est pas spécifiée. Si le compte columnCount n’est pas spécifié, la largeur columnWidth est utilisée pour créer autant de colonnes que le conteneur peut en contenir.

Les valeurs valides en tant que chaîne sont FormatValue.AUTO, FormatValue.INHERIT et les ints de 1 à 50.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété aura la valeur FormatValue.AUTO.

Eléments de l’API associés

Spécifie la valeur de l’espace de gouttière, en pixels, à laisser entre les colonnes (adopte la valeur par défaut si undefined pendant la propagation en cascade). La valeur est un nombre

Les valeurs valides sont les nombres compris entre 0 et 1000, et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété aura la valeur 20.

Largeur de colonne en pixels (adopte la valeur par défaut si undefined pendant la propagation en cascade). Si vous spécifiez la largeur des colonnes, mais pas le nombre, l’objet TextLayout va créer autant de colonnes de cette largeur que possible, à partir des paramètres columnGap et de la largeur du conteneur. Tout espace restant est laissé après la dernière colonne. La valeur est un nombre.

Les valeurs valides en tant que chaîne sont FormatValue.AUTO, FormatValue.INHERIT et les nombres compris entre 0 et 8000.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété aura la valeur FormatValue.AUTO.

Eléments de l’API associés

Renvoie l’objet coreStyles sur cet objet TextLayoutFormat. L’objet coreStyles inclut les formats qui sont définis par TextLayoutFormat et qui se trouvent dans TextLayoutFormat.description. L’objet coreStyles renvoyé se compose d’un tableau de paires nom de style-valeur.

Eléments de l’API associés

Renvoie un objet TextLayoutFormat avec des paramètres par défaut. Cette méthode renvoie toujours le même objet.

Type de casse de chiffres utilisée pour ce texte. La définition de la valeur sur DigitCase.OLD_STYLE lettres minuscules se rapproche fonctionnalité et avec des jambages. Les chiffres sont espacés proportionnellement. Ce style n’est disponible que dans les caractères sélectionnés, le plus souvent dans une police supplémentaire ou spéciale. Le paramètre DigitCase.LINING a une hauteur en majuscules et est généralement à espacement fixe pour s’aligner dans les graphiques.

Les valeurs valides sont DigitCase.DEFAULT, DigitCase.LINING, DigitCase.OLD_STYLE et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur DigitCase.DEFAULT.

Eléments de l’API associés

Type de largeur de chiffres utilisée pour ce texte. La valeur peut être DigitWidth.PROPORTIONAL, ce qui est la meilleure approche pour les nombres individuels, ou DigitWidth.TABULAR, qui est recommandé pour les nombres inclus dans les tableaux, diagrammes et lignes verticales.

Les valeurs valides sont DigitWidth.DEFAULT, DigitWidth.PROPORTIONAL, DigitWidth.TABULAR et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur DigitWidth.DEFAULT.

Eléments de l’API associés

Spécifie le niveau d’intégration bidirectionnelle par défaut du texte dans le bloc de texte. Sens de lecture de gauche à droite, comme dans les scripts de style latin, ou de droite à gauche, comme en arabe ou en hébreu. Cette propriété affecte également le sens de la colonne lorsqu’elle est appliquée au niveau du conteneur. Les colonnes peuvent se lire de gauche à droite ou de droite à gauche, exactement comme du texte. Voici quelques exemples :

Les valeurs valides sont Direction.LTR, Direction.RTL et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur Direction.LTR.

Eléments de l’API associés

Spécifie la ligne de base de l’élément s’alignant sur alignmentBaseline pour déterminer la position verticale de l’élément sur la ligne. La valeur TextBaseline.AUTO sélectionne la ligne de base dominante en fonction de la propriété locale du paragraphe parent. Pour le chinois et le japonais, la valeur de ligne de base sélectionnée est TextBaseline.IDEOGRAPHIC_CENTER ; pour tous les autres, il s’agit de TextBaseline.ROMAN. Ces choix de base sont déterminés par le choix de police et la taille de police.

Les valeurs valides sont FormatValue.AUTO, TextBaseline.ROMAN, TextBaseline.ASCENT, TextBaseline.DESCENT, TextBaseline.IDEOGRAPHIC_TOP, TextBaseline.IDEOGRAPHIC_CENTER, TextBaseline.IDEOGRAPHIC_BOTTOM et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur FormatValue.AUTO.

Eléments de l’API associés

Spécifie la position de la ligne de base de la première ligne du conteneur. La ligne de base à laquelle cette propriété fait référence dépend de la langue définie au niveau du conteneur. Pour le chinois et le japonais, la valeur est TextBaseline.IDEOGRAPHIC_BOTTOM et pour toutes les autres langues, la valeur est TextBaseline.ROMAN La valeur du décalage entre l’encart supérieur (ou l’encart droit si la valeur de blockProgression est RL) du conteneur et la ligne de base de la première ligne peut être BaselineOffset.ASCENT, c’est-à-dire égale à la hauteur de la ligne,BaselineOffset.LINE_HEIGHT, c’est-à-dire égale à la hauteur de cette première ligne, ou n’importe quel nombre de valeur fixe pour indiquer une distance absolue. BaselineOffset.AUTO aligne la hauteur de la ligne sur l’encart supérieur du conteneur.

Les valeurs valides en tant que chaîne sont BaselineOffset.AUTO, BaselineOffset.ASCENT, BaselineOffset.LINE_HEIGHT, FormatValue.INHERIT et les nombres compris entre 0 et 1000.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur BaselineOffset.AUTO.

Eléments de l’API associés

Nom de la police à utiliser, ou liste de noms de police séparés par une virgule. Pour le rendu de l’élément, le moteur d’exécution Flash 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.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura pour valeur Arial.

Recherche de police à utiliser. Si vous spécifiez FontLookup.DEVICE, les polices installées sur le système qui utilise le fichier SWF sont utilisées. Les polices de périphérique donnent la taille des fichiers d’animation, mais le texte n’est pas toujours restitué de la même façon selon les systèmes et plates-formes. Si vous spécifiez FontLookup.EMBEDDED_CFF, des polices vectorielles incorporées dans le fichier SWF publié sont utilisées. Les polices incorporées augmentent la taille du fichier SWF (parfois nettement), mais le texte est systématiquement affiché dans la police choisie.

Les valeurs valides sont FontLookup.DEVICE, FontLookup.EMBEDDED_CFF et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur FontLookup.DEVICE.

Eléments de l’API associés

La taille du texte en pixels.

Les valeurs valides sont les nombres compris entre 1 et 720, et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 12.

Style de texte. Peut être FontPosture.NORMAL, à utiliser en texte brut, ou FontPosture.ITALIC pour l’italique. Cette propriété s’applique uniquement aux polices de périphérique (fontLookup est définie sur flash.text.engine.FontLookup.DEVICE).

Les valeurs valides sont FontPosture.NORMAL, FontPosture.ITALIC et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur FontPosture.NORMAL.

Eléments de l’API associés

Epaisseur du texte. Peut être FontWeight.NORMAL pour une utilisation en texte brut ou FontWeight.BOLD. S’applique uniquement aux polices de périphérique (fontLookup est définie sur flash.text.engine.FontLookup.DEVICE).

Les valeurs valides sont FontWeight.NORMAL, FontWeight.BOLD et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur FontWeight.NORMAL.

Eléments de l’API associés

Règle utilisée pour justifier le texte dans un paragraphe. La valeur par défaut est FormatValue.AUTO, qui justifie le texte en fonction de la propriété locale du paragraphe. Pour toutes les langues, sauf le japonais et le chinois, FormatValue.AUTO devient JustificationRule.SPACE, qui ajoute un espace supplémentaire aux caractères d’espace. Pour le chinois et le japonais, FormatValue.AUTO devient JustficationRule.EAST_ASIAN. La justification change partiellement l’espacement de la ponctuation. Dans un texte en caractères romains, la virgule et les points japonais prennent une largeur de caractère complète, mais seulement la moitié de cette largeur dans un texte en caractères asiatiques. Par ailleurs, dans le texte en caractères asiatiques, l’espacement entre les signes de ponctuation séquentielle se rapproche, obéissant ainsi aux conventions typographiques asiatiques traditionnelles. Notez également, dans l’exemple ci-après, l’interligne qui est appliqué à la deuxième ligne des paragraphes. Dans la version asiatique, les deux dernières lignes sont décalées à gauche. Dans la version en caractères romains, la deuxième ligne et les lignes suivantes sont décalées à gauche.

Les valeurs valides sont JustificationRule.EAST_ASIAN, JustificationRule.SPACE, FormatValue.AUTO et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur FormatValue.AUTO.

Eléments de l’API associés

Style utilisé pour la justification du paragraphe. A utiliser uniquement en combinaison avec un paramètre justificationRule de la règle JustificationRule.EAST_ASIAN. La valeur par défaut FormatValue.AUTO est résolue sur JustificationStyle.PUSH_IN_KINSOKU pour toutes les langues. Les constantes définies par la classe JustificationStyle spécifient les options de gestion des caractères kinsoku, c’est-à-dire des caractères japonais qui ne peuvent pas s’afficher au début ou à la fin d’une ligne. Pour obtenir un texte plus étiré, spécifiez JustificationStyle.PUSH-OUT-ONLY. Si vous souhaitez un comportement similaire à celui obtenu avec le paramètre justificationRule de la règle JustificationRule.SPACE, utilisez JustificationStyle.PRIORITIZE-LEAST-ADJUSTMENT.

Les valeurs valides sont JustificationStyle.PRIORITIZE_LEAST_ADJUSTMENT, JustificationStyle.PUSH_IN_KINSOKU, JustificationStyle.PUSH_OUT_ONLY, FormatValue.AUTO et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur FormatValue.AUTO.

Eléments de l’API associés

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.

Les valeurs valides sont Kerning.ON, Kerning.OFF, Kerning.AUTO et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur Kerning.AUTO.

Eléments de l’API associés

Spécifie le modèle d’interlignage, qui est une combinaison de la base et de la direction de l’interlignage. La base d’interlignage est la ligne de base à laquelle se rapporte la propriété lineHeight. Le sens de l’interlignage détermine si la propriété lineHeight fait référence à la distance de la ligne de base d’une ligne par rapport à celle de la ligne précédente ou suivante. La valeur par défaut FormatValue.AUTO est résolue en fonction de la propriété locale du paragraphe. Pour le chinois et le japonais, il s’agit de LeadingModel.IDEOGRAPHIC_TOP_DOWN et pour tous les autres, il s’agit de LeadingModel.ROMAN_UP.

Base d’interlignage :

Direction de l’interlignage :

Les valeurs valides sont LeadingModel.ROMAN_UP, LeadingModel.IDEOGRAPHIC_TOP_UP, LeadingModel.IDEOGRAPHIC_CENTER_UP, LeadingModel.IDEOGRAPHIC_TOP_DOWN, LeadingModel.IDEOGRAPHIC_CENTER_DOWN, LeadingModel.APPROXIMATE_TEXT_FIELD, LeadingModel.ASCENT_DESCENT_UP, LeadingModel.BOX, LeadingModel.AUTO et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur LeadingModel.AUTO.

Eléments de l’API associés

Définit laquelle des ligatures définies dans la police à utiliser dans le texte. Les ligatures qui apparaissent pour chacun de ces paramètres dépendent de la police. 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. Les ligatures activées par les valeurs de la classe LigatureLevel, MINIMUM, COMMON, UNCOMMON, et EXOTIC, sont cumulables. Chaque valeur active un nouvel ensemble de ligatures, mais comprend également ceux des types précédents.

Remarque : lorsque vous utilisez les polices Arabic ou Syriac, ligatureLevel doit être défini sur MINIMUM ou une valeur supérieure.

Les valeurs valides sont LigatureLevel.MINIMUM, LigatureLevel.COMMON, LigatureLevel.UNCOMMON, LigatureLevel.EXOTIC et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur LigatureLevel.COMMON.

Eléments de l’API associés

Contrôle le retour à la ligne dans le conteneur (adopte la valeur par défaut si undefined pendant la propagation en cascade). Le texte du conteneur peut être défini pour s’adapter à la largeur du conteneur (LineBreak.TO_FIT) ou pour aller à la ligne uniquement lors de caractères de retour chariot ou de saut de ligne (LineBreak.EXPLICIT).

Les valeurs valides sont LineBreak.EXPLICIT, LineBreak.TO_FIT et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété aura la valeur LineBreak.TO_FIT.

Eléments de l’API associés

Contrôles d’interligne du texte. La distance entre la ligne de base de la ligne précédente ou suivante (en fonction de LeadingModel) et la ligne de base de la ligne actuelle est égale à la quantité maximale de l’interlignage appliquée à n’importe quel caractère de la ligne. Il s’agit d’un nombre ou d’un pourcentage. Si vous spécifiez un pourcentage, entrez une valeur de chaîne, telle que 140 %.

Les valeurs numériques valides sont comprises entre -720 et 720.

Les valeurs en pourcentage valides sont comprises entre -1000 % à 1000 %.

Les valeurs valides incluent FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura une valeur de 120 %.

Si la valeur est true, applique le style de formatage barré, une ligne au milieu du texte.

Les valeurs valides sont true, false et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur false.

Définit les attributs de formatage utilisés pour les liens en état normal. Cette valeur est propagée en cascade vers le bas de la hiérarchie et s’applique à tous les liens descendants. Accepte inherit, un paramètre ITextLayoutFormat ou convertit un tableau d’objets avec une clé et une valeur en tant que membres vers un objet TextLayoutFormat.

Les valeurs valides incluent FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur null.

Définit les attributs de formatage utilisés pour les liens en état suspendu, c’est-à-dire lorsque l’utilisateur survole un lien avec la souris. Cette valeur est propagée en cascade vers le bas de la hiérarchie et s’applique à tous les liens descendants. Accepte inherit, un paramètre ITextLayoutFormat ou convertit un tableau d’objets avec une clé et une valeur en tant que membres vers un objet TextLayoutFormat.

Les valeurs valides incluent FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur null.

Définit les attributs de formatage utilisés pour les liens en état normal. Cette valeur est propagée en cascade vers le bas de la hiérarchie et s’applique à tous les liens descendants. Accepte inherit, un paramètre ITextLayoutFormat ou convertit un tableau d’objets avec une clé et une valeur en tant que membres vers un objet TextLayoutFormat.

Les valeurs valides incluent FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur null.

Cela spécifie un retrait automatique pour le bord de début des listes, lorsque la valeur d’espacement de la liste de ce côté est auto.

Les valeurs valides sont les nombres compris entre -1000 et 1000, et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 40.

Définit les marqueurs de liste d’attributs de mise en forme. Cette valeur est propagée en cascade vers le bas de la hiérarchie et s’applique à tous les liens descendants. Accepte inherit, un paramètre IListMarkerFormat ou convertit un tableau d’objets avec une clé et une valeur en tant que membres vers un objet ListMarkerFormat.

Les valeurs valides incluent FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur null.

Les valeurs valides sont ListStylePosition.INSIDE, ListStylePosition.OUTSIDE et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur ListStylePosition.OUTSIDE.

Eléments de l’API associés

Les valeurs valides sont ListStyleType.UPPER_ALPHA, ListStyleType.LOWER_ALPHA, ListStyleType.UPPER_ROMAN, ListStyleType.LOWER_ROMAN, ListStyleType.NONE, ListStyleType.DISC, ListStyleType.CIRCLE, ListStyleType.SQUARE, ListStyleType.BOX, ListStyleType.CHECK, ListStyleType.DIAMOND, ListStyleType.HYPHEN, ListStyleType.ARABIC_INDIC, ListStyleType.BENGALI, ListStyleType.DECIMAL, ListStyleType.DECIMAL_LEADING_ZERO, ListStyleType.DEVANAGARI, ListStyleType.GUJARATI, ListStyleType.GURMUKHI, ListStyleType.KANNADA, ListStyleType.PERSIAN, ListStyleType.THAI, ListStyleType.URDU, ListStyleType.CJK_EARTHLY_BRANCH, ListStyleType.CJK_HEAVENLY_STEM, ListStyleType.HANGUL, ListStyleType.HANGUL_CONSTANT, ListStyleType.HIRAGANA, ListStyleType.HIRAGANA_IROHA, ListStyleType.KATAKANA, ListStyleType.KATAKANA_IROHA, ListStyleType.LOWER_ALPHA, ListStyleType.LOWER_GREEK, ListStyleType.LOWER_LATIN, ListStyleType.UPPER_ALPHA, ListStyleType.UPPER_GREEK, ListStyleType.UPPER_LATIN et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur ListStyleType.DISC.

Eléments de l’API associés

Variable locale du texte. Contrôle les transformations de casse et de forme. Les identifiants de langue standard tels que décrits dans la norme technique Unicode #35 sont utilisés. Par exemple en, en_US et en-US correspondent à l’anglais, ja au japonais.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur en.

Encart inférieur en pixels. Par défaut, auto a la valeur zéro, sauf dans les listes qui obtiennent un espacement côté début de 45. (adopte la valeur par défaut si la valeur est non définie pendant la propagation en cascade). Espace entre le bord inférieur du conteneur et le texte. La valeur est un nombre ou auto.

Avec le texte horizontal, dans les conteneurs défilants à plusieurs colonnes, la première colonne et les suivantes affichent la marge sous forme d’espace au bas du conteneur ; mais pour la dernière colonne, si le texte ne tient pas entièrement, vous devrez éventuellement le faire défiler pour voir la marge.

Les valeurs valides en tant que chaîne sont FormatValue.AUTO, FormatValue.INHERIT et les nombres compris entre -8000 et 8000.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété aura la valeur FormatValue.AUTO.

Eléments de l’API associés

Encart gauche en pixels. Par défaut, auto a la valeur zéro, sauf dans les listes qui obtiennent un espacement côté début de 45. (adopte la valeur par défaut si la valeur est non définie pendant la propagation en cascade). Espace entre le bord gauche du conteneur et le texte. La valeur est un nombre ou auto.

Avec le texte vertical, dans les conteneurs défilants à plusieurs colonnes, la première colonne et les suivantes affichent la marge sous forme d’espace à la fin du conteneur ; mais pour la dernière colonne, si le texte ne tient pas entièrement, vous devrez éventuellement le faire défiler pour voir la marge.

Les valeurs valides en tant que chaîne sont FormatValue.AUTO, FormatValue.INHERIT et les nombres compris entre -8000 et 8000.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété aura la valeur FormatValue.AUTO.

Eléments de l’API associés

Encart droit en pixels. Par défaut, auto a la valeur zéro, sauf dans les listes qui obtiennent un espacement côté début de 45. (adopte la valeur par défaut si la valeur est non définie pendant la propagation en cascade). Espace entre le bord droit du conteneur et le texte. La valeur est un nombre ou auto.

Les valeurs valides en tant que chaîne sont FormatValue.AUTO, FormatValue.INHERIT et les nombres compris entre -8000 et 8000.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété aura la valeur FormatValue.AUTO.

Eléments de l’API associés

Encart supérieur en pixels. Par défaut, auto a la valeur zéro, sauf dans les listes qui obtiennent un espacement côté début de 45. (adopte la valeur par défaut si la valeur est non définie pendant la propagation en cascade). Espace entre le bord supérieur du conteneur et le texte. La valeur est un nombre ou auto.

Les valeurs valides en tant que chaîne sont FormatValue.AUTO, FormatValue.INHERIT et les nombres compris entre -8000 et 8000.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété aura la valeur FormatValue.AUTO.

Eléments de l’API associés

Nombre qui indique, en pixels, la valeur de retrait du bord de la fin du paragraphe. Fait référence au bord droit dans un texte rédigé de gauche à droite et au bord gauche dans un texte rédigé de droite à gauche.

Les valeurs valides sont les nombres compris entre 0 et 8000, et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 0.

Nombre qui indique la quantité d’espace, en pixels, à laisser après le paragraphe. Réduit en tandem avec paragraphSpaceBefore.

Les valeurs valides sont les nombres compris entre 0 et 8000, et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 0.

Nombre qui indique la quantité d’espace, en pixels, à laisser avant le paragraphe. Réduit en tandem avec paragraphSpaceAfter.

Les valeurs valides sont les nombres compris entre 0 et 8000, et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 0.

Nombre qui indique, en pixels, la valeur de retrait du bord de la fin du paragraphe. Fait référence au bord gauche dans un texte rédigé de gauche à droite et au bord droit dans un texte rédigé de droite à gauche.

Les valeurs valides sont les nombres compris entre 0 et 8000, et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 0.

Mode de rendu utilisé pour ce texte. S’applique uniquement aux polices incorporées (la propriété fontLookup est définie sur FontLookup.EMBEDDED_CFF).

Les valeurs valides sont RenderingMode.NORMAL, RenderingMode.CFF et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur RenderingMode.CFF.

Eléments de l’API associés

Attribue une classe d’identification à l’élément, ce qui permet de définir le style de l’élément en référençant la propriété styleName.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la cascade la valeur est undefined, cette propriété aura la valeur null.

Renvoie les styles sur cet objet TextLayoutFormat. Notez que la méthode Get effectue une copie du dictionnaire de styles. L’objet coreStyles encapsule tous les styles définis dans la propriété de format y compris les styles principaux et utilisateur. L’objet renvoyé se compose d’un tableau de paires nom de style-valeur.

Eléments de l’API associés

Spécifie les taquets de tabulation associés au paragraphe. Les accesseurs Set peuvent contenir un tableau de TabStopFormat, une représentation sous forme de chaîne condensée, une valeur undefined ou FormatValue.INHERIT. La représentation sous forme de chaîne condensée est toujours convertie en tableau d’objets TabStopFormat.

Le format basé sur une chaîne est une liste de taquets de tabulation, où chaque taquet de tabulation est délimité par un ou plusieurs espaces.

Un taquet de tabulation prend la forme suivante : <type d’alignement><position d’alignement>|<jeton d’alignement>.

Le type d’alignement est un caractère unique. Il peut s’agir des caractères S, E, C ou D (ou des équivalents minuscules). S ou s correspond à start, E ou e à end, C ou c à center, D ou d à decimal. Le type d’alignement est facultatif. S’il n’est pas spécifié, sa valeur est par défaut S.

La position d’alignement est un nombre qui est spécifié conformément aux spécifications FXG des nombres (notation décimale ou scientifique). La position d’alignement est obligatoire.

La barre verticale permet de séparer la position d’alignement du jeton d’alignement, et elle ne doit être présente que si le jeton d’alignement est présent.

Le jeton d’alignement est facultatif si l’alignement est de type D et ne doit pas être présent si le type d’alignement est autre que D. Le jeton d’alignement peut se composer de n’importe quelle séquence de caractères se terminant par l’espace qui met fin au taquet de tabulation (pour le dernier taquet de tabulation, l’espace de fin est facultatif ; la fin du jeton d’alignement étant implicite). Un espace peut faire partie du jeton d’alignement s’il s’accompagne d’une barre oblique inverse (\). Une barre oblique inverse peut faire partie du jeton d’alignement si elle est convertie avec une autre barre oblique inverse (\\). Si l’alignement est de type D et que le jeton d’alignement n’est pas spécifié, il prendra la valeur null par défaut.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur null.

Eléments de l’API associés

Alignement des lignes du paragraphe par rapport au conteneur. TextAlign.LEFT aligne les lignes le long du bord gauche du conteneur. TextAlign.RIGHT les aligne sur le bord droit. TextAlign.CENTER positionne la ligne à distance égale entre les bords gauche et droit. TextAlign.JUSTIFY répartit les lignes afin qu’elles remplissent l’espace. TextAlign.START équivaut à définir gauche dans du texte de gauche à droite ou droite dans du texte de droite à gauche. TextAlign.END revient à spécifier la droite pour un texte écrit de gauche à droite, ou à spécifier la gauche pour un texte écrit de droite à gauche.

Les valeurs valides sont TextAlign.LEFT, TextAlign.RIGHT, TextAlign.CENTER, TextAlign.JUSTIFY, TextAlign.START, TextAlign.END et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur TextAlign.START.

Eléments de l’API associés

Alignement de la dernière (ou de l’unique) ligne du paragraphe par rapport au conteneur dans un texte justifié. Si la propriété textAlign est définie sur TextAlign.JUSTIFY, textAlignLast indique la façon dont la dernière ligne (ou la ligne unique s’il s’agit d’un seul bloc de lignes) est alignée. Les valeurs sont similaires à textAlign.

Les valeurs valides sont TextAlign.LEFT, TextAlign.RIGHT, TextAlign.CENTER, TextAlign.JUSTIFY, TextAlign.START, TextAlign.END et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur TextAlign.START.

Eléments de l’API associés

Valeur alpha (transparence) du texte. La valeur 0 est entièrement transparente et la valeur 1 est complètement opaque. Les objets d’affichage où textAlpha est défini sur 0 sont actifs, même s’ils sont invisibles.

Les valeurs valides sont les nombres compris entre 0 et 1, et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 1.

Décoration du texte. Permet d’appliquer un soulignement. Par défaut, aucun soulignement n’est appliqué.

Les valeurs valides sont TextDecoration.NONE, TextDecoration.UNDERLINE et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur TextDecoration.NONE.

Eléments de l’API associés

Nombre qui indique la valeur de retrait de la première ligne du paragraphe. Une valeur de retrait négative pousse la ligne dans la marge, et probablement en dehors du conteneur.

Les valeurs valides sont les nombres compris entre -8000 et 8000, et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 0.

Spécifie des options de justification de texte. La valeur par défaut est TextJustify.INTER_WORD, ce qui signifie qu’un espace supplémentaire est ajouté aux espaces. TextJustify.DISTRIBUTE ajoute un espace supplémentaire aux espaces et entre chaque lettre. A utiliser uniquement en combinaison avec une valeur justificationRule de JustificationRule.SPACE.

Les valeurs valides sont TextJustify.INTER_WORD, TextJustify.DISTRIBUTE et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur TextJustify.INTER_WORD.

Eléments de l’API associés

Détermine le nombre de degrés de rotation de ce texte.

Les valeurs valides sont TextRotation.ROTATE_0, TextRotation.ROTATE_180, TextRotation.ROTATE_270, TextRotation.ROTATE_90, TextRotation.AUTO et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur TextRotation.AUTO.

Eléments de l’API associés

Nombre de pixels (ou pourcentage de taille fontSize, comme 120 %) indiquant la valeur d’interlettrage (crénage manuel) à appliquer à gauche de chaque caractère. Si le crénage est activé, la valeur trackingLeft est ajoutée aux valeurs de la table de crénage de la police. Si le crénage est désactivé, la valeur trackingLeft est utilisée comme valeur de crénage manuel. Prend en charge les valeurs positives et négatives.

Les valeurs valides sous forme de nombre sont comprises entre -1000 et 1000.

Les valeurs en pourcentage valides sont comprises entre -1000 % à 1000 %.

Les valeurs valides incluent FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 0.

Nombre de pixels (ou pourcentage de taille fontSize, comme 120 %) indiquant la valeur d’interlettrage (crénage manuel) à appliquer à droite de chaque caractère. Si le crénage est activé, la valeur trackingRight est ajoutée aux valeurs de la table de crénage de la police. Si le crénage est désactivé, la valeur trackingRight est utilisée comme valeur de crénage manuel. Prend en charge les valeurs positives et négatives.

Les valeurs valides sous forme de nombre sont comprises entre -1000 et 1000.

Les valeurs en pourcentage valides sont comprises entre -1000 % à 1000 %.

Les valeurs valides incluent FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 0.

Type de casse typographique utilisée pour ce texte. Voici quelques exemples :

Les valeurs valides sont TLFTypographicCase.DEFAULT, TLFTypographicCase.CAPS_TO_SMALL_CAPS, TLFTypographicCase.UPPERCASE, TLFTypographicCase.LOWERCASE, TLFTypographicCase.LOWERCASE_TO_SMALL_CAPS et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur TLFTypographicCase.DEFAULT.

Eléments de l’API associés

Renvoie l’objet userStyles sur cet objet TextLayoutFormat. L’objet userStyles inclut les formats qui sont définis par TextLayoutFormat et qui ne se trouvent pas dans TextLayoutFormat.description. L’objet userStyles renvoyé se compose d’un tableau de paires nom de style-valeur.

Eléments de l’API associés

Alignement vertical ou justification (adopte la valeur par défaut si undefined pendant la propagation en cascade). Indique la façon dont les éléments TextFlow s’alignent dans le conteneur.

Les valeurs valides sont VerticalAlign.TOP, VerticalAlign.MIDDLE, VerticalAlign.BOTTOM, VerticalAlign.JUSTIFY et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété aura la valeur VerticalAlign.TOP.

Eléments de l’API associés

Réduit ou conserve les espaces lors de l’importation de texte dans un objet TextFlow. WhiteSpaceCollapse.PRESERVE conserve tous les espaces. WhiteSpaceCollapse.COLLAPSE supprime les nouvelles lignes, les tabulations et l’interlignage ou les espaces dans un bloc de texte importé. Les caractères de balise de saut de ligne () et de séparateur de ligne Unicode sont conservés.

Les valeurs valides sont WhiteSpaceCollapse.PRESERVE, WhiteSpaceCollapse.COLLAPSE et FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété elle aura la valeur WhiteSpaceCollapse.COLLAPSE.

Eléments de l’API associés

Spécifie les espacements optimal, minimal et maximal (comme multiplicateur de la largeur d’un espace normal) entres les mots à utiliser lors de la justification. L’espace optimal permet d’indiquer la taille souhaitée d’un espace, sous la forme d’une fraction de la valeur définie dans la police. Les valeurs minimale et maximale sont utilisés lorsque textJustify a la valeur distribute pour déterminer la largeur que peuvent prendre les espaces entre les mots avant que l’espacement des lettres soit utilisé pour justifier la ligne.

Les valeurs en pourcentage valides sont comprises entre -1000 % à 1000 %.

Les valeurs valides incluent FormatValue.INHERIT.

La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie.

Si lors de la propagation en cascade la valeur est undefined, cette propriété hérite ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 100 %, 50 %, 150 %.

Crée un nouvel objet TextLayoutFormat. Tous les paramètres sont vides ou peuvent être initialisés à partir de l’objet initialValues fourni.

Eléments de l’API associés

Remplace les valeurs des propriétés de cet objet TextLayoutFormat par les valeurs des propriétés qui sont définies dans l’occurrence incoming ITextLayoutFormat. Les propriétés dont les valeurs sont undefined dans l’occurrence incoming ITextLayoutFormat ne sont pas modifiées dans cet objet.

Paramètres

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_applyExample extends Sprite
    {
        public function TextLayoutFormat_applyExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes in the first one
            textLayoutFormat.textIndent = 8;
            textLayoutFormat.color = 0x336633;
            textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
            textLayoutFormat.fontSize = 24;
            // set some of the same attributes on the second one
            textLayoutFormat2.color = 0x0000CC;
            textLayoutFormat2.fontSize = 12;
            textLayoutFormat2.textIndent = 24;
            // add text to the span, the span to the paragraph, and the paragraph to the text flow.
            span.text = "Notice that fontFamily is unchanged because it was undefined in textLayoutFormat2.";
            p.addChild( span);
            textFlow.addChild(p);
            // use apply() to apply textLayoutFormat2 format settings; assign format to the text flow
            textLayoutFormat.apply(textLayoutFormat2);  
            textFlow.hostFormat = textLayoutFormat;  
            // add paragraph to textFlow and update controller to display it
            textFlow.addChild(p);
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();  
        }
    }
}

Concatène les valeurs des propriétés de l’occurrence incoming ITextLayoutFormat avec les valeurs de cet objet TextLayoutFormat. Dans cet objet TextLayoutFormat (l’objet récepteur), les propriétés dont les valeurs sont FormatValue.INHERIT et les propriétés héritières dont les valeurs sont undefined reçoivent de nouvelles valeurs de la part de l’objet incoming. Les propriétés non héritières dont les valeurs sont undefined reçoivent leurs valeurs par défaut. Les valeurs de toutes les autres propriétés restent inchangées.

Paramètres

Eléments de l’API associés

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_concatExample extends Sprite
    {
        public function TextLayoutFormat_concatExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes in the first one
            textLayoutFormat.textIndent = 8;
            textLayoutFormat.color = 0x336633;
            textLayoutFormat.fontSize = 18;
            // set some of the same attributes on the second one
            textLayoutFormat2.textIndent = 24;
            textLayoutFormat2.color = 0x0000CC;
            textLayoutFormat2.fontSize = 12;
            textLayoutFormat2.fontFamily = "Arial, Helvetica, _sans";
            // concat textLayoutFormat2 settings; assign format to the text flow
            textLayoutFormat.concat(textLayoutFormat2);    
            textFlow.hostFormat = textLayoutFormat; 
            // add text to the span, the span to the paragraph, and the paragraph to the text flow.
            span.text = "Notice that fontFamily value has been added from textLayout2 to textLayout but " +
                "the other values have not been changed.";     
            p.addChild( span);
            textFlow.addChild(p);
            // update controller to display it
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}

Concatène les valeurs des propriétés de l’occurrence incoming ITextLayoutFormat avec les valeurs de cet objet TextLayoutFormat. Dans cet objet TextLayoutFormat (l’objet récepteur), les propriétés dont les valeurs sont FormatValue.INHERIT et les propriétés héritières dont les valeurs sont undefined reçoivent de nouvelles valeurs de la part de l’objet incoming. Les valeurs de toutes les autres propriétés restent inchangées.

Paramètres

Eléments de l’API associés

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_concatInheritOnlyExample extends Sprite
    {
        public function TextLayoutFormat_concatInheritOnlyExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes in the first one
            textLayoutFormat.color = 0xFF0000;
            textLayoutFormat.fontSize = undefined;            
            // set attributes on the second one (fontSize set here, too)
            textLayoutFormat2.color = 0x00FF00;
            textLayoutFormat2.backgroundColor = 0x00CCCC;
            textLayoutFormat2.fontSize = 16;
            textLayoutFormat2.fontFamily = "Times Roman";
            // concat textLayoutFormat2 settings; assign format to the text flow
            textLayoutFormat.concatInheritOnly(textLayoutFormat2);    
            textFlow.hostFormat = textLayoutFormat; 
            // add text to the span, the span to the paragraph, and the paragraph to the text flow.
            span.text = "Notice that the value of backgroundColor is "
            span.text += textLayoutFormat.backgroundColor;
            span.text += ", even though it is set in textLayoutFormat2. This is because " +
                "this property does not inherit. Also notice that font color does not change " +
                "because it is not undefined."
            p.addChild( span);
            textFlow.addChild(p);
            // update controller to display it
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();  
        }
    }
}

Copie les paramètres TextLayoutFormat à partir de l’occurrence values ITextLayoutFormat dans cet objet TextLayoutFormat. Si les valeurs sontnull, cet objet TexteLayoutFormat est initialisé avec des valeurs non définies pour toutes les propriétés.

Paramètres

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_copyExample extends Sprite
    {
        public function TextLayoutFormat_copyExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes in the second one
            textLayoutFormat2.textIndent = 8;
            textLayoutFormat2.color = 0x336633;
            textLayoutFormat2.fontFamily = "Times Roman";
            textLayoutFormat2.fontSize = 18;
            // add text to the span, the span to the paragraph, and the paragraph to the text flow.
            span.text = "Notice that formatting values set in textLayoutFormat2 override " +
                "the default values in textLayoutFormat."; 
            p.addChild(span);
            textFlow.addChild(p);
            // copy format settings of textLayoutFormat2; assign format to the text flow
            textLayoutFormat.copy(textLayoutFormat2);
            textFlow.hostFormat = textLayoutFormat;  
            // add paragraph to textFlow and update controller to display it
            textFlow.addChild(p);
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();      
        }
    }
}

Crée un nouvel objet TextLayoutFormat. Tous les paramètres sont vides ou peuvent être initialisés à partir de l’objet initialValues fourni.

Paramètres

Renvoie la valeur du style spécifié par le paramètre styleProp, qui spécifie le nom du style.

Paramètres

Compare les propriétés de l’occurrence ITextLayoutFormat p1 avec celles de l’occurrence ITextLayoutFormat p2 et renvoie la valeur true si toutes les propriétés correspondent.

Paramètres

Définit les propriétés de cet objet TextLayoutFormat sur undefined si elles ne correspondent pas à celles de l’occurrence ITextLayoutFormat incoming.

Paramètres

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_removeClashingExample extends Sprite
    {
        public function TextLayoutFormat_removeClashingExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes for textLayoutFormat2
            textLayoutFormat.textIndent = 8;
            textLayoutFormat.color = 0x336633;
            textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
            textLayoutFormat.fontSize = 24;
            // set fontFamily to same value for textLayoutFormat2            
            textLayoutFormat2.fontFamily = "Arial, Helvetica, _sans";
            // add text to the span, the span to the paragraph, and the paragraph to the text flow.
            span.text = "Notice that fontFamily (Arial, Helvetica, _sans) is applied." 
            p.addChild( span);
            textFlow.addChild(p);    
            // call removeClashing(), cancelling any values that clash with textLayoutFormat; 
            // assign it to the text flow
            textLayoutFormat.removeClashing(textLayoutFormat2);  
            textFlow.hostFormat = textLayoutFormat;  
            // add paragraph to textFlow and update controller to display it
            textFlow.addChild(p);
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();  
        }
    }
}

Définit les propriétés de cet objet TextLayoutFormat sur undefined si elles correspondent à celles de l’occurrence ITextLayoutFormat incoming.

Paramètres

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_removeMatchingExample extends Sprite
    {
        public function TextLayoutFormat_removeMatchingExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes for textLayoutFormat
            textLayoutFormat.textIndent = 8;
            textLayoutFormat.color = 0x336633;
            textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
            textLayoutFormat.fontSize = 24;
            // add text to the span, the span to the paragraph, and the paragraph to the text flow
            span.text = "Notice that fontFamily (Arial, Helvetica, _sans) is not applied." 
            p.addChild( span);
            textFlow.addChild(p);
            // set fontFamily to same value for textLayoutFormat2            
            textLayoutFormat2.fontFamily = "Arial, Helvetica, _sans";        
            // call removeMatching() to remove any values that match textLayoutFormat2; 
            // assign textLayoutFormat to the text flow
            textLayoutFormat.removeMatching(textLayoutFormat2);
            textFlow.hostFormat = textLayoutFormat;  
            // add paragraph to textFlow and update controller to display it
            textFlow.addChild(p);
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();  
        }
    }
}

Définit le style spécifié par le paramètre styleProp sur la valeur spécifiée par le paramètre newValue.

Paramètres