Pakiet | flash.text.engine |
Klasa | public final class GroupElement |
Dziedziczenie | GroupElement ContentElement Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
content
obiektu TextBlock. Obiekt GroupElement może również korzystać ze wspólnego formatowania w obrębie innego obiektu GroupElement.
Jeśli obiekt GroupElement zawiera inny obiekt GroupElement, wewnętrzny obiekt GroupElement zachowuje własne formatowanie (ustawienia ElementFormat). Nie dziedziczy formatowania zewnętrznego obiektu GroupElement.
Większość właściwości formatowania nie ma wpływu na obiekt GroupElement. Z tego powodu dozwolone jest tworzenie wiersza tekstu dla obiektu GroupElement z wartością null dla parametru elementFormat
. Klika właściwości dotyczących formatu, takie jak kerning
oraz ligature
wpływa na formatowanie w przypadku przecięć mających miejsce pomiędzy elementami grupy. Jeśli grupa zawiera format o wartości null, format poprzedniego elementu decyduje o formatowaniu w miejscu przecięcia pomiędzy elementami grupy.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
elementCount : int [tylko do odczytu]
Liczba elementów w grupie. | GroupElement | ||
elementFormat : ElementFormat
Obiekt ElementFormat zastosowany dla elementu. | ContentElement | ||
eventMirror : EventDispatcher
Obiekt EventDispatcher otrzymujący kopie każdego zdarzenia wywołanego do poprawnego wiersza tekstu utworzonego na podstawie tego elementu treści. | ContentElement | ||
groupElement : GroupElement [tylko do odczytu]
Obiekt GroupElement zawierający ten element lub wartość null, jeśli element nie znajduje się w grupie. | ContentElement | ||
rawText : String [tylko do odczytu]
Kopia tekstu w elemencie, w tym znaki U+FDEF. | ContentElement | ||
text : String [tylko do odczytu]
Kopia tekstu w elemencie bez znaków U+FDEF reprezentujących element graficzny w ciągu znaków. | ContentElement | ||
textBlock : flash.text.engine:TextBlock [tylko do odczytu]
Obiekt TextBlock, do którego należy element. | ContentElement | ||
textBlockBeginIndex : int [tylko do odczytu]
Indeks w bloku tekstu pierwszego znaku tego elementu. | ContentElement | ||
textRotation : String
Obrót zastosowany do elementu jako jednostki. | ContentElement | ||
userData : *
Umożliwia aplikacji skojarzenie dowolnych danych z elementem. | ContentElement |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
GroupElement(elements:Vector.<ContentElement> = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Tworzy nową instancję GroupElement. | GroupElement | ||
Pobiera element z grupy. | GroupElement | ||
Zwraca element zawierający znak określony przez parametr charIndex. | GroupElement | ||
Zwraca indeks elementu określony przez parametr element. | GroupElement | ||
Zastępuje zakres elementów określonych przez parametry beginIndex oraz endIndex za pomocą nowego obiektu GroupElement zawierającego te elementy. | GroupElement | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Łączy tekst z zakresu elementów określonych przez parametr beginIndex oraz endIndex, tworząc element określony przez parametr beginIndex bez wpływu na format tego elementu. | GroupElement | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
replaceElements(beginIndex:int, endIndex:int, newElements:Vector.<ContentElement>):Vector.<ContentElement>
Zastępuje zakres elementów określonych przez parametry beginIndex oraz endIndex zawartością parametru newElements. | GroupElement | ||
Ustawia elementy w grupie jako zawartość obiektu Vector. | GroupElement | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Dzieli obiekt TextElement na dwa, tworząc nowy obiekt TextElement w określonej pozycji. | GroupElement | ||
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 | ||
Usuwa podział na grupy elementów w zagnieżdżonym elemencie GroupElement określonym przez groupIndex w obrębie zewnętrznego obiektu GroupElement. | GroupElement | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
elementCount | właściwość |
GroupElement | () | Konstruktor |
public function GroupElement(elements:Vector.<ContentElement> = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Tworzy nowe wystąpienie klasy GroupElement.
Parametryelements:Vector.<ContentElement> (default = null ) — Wektor obiektu ContentElement uwzględniony w obiekcie GroupElement. Obiekt Vector może być pusty. Wartością domyślną jest null .
| |
elementFormat:ElementFormat (default = null ) — Format elementu dla grupy. Wartością domyślną jest null . Ten format ma zastosowanie do przecięć pomiędzy elementami w grupie; te elementy nie dziedziczą formatu.
| |
eventMirror:EventDispatcher (default = null ) — Obiekt EventDispatcher otrzymujący kopie każdego zdarzenia wywołanego do wierszy tekstu utworzonych na podstawie tego elementu treści. Wartością domyślną jest null .
| |
textRotation:String (default = "rotate0 ") — Obrót zastosowany do elementu jako jednostki. Dla tej właściwości należy użyć stałej TextRotation . Wartością domyślną jest TextRotation.ROTATE_0 .
|
Zgłasza
ArgumentError — Określona właściwość element zawiera elementy null .
| |
ArgumentError — Określona właściwość content zawiera element, który nie jest znaną podklasą ContentElement .
| |
ArgumentError — Określona właściwość element zawiera elementy, które są zdefiniowane jako treść (content ) obiektu TextBlock .
| |
ArgumentError — Określony obiekt element zawiera elementy należące już do grupy lub pojawiające się co najmniej jeden raz w obiektachelements .
|
Powiązane elementy interfejsu API
getElementAt | () | metoda |
public function getElementAt(index:int):ContentElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Pobiera element z grupy.
Parametry
index:int — Indeks elementu do pobrania.
|
ContentElement |
Zgłasza
RangeError — Jeśli wartość właściwości index jest poza zakresem.
|
getElementAtCharIndex | () | metoda |
public function getElementAtCharIndex(charIndex:int):ContentElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Zwraca element zawierający znak określony przez parametr charIndex
.
Parametry
charIndex:int — Liczony od 0 indeks znaku, którego element będzie wyszukiwany. Wartość 0 odpowiada pierwszemu znakowi w grupie, a nie pierwszemu znakowi w obiekcie TextBlock.
|
ContentElement — Element zawierający znak określony przez parametr charIndex
|
Zgłasza
RangeError — Jeśli parametr charIndex nie znajduje się w zakresie 0 - rawText.length .
|
getElementIndex | () | metoda |
public function getElementIndex(element:ContentElement):int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Zwraca indeks elementu określony przez parametr element
.
Parametry
element:ContentElement — Element w grupie, którego indeks będzie pobierany.
|
int — Indeks elementu określonego przez parametr element lub wartość -1, jeśli element nie znajduje się w grupie.
|
groupElements | () | metoda |
public function groupElements(beginIndex:int, endIndex:int):GroupElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Zastępuje zakres elementów określonych przez parametry beginIndex
i endIndex
za pomocą nowego obiektu GroupElement
zawierającego te elementy. Zgodnie z planem zostały zastąpione elementy z zakresu od beginIndex do endIndex-1.
Parametry
beginIndex:int — Liczony od 0 indeks pozycji wyjściowej zakresu do grupowania.
| |
endIndex:int — Liczony od 0 indeks następujący po pozycji końcowej zakresu do grupowania.
|
GroupElement — Nowa grupa.
|
Zgłasza
RangeError — Parametr beginIndex lub endIndex znajduje się poza zakresem.
|
mergeTextElements | () | metoda |
public function mergeTextElements(beginIndex:int, endIndex:int):flash.text.engine:TextElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Łączy tekst z zakresu elementów określonych przez parametr beginIndex
oraz endIndex
, tworząc element określony przez parametr beginIndex
bez wpływu na format tego elementu. Zgodnie z planem zostały połączone elementy z zakresu od beginIndex do endIndex-1. Po połączeniu swojego tekstu elementy z zakresu od beginIndex+1 do endIndex-1 są usuwane z grupy i stają się w elementami osieroconymi z wartością null
dla właściwości group
.
Parametry
beginIndex:int — Liczony od 0 indeks pozycji wyjściowej zakresu do połączenia.
| |
endIndex:int — Liczony od 0 indeks następujący po pozycji końcowej zakresu do połączenia.
|
flash.text.engine:TextElement — Pierwszy element tekstu w zakresie, który teraz zawiera cały tekst z zakresie.
|
Zgłasza
RangeError — Parametr beginIndex lub endIndex znajduje się poza zakresem.
| |
ArgumentError — Jeśli dowolny z elementów w określonym zakresie nie jest obiektem TextElement.
|
Powiązane elementy interfejsu API
replaceElements | () | metoda |
public function replaceElements(beginIndex:int, endIndex:int, newElements:Vector.<ContentElement>):Vector.<ContentElement>
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Zastępuje zakres elementów określonych przez parametry beginIndex
oraz endIndex
zawartością parametru newElements
. Zostały zastąpione elementy z zakresu od beginIndex do endIndex-1.
Aby usunąć elementy, należy przekazać wartośćnull
do newElements
. Aby wstawić element, należy przekazać tę samą wartość do parametru beginIndex
i endIndex
. Nowy element zostaje wstawiony przed określonym indeksem. Aby dołączyć element, należy przekazać wartość elementCount
do parametru beginIndex
.oraz
endIndex
Po operacji wymienione elementy zostają osierocone i zawierają wartość null
dla właściwości group
.
Parametry
beginIndex:int — Liczony od 0 indeks pozycji wyjściowej zakresu zamiennego.
| |
endIndex:int — Liczony od 0 indeks następujący po pozycji końcowej zakresu zamiennego.
| |
newElements:Vector.<ContentElement> — Elementy użyte do zastąpienia określonego zakresu elementów.
|
Vector.<ContentElement> — Obiekt Vector zawierający elementy, które zostały wymienione.
|
Zgłasza
RangeError — Podany parametr beginIndex lub endIndex znajduje się poza zakresem.
| |
ArgumentError — Określone obiekty newElements zawierają elementy null .
| |
ArgumentError — Określone obiekty newElements zawierają wartość this .
| |
ArgumentError — Określone obiekty newElements zawierają elementy, które nie stanowią znanej podklasy ContentElement .
| |
ArgumentError — Określone obiekty newElements zawierają elementy, które są zdefiniowane jako treść (content ) obiektu TextBlock .
| |
ArgumentError — Określone obiekty newElements zawierają elementy należące już do grupy lub pojawiające się co najmniej jeden raz we właściwości elements .
| |
ArgumentError — Jeśli działanie spowoduje zagnieżdżenie obrotu w obiekcie GroupElement .
|
setElements | () | metoda |
public function setElements(value:Vector.<ContentElement>):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Ustawia elementy w grupie jako treść obiektu Vector.
Parametry
value:Vector.<ContentElement> |
Zgłasza
ArgumentError — Określona właściwość value zawiera elementy null .
| |
ArgumentError — Określona właściwość value zawiera wartość null .
| |
ArgumentError — Określona właściwość value nie zawiera elementów znanej podklasy ContentElement .
| |
ArgumentError — Określona właściwość value zawiera elementy, które są zdefiniowane jako treść (content ) obiektu TextBlock .
| |
ArgumentError — Określona właściwość value zawiera elementy należące już do grupy lub pojawiające się co najmniej jeden raz we właściwości value .
| |
ArgumentError — Jeśli działanie spowoduje zagnieżdżenie obrotu w obiekcie GroupElement .
|
splitTextElement | () | metoda |
public function splitTextElement(elementIndex:int, splitIndex:int):flash.text.engine:TextElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Dzieli obiekt TextElement na dwa, tworząc nowy obiekt TextElement na określonej pozycji.
Parametry
elementIndex:int — Liczony od 0 indeks pozycji elementu w grupie.
| |
splitIndex:int — Liczony od 0 indeks znaku w obiekcie TextElement, w którym wystąpi podział. Określony znak stanowi pierwszy znak w nowym obiekcie TextElement.
|
flash.text.engine:TextElement — Nowy element tekstowy zawierający wspomnianą część pierwotnego elementu tekstowego.
|
Zgłasza
RangeError — Jeśli parametr elementIndex lub charIndex znajduje się poza zakresem.
| |
ArgumentError — Jeśli element określony przez elementIndex nie jest obiektem TextElement.
|
Powiązane elementy interfejsu API
ungroupElements | () | metoda |
public function ungroupElements(groupIndex:int):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Usuwa podział na grupy elementów w zagnieżdżonym elemencie GroupElement określonym przez groupIndex
w obrębie zewnętrznego obiektu GroupElement. Po operacji elementy z podzielonej grupy zastępują zagnieżdżony obiekt GroupElement, który staje się obiektem osieroconym z wartością null
we właściwości group
.
Parametry
groupIndex:int — Liczony od 0 indeks pozycji grupy, która będzie rozdzielona.
|
Zgłasza
RangeError — Jeśli groupIndex jest poza zakresem.
| |
ArgumentError — Jeśli element określony przez groupIndex nie jest obiektem GroupElement.
|
content
obiektu TextBlock, z którego tworzy trzy wiersze.
package { import flash.display.Sprite; import flash.display.MovieClip; import flash.text.engine.ContentElement; import flash.text.engine.TextBlock; import flash.text.engine.TextElement; import flash.text.engine.GraphicElement; import flash.text.engine.GroupElement; import flash.text.engine.TextLine; import flash.text.engine.ElementFormat; import flash.text.engine.FontDescription; public class GroupElementExample extends Sprite { public function GroupElementExample():void { var redBox:MovieClip = new MovieClip(); redBox.graphics.beginFill(0xCC0000, 1.0); redBox.graphics.drawRect(0, 0, 20, 20); redBox.graphics.endFill(); var format:ElementFormat = new ElementFormat(); var fontDescription:FontDescription = new FontDescription("Arial"); format.fontSize = 16; format.fontDescription = fontDescription; var str1:String = "This red box is a GraphicElement "; var str2:String = " in the middle of two TextElements, " + " which together make " + "up a GroupElement in a TextBlock that is broken into three lines."; var textElement1:TextElement = new TextElement(str1,format); var graphicElement:GraphicElement = new GraphicElement(redBox,redBox.width,redBox.height, format); var textElement2:TextElement = new TextElement(str2, format); var groupVector:Vector.<ContentElement> = new Vector.<ContentElement>(); groupVector.push(textElement1, graphicElement, textElement2); var groupElement = new GroupElement(groupVector); var textBlock:TextBlock = new TextBlock(); textBlock.content = groupElement; createTextLines(textBlock); } private function createTextLines(textBlock:TextBlock):void { var yPos = 20; var line_length:Number = 450; var textLine:TextLine = textBlock.createTextLine (null, line_length); while (textLine) { addChild(textLine); textLine.x = 15; yPos += textLine.height+8; textLine.y = yPos; textLine = textBlock.createTextLine(textLine, line_length); } } } }
Tue Jun 12 2018, 12:06 PM Z