LinkElement

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

Klasa LinkElement definiuje łącze do identyfikatora URI (Universal Resource Identifier), które jest uruchamiane po kliknięciu. Klasa LinkElement jest podklasą klasy SubParagraphGroupElementBase. Może zawierać obiekty FlowElement, na przykład obiekt SpanElement, który przechowuje tekst łącza. Pusty obiekt LinkElement, który nie zawiera obiektu FlowElement, jest ignorowany.

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

Wyświetl przykłady

Powiązane elementy interfejsu API

LinkState
FlowElement.linkActiveFormat
FlowElement.linkHoverFormat
FlowElement.linkNormalFormat
TextFlow

Właściwości publiczne

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

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		LinkElement() Konstruktor — tworzy nową instancję klasy LinkElement.	LinkElement
		addChild(child:FlowElement):FlowElement Dołącza podrzędny element FlowElement.	FlowGroupElement
		addChildAt(index:uint, child:FlowElement):FlowElement 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
		clearStyle(styleProp:String):void Usuwa styl określony przez parametr styleProp z danego obiektu FlowElement.	FlowElement
		deepCopy(relativeStart:int = 0, relativeEnd:int = -1):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
		dispatchEvent(evt:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	LinkElement
		equalUserStyles(otherElement:FlowElement):Boolean Porównanie stylów userStyle danej kopii ze stylami userStyle innego elementu otherElement.	FlowElement
		findChildIndexAtPosition(relativePosition:int):int Na podstawie względnego położenia tekstu znajdowany jest pierwszy podrzędny element FlowElement, który zawiera położenie względne.	FlowGroupElement
		findLeaf(relativePosition:int):FlowLeafElement Na podstawie względnego położenia tekstu znajduje element liścia zawierający to położenie.	FlowGroupElement
		getAbsoluteStart():int Zwraca położenie początkowe elementu w przepływie tekstu w postaci indeksu bezwzględnego.	FlowElement
		getCharAtPosition(relativePosition:int):String Zwraca znak w określonym położeniu względem danego obiektu FlowElement.	FlowElement
		getCharCodeAtPosition(relativePosition:int):int Zwraca kod znaku w określonym położeniu względem danego obiektu FlowElement.	FlowElement
		getChildAt(index:int):FlowElement Zwraca obiekt potomny FlowElement w określonym indeksie.	FlowGroupElement
		getChildIndex(child:FlowElement):int Wyszukuje elementy potomne określonego obiektu FlowElement i zwraca ich indeksy.	FlowGroupElement
		getElementRelativeStart(ancestorElement:FlowElement):int Zwraca początek tego elementu względem elementu przodka.	FlowElement
		getFirstLeaf():FlowLeafElement Zwraca pierwszy element potomny FlowLeafElement danej grupy.	FlowGroupElement
		getLastLeaf():FlowLeafElement Zwraca ostatni element potomny FlowLeafElement danej grupy.	FlowGroupElement
		getNextSibling():FlowElement Zwraca następny siostrzany obiekt FlowElement z hierarchii przepływu tekstu.	FlowElement
		getParagraph():ParagraphElement Zwraca obiekt ParagraphElement skojarzony z danym elementem.	FlowElement
		getPreviousSibling():FlowElement Zwraca poprzedni obiekt równorzędny FlowElement z hierarchii przepływu tekstu.	FlowElement
		getStyle(styleProp:String):* Zwraca wartość stylu określonego przez parametr styleProp, który określa nazwę stylu oraz może zawierać dowolną nazwę stylu użytkownika.	FlowElement
		getText(relativeStart:int = 0, relativeEnd:int = -1, paragraphSeparator:String = " "):String [przesłanianie]	FlowGroupElement
		getTextFlow():flashx.textLayout.elements:TextFlow Przechodzi do coraz wyższych poziomów w hierarchii przepływu tekstu w celu zwrócenia głównego obiektu TextFlow dla elementu.	FlowElement
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	LinkElement
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		initialized(document:Object, id:String):void 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
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		removeChild(child:FlowElement):FlowElement Usuwa określony obiekt podrzędny FlowElement z grupy.	FlowGroupElement
		removeChildAt(index:uint):FlowElement Usuwa potomny obiekt FlowElement o określonym indeksie.	FlowGroupElement
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Usuwa detektor z obiektu EventDispatcher.	LinkElement
		replaceChildren(beginChildIndex:int, endChildIndex:int, ... rest):void Zastępuje elementy podrzędne w grupie nowymi określonymi elementami.	FlowGroupElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		setStyle(styleProp:String, newValue:*):void Ustawia styl określony przez parametr styleProp na wartość określoną przez parametr newValue.	FlowElement
		shallowCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement Tworzy kopię danego obiektu FlowElement, kopiując treść między dwoma określonymi położeniami znaków.	FlowElement
		splitAtIndex(childIndex:int):FlowGroupElement Dzieli dany obiekt w położeniu określonym przez parametr childIndex.	FlowGroupElement
		splitAtPosition(relativePosition:int):FlowElement Dzieli obiekt FlowElement w miejscu określonym przez parametr relativePosition, co stanowi względne położenie tego elementu w tekście.	FlowElement
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		willTrigger(type:String):Boolean Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.	LinkElement

Zdarzenia

Kliknij, aby uzyskać więcej informacji o zdarzeniach

	Podsumowanie	Zdefiniowane przez
click	Wywoływane po kliknięciu łącza.	LinkElement
mouseDown	Wywoływane po naciśnięciu przycisku myszy na łączu.	LinkElement
mouseMove	Wywoływane przy przesunięciu wskaźnika myszy nad łączem.	LinkElement
mouseUp	Wywoływane po zwolnieniu przycisku myszy nad łączem.	LinkElement
rollOut	Wywoływane po odsunięciu wskaźnika myszy poza łącze.	LinkElement
rollOver	Wywoływane przy pierwszym ustawieniu wskaźnika myszy na łączu.	LinkElement

Szczegół właściwości

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):void

