FlowElement  - AS3

TextLayoutFormat : 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

TextLayoutFormat : valeur alpha (transparence) pour l’arrière-plan (adopte la valeur par défaut si undefined pendant la 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.

TextLayoutFormat : 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

TextLayoutFormat : 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

TextLayoutFormat : 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éritera 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

TextLayoutFormat : contrôle l’autorisation des sauts de ligne 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

TextLayoutFormat : 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

TextLayoutFormat : contrôle la manière dont le texte enveloppe un élément flottant. La valeur none permet d’ajuster le plus étroitement possible le texte autour d’un élément flottant. Si la valeur left (gauche) est définie, le texte ignorera toute partie du conteneur possédant un élément flottant gauche, tandis que si la valeur right (droite) est définie, le texte ignorera toute partie du conteneur possédant un élément flottant droit. Si ces deux valeurs sont définies, le texte ignorera tout élément flottant.

Les valeurs valides sont 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 lors de la propagation en cascade, la valeur est undefined, cette propriété aura la valeur ClearFloats.NONE.

Eléments de l’API associés

TextLayoutFormat : 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.

TextLayoutFormat : 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

TextLayoutFormat : 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.

TextLayoutFormat : 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 les attributs de format de caractère calculés qui sont appliqués à cet élément. Prend en compte l’héritage des attributs d’éléments parent.

Eléments de l’API associés

Renvoie l’objet coreStyles sur cet objet FlowElement. Notez que la méthode Get effectue une copie du dictionnaire de styles principaux. L’objet coreStyles encapsule les formats qui sont définis par TextLayoutFormat et qui se trouvent dans TextLayoutFormat.description. L’objet coreStyles se compose d’un tableau de paires nom de style-valeur.

Eléments de l’API associés

TextLayoutFormat : le 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

TextLayoutFormat : 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

TextLayoutFormat : 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éritera 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

TextLayoutFormat : spécifie la ligne de base de l’élément s’alignant sur le 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

TextLayoutFormat : spécifie la position de 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éritera 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

TextLayoutFormat : 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.

TextLayoutFormat : 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

TextLayoutFormat : 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.

TextLayoutFormat : style du 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

TextLayoutFormat : épaisseur 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

Propriétés TextLayoutFormat appliquées directement à cet élément.

Chaque élément peut se voir appliquer des propriétés grâce à son format. Les propriétés appliquées à cet élément remplacent des propriétés héritées du parent. Les propriétés appliquées à cet élément seront à leur tour héritées par les enfants de l’élément si elles ne sont pas remplacées sur l’enfant. Si aucune propriété n’est appliquée à l’élément, cette propriété est null.

Eléments de l’API associés

Attribue un identifiant à l’élément. De fait, il est possible de définir le style de l’élément, vous pouvez donc référencer l’identifiant. Par exemple, la ligne suivante définit la couleur d’un objet SpanElement ayant un identifiant de span1 :

         textFlow.getElementByID("span1").setStyle("color", 0xFF0000);
         

Eléments de l’API associés

TextLayoutFormat : 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é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

TextLayoutFormat : 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é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

TextLayoutFormat : 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

TextLayoutFormat : 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éritera 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

TextLayoutFormat : contrôle laquelle des ligatures qui sont définies dans la police peut être utilisée 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

TextLayoutFormat : contrôle le retour à la ligne des mots 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

TextLayoutFormat : contrôles d’interlignage pour le 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 %.

TextLayoutFormat : 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.

TextLayoutFormat : définit les attributs de formatage utilisés pour les liens à l'é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éritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur null.

TextLayoutFormat : définit les attributs de formatage utilisés pour les liens à l'é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.

TextLayoutFormat : définit les attributs de formatage utilisés pour les liens à l'é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éritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur null.

TextLayoutFormat : 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éritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 40.

TextLayoutFormat : 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éritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur null.

TextLayoutFormat:

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éritera 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

TextLayoutFormat:

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éritera 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

TextLayoutFormat : paramètres régionaux 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.

TextLayoutFormat : 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

TextLayoutFormat : 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

TextLayoutFormat : encart à droite 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

TextLayoutFormat : 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

TextLayoutFormat : 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.

TextLayoutFormat : nombre qui spécifie 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.

TextLayoutFormat : nombre qui spécifie la quantité d’espace, en pixels, à conserver 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.

TextLayoutFormat : nombre qui indique, en pixels, la valeur de retrait du bord du début 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.

Renvoie le parent de ce objet FlowElement. Chaque objet FlowElement a au plus un parent.

Renvoie la fin relative de cet objet FlowElement dans le parent. Si le parent est null cette propriété est toujours égale à textLength. Si le parent n’est pas null, la valeur est la somme des longueurs du texte et de toutes ses frères, qui est en fait le premier caractère du prochain objet FlowElement.

Eléments de l’API associés

Renvoie le début relatif de cet objet FlowElement dans le parent. Si le parent est null, cette valeur est toujours zéro. Si le parent n’est pas null, la valeur est la somme des longueurs de texte de tous ses frères précédents.

Eléments de l’API associés

TextLayoutFormat : 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

TextLayoutFormat : 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 undefined pendant la cascade cette propriété aura la valeur null.

Renvoie les styles sur cet objet FlowElement. Notez que la méthode Get effectue une copie du dictionnaire de styles. L’objet renvoyé 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

TextLayoutFormat : 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éritera 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

TextLayoutFormat : 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

TextLayoutFormat : 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

TextLayoutFormat : 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.

TextLayoutFormat : 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

TextLayoutFormat : nombre qui indique la quantité, en pixels, pour mettre en retrait 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.

TextLayoutFormat : 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éritera 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

Renvoie la longueur totale de texte administrée par cet objet FlowElement et ses enfants. Si un élément n’a aucun texte, la valeur de textLength est généralement la valeur zéro.

Les objets ParagraphElement ont une dernière plage avec un caractère terminateur de paragraphe pour le dernier objet SpanElement. Le terminateur de paragraphe est inclus dans la valeur de la propriété textLength textLength de cet objet SpanElement et de tous ses parents. Il n’est pas inclus dans la propriété text de l’objet SpanElement.

Eléments de l’API associés

TextLayoutFormat : 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

Définit le suivi et est synonyme de la propriété trackingRight. Spécifié sous forme d’un nombre de pixels ou un pourcentage de valeur fontSize.

Eléments de l’API associés

TextLayoutFormat : nombre de pixels (ou pourcentage de taille fontSize, comme 120 %) indiquant la quantité de l’approche (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.

TextLayoutFormat : nombre de pixels (ou pourcentage de taille fontSize, comme 120 %) indiquant la quantité de l’approche (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.

Chaque objet FlowElement a une propriété typeName. La valeur par défaut de typeName est la chaîne que TextConverter de l’objet textLayoutFormat utilise. Cette interface peut être utilisée pour définir une autre propriété typeName pour un objet FlowElement. En règle générale, cela se fait pour prendre en charge les sélecteurs de type dans CSS.

Voir la documentation TEXT_FIELD_HTML_FORMAT pour la procédure d’utilisation.

Eléments de l’API associés

TextLayoutFormat : le 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

Permet de lire les styles d’écriture de l’utilisateur sur un objet FlowElement. Notez que la lecture de cette propriété effectue une copie de la propriété userStyles définie dans le format de cet élément.

TextLayoutFormat : 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

TextLayoutFormat : réduit ou conserve les espaces lors de l’importation de texte dans un 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

TextLayoutFormat : 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éritera ses valeurs d’un ancêtre. Si aucun ancêtre n’a défini cette propriété, elle aura la valeur 100 %, 50 %, 150 %.

Classe de base : appeler un nouvel objet new FlowElement() renvoie une exception d’erreur.

Supprime le style spécifié par le paramètre styleProp à partir de cet objet FlowElement. Définit la valeur sur undefined.

Paramètres

Eléments de l’API associés

package flashx.textLayout.elements.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;
    
    public class FlowElement_clearStyleExample extends Sprite{    
        public function FlowElement_clearStyleExample()
        {
            // create a container and a TextFlow object
            var container:Sprite = new Sprite();
            this.addChild(container);
            var textFlow:TextFlow = new TextFlow();
            
            // create a paragraph and set lineThrough style to true 
            var paragraph:ParagraphElement = new ParagraphElement();
            paragraph.setStyle("color", 204);
            // create two spans of text
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            var span3:SpanElement = new SpanElement();            
            span1.text = "After calling clearStyle(), the value of color for span1 is: ";     
            span2.text = " but the value of span1.getStyle() for color is ";
            span3.text = " because getStyle() returns the inherited value that's applied to the style.";
            span1.clearStyle("color");        // undefined
            span1.text += span1.color;
            paragraph.addChild(span1);
            paragraph.addChild(span2);
            span2.text += span1.getStyle("color");    //204 
            paragraph.addChild(span3);
            
            textFlow.addChild(paragraph);
            // add controller, then update controller to display text
            var firstController:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(firstController);
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}

Effectue une copie en profondeur de cette objet FlowElement, y compris tout enfant, copiant le contenu entre les deux emplacements de caractère et renvoyant la copie en tant qu’objet FlowElement.

Sans arguments, par défaut, le paramètre deepCopy() copie l’élément entier par défaut.

Paramètres

Eléments de l’API associés

package flashx.textLayout.elements.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;
    
    public class FlowElement_deepCopyExample extends Sprite{    
        public function FlowElement_deepCopyExample()
        {
            // 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 span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            // add text to the spans and spans to the paragraph
            span1.text = "Hello, ";
            span2.text = "World!";
            p.fontSize = 48;
            p.addChild(span1);
            p.addChild(span2);
            // make a deep copy of paragraph p, starting at relative offset 3; copy to end
            var p2:ParagraphElement = p.deepCopy(3, -1) as ParagraphElement; 
            // add copied paragraph (p2) to textflow; add composer and controller 
            // and update controller to display text
            textFlow.addChild(p2);
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();    // 'lo, World!'
        }
    }
}

Comparez ces styles utilisateur avec les styles utilisateur d’autres éléments.

Paramètres

Eléments de l’API associés

Renvoie l’emplacement de départ de l’élément dans l’enchaînement de texte avec un index absolu. Le premier caractère dans l’enchaînement est la position 0.

Eléments de l’API associés

package flashx.textLayout.elements.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;
    
    public class FlowElement_getAbsoluteStartExample extends Sprite
    {    
        public function FlowElement_getAbsoluteStartExample()
        {
            // 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 span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            // add text to the spans, spans to the paragraph, and paragraph to the text flow
            span1.text = "The start of span2 ";
            span2.text = "in this paragraph is at index: ";
            p.fontSize = 20;
            p.addChild(span1);
            p.addChild(span2);
            textFlow.addChild(p);
            // find the starting position of span2 and update controller to display text
            span2.text += span2.getAbsoluteStart();  // 19
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();  
        }
    }
}

Renvoie le caractère à la position spécifiée, par rapport à cet objet FlowElement. Le premier caractère à la position relative 0.

Paramètres

Eléments de l’API associés

package flashx.textLayout.elements.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;
    
    public class FlowElement_getCharAtPositionExample extends Sprite
    {        
        public function FlowElement_getCharAtPositionExample()
        {
            // create a container and a controller for it and add it to the stage
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            this.stage.addChild( container );
                        
            //create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            
            // add text to the two spans, calling getCharAtPosition() to return the
            // character at relative position 27 in the first span
            span1.text = "The character at offset 27 in this paragraph is: ";
            span2.text =  span1.getCharAtPosition(27) + ".";    // i
            
            // add spans to paragraph p   
            p.addChild(span1);
            p.addChild(span2);
            
            // add paragraph p to text flow and update controller to display it
            textFlow.addChild(p);
            textFlow.flowComposer.addController( controller );                               
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

Renvoie le code de caractère à la position spécifiée, par rapport à cet objet FlowElement. Le premier caractère à la position relative 0.

Paramètres

Eléments de l’API associés

package flashx.textLayout.elements.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;
    
    public class FlowElement_getCharCodeAtPositionExample extends Sprite
    {        
        public function FlowElement_getCharCodeAtPositionExample()
        {
            // create a container and a controller for it and add it to the stage
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            this.stage.addChild( container );
            
            //create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            
            // add text to spans; use getCharCodeAtPosition() to add char code from pos. 16
            // of span1
            
            span1.text = "The character code at offset 16 in this paragraph is: ";
            span2.text =  String(span1.getCharCodeAtPosition(16)) + ".";    // 100 (d)
            
            // add spans to paragraph p   
            p.addChild(span1);
            p.addChild(span2);
            
            // add paragraph p to text flow and update controller to display it
            textFlow.addChild(p);
            textFlow.flowComposer.addController( controller );                               
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

Renvoie la valeur de début de cet élément par rapport à l’élément ancêtre. Suppose que l’élément ancêtre est dans la chaîne parent. Si l’élément ancêtre est le parent, il s’agit du même que this.parentRelativeStart. Si l’élément ancêtre est le grand-parent, il s’agit du même que parentRelativeStart plus parent.parentRelativeStart et ainsi de suite.

Paramètres

Eléments de l’API associés

package flashx.textLayout.elements.examples {
    
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.LinkElement;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class FlowElement_getElementRelativeStartExample extends Sprite
    {        
        public function FlowElement_getElementRelativeStartExample()
        {
            // create a container and a controller for it and add it to the stage
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController( container, 400, 200 );
            this.stage.addChild( container );
            
            //create TextFlow, ParagraphElement, SpanElement, and LinkElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var link:LinkElement = new LinkElement();
            var span2:SpanElement = new SpanElement();
            var span3:SpanElement = new SpanElement();
            
            // add text to first two spans
            span1.text = "The relative start of the link SpanElement (";
            span2.text =  ") in this paragraph is at position ";
            
            // create link span, add text and corresponding URL and add to link
            var linkSpan:SpanElement = new SpanElement();
            linkSpan.text = "Adobe's website";
            link.href = "http://www.adobe.com";
            link.addChild(linkSpan);
            
            // add first span, link, and second span to paragraph p   
            p.addChild(span1);
            p.addChild(link);
            p.addChild(span2);
            
            // call getElementRelativeStart() to get start of linkSpan and add to span 3
            span3.text = String(linkSpan.getElementRelativeStart(p)) + ".";  // 44.
            p.addChild(span3);
            
            // add paragraph p to text flow and update controller to display it
            textFlow.addChild(p);
            textFlow.flowComposer.addController( controller );                               
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

Renvoie le prochain objet FlowElement frère dans la hiérarchie de l’enchaînement de texte.

Eléments de l’API associés

package flashx.textLayout.elements.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;
    
    public class FlowElement_getNextSiblingExample extends Sprite
    {        
        public function FlowElement_getNextSiblingExample()
        {
            // 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 span1:SpanElement = new SpanElement();
            var span2:SpanElement = new SpanElement();
            var nextSpanElement:SpanElement = new SpanElement();
            // add text, set font size, add spans to paragraph, add paragraph to text flow
            span1.text = "Hello, ";
            span2.text = "World!";
            p.fontSize = 48;
            p.addChild(span1);
            p.addChild(span2);
            textFlow.addChild(p);
            // get next SpanElement for span1 and set its color to red; display text
            nextSpanElement = SpanElement(span1.getNextSibling());
            nextSpanElement.color = 0xCC0000;
            textFlow.flowComposer.addController(new ContainerController(this,stage.stageWidth,stage.stageHeight));
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}

Renvoie l’objet ParagraphElement associé à cet élément. Il recherche la hiérarchie de l’enchaînement de texte et renvoie le premier objet ParagraphElement.

Eléments de l’API associés