Package | flashx.textLayout.elements |
Classe | public class SpanElement |
Héritage | SpanElement FlowLeafElement FlowElement Object |
Sous-classes | SpecialCharacterElement |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Un objet ParagraphElement a un seul objet SpanElement si tout le texte du paragraphe partage la même jeu d’attributs. Il possède plusieurs objets SpanElement si le texte dans le paragraphe possède plusieurs formats.
Propriété MXML par défautmxmlChildren
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
alignmentBaseline : *
TextLayoutFormat : spécifie la ligne de base sur laquelle la ligne de base dominante s’aligne. | FlowElement | ||
backgroundAlpha : *
TextLayoutFormat : valeur alpha (transparence) pour l’arrière-plan (adopte la valeur par défaut si undefined pendant la cascade). | FlowElement | ||
backgroundColor : *
TextLayoutFormat : couleur d’arrière-plan du texte (adopte la valeur par défaut si undefined pendant la propagation en cascade). | FlowElement | ||
baselineShift : *
TextLayoutFormat : valeur de décalage de la ligne de base par rapport à la valeur dominantBaseline. | FlowElement | ||
blockProgression : *
TextLayoutFormat : spécifie la progression verticale ou horizontale du positionnement de la ligne. | FlowElement | ||
breakOpportunity : *
TextLayoutFormat : contrôle l’autorisation des sauts de ligne lors de la séparation de l’habillage du texte en plusieurs lignes. | FlowElement | ||
cffHinting : *
TextLayoutFormat : type de repère CFF utilisé pour ce texte. | FlowElement | ||
clearFloats : *
TextLayoutFormat : contrôle la manière dont le texte enveloppe un élément flottant. | FlowElement | ||
color : *
TextLayoutFormat : couleur du texte. | FlowElement | ||
columnCount : *
TextLayoutFormat : nombre de colonnes de texte (adopte la valeur par défaut si la valeur est undefined pendant la propagation en cascade). | FlowElement | ||
columnGap : *
TextLayoutFormat : spécifie la quantité d’espace de gouttière, en pixels, à laisser entre les colonnes (adopte la valeur par défaut si undefined pendant la propagation en cascade). | FlowElement | ||
columnWidth : *
TextLayoutFormat : largeur de colonne en pixels (adopte la valeur par défaut si undefined pendant la propagation en cascade). | FlowElement | ||
computedFormat : flashx.textLayout.formats:ITextLayoutFormat [override] [lecture seule]
Les attributs de format de caractère calculés qui sont appliqués à cet élément. | FlowLeafElement | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
coreStyles : Object [lecture seule] Renvoie l’objet coreStyles sur cet objet FlowElement. | FlowElement | ||
digitCase : *
TextLayoutFormat : le type de casse de chiffres utilisée pour ce texte. | FlowElement | ||
digitWidth : *
TextLayoutFormat : type de largeur de chiffres utilisée pour ce texte. | FlowElement | ||
direction : *
TextLayoutFormat : spécifie le niveau d’intégration bidirectionnelle par défaut du texte dans le bloc de texte. | FlowElement | ||
dominantBaseline : *
TextLayoutFormat : 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. | FlowElement | ||
firstBaselineOffset : *
TextLayoutFormat : spécifie la position de ligne de base de la première ligne du conteneur. | FlowElement | ||
fontFamily : *
TextLayoutFormat : nom de la police à utiliser, ou liste de noms de police séparés par une virgule. | FlowElement | ||
fontLookup : *
TextLayoutFormat : recherche de police à utiliser. | FlowElement | ||
fontSize : *
TextLayoutFormat : taille du texte en pixels. | FlowElement | ||
fontStyle : *
TextLayoutFormat : style du texte. | FlowElement | ||
fontWeight : *
TextLayoutFormat : épaisseur du texte. | FlowElement | ||
format : flashx.textLayout.formats:ITextLayoutFormat Propriétés TextLayoutFormat appliquées directement à cet élément. | FlowElement | ||
id : String
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. | FlowElement | ||
justificationRule : *
TextLayoutFormat : règle utilisée pour justifier le texte dans un paragraphe. | FlowElement | ||
justificationStyle : *
TextLayoutFormat : style utilisé pour la justification du paragraphe. | FlowElement | ||
kerning : *
TextLayoutFormat : le crénage ajuste les pixels entre certaines paires de caractères pour améliorer la lisibilité. | FlowElement | ||
leadingModel : *
TextLayoutFormat : spécifie le modèle d’interlignage, qui est une combinaison de la base et de la direction de l’interlignage. | FlowElement | ||
ligatureLevel : *
TextLayoutFormat : contrôle laquelle des ligatures qui sont définies dans la police peut être utilisée dans le texte. | FlowElement | ||
lineBreak : *
TextLayoutFormat : contrôle le retour à la ligne dans le conteneur (adopte la valeur par défaut si undefined pendant cascade). | FlowElement | ||
lineHeight : *
TextLayoutFormat : contrôles d’interlignage pour le texte. | FlowElement | ||
lineThrough : *
TextLayoutFormat : si la valeur est true, applique le style de formatage barré, une ligne au milieu du texte. | FlowElement | ||
linkActiveFormat : *
TextLayoutFormat : définit les attributs de mise en forme utilisés pour les liens à l’état normal. | FlowElement | ||
linkHoverFormat : *
TextLayoutFormat : définit les attributs de mise en forme utilisés pour les liens à l’état pointé, c’est-à-dire lorsque l’utilisateur survole un lien avec la souris. | FlowElement | ||
linkNormalFormat : *
TextLayoutFormat : définit les attributs de mise en forme utilisés pour les liens à l’état normal. | FlowElement | ||
listAutoPadding : *
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. | FlowElement | ||
listMarkerFormat : *
TextLayoutFormat : définit les marqueurs de liste d’attributs de mise en forme. | FlowElement | ||
listStylePosition : *
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. | FlowElement | ||
listStyleType : *
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. | FlowElement | ||
locale : *
TextLayoutFormat : paramètres régionaux du texte. | FlowElement | ||
mxmlChildren : Array
Définit le texte en fonction du contenu dans les balises de plages ; supprime toujours les enfants existants. | SpanElement | ||
paddingBottom : *
TextLayoutFormat : encart inférieur en pixels. | FlowElement | ||
paddingLeft : *
TextLayoutFormat : encart à gauche en pixels. | FlowElement | ||
paddingRight : *
TextLayoutFormat : encart à droite en pixels. | FlowElement | ||
paddingTop : *
TextLayoutFormat : encart supérieur en pixels. | FlowElement | ||
paragraphEndIndent : *
TextLayoutFormat : nombre qui indique, en pixels, la valeur de retrait du bord de la fin du paragraphe. | FlowElement | ||
paragraphSpaceAfter : *
TextLayoutFormat : un nombre qui spécifie la quantité d’espace, en pixels, à laisser après le paragraphe. | FlowElement | ||
paragraphSpaceBefore : *
TextLayoutFormat : nombre qui spécifie la quantité d’espace, en pixels, à conserver avant le paragraphe. | FlowElement | ||
paragraphStartIndent : *
TextLayoutFormat : nombre qui indique, en pixels, la valeur de retrait du bord du début du paragraphe. | FlowElement | ||
parent : FlowGroupElement [lecture seule] Renvoie le parent de ce objet FlowElement. | FlowElement | ||
parentRelativeEnd : int [lecture seule] Renvoie la fin relative de cet objet FlowElement dans le parent. | FlowElement | ||
parentRelativeStart : int [lecture seule] Renvoie le début relatif de cet objet FlowElement dans le parent. | FlowElement | ||
renderingMode : *
TextLayoutFormat : mode de rendu utilisé pour ce texte. | FlowElement | ||
styleName : *
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. | FlowElement | ||
styles : Object [lecture seule] Renvoie les styles sur cet objet FlowElement. | FlowElement | ||
tabStops : *
TextLayoutFormat : spécifie les taquets de tabulation associés au paragraphe. | FlowElement | ||
text : String
Reçoit la chaîne de texte que cet objet SpanElement contient. | SpanElement | ||
textAlign : *
TextLayoutFormat : alignement des lignes du paragraphe par rapport au conteneur. | FlowElement | ||
textAlignLast : *
TextLayoutFormat : alignement de la dernière (ou unique) ligne dans le paragraphe par rapport au conteneur dans un texte justifié. | FlowElement | ||
textAlpha : *
TextLayoutFormat : valeur alpha (transparence) du texte. | FlowElement | ||
textDecoration : *
TextLayoutFormat : décoration du texte. | FlowElement | ||
textIndent : *
TextLayoutFormat : nombre qui indique la quantité, en pixels, pour mettre en retrait la première ligne du paragraphe. | FlowElement | ||
textJustify : *
TextLayoutFormat : spécifie des options de justification de texte. | FlowElement | ||
textLength : int [lecture seule]
Renvoie la longueur totale de texte administrée par cet objet FlowElement et ses enfants. | FlowElement | ||
textRotation : *
TextLayoutFormat : détermine le nombre de degrés de rotation de ce texte. | FlowElement | ||
tracking : Object [écriture seule]
Définit le suivi et est synonyme de la propriété trackingRight. | FlowElement | ||
trackingLeft : *
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. | FlowElement | ||
trackingRight : *
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. | FlowElement | ||
typeName : String
Chaque objet FlowElement a une propriété typeName. | FlowElement | ||
typographicCase : *
TextLayoutFormat : le type de casse typographique utilisée pour ce texte. | FlowElement | ||
userStyles : Object Permet de lire les styles d’écriture de l’utilisateur sur un objet FlowElement. | FlowElement | ||
verticalAlign : *
TextLayoutFormat : alignement vertical ou justification (adopte la valeur par défaut si undefined pendant la propagation en cascade). | FlowElement | ||
whiteSpaceCollapse : *
TextLayoutFormat : réduit ou conserve les espaces lors de l’importation de texte dans un TextFlow. | FlowElement | ||
wordSpacing : *
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. | FlowElement |
Méthode | Défini par | ||
---|---|---|---|
Constructeur : crée un objet SpanElement pour contenir un segment de texte dans un paragraphe. | SpanElement | ||
Supprime le style spécifié par le paramètre styleProp à partir de cet objet FlowElement. | FlowElement | ||
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. | FlowElement | ||
Comparez ces styles utilisateur avec les styles utilisateur d’autres éléments. | FlowElement | ||
Renvoie l’emplacement de départ de l’élément dans l’enchaînement de texte avec un index absolu. | FlowElement | ||
Renvoie le caractère à la position spécifiée, par rapport à cet objet FlowElement. | FlowElement | ||
Renvoie le code de caractère à la position spécifiée, par rapport à cet objet FlowElement. | FlowElement | ||
Renvoie l’objet FontMetrics pour la plage. | FlowLeafElement | ||
Renvoie la valeur de début de cet élément par rapport à l’élément ancêtre. | FlowElement | ||
Renvoie le prochain objet FlowLeafElement. | FlowLeafElement | ||
Renvoie le prochain objet FlowElement frère dans la hiérarchie de l’enchaînement de texte. | FlowElement | ||
Renvoie l’objet ParagraphElement associé à cet élément. | FlowElement | ||
Renvoie l’objet FlowLeafElement précédent. | FlowLeafElement | ||
Renvoie l’objet FlowElement frère précédent dans la hiérarchie de l’enchaînement de texte. | FlowElement | ||
Renvoie la valeur du style spécifié par le paramètre styleProp, qui spécifie le nom du style et peut être n’importe quel nom de style d’utilisateur. | FlowElement | ||
Récupère la plage de texte spécifiée à partir d’un élément d’enchaînement. | FlowElement | ||
Gravit la hiérarchie de l’enchaînement de texte pour renvoyer l’objet TextFlow racine pour l’élément. | FlowElement | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Appelé pour des objets MXML une fois que l’objet d’implémentation a été créé et que toutes les propriétés de composants spécifiées sur la balise MXML ont été initialisées. | FlowElement | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Met à jour le texte de la plage de texte en fonction des positions de début et de fin spécifiées. | SpanElement | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Définit le style spécifié par le paramètre styleProp à la valeur spécifiée par le paramètre newValue. | FlowElement | ||
Effectue une copie de cet objet FlowElement, copie le contenu entre deux positions de caractères spécifiées. | FlowElement | ||
Divise cet objet FlowElement à la position spécifiée par le paramètre relativePosition, qui est une position relative dans le texte pour cet élément. | FlowElement | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
mxmlChildren | propriété |
mxmlChildren:Array
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Définit le texte en fonction du contenu dans les balises de plages ; supprime toujours les enfants existants. Cette propriété est conçue pour être utilisée lors de l’importation du fichier MXML compilé dans Flex. Flash Professional ignore cette propriété. Lorsque les éléments de balisage TLF contiennent d’autres éléments de balisage TLF en tant qu’enfants, les enfants sont affectés à cette propriété.
Implémentation
public function get mxmlChildren():Array
public function set mxmlChildren(value:Array):void
Valeur émise
TypeError — Si l’élément tableau n’est pas un objet SpecialCharacterElement ni un objet String.
|
text | propriété |
text:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Reçoit la chaîne de texte que cet objet SpanElement contient.
Le texte d’une plage n’inclut pas le retour à la ligne (CR) à la fin du paragraphe mais il est inclus dans la valeur de textLength
.
Implémentation
public function get text():String
public function set text(value:String):void
SpanElement | () | Constructeur |
public function SpanElement()
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur : crée un objet SpanElement pour contenir un segment de texte dans un paragraphe.
replaceText | () | méthode |
public function replaceText(relativeStartPosition:int, relativeEndPosition:int, textValue:String):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Met à jour le texte de la plage de texte en fonction des positions de début et de fin spécifiées. Pour insérer du texte, définissez la position de fin égale à la position de départ. Pour ajouter du texte au texte existant dans la plage, définissez la position de début et la position de fin égales à la longueur du texte existant.
Le texte remplacé contient le caractère de début et jusqu’au caractère de fin mais sans l’inclure.
Paramètres
relativeStartPosition:int — La position d’index du début du texte à remplacer, par rapport au début de la plage. Le premier caractère de la plage est à la position 0.
| |
relativeEndPosition:int — La position une de l’index après le dernier caractère du texte à remplacer, par rapport au début de la plage. Définissez cette valeur égale à la valeur relativeStartPos pour une insertion.
| |
textValue:String — Le texte de remplacement ou le texte à ajouter, selon le cas.
|
Valeur émise
RangeError — Les positions relativeStartPosition ou relativeEndPosition est hors limites ou une paire de remplacement est en cours de division en conséquence du remplacement.
|
Exemple ( Comment utiliser cet exemple )
L’exemple utilise une seconde plage (span2) pour afficher les résultats.
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 SpanElement_replaceTextExample extends Sprite { public function SpanElement_replaceTextExample() { // create 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 paragraph:ParagraphElement = new ParagraphElement(); var span:SpanElement = new SpanElement; var span2:SpanElement = new SpanElement; // add composer and container controller var controller:ContainerController = new ContainerController(container, 200, 700 ); textFlow.flowComposer.addController(controller); textFlow.fontSize = 24; // set font size // create text string and add it to the span var str:String = "0123456"; span.text = str; // insert at the beginning span.replaceText(0, 0, "abc"); span2.text = span.text + '\n'; // append to the end of the text span.replaceText(10, 10, "abc"); span2.text += span.text + '\n'; // insert string in the middle of the text span.replaceText(5, 8, "abc"); span2.text += span.text + '\n'; // replace text with string span.replaceText(0, 13, "abc"); span2.text += span.text + '\n'; // replace text with string span.replaceText(0, 3, "That's all she wrote!\n"); span2.text += span.text + '\n'; // display the results paragraph.addChild(span2); textFlow.addChild(paragraph); textFlow.flowComposer.updateAllControllers(); } } }
package flashx.textLayout.elements.examples { import flash.display.Sprite; import flash.text.engine.FontPosture; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.TextFlow; public class SpanElementExample extends Sprite { public function SpanElementExample() { // 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 spanHello:SpanElement = new SpanElement(); var spanWorld:SpanElement = new SpanElement(); // add text and styles to the spans spanHello.text = "Hello, "; spanHello.fontSize = 48; spanWorld.text = "World!"; spanWorld.fontSize = 56; spanWorld.fontStyle = FontPosture.ITALIC; spanWorld.color = 0xFFCC00; // add spans to paragraph, paragraph to text flow p.addChild(spanHello); p.addChild(spanWorld); textFlow.addChild(p); // update controller to display text var controller:ContainerController = new ContainerController(container, 400, 200 ); textFlow.flowComposer.addController(controller); textFlow.flowComposer.updateAllControllers(); } } }
Tue Jun 12 2018, 09:30 AM Z