Pakiet | flashx.textLayout.events |
Klasa | public class FlowElementMouseEvent |
Dziedziczenie | FlowElementMouseEvent Event Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Do elementu łącza można dodać detektor zdarzeń, który będzie wykrywał zdarzenia tego typu. Jeśli użytkownik wybierze opcję anulowania zdarzenia za pomocą metody Event.preventDefault()
, wówczas nie zostanie wykonane domyślne zachowanie skojarzone z tym zdarzeniem.
Jeśli użytkownik nie doda detektora zdarzeń do elementu łącza lub detektor zdarzeń nie spowoduje anulowania zachowania, wówczas zdarzenie zostanie wywołane ponownie, ale tym razem przez wystąpienie klasy TextFlow skojarzone z elementem łącza, a nie przez sam element łącza. Takie rozwiązanie umożliwia wykrycie zdarzenia za pomocą detektora zdarzeń dołączonego do TextFlow.
Zdarzenia FlowElementMouseEvent są wywoływane tylko wówczas, gdy tekst nie może być edytowany lub gdy podczas wykonywania operacji myszą zostanie naciśnięty klawisz Ctrl.
Zdarzenia poniższych typów (sześć typów) są wywoływane tylko wówczas, gdy nie jest możliwa edycja tekstu lub gdy naciśnięty jest klawisz Ctrl:
-
FlowElementMouseEvent.CLICK
-
FlowElementMouseEvent.MOUSE_DOWN
-
FlowElementMouseEvent.MOUSE_UP
-
FlowElementMouseEvent.MOUSE_MOVE
-
FlowElementMouseEvent.ROLL_OVER
-
FlowElementMouseEvent.ROLL_OUT
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
bubbles : Boolean [tylko do odczytu]
Określa, czy zdarzenie może przechodzić fazę propagacji. | Event | ||
cancelable : Boolean [tylko do odczytu]
Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem. | Event | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
currentTarget : Object [tylko do odczytu]
Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. | Event | ||
eventPhase : uint [tylko do odczytu]
Bieżąca faza przepływu zdarzeń. | Event | ||
flowElement : FlowElement
Obiekt FlowElement, który wywołał zdarzenie. | FlowElementMouseEvent | ||
originalEvent : MouseEvent
Pierwotne zdarzenie mszy wygenerowane przez operacje wykonywane myszą. | FlowElementMouseEvent | ||
target : Object [tylko do odczytu]
Miejsce docelowe zdarzenia. | Event | ||
type : String [tylko do odczytu]
Typ zdarzenia. | Event |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
FlowElementMouseEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, flowElement:FlowElement = null, originalEvent:MouseEvent = null)
Tworzy obiekt zdarzenia, który zawiera informacje dotyczące operacji wykonywanych myszą. | FlowElementMouseEvent | ||
Powiela instancję podklasy Event. | Event | ||
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0. | Event | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault(). | Event | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane. | Event | ||
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 | ||
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim. | Event | ||
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń. | Event | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu Event. | Event | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
Stała | Zdefiniowane przez | ||
---|---|---|---|
CLICK : String = "click" [statyczny]
Definiuje wartość właściwości type obiektu zdarzenia kliknięcia. | FlowElementMouseEvent | ||
MOUSE_DOWN : String = "mouseDown" [statyczny]
Definiuje wartość właściwości type obiektu zdarzenia mouseDown. | FlowElementMouseEvent | ||
MOUSE_MOVE : String = "mouseMove" [statyczny]
Definiuje wartość właściwości type obiektu zdarzenia mouseMove. | FlowElementMouseEvent | ||
MOUSE_UP : String = "mouseUp" [statyczny]
Definiuje wartość właściwości type obiektu zdarzenia mouseUp. | FlowElementMouseEvent | ||
ROLL_OUT : String = "rollOut" [statyczny]
Definiuje wartość właściwości type obiektu zdarzenia rollOut. | FlowElementMouseEvent | ||
ROLL_OVER : String = "rollOver" [statyczny]
Definiuje wartość właściwości type obiektu zdarzenia rollOver. | FlowElementMouseEvent |
flowElement | właściwość |
flowElement:FlowElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Obiekt FlowElement, który wywołał zdarzenie.
Implementacja
public function get flowElement():FlowElement
public function set flowElement(value:FlowElement):void
Powiązane elementy interfejsu API
originalEvent | właściwość |
originalEvent:MouseEvent
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Pierwotne zdarzenie mszy wygenerowane przez operacje wykonywane myszą. Ta właściwość może zawierać dowolne z poniższych wartości:
MouseEvent.CLICK
MouseEvent.MOUSE_DOWN
MouseEvent.MOUSE_UP
MouseEvent.MOUSE_MOVE
MouseEvent.MOUSE_OVER
MouseEvent.MOUSE_OUT
W większości przypadku zdarzenie oryginalne odpowiada zdarzeniu wywołanemu przez element łącza. Zdarzenia są zgodne ze zdarzeniami click
, mouseDown
, mouseOut
i mouseOver
. Istnieją jednak dwa przypadki, gdy zdarzenie oryginalne jest konwertowane przez element łącza na zdarzenie powiązane. Jeśli element łącza wykryje zdarzenie mouseOver
, wywoła zdarzenie rollOver
. Jeśli element łącza wykryje zdarzenie mouseOut
, wywoła zdarzenie rollOut
. Zazwyczaj element docelowy zdarzenia i współrzędne myszy są powiązane z zawierającym element łącza wystąpieniem klasy TextLine.
Implementacja
public function get originalEvent():MouseEvent
public function set originalEvent(value:MouseEvent):void
Powiązane elementy interfejsu API
FlowElementMouseEvent | () | Konstruktor |
public function FlowElementMouseEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, flowElement:FlowElement = null, originalEvent:MouseEvent = null)
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Tworzy obiekt zdarzenia, który zawiera informacje dotyczące operacji wykonywanych myszą. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń. Jeśli planowane jest ręczne wywoływanie zdarzenia, należy użyć konstruktora. Użycie konstruktora nie jest wymagane w przypadku wykrywania obiektów FlowElementMouseEvent wygenerowanych przez obiekt FlowElement.
Parametrytype:String — Typ zdarzenia. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości type . Występuje sześć typów: FlowElementMouseEvent.CLICK , FlowElementMouseEvent.MOUSE_DOWN , FlowElementMouseEvent.MOUSE_MOVE , FlowElementMouseEvent.MOUSE_UP , FlowElementMouseEvent.ROLL_OVER i FlowElementMouseEvent.ROLL_OUT .
| |
bubbles:Boolean (default = false ) — Określa, czy obiekt Event uczestniczy w fazie propagacji przepływu zdarzeń. Obiekty FlowElementMouseEvent nie propagują.
| |
cancelable:Boolean (default = true ) — Określa, czy obiekt Event może zostać anulowany. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości cancelable . Obiekty FlowElementMouseEvent mogą być anulowane. Do domyślnego zachowania skojarzonego z tym zdarzeniem można uzyskać dostęp poprzez wywołanie metody preventDefault() w detektorze zdarzenia.
| |
flowElement:FlowElement (default = null ) — Wystąpienie klasy FlowElement, obecnie obiekt LinkElement, skojarzone z tym zdarzeniem. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem właściwości flowElement .
| |
originalEvent:MouseEvent (default = null ) — Oryginalne zdarzenie myszy, które wystąpiło w flowElement. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem właściwości originalEvent .
|
CLICK | Stała |
public static const CLICK:String = "click"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Definiuje wartość właściwości type
obiektu zdarzenia click
.
Powiązane elementy interfejsu API
MOUSE_DOWN | Stała |
public static const MOUSE_DOWN:String = "mouseDown"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Definiuje wartość właściwości type
obiektu zdarzenia a mouseDown
.
Powiązane elementy interfejsu API
MOUSE_MOVE | Stała |
public static const MOUSE_MOVE:String = "mouseMove"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Definiuje wartość właściwości type
obiektu zdarzenia mouseMove
.
Powiązane elementy interfejsu API
MOUSE_UP | Stała |
public static const MOUSE_UP:String = "mouseUp"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Definiuje wartość właściwości type
obiektu zdarzenia mouseUp
.
Powiązane elementy interfejsu API
ROLL_OUT | Stała |
public static const ROLL_OUT:String = "rollOut"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Definiuje wartość właściwości type
obiektu zdarzenia rollOut
.
Powiązane elementy interfejsu API
ROLL_OVER | Stała |
public static const ROLL_OVER:String = "rollOver"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Definiuje wartość właściwości type
obiektu zdarzenia rollOver
.
Powiązane elementy interfejsu API
Ten przykład przedstawia sposób wykrywania zdarzeń myszy, jakie mogą pojawiać się w instancjach klasy LinkElement. Dwa główne etapy są przeznaczone do wywołania metody addEventListener() dla każdego typu zdarzenia oraz w celu utworzenia funkcji procedury obsługi zdarzeń.
Wywołanie metody addEventListener()
jest realizowane do instancji klasy LinkElement. Możliwe jest stosowanie prostych ciągów, takich jak "click"
i "mouseDown"
, ale bezpieczniejsze jest używanie stałych statycznych. W przykładzie wykorzystano stałe z klasy MouseEvent, ponieważ klasa FlowElementMouseEvent nie zawiera stałych statycznych.
Ten przykład zawiera tylko jedną funkcję procedury obsługi zdarzeń, ponieważ kod jest taki sam dla wszystkich zdarzeń. Zwykle kod, który odpowiada poszczególnym typom zdarzeń jest różny — w takim przypadku lepszym rozwiązaniem jest osobna funkcja procedury obsługi zdarzeń dla każdego wywołania metody addEventListener()
.
package flashx.textLayout.events.examples { import flash.display.Sprite; import flash.events.MouseEvent; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.LinkElement; import flashx.textLayout.events.FlowElementMouseEvent; import flashx.textLayout.formats.TextLayoutFormat; public class FlowElementMouseEvent_example extends Sprite { private var tf:TextFlow; public function FlowElementMouseEvent_example() { // define TextFlow tf = new TextFlow(); // define link element var linkPar:ParagraphElement = new ParagraphElement(); var linkEl:LinkElement = new LinkElement(); linkEl.href = "http://www.adobe.com/go/flashplayer"; linkEl.target = "_blank"; // when link is clicked, open a new browser window var span1:SpanElement = new SpanElement(); // for text associated with link span1.text = "Get Flash Player"; linkEl.addChild(span1); // define paragraph element for name of events dispatched var textPar:ParagraphElement = new ParagraphElement(); var span2:SpanElement = new SpanElement(); span2.text ="Three most recent events:"; // add span (text) and link elements to the TextFlow linkPar.addChild(linkEl); // add LinkElement to first paragraph textPar.addChild(span2); // add header text to second paragraph tf.addChild(linkPar); // add paragraph with link to text flow tf.addChild(textPar); // add paragraph for events to text flow // add event listeners for all six FlowElementMouseEvent types linkEl.addEventListener(FlowElementMouseEvent.CLICK, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.MOUSE_DOWN, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.MOUSE_MOVE, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.MOUSE_UP, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.ROLL_OVER, linkHandler); linkEl.addEventListener(FlowElementMouseEvent.ROLL_OUT, linkHandler); // create text container for link and event listing text var linkContainer:Sprite = new Sprite(); linkContainer.x = 10; linkContainer.y = 10; var linkController:ContainerController = new ContainerController(linkContainer,200,80); var linkControllerFormat:TextLayoutFormat = new TextLayoutFormat(); linkControllerFormat.paddingTop = 3; linkController.format = linkControllerFormat; tf.flowComposer.addController(linkController); // Add linkContainer to Display List addChild(linkContainer); tf.flowComposer.updateAllControllers(); } // event handler function private function linkHandler(ev:FlowElementMouseEvent):void { var par:ParagraphElement = new ParagraphElement(); var span:SpanElement = new SpanElement(); span.text = ev.type; par.addChild(span); tf.replaceChildren(2,2,par); if (tf.numChildren > 5) { tf.removeChildAt(5); } tf.flowComposer.updateAllControllers(); } } }
Tue Jun 12 2018, 12:06 PM Z