Paket | flashx.textLayout.elements |
Klasse | public final class LinkElement |
Vererbung | LinkElement SubParagraphGroupElementBase FlowGroupElement FlowElement Object |
Implementiert | IEventDispatcher |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Beim Klicken auf ein LinkElement wird normalerweise die flash.net.navigateToURL()
-Methode aufgerufen. Ein spezielles URI-Schema Ereignis:
wird ebenfalls unterstützt. Dieses Schema erstellt ein TextFlow-Ereignis, auf das der Benutzer warten kann, um AS3-Code auszuführen. Unten wird ein Beispiel gezeigt.
Wenn Sie ein Ziel festlegen, müssen Sie einen der folgenden Werte verwenden:
Zielwert | description |
---|---|
_self | Ersetzt die aktuelle HTML-Seite. Wenn diese sich in sich in einem Frame oder einem Frameset befindet, wird dieser Frame zum Laden verwendet. Wenn es der vollständige Browser ist, wird er geöffnet, um die ursprüngliche Seite zu ersetzen. |
_blank | Öffnet einen neuen Browser ohne Namen. |
_parent | Ersetzt die HTML-Seite, aus der das Element stammt. |
_top | Lädt den aktuellen Browser, wobei alles ersetzt wird, z. B. ein Frameset. |
Standard-MXML-EigenschaftmxmlChildren
Verwandte API-Elemente
FlowElement.linkActiveFormat
FlowElement.linkHoverFormat
FlowElement.linkNormalFormat
TextFlow
Eigenschaft | Definiert von | ||
---|---|---|---|
alignmentBaseline : *
TextLayoutFormat: Gibt die Grundlinie an, an dem die dominierende Grundlinie ausgerichtet wird. | FlowElement | ||
backgroundAlpha : *
TextLayoutFormat: Alpha-Wert (Transparenz) für den Hintergrund (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
backgroundColor : *
TextLayoutFormat: Hintergrundfarbe des Texts (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
baselineShift : *
TextLayoutFormat: Betrag, um den die Grundlinie vom dominantBaseline-Wert verschoben wird. | FlowElement | ||
blockProgression : *
TextLayoutFormat: Gibt eine vertikale oder horizontale Abfolge der Zeilenplatzierung an. | FlowElement | ||
breakOpportunity : *
TextLayoutFormat: Gibt die Position von Zeilenumbrüchen in einem mehrzeiligen Text an. | FlowElement | ||
cffHinting : *
TextLayoutFormat: Die für diesen Text verwendete Art des CFF-Hintings. | FlowElement | ||
clearFloats : *
TextLayoutFormat: Steuert, wie der Text bei einem Float umbricht. | FlowElement | ||
color : *
TextLayoutFormat: Farbe des Texts. | FlowElement | ||
columnCount : *
TextLayoutFormat: Anzahl der Textspalten (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
columnGap : *
TextLayoutFormat: Gibt den Zwischenraum in Pixeln an, der zwischen den Spalten gelassen werden soll (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
columnWidth : *
TextLayoutFormat: Spaltenbreite in Pixeln (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
computedFormat : flashx.textLayout.formats:ITextLayoutFormat [schreibgeschützt]
Gibt die berechneten Formatattribute zurück, die für dieses Element wirksam sind. | FlowElement | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
coreStyles : Object [schreibgeschützt] Gibt die coreStyles für dieses FlowElement zurück. | FlowElement | ||
digitCase : *
TextLayoutFormat: Die für diesen Text verwendete Ziffernart. | FlowElement | ||
digitWidth : *
TextLayoutFormat: Die für diesen Text verwendete Ziffernbreite. | FlowElement | ||
direction : *
TextLayoutFormat: Gibt die standardmäßige bidirektionale Einbettungsebene des Texts im Textblock an. | FlowElement | ||
dominantBaseline : *
TextLayoutFormat: Gibt an, welche Elementgrundlinie an der alignmentBaseline ausgerichtet wird, um die vertikale Position des Elements auf der Linie zu bestimmen. | FlowElement | ||
firstBaselineOffset : *
TextLayoutFormat: Gibt die Grundlinienposition der ersten Linie im Container an. | FlowElement | ||
fontFamily : *
TextLayoutFormat: Der Name der zu verwendenden Schriftart oder eine durch Kommas getrennte Liste mit Schriftartnamen. | FlowElement | ||
fontLookup : *
TextLayoutFormat: Zu verwendende Schriftartsuche. | FlowElement | ||
fontSize : *
TextLayoutFormat: Die Textgröße in Pixeln. | FlowElement | ||
fontStyle : *
TextLayoutFormat: Stil des Texts. | FlowElement | ||
fontWeight : *
TextLayoutFormat: Schriftartstärke. | FlowElement | ||
format : flashx.textLayout.formats:ITextLayoutFormat Direkt für dieses Element angewendete TextLayoutFormat-Eigenschaften. | FlowElement | ||
href : String
Der mit dem LinkElement-Objekt verknüpfte Uniform Resource Identifier (URI). | LinkElement | ||
id : String
Weist einem Element einen identifizierenden Namen zu, sodass es möglich ist, einen Stil für das Element durch Verweis auf die ID festzulegen. | FlowElement | ||
justificationRule : *
TextLayoutFormat: Regel zum Ausrichten von Text in einem Absatz. | FlowElement | ||
justificationStyle : *
TextLayoutFormat: Der Stil, der zum Ausrichten des Absatzes verwendet wird. | FlowElement | ||
kerning : *
TextLayoutFormat: Beim Kerning werden die Pixel zwischen bestimmten Zeichenpaaren angepasst, um die Lesbarkeit zu verbessern. | FlowElement | ||
leadingModel : *
TextLayoutFormat: Gibt das Zeilenabstandsmodell an, das eine Kombination von Zeilenabstandsbasis und Zeilenabstandsrichtung ist. | FlowElement | ||
ligatureLevel : *
TextLayoutFormat: Steuert, welche in der Schriftart definierten Ligaturen im Text verwendet werden können. | FlowElement | ||
lineBreak : *
TextLayoutFormat: Steuert Zeilenumbruch im Container (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
lineHeight : *
TextLayoutFormat: Steuerelemente für den Zeilenabstand des Texts. | FlowElement | ||
lineThrough : *
TextLayoutFormat: Wenn „true“, wird Durchstreichung angewendet, d. h eine mitten durch den Text gezogene Linie. | FlowElement | ||
linkActiveFormat : *
TextLayoutFormat: Definiert die Formatierungsattribute für Links im normalen Status. | FlowElement | ||
linkHoverFormat : *
TextLayoutFormat: Definiert die Formatierungsattribute, die für Links verwendet werden, über die der Mauszeiger bewegt wird („Hover“-Status). | FlowElement | ||
linkNormalFormat : *
TextLayoutFormat: Definiert die Formatierungsattribute für Links im normalen Status. | FlowElement | ||
linkState : String [schreibgeschützt]
Der aktuelle Status des Hyperlinks. | LinkElement | ||
listAutoPadding : *
TextLayoutFormat: Legt einen automatischen Einzug für die Startkante von Listen fest, wenn der Auffüllwert der Liste auf dieser Seite „auto“ lautet. | FlowElement | ||
listMarkerFormat : *
TextLayoutFormat: Definiert die Listenmarkierungen der Formatierungsattribute. | FlowElement | ||
listStylePosition : *
TextLayoutFormat: Zulässige Werte sind ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT. Standardwert ist nicht definiert, d. h. wurde nicht festgelegt. Wenn die Eigenschaft während einer Kaskade nicht definiert ist, wird der Wert aus einem übergeordneten Element übernommen. | FlowElement | ||
listStyleType : *
TextLayoutFormat: Zulässige Werte sind 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. Standardwert ist nicht definiert, d. h. wurde nicht festgelegt. Wenn die Eigenschaft während einer Kaskade nicht definiert ist, wird der Wert aus einem übergeordneten Element übernommen. | FlowElement | ||
locale : *
TextLayoutFormat: Das Gebietsschema des Texts. | FlowElement | ||
mxmlChildren : Array
Wendet ein Array von untergeordneten Elementen auf dieses Objekt an. | FlowGroupElement | ||
numChildren : int [schreibgeschützt]
Gibt die Anzahl der untergeordneten FlowElements dieses FlowGroupElement-Objekts zurück. | FlowGroupElement | ||
paddingBottom : *
TextLayoutFormat: Der untere Versatz in Pixeln. | FlowElement | ||
paddingLeft : *
TextLayoutFormat: Der linke Einzug in Pixeln. | FlowElement | ||
paddingRight : *
TextLayoutFormat: Der rechte Einzug in Pixeln. | FlowElement | ||
paddingTop : *
TextLayoutFormat: Der obere Versatz in Pixeln. | FlowElement | ||
paragraphEndIndent : *
TextLayoutFormat: Eine Zahl, die den Versatz des unteren Absatzrands in Pixeln angibt. | FlowElement | ||
paragraphSpaceAfter : *
TextLayoutFormat: Eine Zahl, die den Leerraum nach dem Absatz (in Pixeln) festlegt. | FlowElement | ||
paragraphSpaceBefore : *
TextLayoutFormat: Eine Zahl, die den Wert für den Leeraum vor dem Absatz in Pixeln angibt. | FlowElement | ||
paragraphStartIndent : *
TextLayoutFormat: Eine Zahl, die den Versatz des oberen Absatzrands angibt in Pixeln angibt. | FlowElement | ||
parent : FlowGroupElement [schreibgeschützt] Gibt das übergeordnete Element dieses FlowElement-Objekts zurück. | FlowElement | ||
parentRelativeEnd : int [schreibgeschützt] Gibt das relative Ende diesesFlowElement-Objekts im übergeordneten Element zurück. | FlowElement | ||
parentRelativeStart : int [schreibgeschützt] Gibt den relativen Beginn diesesFlowElement-Objekts im übergeordneten Element zurück. | FlowElement | ||
renderingMode : *
TextLayoutFormat: Der für diesen Text verwendete Wiedergabemodus. | FlowElement | ||
styleName : *
TextLayoutFormat: Weist einem Element eine identifizierende Klasse zu, sodass es möglich ist, einen Stil für das Element durch Verweis auf styleName festzulegen. | FlowElement | ||
styles : Object [schreibgeschützt] Gibt die Stile für dieses FlowElement zurück. | FlowElement | ||
tabStops : *
TextLayoutFormat: Gibt die Tabulatoren an, die dem Absatz zugewiesen sind. | FlowElement | ||
target : String
Der mit dem LinkElement verknüpfte Target-Wert. | LinkElement | ||
textAlign : *
TextLayoutFormat: Ausrichtung der Zeilen im Absatz relativ zum Container. | FlowElement | ||
textAlignLast : *
TextLayoutFormat: Ausrichtung der letzten (oder einzigen) Zeile im Absatz relativ zum Container im ausgerichteten Text. | FlowElement | ||
textAlpha : *
TextLayoutFormat: Wert für Alpha (Transparenz) des Texts. | FlowElement | ||
textDecoration : *
TextLayoutFormat: Auszeichnung im Text. | FlowElement | ||
textIndent : *
TextLayoutFormat: Eine Zahl, die die Einrückung der ersten Zeile des Absatzes in Pixeln festlegt. | FlowElement | ||
textJustify : *
TextLayoutFormat: Gibt Optionen für die Ausrichtung des Texts an. | FlowElement | ||
textLength : int [schreibgeschützt]
Gibt die Gesamtlänge des Textes, der zum FlowElement-Objekt und den untergeordneten Elementen gehört, zurück. | FlowElement | ||
textRotation : *
TextLayoutFormat: Bestimmt die Gradzahl zum Drehen dieses Texts. | FlowElement | ||
tracking : Object [Nur Schreiben]
Legt das Verfolgen fest und ist synonym mit der trackingRight-Eigenschaft. | FlowElement | ||
trackingLeft : *
TextLayoutFormat: Zahl in Pixeln (oder Prozent der Schriftgröße, z. B. 120 %), die die Laufweite (manuelles Kerning) angibt, auf die linke Seite jedes Zeichens angewendet werden soll. | FlowElement | ||
trackingRight : *
TextLayoutFormat: Zahl in Pixeln (oder Prozent der Schriftgröße, z. B. 120 %), die die Laufweite (manuelles Kerning) angibt, die auf die rechte Seite jedes Zeichens angewendet werden soll. | FlowElement | ||
typeName : String
Zu jedem FlowElement gehört ein typeName. | FlowElement | ||
typographicCase : *
TextLayoutFormat: Die für diesen Text verwendete typografische Buchstabenart. | FlowElement | ||
userStyles : Object Ermöglicht das Lesen und Schreiben von Benutzerstilen in einem FlowElement-Objekt. | FlowElement | ||
verticalAlign : *
TextLayoutFormat: Vertikale Ausrichtung oder Blocksatz (übernimmt Standardwert, wenn während der Kaskade nicht definiert). | FlowElement | ||
whiteSpaceCollapse : *
TextLayoutFormat: Blendet Leerraum aus oder behält ihn bei, wenn Text in einem TextFlow importiert wird. | FlowElement | ||
wordSpacing : *
TextLayoutFormat: Legt den optimalen, minimalen und maximalen Abstand (als Vielfaches der Breite einer normalen Leerstelle) zwischen Wörtern fest, der beim Blocksatz verwendet wird. | FlowElement |
Methode | Definiert von | ||
---|---|---|---|
Konstruktor - erstellt eine neue LinkElement-Instanz. | LinkElement | ||
Hängt ein untergeordnetes FlowElement-Objekt an. | FlowGroupElement | ||
Fügt der festgelegten Indexposition ein untergeordnetes FlowElement-Objekt hinzu. | FlowGroupElement | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | LinkElement | ||
Löscht den vom styleProp-Parameter festgelegten Stil aus diesem FlowElement-Objekt. | FlowElement | ||
Erstellt eine tiefe Kopie dieses FlowElement-Objekts, einschließlich untergeordneter Elemente, indem der Inhalt zwischen zwei festgelegten Zeichenpositionen kopiert und die Kopie als FlowElement-Objekt zurückgegeben wird. | FlowElement | ||
Sendet ein Ereignis in den Ereignisablauf. | LinkElement | ||
Vergleicht die userStyles dieses Elements mit den userStyles anderer Elemente. | FlowElement | ||
Diese Methode sucht für eine gegebene relative Textposition nach der Indexposition des ersten untergeordneten FlowElements, das die relative Position enthält. | FlowGroupElement | ||
Sucht bei einer gegebenen relativen Textposition nach dem Blattelement, das die Position enthält. | FlowGroupElement | ||
Gibt die Startposition des Elements im Textfluss als absolute Indexposition zurück. | FlowElement | ||
Gibt das Zeichen an der festgelegten Position relativ zu diesem FlowElement-Objekt zurück. | FlowElement | ||
Gibt den Zeichencode an der festgelegten Position relativ zu diesem FlowElement zurück. | FlowElement | ||
Gibt das untergeordnete FlowElement an der festgelegten Indexposition zurück. | FlowGroupElement | ||
Sucht in untergeordneten Elementen nach dem festgelegten FlowElement-Objekt und gibt dessen Indexposition zurück. | FlowGroupElement | ||
Gibt den Beginn dieses Elements relativ zu einem übergeordneten Element zurück. | FlowElement | ||
Gibt das erste untergeordnete FlowLeafElement für diese Gruppe zurück. | FlowGroupElement | ||
Gibt das letzte untergeordnete FlowLeafElement für diese Gruppe zurück. | FlowGroupElement | ||
Gibt das nächste gleichgeordnete FlowElement in der Textflusshierarchie zurück. | FlowElement | ||
Gibt das mit diesem Element verknüpfte ParagraphElement-Objekt zurück. | FlowElement | ||
Gibt das vorherige gleichgeordnete FlowElement in der Textflusshierarchie zurück. | FlowElement | ||
Gibt den Wert des vom styleProp-Parameter festgelegten Stils zurück. Dieser legt den Stilnamen fest und kann einen beliebigen Benutzerstilnamen enthalten. | FlowElement | ||
[override] | FlowGroupElement | ||
Durchsucht die Textflusshierarchie in aufsteigender Richtung, um das TextFlow-Stammobjekt für das Element zurückzugeben. | FlowElement | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | LinkElement | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Wird für MXML-Objekte aufgerufen, nachdem das Implementierungsobjekt erstellt und sämtliche im MXML-Tag angegebenen Komponenteneigenschaften initialisiert wurden. | FlowElement | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt das angegebene untergeordnete FlowElement-Objekt aus der Gruppe. | FlowGroupElement | ||
Entfernt das untergeordnete FlowElement-Objekt an der festgelegten Indexposition. | FlowGroupElement | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | LinkElement | ||
Ersetzt untergeordnete Elemente in der Gruppe durch die festgelegten neuen Elemente. | FlowGroupElement | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Legt für den vom styleProp-Parameter festgelegten Stil den vom newValue-Parameter festgelegten Wert fest. | FlowElement | ||
Erstellt eine Kopie dieses FlowElement-Objekts, indem der Inhalt zwischen zwei angegebenen Zeichenpositionen kopiert wird. | FlowElement | ||
Teilt dieses Objekt an der Position, die durch den childIndex-Parameter festgelegt wurde. | FlowGroupElement | ||
Teilt dieses FlowElement-Objekt an der vom relativePosition-Parameter angegebenen Position, die einer relativen Position im Text für dieses Element entspricht. | FlowElement | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | LinkElement |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
Wird durch Klicken auf den Hyperlink ausgelöst. | LinkElement | |||
Wird ausgelöst, wenn die Maustaste über einem Hyperlink gedrückt wird. | LinkElement | |||
Wird ausgelöst, wenn der Mauszeiger über den Hyperlink bewegt wird. | LinkElement | |||
Wird ausgelöst, wenn die Maustaste über einem Hyperlink losgelassen wird. | LinkElement | |||
Wird ausgelöst, wenn der Mauszeiger den Hyperlink verlässt. | LinkElement | |||
Wird ausgelöst, wenn der Mauszeiger den Hyperlink berührt. | LinkElement |
href | Eigenschaft |
href:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der mit dem LinkElement-Objekt verknüpfte Uniform Resource Identifier (URI). Der URI kann ein beliebiger URI sein, der von der flash.net.navigateToURL()
-Methode unterstützt wird. Diese Eigenschaft wird dem request
-Parameter für diese Methode zugeordnet. Der URI kann auch die Form event:eventType
haben. Wenn darauf geklickt wird, erstellt der TextFlow ein Ereignis des Typs eventType
.
Implementierung
public function get href():String
public function set href(value:String):void
Verwandte API-Elemente
linkState | Eigenschaft |
target | Eigenschaft |
target:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der mit dem LinkElement verknüpfte Target-Wert. Mögliche Werte sind „_self“, „_blank“, „_parent“ und „_top“. Dieser Wert wird dem window
-Parameter der flash.net.navigateToURL()
-Methode zugeordnet.
Implementierung
public function get target():String
public function set target(value:String):void
Verwandte API-Elemente
LinkElement | () | Konstruktor |
public function LinkElement()
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor - erstellt eine neue LinkElement-Instanz.
addEventListener | () | Methode |
public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. Sie können Ereignis-Listener bei allen Knoten in der Anzeigeliste für eine bestimmte Art von Ereignis, Phase oder Priorität registrieren.
Nachdem Sie einen Ereignis-Listener erfolgreich registriert haben, können Sie seine Priorität nicht durch weitere Aufrufe von addEventListener()
ändern. Um die Priorität eines Listeners zu ändern, müssen Sie zunächst removeEventListener()
aufrufen. Anschließend können Sie den Listener mit der neuen Prioritätsstufe erneut aufrufen.
Nach der Registrierung des Listeners haben nachfolgende Aufrufe von addEventListener()
mit einem anderen type
- oder useCapture
-Wert eine separate Listener-Registrierung zur Folge. Wenn Sie beispielsweise zuerst einen Listener registrieren, für den useCapture
auf true
gesetzt ist, wird dieser nur während der Erfassungsphase aktiv sein. Wenn Sie addEventListener()
für dasselbe Listener-Objekt erneut aufrufen, diesmal aber useCapture
auf false
gesetzt ist, werden zwei separate Listener angelegt: einer, der während der Erfassungsphase aktiv ist und ein zweiter, der während der Ziel- und Bubbling-Phase aktiv ist.
Sie können einen Ereignis-Listener nicht nur für die Ziel- oder Bubbling-Phase registrieren. Die beiden Phasen hängen während der Registrierung immer zusammen, da Bubbling nur für übergeordnete Elemente des Zielknotens gilt.
Wenn Sie einen Ereignis-Listener nicht mehr benötigen, entfernen sie ihn, indem Sie EventDispatcher.removeEventListener()
aufrufen, andernfalls könnte es zu Speicherproblemen kommen. Objekte mit registrierten Ereignis-Listenern werden nicht automatisch aus dem Speicher entfernt, da der Garbagekollektor (Speichermanagement) keine Objekte entfernt, die noch Verweise enthalten.
Beim Kopieren einer EventDispatcher-Instanz werden zugewiesene Ereignis-Listener nicht kopiert. (Wenn ein neu angelegter Knoten einen Ereignis-Listener benötigt, müssen Sie den Listener nach dem Erstellen des Knotens zuweisen.) Wenn Sie jedoch eine EventDispatcher-Instanz verschieben, werden zugewiesene Ereignis-Listener ebenfalls verschoben.
Wenn der Ereignis-Listener bei einem Knoten registriert ist und dieser Knoten ein Ereignis durchgeführt, so wird der Ereignis-Listener nicht während der aktuellen Phase ausgelöst, kann aber in einer späteren Phase im Ereignisablauf gesendet werden, etwa in der Bubbling-Phase.
Wird ein Ereignis-Listener von einem Knoten entfernt, während mit dem Knoten ein Ereignis durchgeführt wird, so wird er von den aktuellen Aktionen immer noch ausgelöst. Nachdem er entfernt worden ist, wird der Ereignis-Listener nicht wieder aufgerufen (es sei denn er wird für spätere Verarbeitungsvorgänge erneut aufgerufen).
Parameter
type:String — Der Typ des Ereignisses.
| |
listener:Function — Die Listener-Funktion, die das Ereignis verarbeitet. Diese Funktion muss, wie das nachfolgende Beispiel zeigt, ein Ereignisobjekt als einzigen Parameter akzeptieren und keinen Wert zurückgeben:
| |
useCapture:Boolean (default = false ) — Bestimmt, ob der Listener in der Erfassungsphase oder in der Ziel- und Bubbling-Phase arbeitet. Ist useCapture auf true gesetzt, so verarbeitet der Listener das Ereignis nur während der Erfassungsphase und nicht während der Ziel- oder Bubbling-Phase. Hat useCapture hingegen den Wert false , verarbeitet der Listener das Ereignis nur während der Ziel- oder Bubbling-Phase. Damit das Ereignis in allen drei Phasen aktiv ist, rufen Sie addEventListener() zweimal auf; einmal ist useCapture auf true gesetzt, und beim zweiten Mal hat useCapture den Wert false .
| |
priority:int (default = 0 ) — Die Prioritätsstufe des Ereignis-Listeners. Prioritäten werden über eine 32-Bit-Ganzzahl zugewiesen. Je höher die Zahl, desto höher die Priorität. Alle Listener mit der Priorität n werden vor Listenern mit der Priorität n-1 verarbeitet. Wenn zwei oder mehr Listener die gleiche Priorität aufweisen, werden sie in der Reihenfolge verarbeitet, in der sie hinzugefügt wurden. Die Standardpriorität ist 0.
| |
useWeakReference:Boolean (default = false ) — Bestimmt, ob der Verweis auf den Listener stark oder schwach ist. Ein starker Verweis (der Standard) verhindert, dass der Listener von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht. Funktionen von Mitgliedern auf Klassenebene werden nicht vom Garbagekollektor entfernt. Daher können Sie |
dispatchEvent | () | Methode |
public function dispatchEvent(evt:Event):Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Sendet ein Ereignis in den Ereignisablauf. Das Ereignisziel ist das EventDispatcher-Objekt, für das die Methode dispatchEvent()
aufgerufen wird.
Parameter
evt:Event — Das Ereignisobjekt, das in den Ereignisablauf gesendet wird.
|
Boolean — Der Wert true (sofern nicht preventDefault() ) wird bei dem Ereignis aufgerufen. In diesem Fall wird false zurückgegeben.
|
hasEventListener | () | Methode |
public function hasEventListener(type:String):Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. Dadurch können Sie bestimmen, wo ein EventDispatcher-Objekt die Verarbeitung eines Ereignistyps in der Ereignisablaufhierarchie geändert hat. Um festzustellen, ob ein bestimmter Ereignistyp einen Ereignis-Listener auslöst, verwenden Sie IEventDispatcher.willTrigger()
.
Der Unterschied zwischen hasEventListener()
und willTrigger()
besteht darin, dass hasEventListener()
nur das Objekt untersucht, zu dem es gehört, während willTrigger()
den gesamten Ereignisablauf auf das im Parameter type
angegebene Ereignis untersucht.
Parameter
type:String — Der Typ des Ereignisses.
|
Boolean — Der Wert true , wenn ein Listener des angegebenen Typs registriert ist; andernfalls false .
|
removeEventListener | () | Methode |
public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Entfernt einen Listener aus dem EventDispatcher-Objekt. Wenn kein entsprechender Listener mit dem EventDispatcher-Objekt registriert ist, hat ein Aufruf dieser Methode keine Auswirkungen.
Parameter
type:String — Der Typ des Ereignisses.
| |
listener:Function — Das zu entfernende Listener-Objekt.
| |
useCapture:Boolean (default = false ) — Gibt an, ob der Listener für die Erfassungsphase oder die Ziel- und Bubbling-Phase registriert wurde. Wenn der Listener sowohl für die Erfassungs- als auch für die Bubbling-Phase registriert wurde, sind auch zwei Aufrufe von removeEventListener() erforderlich, um beide zu entfernen: ein Aufruf, bei dem useCapture auf true gesetzt ist, und einer, bei dem useCapture auf false gesetzt ist.
|
willTrigger | () | Methode |
public function willTrigger(type:String):Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. Diese Methode liefert den Wert true
, wenn während irgendeiner Phase des Ereignisablaufs ein Ereignis-Listener aufgerufen wird, wenn ein Ereignis des angegebenen Typs für dieses EventDispatcher-Objekt oder eines seiner nachfolgenden Elemente ausgelöst wird.
Der Unterschied zwischen hasEventListener()
und willTrigger()
besteht darin, dass hasEventListener()
nur das Objekt untersucht, zu dem es gehört, während willTrigger()
den gesamten Ereignisablauf auf das im Parameter type
angegebene Ereignis untersucht.
Parameter
type:String — Der Typ des Ereignisses.
|
Boolean — Der Wert true , wenn ein Listener des angegebenen Typs ausgelöst wird; andernfalls false .
|
click | Ereignis |
flashx.textLayout.events.FlowElementMouseEvent
Eigenschaft FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.CLICK
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird durch Klicken auf den Hyperlink ausgelöst. Clients können überschreiben, wie der Hyperlink das Ereignis verarbeitet, indem sie es selbst verarbeiten und die preventDefault()-Methode aufrufen.
Definiert den Wert der Eigenschafttype
eines click
-Ereignisobjekts.
mouseDown | Ereignis |
flashx.textLayout.events.FlowElementMouseEvent
Eigenschaft FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_DOWN
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn die Maustaste über einem Hyperlink gedrückt wird.
Definiert den Wert der Eigenschafttype
eines mouseDown
-Ereignisobjekts.
mouseMove | Ereignis |
flashx.textLayout.events.FlowElementMouseEvent
Eigenschaft FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_MOVE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn der Mauszeiger über den Hyperlink bewegt wird.
Definiert den Wert der Eigenschafttype
eines mouseMove
-Ereignisobjekts.
mouseUp | Ereignis |
flashx.textLayout.events.FlowElementMouseEvent
Eigenschaft FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_UP
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn die Maustaste über einem Hyperlink losgelassen wird.
Definiert den Wert der Eigenschafttype
eines mouseUp
-Ereignisobjekts.
rollOut | Ereignis |
flashx.textLayout.events.FlowElementMouseEvent
Eigenschaft FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.ROLL_OUT
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn der Mauszeiger den Hyperlink verlässt.
Definiert den Wert der Eigenschafttype
eines rollOut
-Ereignisobjekts.
rollOver | Ereignis |
flashx.textLayout.events.FlowElementMouseEvent
Eigenschaft FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.ROLL_OVER
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn der Mauszeiger den Hyperlink berührt.
Definiert den Wert der Eigenschafttype
eines rollOver
-Ereignisobjekts.
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:
verwendet, um ein Ereignis zu generieren, dass beim Klicken ActionScript-Code ausführt.
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, 10:04 AM Z