Powiązane elementy interfejsu API

flash.net.navigateToURL()

linkState

właściwość

linkState:String [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5

Bieżący stan łącza.

Implementacja
public function get linkState():String

Powiązane elementy interfejsu API

LinkState

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):void

Powiązane elementy interfejsu API

flash.net.navigateToURL()

Konstruktor Szczegół

()

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.

Szczegół metody

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: `function(evt:Event):void` Funkcja może mieć dowolną nazwę.

	`useCapture:Boolean` (default = `false`) — Określa, czy detektor działa w fazie przechwytywania, czy w fazach miejsca docelowego i propagacji. Jeżeli parametr `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`) — Poziom priorytetu detektora zdarzeń. Priorytet ma postać 32-bitowej liczby całkowitej. Im wyższa jest liczba, tym wyższy priorytet. Wszystkie detektory z priorytetem n są przetwarzane przed detektorami z priorytetem n-1. Jeżeli dwa lub większa liczba detektorów ma ten sam priorytet, będą one przetwarzane w kolejności, w jakiej zostały dodane. Priorytet domyślny to 0.

	`useWeakReference:Boolean` (default = `false`) — Określa, czy odwołanie do detektora jest mocne, czy słabe. Odwołanie mocne (domyślnie) zapobiega usunięciu detektora przy okazji porządkowania pamięci. Odwołanie słabe temu nie zapobiega. Funkcje składowe na poziomie klasy nie podlegają porządkowaniu pamięci, zatem można ustawić właściwość `useWeakReference` na wartość `true` dla funkcji składowych na poziomie klasy, nie narażając ich na usunięcie. Jeżeli właściwość `useWeakReference` zostanie ustawiona na wartość `true` dla detektora, który jest zagnieżdżoną funkcją wewnętrzną, wówczas funkcja będzie usuwana w procesie porządkowania pamięci i przestanie być trwała. W przypadku tworzenia odniesień do funkcji wewnętrznej (zapisania jej w innej zmiennej) nie będzie ona usuwana w procesie porządkowania pamięci i pozostanie trwała.

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ń.

Zwraca

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.

Zwraca

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`) — Określa, czy detektor był zarejestrowany dla fazy przechwytywania, czy dla faz miejsca docelowego i propagacji. Jeżeli detektor był zarejestrowany zarówno dla fazy przechwytywania, jak i dla fazy miejsca docelowego i propagacji, konieczne są dwa wywołania metody `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.

Parametry

type:String — Typ zdarzenia.

Zwraca

Boolean — Wartość true, jeśli detektor określonego typu będzie wywoływany, wartość false w przeciwnym wypadku.

Szczegół zdarzenia

click

Zdarzenie

Typ obiektu zdarzenia: flashx.textLayout.events.FlowElementMouseEvent
wł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ści type obiektu zdarzenia click.

mouseDown

Zdarzenie

Typ obiektu zdarzenia: flashx.textLayout.events.FlowElementMouseEvent
wł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ści type obiektu zdarzenia a mouseDown.

mouseMove

Zdarzenie

Typ obiektu zdarzenia: flashx.textLayout.events.FlowElementMouseEvent
wł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ści type obiektu zdarzenia mouseMove.

mouseUp

Zdarzenie

Typ obiektu zdarzenia: flashx.textLayout.events.FlowElementMouseEvent
wł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ści type obiektu zdarzenia mouseUp.

rollOut

Zdarzenie

Typ obiektu zdarzenia: flashx.textLayout.events.FlowElementMouseEvent
wł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ści type obiektu zdarzenia rollOut.

rollOver

Zdarzenie

Typ obiektu zdarzenia: flashx.textLayout.events.FlowElementMouseEvent
wł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ści type obiektu zdarzenia rollOver.

Przykłady Sposób korzystania z tego przykładu

LinkElementExample.as

Ten przykład dodaje LinkElement do akapitu i przesłania format domyślny dla ustawienia wskaźnika myszy nad łączem — tekst łącza staje się czerwony.

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();
        }
    }
}

LinkElementEventExample.as

W przykładzie za pomocą schematu identyfikatora URI 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();
        }
    }
}

Informacje prawne | Zasady prywatności online

LinkElement - AS3

Pakietyx

Elementy językowe

Dodatki

Pakiet flashx.textLayout.elements

href

linkState

target

LinkElement

addEventListener

dispatchEvent

hasEventListener

removeEventListener

willTrigger

click

mouseDown

mouseMove

mouseUp

rollOut

rollOver