LinkElement

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

Die LinkElement-Klasse definiert einen Hyperlink für einen URI (Universal Resource Identifier), der durch Klicken des Benutzers ausgeführt wird. Die LinkElement-Klasse ist eine Unterklasse der SubParagraphGroupElementBase-Klasse. Sie kann ein oder mehrere FlowElement-Objekte enthalten, z. B. ein SpanElement-Objekt, das den Hyperlinktext speichert. Ein leeres LinkElement, das kein FlowElement-Objekt enthält, wird ignoriert.

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

Beispiele anzeigen

Verwandte API-Elemente

LinkState
FlowElement.linkActiveFormat
FlowElement.linkHoverFormat
FlowElement.linkNormalFormat
TextFlow

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		LinkElement() Konstruktor - erstellt eine neue LinkElement-Instanz.	LinkElement
		addChild(child:FlowElement):FlowElement Hängt ein untergeordnetes FlowElement-Objekt an.	FlowGroupElement
		addChildAt(index:uint, child:FlowElement):FlowElement 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
		clearStyle(styleProp:String):void Löscht den vom styleProp-Parameter festgelegten Stil aus diesem FlowElement-Objekt.	FlowElement
		deepCopy(relativeStart:int = 0, relativeEnd:int = -1):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
		dispatchEvent(evt:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	LinkElement
		equalUserStyles(otherElement:FlowElement):Boolean Vergleicht die userStyles dieses Elements mit den userStyles anderer Elemente.	FlowElement
		findChildIndexAtPosition(relativePosition:int):int Diese Methode sucht für eine gegebene relative Textposition nach der Indexposition des ersten untergeordneten FlowElements, das die relative Position enthält.	FlowGroupElement
		findLeaf(relativePosition:int):FlowLeafElement Sucht bei einer gegebenen relativen Textposition nach dem Blattelement, das die Position enthält.	FlowGroupElement
		getAbsoluteStart():int Gibt die Startposition des Elements im Textfluss als absolute Indexposition zurück.	FlowElement
		getCharAtPosition(relativePosition:int):String Gibt das Zeichen an der festgelegten Position relativ zu diesem FlowElement-Objekt zurück.	FlowElement
		getCharCodeAtPosition(relativePosition:int):int Gibt den Zeichencode an der festgelegten Position relativ zu diesem FlowElement zurück.	FlowElement
		getChildAt(index:int):FlowElement Gibt das untergeordnete FlowElement an der festgelegten Indexposition zurück.	FlowGroupElement
		getChildIndex(child:FlowElement):int Sucht in untergeordneten Elementen nach dem festgelegten FlowElement-Objekt und gibt dessen Indexposition zurück.	FlowGroupElement
		getElementRelativeStart(ancestorElement:FlowElement):int Gibt den Beginn dieses Elements relativ zu einem übergeordneten Element zurück.	FlowElement
		getFirstLeaf():FlowLeafElement Gibt das erste untergeordnete FlowLeafElement für diese Gruppe zurück.	FlowGroupElement
		getLastLeaf():FlowLeafElement Gibt das letzte untergeordnete FlowLeafElement für diese Gruppe zurück.	FlowGroupElement
		getNextSibling():FlowElement Gibt das nächste gleichgeordnete FlowElement in der Textflusshierarchie zurück.	FlowElement
		getParagraph():ParagraphElement Gibt das mit diesem Element verknüpfte ParagraphElement-Objekt zurück.	FlowElement
		getPreviousSibling():FlowElement Gibt das vorherige gleichgeordnete FlowElement in der Textflusshierarchie zurück.	FlowElement
		getStyle(styleProp:String):* Gibt den Wert des vom styleProp-Parameter festgelegten Stils zurück. Dieser legt den Stilnamen fest und kann einen beliebigen Benutzerstilnamen enthalten.	FlowElement
		getText(relativeStart:int = 0, relativeEnd:int = -1, paragraphSeparator:String = " "):String [override]	FlowGroupElement
		getTextFlow():flashx.textLayout.elements:TextFlow Durchsucht die Textflusshierarchie in aufsteigender Richtung, um das TextFlow-Stammobjekt für das Element zurückzugeben.	FlowElement
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	LinkElement
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		initialized(document:Object, id:String):void Wird für MXML-Objekte aufgerufen, nachdem das Implementierungsobjekt erstellt und sämtliche im MXML-Tag angegebenen Komponenteneigenschaften initialisiert wurden.	FlowElement
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeChild(child:FlowElement):FlowElement Entfernt das angegebene untergeordnete FlowElement-Objekt aus der Gruppe.	FlowGroupElement
		removeChildAt(index:uint):FlowElement Entfernt das untergeordnete FlowElement-Objekt an der festgelegten Indexposition.	FlowGroupElement
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	LinkElement
		replaceChildren(beginChildIndex:int, endChildIndex:int, ... rest):void Ersetzt untergeordnete Elemente in der Gruppe durch die festgelegten neuen Elemente.	FlowGroupElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		setStyle(styleProp:String, newValue:*):void Legt für den vom styleProp-Parameter festgelegten Stil den vom newValue-Parameter festgelegten Wert fest.	FlowElement
		shallowCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement Erstellt eine Kopie dieses FlowElement-Objekts, indem der Inhalt zwischen zwei angegebenen Zeichenpositionen kopiert wird.	FlowElement
		splitAtIndex(childIndex:int):FlowGroupElement Teilt dieses Objekt an der Position, die durch den childIndex-Parameter festgelegt wurde.	FlowGroupElement
		splitAtPosition(relativePosition:int):FlowElement Teilt dieses FlowElement-Objekt an der vom relativePosition-Parameter angegebenen Position, die einer relativen Position im Text für dieses Element entspricht.	FlowElement
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	LinkElement

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

	Übersicht	Definiert von
click	Wird durch Klicken auf den Hyperlink ausgelöst.	LinkElement
mouseDown	Wird ausgelöst, wenn die Maustaste über einem Hyperlink gedrückt wird.	LinkElement
mouseMove	Wird ausgelöst, wenn der Mauszeiger über den Hyperlink bewegt wird.	LinkElement
mouseUp	Wird ausgelöst, wenn die Maustaste über einem Hyperlink losgelassen wird.	LinkElement
rollOut	Wird ausgelöst, wenn der Mauszeiger den Hyperlink verlässt.	LinkElement
rollOver	Wird ausgelöst, wenn der Mauszeiger den Hyperlink berührt.	LinkElement

Eigenschaftendetails

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

flash.net.navigateToURL()

linkState

Eigenschaft

linkState:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 10, AIR 1.5

Der aktuelle Status des Hyperlinks.

Implementierung
public function get linkState():String

Verwandte API-Elemente

LinkState

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

flash.net.navigateToURL()

Konstruktordetails

()

Konstruktor

public function LinkElement()

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 10, AIR 1.5

Konstruktor - erstellt eine neue LinkElement-Instanz.

Methodendetails

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: `function(evt:Event):void` Der Name der Funktion ist beliebig.

	`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 `useWeakReference` für Mitgliedsfunktionen auf Klassenebene auf `true` setzen, ohne dass sie vom Garbagekollektor entfernt werden. Wenn Sie `useWeakReference` für einen Listener, der eine verschachtelte innere Funktion ist, auf `true` setzen, wird Garbage Collection auf diese Funktion angewendet, die damit nicht mehr permanent gespeichert wird. Indem Sie Verweise auf die innere Funktion erstellen (d. h sie in einer anderen Variable speichern), umgehen Sie die Garbage Collection, sodass die Funktion permanent gespeichert bleibt.

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.

Rückgabewerte

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.

Rückgabewerte

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.

Parameter

type:String — Der Typ des Ereignisses.

Rückgabewerte

Boolean — Der Wert true, wenn ein Listener des angegebenen Typs ausgelöst wird; andernfalls false.

Ereignisdetails

click

Ereignis

Ereignisobjekttyp: 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 Eigenschaft type eines click-Ereignisobjekts.

mouseDown

Ereignis

Ereignisobjekttyp: 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 Eigenschaft type eines mouseDown-Ereignisobjekts.

mouseMove

Ereignis

Ereignisobjekttyp: 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 Eigenschaft type eines mouseMove-Ereignisobjekts.

mouseUp

Ereignis

Ereignisobjekttyp: 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 Eigenschaft type eines mouseUp-Ereignisobjekts.

rollOut

Ereignis

Ereignisobjekttyp: 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 Eigenschaft type eines rollOut-Ereignisobjekts.

rollOver

Ereignis

Ereignisobjekttyp: 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 Eigenschaft type eines rollOver-Ereignisobjekts.

Beispiele Verwendung dieses Beispiels

LinkElementExample.as

Dieses Beispiel fügt einem Absatz ein LinkElement hinzu und überschreibt das Standardformat für den Schwebestatus, wobei der Hyperlinktext rot markiert wird.

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

In diesem Beispiel wird das URI-Schema 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();
        }
    }
}

Rechtliche Hinweise | Onlinedatenschutzerklärung

LinkElement - AS3

Klassen x

href

linkState

target

LinkElement

addEventListener

dispatchEvent

hasEventListener

removeEventListener

willTrigger

click

mouseDown

mouseMove

mouseUp

rollOut

rollOver