Pakiet | flashx.textLayout.elements |
Klasa | public class SpanElement |
Dziedziczenie | SpanElement FlowLeafElement FlowElement Object |
Podklasy | SpecialCharacterElement |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Element ParagraphElement będzie zawierał jeden obiekt SpanElement, jeśli cały tekst w akapicie współkorzysta z tego samego zestawu atrybutów. Zawiera wiele elementów SpanElement, jeśli tekst w akapicie zawiera wiele formatów.
Domyślna właściwość MXMLmxmlChildren
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
alignmentBaseline : *
TextLayoutFormat: określa linię bazową, do której wyrównywana jest dominująca linia bazowa. | FlowElement | ||
backgroundAlpha : *
TextLayoutFormat: wartość alfa (przezroczystość) dla tła (jeśli przekazana kaskadowo wartość nie jest zdefiniowana, przyjmowana jest wartość domyślna). | FlowElement | ||
backgroundColor : *
TextLayoutFormat: kolor tła tekstu (jeśli zostanie przekazana kaskadowo wartość undefined, przyjmowana jest wartość domyślna). | FlowElement | ||
baselineShift : *
TextLayoutFormat: przesunięcie linii bazowej względem wartości dominantBaseline. | FlowElement | ||
blockProgression : *
TextLayoutFormat: określa pionowy lub poziomy przyrost położenia przy rozmieszczaniu wierszy. | FlowElement | ||
breakOpportunity : *
TextLayoutFormat: steruje miejscem dozwolonego podziału wierszy przy zawijaniu tekstu. | FlowElement | ||
cffHinting : *
TextLayoutFormat: typ przyciągania CFF użyty dla tego tekstu. | FlowElement | ||
clearFloats : *
TextLayoutFormat: Steruje sposobem zawijania tekstu wokół obiektu ruchomego. | FlowElement | ||
color : *
TextLayoutFormat: kolor tekstu. | FlowElement | ||
columnCount : *
TextLayoutFormat: liczba kolumn tekstu (jeśli kaskadowo zostanie przekazana wartość undefined, przyjmowana jest wartość domyślna). | FlowElement | ||
columnGap : *
TextLayoutFormat: określa odstęp między kolumnami w pikselach (jeśli przekazana kaskadowo wartość jest równa undefined, przyjmowana jest wartość domyślna). | FlowElement | ||
columnWidth : *
TextLayoutFormat: szerokość kolumny w pikselach (jeśli przekazana kaskadowo wartość jest równa undefined, przyjmowana jest wartość domyślna). | FlowElement | ||
computedFormat : flashx.textLayout.formats:ITextLayoutFormat [przesłanianie] [tylko do odczytu]
Obliczone atrybuty formatu, które obowiązują dla danego elementu. | FlowLeafElement | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
coreStyles : Object [tylko do odczytu] Zwraca właściwość coreStyles tego obiektu FlowElement. | FlowElement | ||
digitCase : *
TextLayoutFormat: sposób różnicowania wielkości cyfr w tekście. | FlowElement | ||
digitWidth : *
TextLayoutFormat: Szerokość cyfr stosowana w tym tekście. | FlowElement | ||
direction : *
TextLayoutFormat: określa domyślny dwukierunkowy poziom osadzenia tekstu w bloku tekstu. | FlowElement | ||
dominantBaseline : *
TextLayoutFormat: określa, która linia bazowa elementów jest przyciągana do linii alignmentBaseline w celu ustalenia pionowego położenia elementu w wierszu. | FlowElement | ||
firstBaselineOffset : *
TextLayoutFormat: określa położenie linii bazowej dla pierwszego wiersza w kontenerze. | FlowElement | ||
fontFamily : *
TextLayoutFormat: nazwa użytej czcionki lub lista nazw czcionek oddzielonych od siebie przecinkami. | FlowElement | ||
fontLookup : *
TextLayoutFormat: sposób wyszukiwania czcionek. | FlowElement | ||
fontSize : *
TextLayoutFormat: rozmiar tekstu w pikselach. | FlowElement | ||
fontStyle : *
TextLayoutFormat: styl tekstu. | FlowElement | ||
fontWeight : *
TextLayoutFormat: grubość tekstu. | FlowElement | ||
format : flashx.textLayout.formats:ITextLayoutFormat Właściwości TextLayoutFormat są stosowane bezpośrednio do tego elementu. | FlowElement | ||
id : String
Przypisuje identyfikującą nazwę do elementu, umożliwiając ustawienie stylu dla elementu poprzez utworzenie odniesienia do identyfikatora. | FlowElement | ||
justificationRule : *
TextLayoutFormat: reguła justowania tekstu w akapicie. | FlowElement | ||
justificationStyle : *
TextLayoutFormat: styl justowania akapitu. | FlowElement | ||
kerning : *
TextLayoutFormat: kerning dopasowuje piksele pomiędzy określonymi parami znaków w celu poprawienia czytelności. | FlowElement | ||
leadingModel : *
TextLayoutFormat: określa model interlinii, czyli ustawienia podstawy i kierunku interlinii. | FlowElement | ||
ligatureLevel : *
TextLayoutFormat: określa, które z ligatur zdefiniowanych w czcionce mogą być używane w tekście. | FlowElement | ||
lineBreak : *
TextLayoutFormat: steruje podziałem wyrazów między wiersze w kontenerze (jeśli wartość przekazana kaskadowo jest równa undefined, przyjmowana jest wartość domyślna). | FlowElement | ||
lineHeight : *
TextLayoutFormat: specyfikacja interlinii tekstu. | FlowElement | ||
lineThrough : *
TextLayoutFormat: wartość true powoduje zastosowanie przekreślenia, czyli linii biegnącej przez środek wiersza tekstu. | FlowElement | ||
linkActiveFormat : *
TextLayoutFormat: Definiuje atrybuty formatujące używane dla łączy w stanie normalnym. | FlowElement | ||
linkHoverFormat : *
TextLayoutFormat: Definiuje atrybuty formatowania używane dla łączy w stanie wskazywania, gdy wskaźnik myszy znajduje się w obrębie obwiedni łącza (nasuwanie kursora). | FlowElement | ||
linkNormalFormat : *
TextLayoutFormat: Definiuje atrybuty formatujące używane dla łączy w stanie normalnym. | FlowElement | ||
listAutoPadding : *
TextLayoutFormat: Określa automatyczne wcięcie dla krawędzi początkowych list w przypadkach, gdy wartość dopełnienia listy po danej stronie wynosi auto. | FlowElement | ||
listMarkerFormat : *
TextLayoutFormat: Definiuje znaczniki formatowania list atrybutów. | FlowElement | ||
listStylePosition : *
TextLayoutFormat: Wartości dozwolone: ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT. Wartość domyślna (undefined) oznacza, że właściwość nie jest ustawiona. Jeśli zostanie przekazana kaskadowo wartość undefined, ta właściwość odziedziczy wartość z obiektu macierzystego. | FlowElement | ||
listStyleType : *
TextLayoutFormat: Wartości dozwolone: 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. Wartość domyślna (undefined) oznacza, że właściwość nie jest ustawiona. Jeśli zostanie przekazana kaskadowo wartość undefined, ta właściwość odziedziczy wartość z obiektu macierzystego. | FlowElement | ||
locale : *
TextLayoutFormat: ustawienia narodowe tekstu. | FlowElement | ||
mxmlChildren : Array
Ustawia tekst w zakresie na podstawie treści; zawsze usuwa istniejące elementy podrzędne. | SpanElement | ||
paddingBottom : *
TextLayoutFormat: Wstawka dolna w pikselach. | FlowElement | ||
paddingLeft : *
TextLayoutFormat: Lewa wstawka w pikselach. | FlowElement | ||
paddingRight : *
TextLayoutFormat: Prawa wstawka w pikselach. | FlowElement | ||
paddingTop : *
TextLayoutFormat: Górna wstawka w pikselach. | FlowElement | ||
paragraphEndIndent : *
TextLayoutFormat: liczba określająca (w pikselach) wielkość wcięcia końcowej krawędzi akapitu. | FlowElement | ||
paragraphSpaceAfter : *
TextLayoutFormat: liczba, która określa w pikselach ilość miejsca, jaką należy pozostawić za akapitem. | FlowElement | ||
paragraphSpaceBefore : *
TextLayoutFormat: liczba, która określa w pikselach ilość miejsca, jaką należy pozostawić przed akapitem. | FlowElement | ||
paragraphStartIndent : *
TextLayoutFormat: liczba określająca (w pikselach) wielkość wcięcia początkowej krawędzi akapitu. | FlowElement | ||
parent : FlowGroupElement [tylko do odczytu] Zwraca obiekt nadrzędny danego obiektu FlowElement. | FlowElement | ||
parentRelativeEnd : int [tylko do odczytu] Zwraca względny koniec danego obiektu FlowElement w elemencie nadrzędnym. | FlowElement | ||
parentRelativeStart : int [tylko do odczytu] Zwraca względny początek danego obiektu FlowElement w elemencie nadrzędnym. | FlowElement | ||
renderingMode : *
TextLayoutFormat: tryb renderowania używany dla tego tekstu. | FlowElement | ||
styleName : *
TextLayoutFormat: Przypisuje klasę identyfikującą do elementu, umożliwiając ustawienie stylu dla elementu za pomocą odniesienia do właściwości styleName. | FlowElement | ||
styles : Object [tylko do odczytu] Zwraca właściwość styles tego obiektu FlowElement. | FlowElement | ||
tabStops : *
TextLayoutFormat: określa znaczniki tabulacji skojarzone z akapitem. | FlowElement | ||
text : String
Otrzymuje ciąg tekstu, które zawiera obiekt SpanElement. | SpanElement | ||
textAlign : *
TextLayoutFormat: wyrównanie wierszy akapitu względem kontenera. | FlowElement | ||
textAlignLast : *
TextLayoutFormat: wyrównanie ostatniego (lub jedynego) wiersza tekstu justowanego w akapicie względem kontenera. | FlowElement | ||
textAlpha : *
TextLayoutFormat: wartość Alfa (przezroczystość) dla tekstu. | FlowElement | ||
textDecoration : *
TextLayoutFormat: dekoracja tekstu. | FlowElement | ||
textIndent : *
TextLayoutFormat: liczba określająca w pikselach wcięcie pierwszego wiersza akapitu. | FlowElement | ||
textJustify : *
TextLayoutFormat: określa opcje justowania tekstu. | FlowElement | ||
textLength : int [tylko do odczytu]
Zwraca całkowitą długość tekstu, którego właścicielem jest obiekt FlowElement oraz jego obiekty podrzędne. | FlowElement | ||
textRotation : *
TextLayoutFormat: kąt obrotu tego tekstu w stopniach. | FlowElement | ||
tracking : Object [tylko do zapisu]
Ustawia światło i działa tak samo, jak właściwość trackingRight. | FlowElement | ||
trackingLeft : *
TextLayoutFormat: liczba pikseli (lub procent wartości fontSize, np. 120%) wskazująca ilość światła (kerning ręczny) do zastosowania po lewej stronie każdego znaku. | FlowElement | ||
trackingRight : *
TextLayoutFormat: liczba pikseli (lub procent wartości fontSize, np. 120%) wskazująca ilość światła (kerning ręczny) do zastosowania po prawej stronie każdego znaku. | FlowElement | ||
typeName : String
Każdy obiekt FlowElement ma właściwość typeName. | FlowElement | ||
typographicCase : *
TextLayoutFormat: sposób różnicowania wielkości liter w tekście. | FlowElement | ||
userStyles : Object Umożliwia odczytywanie i zapisywanie stylów użytkownika w obiekcie FlowElement. | FlowElement | ||
verticalAlign : *
TextLayoutFormat: wyrównanie pionowe lub justowanie (jeśli wartość przekazana kaskadowo jest równa undefined, przyjmowana jest wartość domyślna). | FlowElement | ||
whiteSpaceCollapse : *
TextLayoutFormat: powoduje usuwanie albo zachowywanie białych znaków podczas importowania tekstu do obiektu TextFlow. | FlowElement | ||
wordSpacing : *
TextLayoutFormat: Określa optymalny, minimalny i maksymalny odstęp między wyrazami (jako mnożnik szerokości normalnego odstępu) obowiązujący przy justowaniu. | FlowElement |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Konstruktor — tworzy obiekt SpanElement w celu przechowywania fragmentu tekstu w akapicie. | SpanElement | ||
Usuwa styl określony przez parametr styleProp z danego obiektu FlowElement. | FlowElement | ||
Tworzy głęboką kopię tego obiektu FlowElement wraz z wszelkimi elementami podrzędnymi, kopiując treść między dwoma określonymi położeniami znaków oraz zwracając kopię jako obiekt FlowElement. | FlowElement | ||
Porównanie stylów userStyle danej kopii ze stylami userStyle innego elementu otherElement. | FlowElement | ||
Zwraca położenie początkowe elementu w przepływie tekstu w postaci indeksu bezwzględnego. | FlowElement | ||
Zwraca znak w określonym położeniu względem danego obiektu FlowElement. | FlowElement | ||
Zwraca kod znaku w określonym położeniu względem danego obiektu FlowElement. | FlowElement | ||
Zwraca obiekty FontMetrics dla zakresu. | FlowLeafElement | ||
Zwraca początek tego elementu względem elementu przodka. | FlowElement | ||
Zwraca następny element FlowLeafElement. | FlowLeafElement | ||
Zwraca następny siostrzany obiekt FlowElement z hierarchii przepływu tekstu. | FlowElement | ||
Zwraca obiekt ParagraphElement skojarzony z danym elementem. | FlowElement | ||
Zwraca poprzedni obiekt FlowLeafElement. | FlowLeafElement | ||
Zwraca poprzedni obiekt równorzędny FlowElement z hierarchii przepływu tekstu. | FlowElement | ||
Zwraca wartość stylu określonego przez parametr styleProp, który określa nazwę stylu oraz może zawierać dowolną nazwę stylu użytkownika. | FlowElement | ||
Pobiera określony zakres tekstu z elementu przepływu. | FlowElement | ||
Przechodzi do coraz wyższych poziomów w hierarchii przepływu tekstu w celu zwrócenia głównego obiektu TextFlow dla elementu. | FlowElement | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wywoływany dla obiektów MXML po utworzeniu obiektu implementującego i jeśli zainicjalizowano wszystkie właściwości składnika określonego w znaczniku MXML. | FlowElement | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Aktualizuje tekst w zakresie tekstu na podstawie określonych położeń rozpoczęcia i zakończenia. | SpanElement | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Ustawia styl określony przez parametr styleProp na wartość określoną przez parametr newValue. | FlowElement | ||
Tworzy kopię danego obiektu FlowElement, kopiując treść między dwoma określonymi położeniami znaków. | FlowElement | ||
Dzieli obiekt FlowElement w miejscu określonym przez parametr relativePosition, co stanowi względne położenie tego elementu w tekście. | FlowElement | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
mxmlChildren | właściwość |
mxmlChildren:Array
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Ustawia tekst w zakresie na podstawie treści; zawsze usuwa istniejące elementy potomne. Ta właściwość jest przeznaczona do użytku podczas importowania skompilowanego kodu XML w programie Flex. Program Flash Professional ignoruje tę właściwość. Jeśli elementy znaczników TLF zawierają inne znaczniki TLF jako elementy podrzędne, wówczas elementy podrzędne są przypisane do tej właściwości.
Implementacja
public function get mxmlChildren():Array
public function set mxmlChildren(value:Array):void
Zgłasza
TypeError — Jeśli element tablicy nie jest elementem SpecialCharacterElement ani obiektem String.
|
text | właściwość |
text:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Otrzymuje ciąg znaków tekstu, które zawiera obiekt SpanElement.
Tekst w zakresie nie zawiera znaku powrotu karetki na końcu akapitu, ale jest on zawarty w wartości textLength
.
Implementacja
public function get text():String
public function set text(value:String):void
SpanElement | () | Konstruktor |
public function SpanElement()
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Konstruktor — tworzy obiekt SpanElement w celu przechowywania fragmentu tekstu w akapicie.
replaceText | () | metoda |
public function replaceText(relativeStartPosition:int, relativeEndPosition:int, textValue:String):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Aktualizuje tekst w zakresie tekstu na podstawie określonych położeń rozpoczęcia i zakończenia. W celu wstawienia tekstu należy ustawić położenie końcowe równe położeniu początkowemu. W celu dołączenia tekstu do tekstu istniejącego w zakresie należy ustawić położenie początkowe i końcowe w taki sposób, aby liczba znaków między tymi położeniami była równa długości istniejącego tekstu.
Zastępowany tekst zawiera pierwszy znak oraz znaki aż do znaku ostatniego (bez niego).
Parametry
relativeStartPosition:int — Indeks początku tekstu do zastąpienia jest określany względem początku zakresu. Pierwszy znak w zakresie ma indeks położenia 0.
| |
relativeEndPosition:int — Indeks 1 po ostatnim znaku tekstu do zastąpienia jest określany względem początku zakresu. W celu wstawienia tę wartość należy ustawić na równą relativeStartPos .
| |
textValue:String — Tekst zastępczy lub tekst do dodania.
|
Zgłasza
RangeError — W wyniku zamiany określone wartości relativeStartPosition i relativeEndPosition znajdują się poza zakresem lub następuje podzielenie zastępczej pary.
|
Przykład ( Sposób korzystania z tego przykładu )
W przykładzie wykorzystano drugi zakres (span2) w celu wyświetlenia rezultatów.
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, 12:06 PM Z