| Pakiet | flashx.textLayout.compose |
| Klasa | public final class TextFlowLine |
| Dziedziczenie | TextFlowLine  Object |
| Implementuje | IVerticalJustificationLine |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Za pomocą tej klasy można uzyskiwać informacje dotyczące tego, w jaki sposób został ustawiony wiersz tekstu: położenie, wysokość, szerokość itp. Gdy przepływ tekstu (TextFlow) zostanie zmodyfikowany, wówczas wiersze bezpośrednio poprzedzające miejsce modyfikacji są oznaczane jako niepoprawne, ponieważ konieczna jest zmiana ich układu. Możliwe jest, że wiersze za miejscem modyfikacji nie zostały uszkodzone od razu, ale mogą zostać odtworzone po ułożeniu tekstu. Można uzyskać dostęp do klasy TextFlowLine, która została uszkodzona, ale wszelkie wartości, do których uzyskano dostęp, odzwierciedlają stary stan obiektu TextFlow. Po zmianie układu obiektu TextFlow następuje wygenerowanie nowych wierszy oraz możliwe jest uzyskanie nowego wiersza dla danego położenia poprzez wywołanie metody TextFlow.flowComposer.findLineAtPosition().
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| absoluteStart : int [tylko do odczytu]
Położenie wiersza jako bezwzględne położenie znaku w obiekcie TextFlow. | TextFlowLine | ||
| ascent : Number [tylko do odczytu]
Określa liczbę pikseli od linii bazowej do górnej części najwyższych znaków w wierszu. | TextFlowLine | ||
| columnIndex : int [tylko do odczytu] Numer kolumny, w której został umieszczony wiersz; pierwsza kolumna ma numer 0. | TextFlowLine | ||
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| controller : ContainerController [tylko do odczytu]
Kontroler (obiekt ContainerController) dla kontenera, w którym został umieszczony wiersz. | TextFlowLine | ||
| descent : Number [tylko do odczytu]
Określa liczbę pikseli od linii bazowej do dolnego punktu najniżej sięgających znaków w wierszu. | TextFlowLine | ||
| height : Number [tylko do odczytu] Wysokość wiersza w pikselach. | TextFlowLine | ||
| lineOffset : Number [tylko do odczytu]
Przesunięcie wiersza w pikselach od odpowiedniego zwężenia kontenera (co wskazuje kierunek akapitu oraz postęp bloku kontenera) przed ułożeniem wierszy w akapicie. | TextFlowLine | ||
| location : int [tylko do odczytu]
Jedna z wartości z TextFlowLineLocation przeznaczona do określania położenia wiersza w akapicie. | TextFlowLine | ||
| paragraph : ParagraphElement [tylko do odczytu]
Akapit (ParagraphElement), w którym znajduje się wiersz. | TextFlowLine | ||
| spaceAfter : Number [tylko do odczytu]
Odstęp do pozostawienia za wierszem. | TextFlowLine | ||
| spaceBefore : Number [tylko do odczytu]
Odstęp do pozostawienia przed wierszem. | TextFlowLine | ||
| textHeight : Number [tylko do odczytu]
Wysokość wiersza tekstu równa wartości sumy wydłużenia górnego (acent) i dolnego (descent). | TextFlowLine | ||
| textLength : int [tylko do odczytu]
Liczba znaków do następnego wiersza, łącznie ze spacjami wiodącymi. | TextFlowLine | ||
| textLineExists : Boolean [tylko do odczytu]
Wskazuje, czy istnieje obiekt flash.text.engine.TextLine dla danej klasy TextFlowLine. | TextFlowLine | ||
| unjustifiedTextWidth : Number [tylko do odczytu]
Szerokość wiersza bez justowania. | TextFlowLine | ||
| validity : String [tylko do odczytu] Poprawność wiersza. | TextFlowLine | ||
| x : Number
Pozioma pozycja wiersza względem jego kontenera, wyrażona jako przesunięcie w pikselach względem lewej krawędzi kontenera. | TextFlowLine | ||
| y : Number
Pionowa pozycja wiersza względem jego kontenera, wyrażona jako przesunięcie w pikselach względem górnej krawędzi kontenera. | TextFlowLine | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0) Konstruktor — tworzy nową instancję klasy TextFlowLine. | TextFlowLine | ||
Zwraca granice wiersza w postaci prostokąta. | TextFlowLine | ||
Zwraca obiekt flash.text.engine.TextLine dla tego wiersza, który może zostać odtworzony, jeśli nie istnieje z powodu czyszczenia pamięci. | TextFlowLine | ||
|
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 | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
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 | |
absoluteStart | właściwość |
ascent | właściwość |
ascent:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Określa liczbę pikseli od linii bazowej do górnego punktu najwyższych znaków w wierszu. Dla obiektu TextLine zawierającego wyłącznie elementy graficzne, wartośćascent wynosi 0.
Implementacja
public function get ascent():NumbercolumnIndex | właściwość |
controller | właściwość |
controller:ContainerController [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Kontroler (obiekt ContainerController) dla kontenera, w którym został umieszczony wiersz.
Implementacja
public function get controller():ContainerControllerPowiązane elementy interfejsu API
descent | właściwość |
descent:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Określa liczbę pikseli od linii bazowej do dolnego punktu najniżej sięgających znaków w wierszu. Dla obiektu TextLine zawierającego wyłącznie elementy graficzne wartośćdescent wynosi 0.
Implementacja
public function get descent():Numberheight | właściwość |
lineOffset | właściwość |
lineOffset:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Przesunięcie wiersza w pikselach od odpowiedniego zwężenia kontenera (co wskazuje kierunek akapitu oraz postęp bloku kontenera) przed ułożeniem wierszy w akapicie.
Implementacja
public function get lineOffset():Numberlocation | właściwość |
paragraph | właściwość |
paragraph:ParagraphElement [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Akapit (ParagraphElement), w którym znajduje się wiersz.
Implementacja
public function get paragraph():ParagraphElementPowiązane elementy interfejsu API
spaceAfter | właściwość |
spaceAfter:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Odstęp do pozostawienia za wierszem.
Jeśli wiersz jest ostatnim wierszem akapitu, który zawiera odstęp za wierszem, wówczas wiersz będzie miał wartość spaceAfter. Jeśli wiersz znajduje się u dołu kolumny, wówczas wartość spaceAfter będzie ignorowana. W przeciwnym wypadku wiersz będzie znajdował się przed innym wierszem w kolumnie i wówczas konieczne będzie ustawienie kolejnego wiersza w pionie w celu zapewnienia, że istnieje co najmniej taki odstęp między ostatnim wierszem w danym akapicie a pierwszym wierszem w kolejnym akapicie.
Implementacja
public function get spaceAfter():NumberPowiązane elementy interfejsu API
spaceBefore | właściwość |
spaceBefore:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Odstęp do pozostawienia przed wierszem.
Jeśli wiersz jest pierwszym wierszem akapitu, przed którym znajduje się odstęp, wówczas wiersz będzie zawierał wartość spaceBefore. Jeśli wiersz znajduje się na górze kolumny, wartość spaceBefore będzie ignorowana. W przeciwnym wypadku wiersz będzie się znajdował za innym wierszem w kolumnie i będzie ustawiony w pionie, aby zapewnić co najmniej taki odstęp między danym wierszem a ostatnim wierszem w poprzednim akapicie.
Implementacja
public function get spaceBefore():NumberPowiązane elementy interfejsu API
textHeight | właściwość |
textHeight:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wysokość wiersza tekstu równa wartości sumy acent + descent. Wartość jest obliczana na podstawie różnicy wysokości linii bazowych, które ograniczają wiersz — góra i dół dla tekstu ideograficznego albo wydłużenie górne i dolne w zależności od tego, czy linia bazowa w y=0 jest ideograficzna (na przykład: TextBaseline.IDEOGRAPHIC_TOP).
Implementacja
public function get textHeight():NumberPowiązane elementy interfejsu API
textLength | właściwość |
textLineExists | właściwość |
textLineExists:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wskazuje, czy istnieje obiekt flash.text.engine.TextLine dla danej klasy TextFlowLine. Wartością jest true, jeśli obiekt TextLine nie został usunięty z pamięci oraz false, jeśli został.
Implementacja
public function get textLineExists():BooleanPowiązane elementy interfejsu API
unjustifiedTextWidth | właściwość |
unjustifiedTextWidth:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Szerokość wiersza bez justowania. W przypadku niewyjustowanego tekstu ta wartość jest równa textLength. W przypadku tekstu wyjustowanego ta wartość przedstawia długość osiągniętą bez justowania, a textLength rzeczywistą szerokość wiersza. Na przykład: po wyjustowaniu następującego ciągu znaków i przypisaniu mu wartości width wynoszącej 500 rzeczywista szerokość wynosi 500, a szerokość niewyjustowana — 268,9921875.
Implementacja
public function get unjustifiedTextWidth():Numbervalidity | właściwość |
validity:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Poprawność wiersza.
Wiersz może być niepoprawny, jeśli tekst, zastosowane atrybuty lub ustawienia kontrolera uległy zmianie od czasu utworzenia wiersza. Wiersz niepoprawny nadal może być wyświetlany i może być używany, ale będą obowiązywały wartości określone podczas tworzenia wiersza. Wiersz zwrócony przez metodę getTextLine() także będzie w stanie niepoprawnym.
Implementacja
public function get validity():StringPowiązane elementy interfejsu API
x | właściwość |
x:Number| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Pozioma pozycja wiersza względem jego kontenera, wyrażona jako przesunięcie w pikselach względem lewej krawędzi kontenera.
Uwaga: Mimo że ta właściwość jest technicznie przeznaczona do odczytu i zapisu, należy traktować ją tak, jak gdyby była przeznaczona tylko do odczytu. Ta funkcja ustawiająca istnieje tylko w celu spełnienia wymagań interfejsu IVerticalJustificationLine, w którym dla tej właściwości zdefiniowana jest zarówno funkcja pobierająca, jak i ustawiająca. Użycie funkcji ustawiającej, choć możliwe, doprowadzi do nieprzewidywalnych rezultatów.
Implementacja
public function get x():Number public function set x(value:Number):voidPowiązane elementy interfejsu API
y | właściwość |
y:Number| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Pionowa pozycja wiersza względem jego kontenera, wyrażona jako przesunięcie w pikselach względem górnej krawędzi kontenera.
Uwaga: Mimo że ta właściwość jest technicznie przeznaczona do odczytu i zapisu, należy traktować ją tak, jak gdyby była przeznaczona tylko do odczytu. Ta funkcja ustawiająca istnieje tylko w celu spełnienia wymagań interfejsu IVerticalJustificationLine, w którym dla tej właściwości zdefiniowana jest zarówno funkcja pobierająca, jak i ustawiająca. Użycie funkcji ustawiającej, choć możliwe, doprowadzi do nieprzewidywalnych rezultatów.
Implementacja
public function get y():Number public function set y(value:Number):voidPowiązane elementy interfejsu API
TextFlowLine | () | Konstruktor |
public function TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Konstruktor — tworzy nowe wystąpienie klasy TextFlowLine.
Uwaga: Klienci nie powinni wywoływać tej metody. Jej działanie jest uzależnione od tego, czy użytkownik napisał własny układacz.
ParametrytextLine:flash.text.engine:TextLine — Obiekt wyświetlany TextLine do użytku dla danego wiersza.
| |
paragraph:ParagraphElement — Akapit (ParagraphElement), w którym zostanie umieszczony wiersz.
| |
outerTargetWidth:Number (default = 0) | |
lineOffset:Number (default = 0) | |
absoluteStart:int (default = 0) | |
numChars:int (default = 0) |
Powiązane elementy interfejsu API
getBounds | () | metoda |
getTextLine | () | metoda |
public function getTextLine(forceValid:Boolean = false):flash.text.engine:TextLine| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Zwraca obiekt flash.text.engine.TextLine dla wiersza, który nie może zostać ponownie utworzony, nawet jeśli nie istnieje z powodu czyszczenia pamięci. Aby spowodować ponowne wygenerowanie obiektu TextLine, należy ustawić forceValid na true. Zwraca null, jeśli nie można ponownie utworzyć obiekt TextLine.
Parametry
forceValid:Boolean (default = false) |
flash.text.engine:TextLine — obiekt dla tego wiersza lub null, jeśli obiekt TextLine nie może zostać odtworzony.
|
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z