Paket | flashx.textLayout.elements |
Klasse | public class SpanElement |
Vererbung | SpanElement FlowLeafElement FlowElement Object |
Unterklassen | SpecialCharacterElement |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ein ParagraphElement enthält ein einzelnes SpanElement-Objekt, wenn der ganze Text im Absatz dieselben Attribute gemeinsam verwendet. Es enthält mehrere SpanElement-Objekte, wenn auf den Text im Absatz mehrere Formate angewendet werden.
Standard-MXML-EigenschaftmxmlChildren
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
alignmentBaseline : *
TextLayoutFormat: Gibt die Grundlinie an, an dem die dominierende Grundlinie ausgerichtet wird. | FlowElement | ||
backgroundAlpha : *
TextLayoutFormat: Alpha-Wert (Transparenz) für den Hintergrund (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
backgroundColor : *
TextLayoutFormat: Hintergrundfarbe des Texts (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
baselineShift : *
TextLayoutFormat: Betrag, um den die Grundlinie vom dominantBaseline-Wert verschoben wird. | FlowElement | ||
blockProgression : *
TextLayoutFormat: Gibt eine vertikale oder horizontale Abfolge der Zeilenplatzierung an. | FlowElement | ||
breakOpportunity : *
TextLayoutFormat: Gibt die Position von Zeilenumbrüchen in einem mehrzeiligen Text an. | FlowElement | ||
cffHinting : *
TextLayoutFormat: Die für diesen Text verwendete Art des CFF-Hintings. | FlowElement | ||
clearFloats : *
TextLayoutFormat: Steuert, wie der Text bei einem Float umbricht. | FlowElement | ||
color : *
TextLayoutFormat: Farbe des Texts. | FlowElement | ||
columnCount : *
TextLayoutFormat: Anzahl der Textspalten (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
columnGap : *
TextLayoutFormat: Gibt den Zwischenraum in Pixeln an, der zwischen den Spalten gelassen werden soll (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
columnWidth : *
TextLayoutFormat: Spaltenbreite in Pixeln (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
computedFormat : flashx.textLayout.formats:ITextLayoutFormat [override] [schreibgeschützt]
Die berechneten Textformatattribute, die für dieses Element wirksam sind. | FlowLeafElement | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
coreStyles : Object [schreibgeschützt] Gibt die coreStyles für dieses FlowElement zurück. | FlowElement | ||
digitCase : *
TextLayoutFormat: Die für diesen Text verwendete Ziffernart. | FlowElement | ||
digitWidth : *
TextLayoutFormat: Die für diesen Text verwendete Ziffernbreite. | FlowElement | ||
direction : *
TextLayoutFormat: Gibt die standardmäßige bidirektionale Einbettungsebene des Texts im Textblock an. | FlowElement | ||
dominantBaseline : *
TextLayoutFormat: Gibt an, welche Elementgrundlinie an der alignmentBaseline ausgerichtet wird, um die vertikale Position des Elements auf der Linie zu bestimmen. | FlowElement | ||
firstBaselineOffset : *
TextLayoutFormat: Gibt die Grundlinienposition der ersten Linie im Container an. | FlowElement | ||
fontFamily : *
TextLayoutFormat: Der Name der zu verwendenden Schriftart oder eine durch Kommas getrennte Liste mit Schriftartnamen. | FlowElement | ||
fontLookup : *
TextLayoutFormat: Zu verwendende Schriftartsuche. | FlowElement | ||
fontSize : *
TextLayoutFormat: Die Textgröße in Pixeln. | FlowElement | ||
fontStyle : *
TextLayoutFormat: Stil des Texts. | FlowElement | ||
fontWeight : *
TextLayoutFormat: Schriftartstärke. | FlowElement | ||
format : flashx.textLayout.formats:ITextLayoutFormat Direkt für dieses Element angewendete TextLayoutFormat-Eigenschaften. | FlowElement | ||
id : String
Weist einem Element einen identifizierenden Namen zu, sodass es möglich ist, einen Stil für das Element durch Verweis auf die ID festzulegen. | FlowElement | ||
justificationRule : *
TextLayoutFormat: Regel zum Ausrichten von Text in einem Absatz. | FlowElement | ||
justificationStyle : *
TextLayoutFormat: Der Stil, der zum Ausrichten des Absatzes verwendet wird. | FlowElement | ||
kerning : *
TextLayoutFormat: Beim Kerning werden die Pixel zwischen bestimmten Zeichenpaaren angepasst, um die Lesbarkeit zu verbessern. | FlowElement | ||
leadingModel : *
TextLayoutFormat: Gibt das Zeilenabstandsmodell an, das eine Kombination von Zeilenabstandsbasis und Zeilenabstandsrichtung ist. | FlowElement | ||
ligatureLevel : *
TextLayoutFormat: Steuert, welche in der Schriftart definierten Ligaturen im Text verwendet werden können. | FlowElement | ||
lineBreak : *
TextLayoutFormat: Steuert Zeilenumbruch im Container (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
lineHeight : *
TextLayoutFormat: Steuerelemente für den Zeilenabstand des Texts. | FlowElement | ||
lineThrough : *
TextLayoutFormat: Wenn „true“, wird Durchstreichung angewendet, d. h eine mitten durch den Text gezogene Linie. | FlowElement | ||
linkActiveFormat : *
TextLayoutFormat: Definiert die Formatierungsattribute für Links im normalen Status. | FlowElement | ||
linkHoverFormat : *
TextLayoutFormat: Definiert die Formatierungsattribute, die für Links verwendet werden, über die der Mauszeiger bewegt wird („Hover“-Status). | FlowElement | ||
linkNormalFormat : *
TextLayoutFormat: Definiert die Formatierungsattribute für Links im normalen Status. | FlowElement | ||
listAutoPadding : *
TextLayoutFormat: Legt einen automatischen Einzug für die Startkante von Listen fest, wenn der Auffüllwert der Liste auf dieser Seite „auto“ lautet. | FlowElement | ||
listMarkerFormat : *
TextLayoutFormat: Definiert die Listenmarkierungen der Formatierungsattribute. | FlowElement | ||
listStylePosition : *
TextLayoutFormat: Zulässige Werte sind ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT. Standardwert ist nicht definiert, d. h. wurde nicht festgelegt. Wenn die Eigenschaft während einer Kaskade nicht definiert ist, wird der Wert aus einem übergeordneten Element übernommen. | FlowElement | ||
listStyleType : *
TextLayoutFormat: Zulässige Werte sind 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, FormatValue.INHERIT. Standardwert ist nicht definiert, d. h. wurde nicht festgelegt. Wenn die Eigenschaft während einer Kaskade nicht definiert ist, wird der Wert aus einem übergeordneten Element übernommen. | FlowElement | ||
locale : *
TextLayoutFormat: Das Gebietsschema des Texts. | FlowElement | ||
mxmlChildren : Array
Legt Text anhand des Inhalts zwischen Span-Tags fest; untergeordnete Elemente werden immer gelöscht. | SpanElement | ||
paddingBottom : *
TextLayoutFormat: Der untere Versatz in Pixeln. | FlowElement | ||
paddingLeft : *
TextLayoutFormat: Der linke Einzug in Pixeln. | FlowElement | ||
paddingRight : *
TextLayoutFormat: Der rechte Einzug in Pixeln. | FlowElement | ||
paddingTop : *
TextLayoutFormat: Der obere Versatz in Pixeln. | FlowElement | ||
paragraphEndIndent : *
TextLayoutFormat: Eine Zahl, die den Versatz des unteren Absatzrands in Pixeln angibt. | FlowElement | ||
paragraphSpaceAfter : *
TextLayoutFormat: Eine Zahl, die den Leerraum nach dem Absatz (in Pixeln) festlegt. | FlowElement | ||
paragraphSpaceBefore : *
TextLayoutFormat: Eine Zahl, die den Wert für den Leeraum vor dem Absatz in Pixeln angibt. | FlowElement | ||
paragraphStartIndent : *
TextLayoutFormat: Eine Zahl, die den Versatz des oberen Absatzrands angibt in Pixeln angibt. | FlowElement | ||
parent : FlowGroupElement [schreibgeschützt] Gibt das übergeordnete Element dieses FlowElement-Objekts zurück. | FlowElement | ||
parentRelativeEnd : int [schreibgeschützt] Gibt das relative Ende diesesFlowElement-Objekts im übergeordneten Element zurück. | FlowElement | ||
parentRelativeStart : int [schreibgeschützt] Gibt den relativen Beginn diesesFlowElement-Objekts im übergeordneten Element zurück. | FlowElement | ||
renderingMode : *
TextLayoutFormat: Der für diesen Text verwendete Wiedergabemodus. | FlowElement | ||
styleName : *
TextLayoutFormat: Weist einem Element eine identifizierende Klasse zu, sodass es möglich ist, einen Stil für das Element durch Verweis auf styleName festzulegen. | FlowElement | ||
styles : Object [schreibgeschützt] Gibt die Stile für dieses FlowElement zurück. | FlowElement | ||
tabStops : *
TextLayoutFormat: Gibt die Tabulatoren an, die dem Absatz zugewiesen sind. | FlowElement | ||
text : String
Empfängt den String mit Text, den dieses SpanElement-Objekt aufnimmt. | SpanElement | ||
textAlign : *
TextLayoutFormat: Ausrichtung der Zeilen im Absatz relativ zum Container. | FlowElement | ||
textAlignLast : *
TextLayoutFormat: Ausrichtung der letzten (oder einzigen) Zeile im Absatz relativ zum Container im ausgerichteten Text. | FlowElement | ||
textAlpha : *
TextLayoutFormat: Wert für Alpha (Transparenz) des Texts. | FlowElement | ||
textDecoration : *
TextLayoutFormat: Auszeichnung im Text. | FlowElement | ||
textIndent : *
TextLayoutFormat: Eine Zahl, die die Einrückung der ersten Zeile des Absatzes in Pixeln festlegt. | FlowElement | ||
textJustify : *
TextLayoutFormat: Gibt Optionen für die Ausrichtung des Texts an. | FlowElement | ||
textLength : int [schreibgeschützt]
Gibt die Gesamtlänge des Textes, der zum FlowElement-Objekt und den untergeordneten Elementen gehört, zurück. | FlowElement | ||
textRotation : *
TextLayoutFormat: Bestimmt die Gradzahl zum Drehen dieses Texts. | FlowElement | ||
tracking : Object [Nur Schreiben]
Legt das Verfolgen fest und ist synonym mit der trackingRight-Eigenschaft. | FlowElement | ||
trackingLeft : *
TextLayoutFormat: Zahl in Pixeln (oder Prozent der Schriftgröße, z. B. 120 %), die die Laufweite (manuelles Kerning) angibt, auf die linke Seite jedes Zeichens angewendet werden soll. | FlowElement | ||
trackingRight : *
TextLayoutFormat: Zahl in Pixeln (oder Prozent der Schriftgröße, z. B. 120 %), die die Laufweite (manuelles Kerning) angibt, die auf die rechte Seite jedes Zeichens angewendet werden soll. | FlowElement | ||
typeName : String
Zu jedem FlowElement gehört ein typeName. | FlowElement | ||
typographicCase : *
TextLayoutFormat: Die für diesen Text verwendete typografische Buchstabenart. | FlowElement | ||
userStyles : Object Ermöglicht das Lesen und Schreiben von Benutzerstilen in einem FlowElement-Objekt. | FlowElement | ||
verticalAlign : *
TextLayoutFormat: Vertikale Ausrichtung oder Blocksatz (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
whiteSpaceCollapse : *
TextLayoutFormat: Blendet Leerraum aus oder behält ihn bei, wenn Text in einem TextFlow importiert wird. | FlowElement | ||
wordSpacing : *
TextLayoutFormat: Legt den optimalen, minimalen und maximalen Abstand (als Vielfaches der Breite einer normalen Leerstelle) zwischen Wörtern fest, der beim Blocksatz verwendet wird. | FlowElement |
Methode | Definiert von | ||
---|---|---|---|
Konstruktor - erstellt ein SpanElement-Objekt, um einen Textabschnitt in einem Absatz aufzunehmen. | SpanElement | ||
Löscht den vom styleProp-Parameter festgelegten Stil aus diesem FlowElement-Objekt. | FlowElement | ||
Erstellt eine tiefe Kopie dieses FlowElement-Objekts, einschließlich untergeordneter Elemente, indem der Inhalt zwischen zwei festgelegten Zeichenpositionen kopiert und die Kopie als FlowElement-Objekt zurückgegeben wird. | FlowElement | ||
Vergleicht die userStyles dieses Elements mit den userStyles anderer Elemente. | FlowElement | ||
Gibt die Startposition des Elements im Textfluss als absolute Indexposition zurück. | FlowElement | ||
Gibt das Zeichen an der festgelegten Position relativ zu diesem FlowElement-Objekt zurück. | FlowElement | ||
Gibt den Zeichencode an der festgelegten Position relativ zu diesem FlowElement zurück. | FlowElement | ||
Gibt das FontMetrics-Objekt für den Bereich zurück. | FlowLeafElement | ||
Gibt den Beginn dieses Elements relativ zu einem übergeordneten Element zurück. | FlowElement | ||
Gibt das nächste FlowLeafElement-Objekt zurück. | FlowLeafElement | ||
Gibt das nächste gleichgeordnete FlowElement in der Textflusshierarchie zurück. | FlowElement | ||
Gibt das mit diesem Element verknüpfte ParagraphElement-Objekt zurück. | FlowElement | ||
Gibt das vorherige FlowLeafElement-Objekt zurück. | FlowLeafElement | ||
Gibt das vorherige gleichgeordnete FlowElement in der Textflusshierarchie zurück. | FlowElement | ||
Gibt den Wert des vom styleProp-Parameter festgelegten Stils zurück. Dieser legt den Stilnamen fest und kann einen beliebigen Benutzerstilnamen enthalten. | FlowElement | ||
Ruft den angegebenen Textbereich aus einem Flusselement ab. | FlowElement | ||
Durchsucht die Textflusshierarchie in aufsteigender Richtung, um das TextFlow-Stammobjekt für das Element zurückzugeben. | FlowElement | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Wird für MXML-Objekte aufgerufen, nachdem das Implementierungsobjekt erstellt und sämtliche im MXML-Tag angegebenen Komponenteneigenschaften initialisiert wurden. | FlowElement | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Aktualisiert den Text im Textbereich basierend auf den festgelegten Start- und Endpositionen. | SpanElement | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Legt für den vom styleProp-Parameter festgelegten Stil den vom newValue-Parameter festgelegten Wert fest. | FlowElement | ||
Erstellt eine Kopie dieses FlowElement-Objekts, indem der Inhalt zwischen zwei angegebenen Zeichenpositionen kopiert wird. | FlowElement | ||
Teilt dieses FlowElement-Objekt an der vom relativePosition-Parameter angegebenen Position, die einer relativen Position im Text für dieses Element entspricht. | FlowElement | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
mxmlChildren | Eigenschaft |
mxmlChildren:Array
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Legt Text anhand des Inhalts zwischen Span-Tags fest; untergeordnete Elemente werden immer gelöscht. Diese Eigenschaft ist zur Verwendung bei MXML-kompilierten Importen in Flex vorgesehen. Flash Professional ignoriert diese Eigenschaft. Wenn TLF- Markupelemente weitere TLF-Markupelemente als untergeordnete Elemente enthalten, werden die untergeordneten Elemente dieser Eigenschaft zugewiesen.
Implementierung
public function get mxmlChildren():Array
public function set mxmlChildren(value:Array):void
Auslöser
TypeError — Wenn das Array-Element kein SpecialCharacterElement oder String ist.
|
text | Eigenschaft |
text:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Empfängt den String mit Text, den dieses SpanElement-Objekt aufnimmt.
Der Text eines Bereiches enthält nicht den Wagenrücklauf (CR) am Ende des Absatzes, dieser ist jedoch im Wert von textLength
enthalten.
Implementierung
public function get text():String
public function set text(value:String):void
SpanElement | () | Konstruktor |
public function SpanElement()
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor - erstellt ein SpanElement-Objekt, um einen Textabschnitt in einem Absatz aufzunehmen.
replaceText | () | Methode |
public function replaceText(relativeStartPosition:int, relativeEndPosition:int, textValue:String):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Aktualisiert den Text im Textbereich basierend auf den festgelegten Start- und Endpositionen. Um Text einzufügen, legen Sie für die Endposition denselben Wert fest wie für die Anfangsposition. Um dem vorhandenen Text im Bereich weiteren Text anzuhängen, legen Sie die Anfangs- und Endposition gleich der Länge des vorhandenen Textes fest.
Der ersetzte Text enthält das Startzeichen bis zum Endzeichen (wobei dieses nicht einbezogen wird).
Parameter
relativeStartPosition:int — Die Indexposition am Anfang des zu ersetzenden Texts relativ zum Anfang des Bereichs. Das erste Zeichen im Bereich befindet sich an der Position 0.
| |
relativeEndPosition:int — Die Indexposition eins nach dem letzten Zeichen des zu ersetzenden Texts relativ zum Beginn des Bereichs. Legen Sie diesen Wert gleich der relativeStartPos fest, wenn Text eingefügt werden soll.
| |
textValue:String — Der Ersetzungstext oder der ggf. hinzuzufügende Text.
|
Auslöser
RangeError — Die festgelegte relativeStartPosition oder relativeEndPosition liegt außerhalb des zulässigen Bereichs oder ein Ersatzpaar wird infolge der Ersetzung geteilt.
|
Beispiel ( Verwendung dieses Beispiels )
In diesem Beispiel wird ein zweiter Bereich (span2) für die Anzeige der Ergebnisse verwendet.
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, 10:04 AM Z