| Pakiet | flashx.textLayout.elements |
| Klasa | public final class LinkElement |
| Dziedziczenie | LinkElement  SubParagraphGroupElementBase FlowGroupElement FlowElement Object |
| Implementuje | IEventDispatcher |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
W normalnej sytuacji kliknięcie obiektu LinkElement powoduje wywołanie metody flash.net.navigateToURL(). Jest też obsługiwany specjalny schemat identyfikatora URI event:. Schemat ten powoduje wygenerowanie zdarzenia TextFlow, które użytkownik może wykryć w celu wykonania kodu ActionScript 3. Poniżej podano przykład.
W przypadku określenia celu musi to być jedna z następujących wartości:
| Wartość docelowa | description |
|---|---|
| _self | Zastępuje bieżącą stronę HTML. Jeśli strona znajduje się w klatce lub zestawie klatek, będzie ładowana w ramach tej klatki. Jeśli jest to przeglądarka, zostanie otwarta w celu zastąpienia strony, od której pochodzi. |
| _blank | Otwiera nową przeglądarkę bez nazwy. |
| _parent | Zastępuje stronę HTML, od której pochodzi. |
| _top | Strona ładowana w bieżącej przeglądarce. Zastępuje wszystko w tej przeglądarce, również zestaw klatek. |
Domyślna właściwość MXMLmxmlChildren
Powiązane elementy interfejsu API
FlowElement.linkActiveFormat
FlowElement.linkHoverFormat
FlowElement.linkNormalFormat
TextFlow
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| 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 [tylko do odczytu]
Zwraca obliczone atrybuty formatu, które obowiązują dla danego elementu. | FlowElement | |
| 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 | |
| href : String
Identyfikator URI (Uniform Resource Identifier) skojarzony z obiektem LinkElement. | LinkElement | ||
| 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 | |
| linkState : String [tylko do odczytu]
Bieżący stan łącza. | LinkElement | ||
| 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
Dołącza tablicę obiektów podrzędnych do tego obiektu. | FlowGroupElement | |
| numChildren : int [tylko do odczytu]
Zwraca liczbę elementów potomnych FlowElement, które zawiera dany obiekt FlowGroupElement. | FlowGroupElement | |
| 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 | |
| target : String
Wartość docelowa skojarzona z LinkElement. | LinkElement | ||
| 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 nową instancję klasy LinkElement. | LinkElement | ||
|
Dołącza podrzędny element FlowElement. | FlowGroupElement | |
|
Dodaje podrzędny obiekt FlowElement w określonym indeksie. | FlowGroupElement | |
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | LinkElement | ||
| 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 | |
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | LinkElement | ||
| Porównanie stylów userStyle danej kopii ze stylami userStyle innego elementu otherElement. | FlowElement | |
|
Na podstawie względnego położenia tekstu znajdowany jest pierwszy podrzędny element FlowElement, który zawiera położenie względne. | FlowGroupElement | |
|
Na podstawie względnego położenia tekstu znajduje element liścia zawierający to położenie. | FlowGroupElement | |
|
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 obiekt potomny FlowElement w określonym indeksie. | FlowGroupElement | |
|
Wyszukuje elementy potomne określonego obiektu FlowElement i zwraca ich indeksy. | FlowGroupElement | |
|
Zwraca początek tego elementu względem elementu przodka. | FlowElement | |
|
Zwraca pierwszy element potomny FlowLeafElement danej grupy. | FlowGroupElement | |
|
Zwraca ostatni element potomny FlowLeafElement danej grupy. | FlowGroupElement | |
| Zwraca następny siostrzany obiekt FlowElement z hierarchii przepływu tekstu. | FlowElement | |
|
Zwraca obiekt ParagraphElement skojarzony z danym elementem. | FlowElement | |
| 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 | |
| [przesłanianie] | FlowGroupElement | |
|
Przechodzi do coraz wyższych poziomów w hierarchii przepływu tekstu w celu zwrócenia głównego obiektu TextFlow dla elementu. | FlowElement | |
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | LinkElement | ||
|
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 | |
|
Usuwa określony obiekt podrzędny FlowElement z grupy. | FlowGroupElement | |
|
Usuwa potomny obiekt FlowElement o określonym indeksie. | FlowGroupElement | |
Usuwa detektor z obiektu EventDispatcher. | LinkElement | ||
|
Zastępuje elementy podrzędne w grupie nowymi określonymi elementami. | FlowGroupElement | |
|
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 dany obiekt w położeniu określonym przez parametr childIndex. | FlowGroupElement | |
|
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 | |
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | LinkElement | ||
| Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
|---|---|---|---|---|
| Wywoływane po kliknięciu łącza. | LinkElement | |||
| Wywoływane po naciśnięciu przycisku myszy na łączu. | LinkElement | |||
| Wywoływane przy przesunięciu wskaźnika myszy nad łączem. | LinkElement | |||
| Wywoływane po zwolnieniu przycisku myszy nad łączem. | LinkElement | |||
| Wywoływane po odsunięciu wskaźnika myszy poza łącze. | LinkElement | |||
| Wywoływane przy pierwszym ustawieniu wskaźnika myszy na łączu. | LinkElement | |||
href | właściwość |
href:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Identyfikator URI (Uniform Resource Identifier) skojarzony z obiektem LinkElement. Identyfikator URI może być dowolnym identyfikatorem URI obsługiwanym przez metodę flash.net.navigateToURL(). Ta właściwość jest odwzorowywana na parametr request dla tej metody. Identyfikator URI możne również mieć formę event:typ_zdarzenia. Po kliknięciu obiekt TextFlow generuje zdarzenie typu typ_zdarzenia.
Implementacja
public function get href():String public function set href(value:String):voidPowiązane elementy interfejsu API
linkState | właściwość |
target | właściwość |
target:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wartość docelowa skojarzona z LinkElement. Możliwe wartości: „_self”, „_blank”, „_parent” i „_top”. Ta wartość jest odwzorowywana na parametr window metody flash.net.navigateToURL().
Implementacja
public function get target():String public function set target(value:String):voidPowiązane elementy interfejsu API
LinkElement | () | Konstruktor |
public function LinkElement()| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Konstruktor — tworzy nowe wystąpienie klasy LinkElement.
addEventListener | () | metoda |
public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Rejestruje obiekt detektora zdarzenia w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. We wszystkich węzłach listy wyświetlania można rejestrować detektory zdarzeń reagujące na zdarzenia konkretnego typu, znajdujące się w określonej fazie i mające określony priorytet.
Po pomyślnym zarejestrowaniu detektora zdarzeń nie można zmienić jego priorytetu przez dodatkowe wywołania metody addEventListener(). Aby zmienić priorytet detektora, należy najpierw wywołać metodę removeEventListener(). Następnie można ponownie zarejestrować detektor z nowym poziomem priorytetu.
Po zarejestrowaniu detektora późniejsze wywołania metody addEventListener() z różnymi wartościami type albo useCapture powodują rejestrowanie odrębnych detektorów. Na przykład detektor zarejestrowany z parametrem useCapture ustawionym na true wykrywa tylko zdarzenia w fazie przechwytywania. Po ponownym wywołaniu metody addEventListener() z tym samym obiektem detektora, ale z parametrem useCapture ustawionym na false będą istniały dwa odrębne detektory: jeden wykrywający zdarzenia w fazie przechwytywania, a drugi wykrywający zdarzenia w fazach miejsca docelowego i propagacji.
Nie można zarejestrować detektora zdarzeń, który wykrywałby tylko zdarzenia w fazie miejsca docelowego lub tylko zdarzenia w fazie propagacji. Te fazy są sprzężone podczas rejestracji, ponieważ propagacja zachodzi tylko w przodkach węzła miejsca docelowego.
Gdy detektor zdarzeń przestanie być potrzebny, należy go usunąć, wywołując metodę EventDispatcher.removeEventListener(); w przeciwnym razie mogą wystąpić problemy w zarządzaniu pamięcią. Obiekty z zarejestrowanymi detektorami zdarzeń nie są automatycznie usuwane z pamięci, ponieważ proces porządkowania pamięci nie usuwa obiektów, do których istnieją odwołania.
Skopiowanie instancji klasy EventDispatcher nie powoduje skopiowania detektorów zdarzeń dołączonych do tej instancji. (Jeśli utworzono nowy węzeł, dla którego potrzebny jest detektor zdarzeń, należy dołączyć detektor po utworzeniu węzła). Jednak przeniesienie instancji klasy EventDispatcher powoduje również przeniesienia dołączonych do niej detektorów zdarzeń
Jeśli detektor zdarzeń jest rejestrowany w węźle w momencie, gdy ten węzeł przetwarza zdarzenie, detektor nie zostanie wywołany w bieżącej fazie, ale może być wywołany w późniejszej fazie przepływu zdarzeń, np. w fazie propagacji.
Jeśli detektor zdarzeń zostanie usunięty z węzła w momencie, gdy ten węzeł przetwarza zdarzenie, zostanie mimo tego wywołany przez bieżące operacje. Raz usunięty detektor zdarzeń nie jest nigdy ponownie wywoływany (chyba że zostanie ponownie zarejestrowany na potrzeby dalszego etapu wykonania programu).
Parametry
type:String — Typ zdarzenia.
| |
listener:Function — Funkcja detektora, który przetwarza zdarzenie. Funkcja musi zaakceptować obiekt Event jako swój jedyny parametr i nie może zwracać żadnych wyników, jak ilustruje to następujący przykład:
| |
useCapture:Boolean (default = false)useCapture jest ustawiony na true, wówczas detektor przetwarza zdarzenie tylko w trakcie fazy przechwytywania, a nie w trakcie fazy miejsca docelowego i propagacji. Jeżeli parametr useCapture ma wartość false, wówczas detektor przetwarza zdarzenie tylko w trakcie fazy miejsca docelowego i propagacji. W celu wykrywania zdarzenia we wszystkich trzech fazach należy wywołać metodę addEventListener dwukrotnie, raz przy właściwości useCapture ustawionej na wartość true, a potem ponownie przy właściwości useCapture ustawionej na wartość false.
| |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false)Funkcje składowe na poziomie klasy nie podlegają porządkowaniu pamięci, zatem można ustawić właściwość |
dispatchEvent | () | metoda |
public function dispatchEvent(evt:Event):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. Miejscem docelowym zdarzenia jest obiekt EventDispatcher, względem którego wywołano metodę dispatchEvent().
Parametry
evt:Event — Obiekt Event, który jest wywoływany, tj. kierowany do przepływu zdarzeń.
|
Boolean — Wartość true, chyba że dla zdarzenia wywołano metodę preventDefault(), co powoduje zwrócenie wartości false.
|
hasEventListener | () | metoda |
public function hasEventListener(type:String):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. Umożliwia to określenie, w którym miejscu hierarchii przepływu zdarzeń w obiekcie EventDispatcher zmodyfikowana jest obsługa zdarzeń danego typu. Aby sprawdzić, czy zdarzenie określonego typu faktycznie wywoła detektor zdarzeń, należy użyć metody IEventDispatcher.willTrigger().
Różnica między metodą hasEventListener() a metodą willTrigger() polega na tym, że metoda hasEventListener() sprawdza tylko obiekt, do którego należy, natomiast metoda willTrigger() sprawdza cały przepływ zdarzenia określonego parametrem type.
Parametry
type:String — Typ zdarzenia.
|
Boolean — Wartość true, jeśli detektor określonego typu jest zarejestrowany, wartość false w przeciwnym wypadku.
|
removeEventListener | () | metoda |
public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Usuwa detektor z obiektu EventDispatcher. Jeśli w obiekcie EventDispatcher nie ma zarejestrowanego zgodnego detektora zdarzeń, wywołanie tej metody nie odnosi żadnego skutku.
Parametry
type:String — Typ zdarzenia.
| |
listener:Function — Obiekt detektora przeznaczony do usunięcia.
| |
useCapture:Boolean (default = false)removeEventListener(): jedno wywołanie z parametrem useCapture ustawionym na true, a następne wywołanie z parametrem useCapture ustawionym na false.
|
willTrigger | () | metoda |
public function willTrigger(type:String):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego przodkach. Ta metoda zwraca wartość true, jeśli detektor zdarzeń będzie wywoływany w dowolnej fazie przepływu zdarzeń, gdy zdarzenie określonego typu zostanie wywołane w obiekcie EventDispatcher lub dowolnym z jego przodków.
Różnica między metodą hasEventListener() a metodą willTrigger() polega na tym, że metoda hasEventListener() sprawdza tylko obiekt, do którego należy, natomiast metoda willTrigger() sprawdza cały przepływ zdarzenia określonego parametrem type.
Parametry
type:String — Typ zdarzenia.
|
Boolean — Wartość true, jeśli detektor określonego typu będzie wywoływany, wartość false w przeciwnym wypadku.
|
click | Zdarzenie |
flashx.textLayout.events.FlowElementMouseEventwłaściwość FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.CLICK| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wywoływane po kliknięciu łącza. Klienci mogą przesłaniać sposób, w jaki łącze obsługuje zdarzenie, obsługując je samodzielnie i wywołując metodę preventDefault().
Definiuje wartość właściwościtype obiektu zdarzenia click.
mouseDown | Zdarzenie |
flashx.textLayout.events.FlowElementMouseEventwłaściwość FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_DOWN| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wywoływane po naciśnięciu przycisku myszy na łączu.
Definiuje wartość właściwościtype obiektu zdarzenia a mouseDown.
mouseMove | Zdarzenie |
flashx.textLayout.events.FlowElementMouseEventwłaściwość FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_MOVE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wywoływane przy przesunięciu wskaźnika myszy nad łączem.
Definiuje wartość właściwościtype obiektu zdarzenia mouseMove.
mouseUp | Zdarzenie |
flashx.textLayout.events.FlowElementMouseEventwłaściwość FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_UP| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wywoływane po zwolnieniu przycisku myszy nad łączem.
Definiuje wartość właściwościtype obiektu zdarzenia mouseUp.
rollOut | Zdarzenie |
flashx.textLayout.events.FlowElementMouseEventwłaściwość FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.ROLL_OUT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wywoływane po odsunięciu wskaźnika myszy poza łącze.
Definiuje wartość właściwościtype obiektu zdarzenia rollOut.
rollOver | Zdarzenie |
flashx.textLayout.events.FlowElementMouseEventwłaściwość FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.ROLL_OVER| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wywoływane przy pierwszym ustawieniu wskaźnika myszy na łączu.
Definiuje wartość właściwościtype obiektu zdarzenia rollOver.
package flashx.textLayout.elements.examples
{
import flash.display.Sprite;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.LinkElement;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
import flashx.textLayout.formats.TextLayoutFormat;
public class LinkElementExample extends Sprite
{
public function LinkElementExample()
{
var textFlow:TextFlow = new TextFlow();
var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
textLayoutFormat.fontSize = 18;
textFlow.hostFormat = textLayoutFormat;
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var link:LinkElement = new LinkElement();
var span2:SpanElement = new SpanElement();
var inf:Object = {color:0xFF0000};
p.linkHoverFormat = inf;
span1.text = "Text that includes a link to ";
link.href = "http://www.adobe.com";
var linkSpan:SpanElement = new SpanElement();
linkSpan.text = "Adobe's website";
link.addChild(linkSpan);
span2.text = ". Notice the custom formatting when the cursor hovers " +
"over the link.";
p.addChild(span1);
p.addChild(link);
p.addChild(span2);
textFlow.addChild(p);
textFlow.flowComposer.addController(new ContainerController(this,stage.stageWidth, stage.stageHeight));
textFlow.flowComposer.updateAllControllers();
}
}
}
event: jest generowane zdarzenie służące do wykonania kodu ActionScript w odpowiedzi na kliknięcie.
package flashx.textLayout.elements.examples
{
import flash.display.Sprite;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.LinkElement;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
import flashx.textLayout.events.FlowElementMouseEvent;
import flashx.textLayout.formats.TextLayoutFormat;
public class LinkElementEventExample extends Sprite
{
public function LinkElementEventExample()
{
var textFlow:TextFlow = new TextFlow();
textFlow.fontFamily = "Arial, Helvetica, _sans";
textFlow.fontSize = 18;
textFlow.paddingLeft = textFlow.paddingRight = textFlow.paddingTop = 20;
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var link:LinkElement = new LinkElement();
var span2:SpanElement = new SpanElement();
span1.text = "Text that includes a link to ";
link.href = "event:changeTextFlowColor";
var linkSpan:SpanElement = new SpanElement();
linkSpan.text = "custom event code"
link.addChild(linkSpan);
span2.text = ". Clicking the link changes the default color of the TextFlow";
p.addChild(span1);
p.addChild(link);
p.addChild(span2);
textFlow.addChild(p);
textFlow.flowComposer.addController(new ContainerController(this,stage.stageWidth, stage.stageHeight));
textFlow.flowComposer.updateAllControllers();
textFlow.addEventListener("changeTextFlowColor",changeTextFlowColor)
}
private function changeTextFlowColor(e:FlowElementMouseEvent):void
{
var textFlow:TextFlow = e.flowElement.getTextFlow();
textFlow.color = textFlow.color == 0x00ff00 ? 0 : 0x00ff00;
textFlow.flowComposer.updateAllControllers();
}
}
}
Tue Jun 12 2018, 12:06 PM Z