LinkElement

Pakket	flashx.textLayout.elements
Klasse	public final class LinkElement
Overerving	LinkElement SubParagraphGroupElementBase FlowGroupElement FlowElement Object
Implementatie	IEventDispatcher

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

De LinkElement-klasse definieert een koppeling met een URI (Universal Resource Identifier) die wordt uitgevoerd wanneer de gebruiker er op klikt. De LinkElement-klasse is een subklasse van de SubParagraphGroupElementBase-klasse en kan een of meer FlowElement-objecten bevatten, zoals een SpanElement-object waarin de koppelingstekst is opgeslagen. Een leeg LinkElement dat geen FlowElement-object bevat wordt genegeerd.

Wanneer op het LinkElement wordt geklikt, wordt doorgaans de methode flash.net.navigateToURL() aangeroepen. Een speciaal URI-schema event: wordt ook ondersteund. Dit schema genereert een TextFlow-gebeurtenis waarnaar de gebruiker kan luisteren om AS3-code uit te voeren. Hieronder vindt u een voorbeeld.

Als u een doel opgeeft, moet dit een van de volgende waarden zijn:

Doelwaarde	beschrijving
_self	Vervangt de huidige HTML-pagina. Als het zich in een frame of frameset bevindt, zal het worden opgeladen in dat frame. Als het de volledige browser is, wordt het geopend als een vervanging van de pagina waar het vandaan kwam.
_blank	Opent een nieuwe browser zonder naam.
_parent	Vervangt de HTML-pagina waar het vandaan kwam.
_top	Wordt geladen in de huidige browser en vervangt de volledige inhoud, zoals een frameset.

Standaard-MXML-eigenschapmxmlChildren

Bekijk de voorbeelden

Meer voorbeelden

Creating TextFlow objects
Adding hyperlinks with TLF

Verwante API-elementen

LinkState
FlowElement.linkActiveFormat
FlowElement.linkHoverFormat
FlowElement.linkNormalFormat
TextFlow

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		alignmentBaseline : * TextLayoutFormat: geeft de basislijn weer, waaraan de dominante basislijn wordt uitgelijnd.	FlowElement
		backgroundAlpha : * TextLayoutFormat: de alfawaarde (transparantie) van de achtergrond (de standaardwaarde wordt overgenomen als de waarde niet is gedefinieerd tijdens de trapsgewijze opmaak).	FlowElement
		backgroundColor : * TextLayoutFormat: de achtergrondkleur (de standaardwaarde wordt overgenomen als de waarde niet is gedefinieerd tijdens de trapsgewijze opmaak).	FlowElement
		baselineShift : * TextLayoutFormat: hoeveelheid dat de basislijn vanaf de dominantBaseline-waarde wordt verschoven.	FlowElement
		blockProgression : * TextLayoutFormat: geeft een verticale of horizontale voortgang van lijnplaatsing aan.	FlowElement
		breakOpportunity : * TextLayoutFormat: besturingselementen waarin lijnen onderbroken mogen worden, wanneer tekstomloop in meerdere lijnen wordt opgebroken.	FlowElement
		cffHinting : * TextLayoutFormat: het type CFF-hinting dat wordt gebruikt voor deze tekst.	FlowElement
		clearFloats : * TextLayoutFormat: bepaalt hoe tekst om een float loopt.	FlowElement
		color : * TextLayoutFormat: kleur van de tekst.	FlowElement
		columnCount : * TextLayoutFormat: het aantal tekstkolommen (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet is gedefinieerd).	FlowElement
		columnGap : * TextLayoutFormat: geeft de waarde van de tussenruimte tussen de kolommen in pixels op (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet gedefinieerd is).	FlowElement
		columnWidth : * TextLayoutFormat: kolombreedte in pixels (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet gedefinieerd is).	FlowElement
		computedFormat : flashx.textLayout.formats:ITextLayoutFormat [alleen-lezen] Retourneert de berekende opmaakkenmerken die actief zijn voor dit element.	FlowElement
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		coreStyles : Object [alleen-lezen] Retourneert de coreStyles voor dit FlowElement.	FlowElement
		digitCase : * TextLayoutFormat: het cijfertype dat wordt gebruikt voor deze tekst.	FlowElement
		digitWidth : * TextLayoutFormat: het type cijferbreedte dat wordt gebruikt voor deze tekst.	FlowElement
		direction : * TextLayoutFormat: geeft het standaardinsluitingsniveau in twee richtingen van de tekst in het tekstblok aan.	FlowElement
		dominantBaseline : * TextLayoutFormat: geeft aan welke elementbasislijn vastgezet is op de alignmentBaseline om de verticale positie van het element op de lijn te bepalen.	FlowElement
		firstBaselineOffset : * TextLayoutFormat: geeft de basislijnpositie van de eerste regel in de container aan.	FlowElement
		fontFamily : * TextLayoutFormat: de naam van het te gebruiken lettertype of een door komma's gescheiden lijst met namen van lettertypen.	FlowElement
		fontLookup : * TextLayoutFormat: het gevonden lettertype wordt gebruikt.	FlowElement
		fontSize : * TextLayoutFormat: de tekstgrootte in pixels.	FlowElement
		fontStyle : * TextLayoutFormat: tekststijl.	FlowElement
		fontWeight : * TextLayoutFormat: tekstdikte.	FlowElement
		format : flashx.textLayout.formats:ITextLayoutFormat TextLayoutFormat-eigenschappen die rechtstreeks op dit element zijn toegepast.	FlowElement
		href : String De Uniform Resource Identifier (URI) die is gekoppeld aan het LinkElement-object.	LinkElement
		id : String Wijst een identificatienaam aan het element toe, waardoor het mogelijk wordt om voor het element een stijl in te stellen door naar de id te verwijzen.	FlowElement
		justificationRule : * TextLayoutFormat: regel die gebruikt wordt om tekst in een alinea uit te vullen.	FlowElement
		justificationStyle : * TextLayoutFormat: de stijl die gebruikt wordt voor de uitvulling van de alinea.	FlowElement
		kerning : * TextLayoutFormat: met tekenspatiëring worden de pixels tussen bepaalde tekenparen aangepast om de leesbaarheid te verbeteren.	FlowElement
		leadingModel : * TextLayoutFormat: geeft het regelafstandmodel aan; dit is een combinatie van de regelafstandbasis en de regelafstandrichting.	FlowElement
		ligatureLevel : * TextLayoutFormat: bepaalt welke ligaturen die in het lettertype gedefinieerd zijn, in de tekst gebruikt kunnen worden.	FlowElement
		lineBreak : * TextLayoutFormat: bepaalt de tekstomloop binnen de container (neemt de standaardwaarde over, als deze niet is gedefinieerd tijdens de trapsgewijze opmaak).	FlowElement
		lineHeight : * TextLayoutFormat: besturingselementen voor de regelafstand in de tekst.	FlowElement
		lineThrough : * TextLayoutFormat: indien true, wordt doorhalen toegepast door een lijn door het midden van de tekst te trekken.	FlowElement
		linkActiveFormat : * TextLayoutFormat: definieert de opmaakkenmerken die worden gebruikt voor koppelingen met normale status.	FlowElement
		linkHoverFormat : * TextLayoutFormat: bepaalt de opmaakkenmerken die worden gebruikt voor koppelingen in aanwijstoestand, wanneer de muis zich binnen de begrenzingen (schuivend over) van een koppeling bevindt.	FlowElement
		linkNormalFormat : * TextLayoutFormat: definieert de opmaakkenmerken die worden gebruikt voor koppelingen met normale status.	FlowElement
		linkState : String [alleen-lezen] De huidige status van de koppeling.	LinkElement
		listAutoPadding : * TextLayoutFormat: geeft een automatische inspringing voor de beginrand van lijsten aan wanneer de opvulwaarde van de lijst voor die zijde auto is.	FlowElement
		listMarkerFormat : * TextLayoutFormat: definieert de opmaakkenmerken voor lijstmarkeringen.	FlowElement
		listStylePosition : * TextLayoutFormat: geldige waarden zijn ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT. Standaardwaarde is ongedefinieerd, wat aangeeft dat dit niet is ingesteld. Als de waarde niet is gedefinieerd tijdens de trapsgewijze opmaak, neemt deze eigenschap de waarde van een voorouder over.	FlowElement
		listStyleType : * TextLayoutFormat: geldige waarden zijn 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. Standaardwaarde is ongedefinieerd, wat aangeeft dat dit niet is ingesteld. Als de waarde niet is gedefinieerd tijdens de trapsgewijze opmaak, neemt deze eigenschap de waarde van een voorouder over.	FlowElement
		locale : * TextLayoutFormat: de landinstelling van de tekst.	FlowElement
		mxmlChildren : Array Voegt een array van onderliggende elementen aan dit object toe.	FlowGroupElement
		numChildren : int [alleen-lezen] Retourneert het aantal onderliggende FlowElement-items van dit FlowGroupElement-object.	FlowGroupElement
		paddingBottom : * TextLayoutFormat: onderste inzet in pixels.	FlowElement
		paddingLeft : * TextLayoutFormat: linkerinzet in pixels.	FlowElement
		paddingRight : * TextLayoutFormat: rechterinzet in pixels.	FlowElement
		paddingTop : * TextLayoutFormat: bovenste inzet in pixels.	FlowElement
		paragraphEndIndent : * TextLayoutFormat: een Getal dat, in pixels, opgeeft hoeveel er aan de eindrand van de alinea moet worden ingesprongen.	FlowElement
		paragraphSpaceAfter : * TextLayoutFormat: een getal dat aangeeft hoeveel ruimte in pixels er na een alinea overblijft.	FlowElement
		paragraphSpaceBefore : * TextLayoutFormat: een getal dat aangeeft hoeveel ruimte in pixels er vóór een alinea is.	FlowElement
		paragraphStartIndent : * TextLayoutFormat: een Getal dat, in pixels, opgeeft hoeveel er aan de beginrand van de alinea moet worden ingesprongen.	FlowElement
		parent : FlowGroupElement [alleen-lezen] Retourneert het bovenliggende object van dit FlowElement-object.	FlowElement
		parentRelativeEnd : int [alleen-lezen] Retourneert het relatieve einde van dit FlowElement-object in het bovenliggende object.	FlowElement
		parentRelativeStart : int [alleen-lezen] Retourneert de relatieve start van dit FlowElement-object in het bovenliggende object.	FlowElement
		renderingMode : * TextLayoutFormat: de renderingmodus voor deze tekst.	FlowElement
		styleName : * TextLayoutFormat: wijst een identificatieklasse toe aan het element zodat het mogelijk wordt een stijl voor het element in te stellen door te verwijzen naar de styleName.	FlowElement
		styles : Object [alleen-lezen] Retourneert de stijlen voor dit FlowElement.	FlowElement
		tabStops : * TextLayoutFormat: geeft de tabstops aan die gerelateerd zijn aan de alinea.	FlowElement
		target : String De doelwaarde die is gekoppeld aan het LinkElement.	LinkElement
		textAlign : * TextLayoutFormat: de uitlijning van lijnen in de alinea ten opzichte van de container.	FlowElement
		textAlignLast : * TextLayoutFormat: de uitlijning van de laatste (of enige) lijn in de alinea ten opzichte van de container in de uitgevulde tekst.	FlowElement
		textAlpha : * TextLayoutFormat: alfawaarde (transparantie) voor de tekst.	FlowElement
		textDecoration : * TextLayoutFormat: tekstdecoratie.	FlowElement
		textIndent : * TextLayoutFormat: een Getal dat, in pixels, opgeeft hoeveel er bij de eerste regel van de alinea moet worden ingesprongen.	FlowElement
		textJustify : * TextLayoutFormat: geeft opties op voor het uitvullen van tekst.	FlowElement
		textLength : int [alleen-lezen] Retourneert de totale lengte van tekst die eigendom is van dit FlowElement-object en de bijbehorende onderliggende objecten.	FlowElement
		textRotation : * TextLayoutFormat: bepaalt het aantal graden waarmee deze tekst geroteerd wordt.	FlowElement
		tracking : Object [alleen-schrijven] Hiermee wordt de 'tracking' ingesteld; dit is gelijk aan de trackingRight-eigenschap.	FlowElement
		trackingLeft : * TextLayoutFormat: getal in pixels (of percentage van fontSize, bijvoorbeeld 120%) dat aangeeft hoeveel 'tracking' (handmatige tekenspatiëring) links van elk teken moet worden toegepast.	FlowElement
		trackingRight : * TextLayoutFormat: getal in pixels (of percentage van fontSize, bijvoorbeeld 120%) dat aangeeft hoeveel 'tracking' (handmatige tekenspatiëring) rechts van elk teken moet worden toegepast.	FlowElement
		typeName : String Elk FlowElement heeft een typeName.	FlowElement
		typographicCase : * TextLayoutFormat: het typografische type dat wordt gebruikt voor deze tekst.	FlowElement
		userStyles : Object Stelt u in staat gebruikersstijlen te lezen en weg te schrijven op een FlowElement-object.	FlowElement
		verticalAlign : * TextLayoutFormat: verticale uitlijning of uitvulling (neemt de standaardwaarde over als deze tijdens de trapsgewijze opmaak niet gedefinieerd is).	FlowElement
		whiteSpaceCollapse : * TextLayoutFormat: vouwt witruimte samen of behoudt deze tijdens het importeren van tekst in een TextFlow.	FlowElement
		wordSpacing : * TextLayoutFormat: geeft de optimale, minimale en maximale spatiëring (als een vermenigvuldiger van de breedte van een normale spatie) tussen woorden op die moet worden gebruikt tijdens uitvulling.	FlowElement

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		LinkElement() Constructor: maakt een nieuwe LinkElement-instantie.	LinkElement
		addChild(child:FlowElement):FlowElement Voegt een onderliggend FlowElement-object toe.	FlowGroupElement
		addChildAt(index:uint, child:FlowElement):FlowElement Voegt een onderliggend FlowElement-object toe op de opgegeven indexpositie.	FlowGroupElement
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.	LinkElement
		clearStyle(styleProp:String):void Hiermee wordt de stijl bepaald door de styleProp-parameter van dit FlowElement-object.	FlowElement
		deepCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement Maakt een uitgebreide kopie van dit FlowElement-object, inclusief alle onderliggende elementen, waarbij de inhoud tussen de twee opgegeven tekenposities wordt gekopieerd. De kopie wordt geretourneerd als een FlowElement-object.	FlowElement
		dispatchEvent(evt:Event):Boolean Verzendt een gebeurtenis naar de gebeurtenisstroom.	LinkElement
		equalUserStyles(otherElement:FlowElement):Boolean Vergelijk de userStyles van dit met element met de userStyles van otherElement.	FlowElement
		findChildIndexAtPosition(relativePosition:int):int Zoek op basis van een relatieve tekstpositie naar de index van het eerste onderliggende FlowElement met de relatieve positie.	FlowGroupElement
		findLeaf(relativePosition:int):FlowLeafElement Zoek op basis van een relatieve tekstpositie naar het bladelement met de relatieve positie	FlowGroupElement
		getAbsoluteStart():int Retourneert de beginlocatie van het element in de tekstflow als een absolute index.	FlowElement
		getCharAtPosition(relativePosition:int):String Retourneert het teken bij de opgegeven positie, relatief ten opzichte van dit FlowElement-object.	FlowElement
		getCharCodeAtPosition(relativePosition:int):int Retourneert de tekencode bij de opgegeven positie, relatief ten opzichte van dit FlowElement-object.	FlowElement
		getChildAt(index:int):FlowElement Retourneert het onderliggende FlowElement-object op de opgegeven index.	FlowGroupElement
		getChildIndex(child:FlowElement):int Zoekt in onderliggende items naar het opgegeven FlowElement-object en retourneert de bijbehorende indexpositie.	FlowGroupElement
		getElementRelativeStart(ancestorElement:FlowElement):int Retourneert het begin van dit element, relatief ten opzichte van een bovenliggend element.	FlowElement
		getFirstLeaf():FlowLeafElement Retourneert de eerste FlowLeafElement-afstammeling van deze groep.	FlowGroupElement
		getLastLeaf():FlowLeafElement Retourneert de laatste FlowLeafElement-afstammeling van deze groep.	FlowGroupElement
		getNextSibling():FlowElement Retourneert het volgende FlowElement dat zich op hetzelfde niveau bevindt in de tekstflowhiërarchie.	FlowElement
		getParagraph():ParagraphElement Retourneert het ParagraphElement-object dat is gekoppeld aan dit element.	FlowElement
		getPreviousSibling():FlowElement Retourneert het voorgaande FlowElement dat zich op hetzelfde niveau bevindt in de tekstflowhiërarchie.	FlowElement
		getStyle(styleProp:String):* Retourneert de waarde van de stijl die is opgegeven door de styleProp-parameter, die de stijlnaam aangeeft en eender welke gebruikersstijlnaam kan bevatten.	FlowElement
		getText(relativeStart:int = 0, relativeEnd:int = -1, paragraphSeparator:String = " "):String [overschrijven]	FlowGroupElement
		getTextFlow():flashx.textLayout.elements:TextFlow Klimt omhoog in de tekstflowhiërarchie en retourneert het basis-TextFlow-object voor het element.	FlowElement
		hasEventListener(type:String):Boolean Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	LinkElement
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		initialized(document:Object, id:String):void Opgeroepen voor MXML-objecten nadat het implementerende object is gemaakt en alle componenteigenschappen die op de MXML-tag zijn opgegeven, zijn geïnitialiseerd.	FlowElement
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeChild(child:FlowElement):FlowElement Verwijdert het opgegeven onderliggende FlowLeafElement-object van de groep	FlowGroupElement
		removeChildAt(index:uint):FlowElement Verwijdert het onderliggende FlowElement-object op de opgegeven indexpositie.	FlowGroupElement
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	LinkElement
		replaceChildren(beginChildIndex:int, endChildIndex:int, ... rest):void Vervangt onderliggende elementen in de groep door de opgegeven nieuwe elementen.	FlowGroupElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		setStyle(styleProp:String, newValue:*):void Hiermee wordt de stijl, zoals bepaald door de styleProp-parameter, ingesteld op de waarde die is bepaald door de newValue-parameter.	FlowElement
		shallowCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement Maakt een kopie van dit FlowElement-object, zodat de inhoud tussen twee opgegeven tekenposities wordt gekopieerd.	FlowElement
		splitAtIndex(childIndex:int):FlowGroupElement Hiermee wordt dit object opgedeeld op de positie die is opgegeven door de childIndex-parameter.	FlowGroupElement
		splitAtPosition(relativePosition:int):FlowElement Hiermee wordt dit FlowElement-object opgedeeld op de positie die wordt bepaald door de relativePosition-parameter. Dit is de relatieve positie in de tekst voor dit element.	FlowElement
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven object.	Object
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	LinkElement

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

	Overzicht	Gedefinieerd door
click	Verzonden wanneer er op de koppeling wordt geklikt.	LinkElement
mouseDown	Verzonden wanneer op de muis wordt geklikt als deze zich boven de koppeling bevindt.	LinkElement
mouseMove	Verzonden wanneer de muis zich over de koppeling verplaatst.	LinkElement
mouseUp	Verzonden wanneer de muis wordt losgeklikt boven de koppeling.	LinkElement
rollOut	Verzonden wanneer de muis zich niet meer in de koppeling bevindt.	LinkElement
rollOver	Verzonden wanneer de muis zich voor het eerst in de koppeling bevindt.	LinkElement

Eigenschapdetails

href	eigenschap

href:String

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

De Uniform Resource Identifier (URI) die is gekoppeld aan het LinkElement-object. De URI kan elke URI zijn die wordt ondersteund door de flash.net.navigateToURL()-methode. Deze eigenschap verwijst naar de parameter request voor die methode. De URI kan ook de vorm event:eventType hebben. Wanneer erop wordt geklikt, genereert de TextFlow een gebeurtenis van het type eventType.

Implementatie
public function get href():String
public function set href(value:String):void

Verwante API-elementen

flash.net.navigateToURL()

linkState

eigenschap

linkState:String [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

De huidige status van de koppeling.

Implementatie
public function get linkState():String

Verwante API-elementen

LinkState

target

eigenschap

target:String

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

De doelwaarde die is gekoppeld aan het LinkElement. Mogelijke waarden zijn "_self", "_blank", "_parent" en "_top". Deze waarde verwijst naar de venster-parameter van de flash.net.navigateToURL()-methode.

Implementatie
public function get target():String
public function set target(value:String):void

Verwante API-elementen

flash.net.navigateToURL()

Constructordetails

()

Constructor

public function LinkElement()

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Constructor: maakt een nieuwe LinkElement-instantie.

Methodedetails

addEventListener

()

methode

 public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. U kunt gebeurtenislisteners registreren op alle knooppunten in het weergaveoverzicht van een specifiek type gebeurtenis, fase of prioriteit.

Nadat het registreren van een gebeurtenislistener is voltooid, kunt u de prioriteit ervan niet wijzigen door extra aanroepen van addEventListener(). Wanneer u de prioriteit van een listener wilt wijzigen, moet u eerst removeEventListener() aanroepen. U kunt de listener opnieuw registreren met het nieuwe prioriteitsniveau.

Nadat de listener is geregistreerd, resulteren volgende aanroepen van addEventListener() met een andere waarde voor type of useCapture in het maken van een afzonderlijke listenerregistratie. Wanneer u bijvoorbeeld eerst een listener registreert bij useCapture ingesteld op true, luistert deze alleen tijdens de vastlegfase. Wanneer u addEventListener() opnieuw aanroept met hetzelfde listenerobject maar met useCapture ingesteld op false, hebt u twee afzonderlijke listeners: één die tijdens de vastlegfase luistert en één die tijdens de doel- en terugkoppelfasen luistert.

U kunt geen gebeurtenislistener registeren voor alleen de doel- of terugkoppelfase. Deze fasen worden bij de registratie gekoppeld, omdat terugkoppeling alleen van toepassing is op voorouders van het doelknooppunt.

Wanneer u een gebeurtenislistener niet langer nodig hebt, kunt u deze verwijderen door EventDispatcher.removeEventListener() aan te roepen; anders kan dit resulteren in geheugenproblemen. Objecten met geregistreerde gebeurtenislisteners worden niet automatisch verwijderd uit het geheugen, omdat de opschoonfunctie geen objecten verwijdert waar nog verwijzingen naar bestaan.

Het kopiëren van een instantie EventDispatcher kopieert de daaraan gekoppelde gebeurtenislisteners. (Wanneer uw nieuwe knooppunt een gebeurtenislistener nodig heeft, moet u de listener eraan koppelen na het maken van het knooppunt.) Wanneer u echter een instantie EventDispatcher verplaatst, worden de daaraan gekoppelde listeners mee verplaatst.

Wanneer de gebeurtenislistener wordt geregistreerd op een knooppunt terwijl een gebeurtenis op dit knooppunt wordt verwerkt, wordt de gebeurtenislistener niet geactiveerd tijdens de huidige fase maar kan wel worden geactiveerd in een latere fase in de gebeurtenisstroom, zoals de terugkoppelfase.

Wanneer een gebeurtenislistener wordt verwijderd uit een knooppunt terwijl een gebeurtenis wordt verwerkt op het knooppunt, wordt deze nog steeds geactiveerd door de huidige handelingen. Nadat deze is verwijderd, wordt de gebeurtenislistener niet meer aangeroepen (tenzij deze opnieuw wordt geregistreerd voor toekomstige verwerking).

Parameters

	`type:String` — Het type gebeurtenis.

	`listener:Function` — De listenerfunctie die de gebeurtenis verwerkt. Deze functie moet een gebeurtenisobject accepteren als de enige parameter en niets retourneren, zoals in dit voorbeeld wordt getoond: `function(evt:Event):void` De functie kan elke naam hebben.

	`useCapture:Boolean` (default = `false`) — Bepaalt of de listener werkt in de vastleg-, doel- en terugkoppelfase. Wanneer `useCapture` wordt ingesteld op `true`, verwerkt de listener de gebeurtenis alleen tijdens de vastlegfase en niet tijdens de doel- of terugkoppelfase. Wanneer `useCapture` wordt ingesteld op `false`, verwerkt de listener de gebeurtenis alleen tijdens de doel- of terugkoppelfase. Wanneer u in alle drie de fasen naar de gebeurtenis wilt luisteren, roept u `addEvenListener()` tweemaal aan, één keer met `useCapture` ingesteld op `true` en één keer met `useCapture` ingesteld op `false`.

	`priority:int` (default = `0`) — Het prioriteitsniveau van de gebeurtenislistener. Prioriteiten worden opgegeven door een 32-bits geheel getal. Hoe hoger het getal, hoe hoger de prioriteit. Alle listeners met een prioriteit n worden verwerkt voor listeners met een prioriteit n -1. Wanneer twee of meer listeners dezelfde prioriteit hebben, worden ze verwerkt in de volgorde waarin ze werden toegevoegd. De standaardprioriteit is 0.

	`useWeakReference:Boolean` (default = `false`) — Bepaalt of de verwijzing van de listener sterk of zwak is. Een sterke verwijzing (standaard) voorkomt dat uw listener wordt opgeschoond. Een zwakke verwijzing doet dat niet. Lidfuncties op klasseniveau worden niet opgeschoond. U kunt dus `useWeakReference` op `true` instellen voor deze functies zonder dat deze zullen worden opgeschoond. Wanneer u `useWeakReference` op `true` instelt voor een listener die een geneste binnenfunctie is, wordt de functie wel opgeschoond en is deze niet meer blijvend. Wanneer u verwijzingen naar de binnenfunctie maakt (deze opslaat in een andere variabele), wordt de functie niet opgeschoond en blijft deze blijvend.

dispatchEvent

()

methode

public function dispatchEvent(evt:Event):Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Verzendt een gebeurtenis naar de gebeurtenisstroom. Het doel van de gebeurtenis is het object EventDispatcher waar dispatchEvent() op wordt aangeroepen.

Parameters

evt:Event — Het gebeurtenisobject dat naar de gebeurtenisflow is verzonden.

Geretourneerde waarde

Boolean — Een waarde true tenzij preventDefault() wordt aangeroepen voor de gebeurtenis; in dat geval wordt false geretourneerd.

hasEventListener

()

methode

public function hasEventListener(type:String):Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. Op die manier kunt u bepalen waar een object EventDispatcher het afhandelen van een gebeurtenis in de hiërarchie van de gebeurtenisstroom heeft gewijzigd. Wanneer u wilt bepalen of een specifiek gebeurtenistype daadwerkelijk een gebeurtenislistener activeert, kunt u IEventDispatcher.willTrigger() gebruiken.

Het verschil tussen hasEventListener() en willTrigger() is dat hasEventListener() alleen het object controleert waar het toe behoort, terwijl willTrigger() de gehele gebeurtenisstroom controleert voor de gebeurtenis die is opgegeven door de parameter type.

Parameters

type:String — Het type gebeurtenis.

Geretourneerde waarde

Boolean — De waarde true wanneer de listener van een specifiek type is geregistreerd; anders false.

removeEventListener

()

methode

public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Verwijdert een listener uit het object EventDispatcher. Wanneer geen overeenkomende listener is geregistreerd bij het object EventDispatcher, heeft een aanroep van deze methode geen invloed.

Parameters

	`type:String` — Het type gebeurtenis.

	`listener:Function` — Het listenerobject dat wordt verwijderd.

	`useCapture:Boolean` (default = `false`) — Geeft aan of de listener is geregistreerd voor de vastleg-, doel- en terugkoppelfase. Wanneer de listener is geregistreerd voor zowel de vastlegfase als de doel- en terugkoppelfase, zijn twee aanroepen van `removeEventListener()` nodig om ze allebei te verwijderen: één aanroep met `useCapture` ingesteld op `true` en een andere met `useCapture` ingesteld op `false`.

willTrigger

()

methode

public function willTrigger(type:String):Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. Deze methode retourneert true wanneer een gebeurtenislistener wordt geactiveerd tijdens een willekeurige fase van de gebeurtenisstroom wanneer een gebeurtenis van het opgegeven type wordt verzonden naar dit object EventDispatcher of een van de afstammingen.

Parameters

type:String — Het type gebeurtenis.

Geretourneerde waarde

Boolean — De waarde true wanneer de listener van een specifiek type wordt geactiveerd; anders false.

Gebeurtenisdetails

click

Gebeurtenis

Type gebeurtenisobject: flashx.textLayout.events.FlowElementMouseEvent
eigenschap FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.CLICK

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Verzonden wanneer er op de koppeling wordt geklikt. Clients kunnen negeren hoe de koppeling met de gebeurtenis omgaat door deze zelf te beheren en preventDefault() aan te roepen.

Definieert de waarde van de eigenschap type van een gebeurtenisobject click.

mouseDown

Gebeurtenis

Type gebeurtenisobject: flashx.textLayout.events.FlowElementMouseEvent
eigenschap FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.MOUSE_DOWN

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Verzonden wanneer op de muis wordt geklikt als deze zich boven de koppeling bevindt.

Definieert de waarde van de eigenschap type van een gebeurtenisobject mouseDown.

mouseMove

Gebeurtenis

Type gebeurtenisobject: flashx.textLayout.events.FlowElementMouseEvent
eigenschap FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.MOUSE_MOVE

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Verzonden wanneer de muis zich over de koppeling verplaatst.

Definieert de waarde van de eigenschap type van een gebeurtenisobject mouseMove.

mouseUp

Gebeurtenis

Type gebeurtenisobject: flashx.textLayout.events.FlowElementMouseEvent
eigenschap FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.MOUSE_UP

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Verzonden wanneer de muis wordt losgeklikt boven de koppeling.

Definieert de waarde van de eigenschap type van een gebeurtenisobject mouseUp.

rollOut

Gebeurtenis

Type gebeurtenisobject: flashx.textLayout.events.FlowElementMouseEvent
eigenschap FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.ROLL_OUT

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Verzonden wanneer de muis zich niet meer in de koppeling bevindt.

Definieert de waarde van de eigenschap type van een gebeurtenisobject rollOut.

rollOver

Gebeurtenis

Type gebeurtenisobject: flashx.textLayout.events.FlowElementMouseEvent
eigenschap FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.ROLL_OVER

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Verzonden wanneer de muis zich voor het eerst in de koppeling bevindt.

Definieert de waarde van de eigenschap type van een gebeurtenisobject rollOver.

Voorbeelden Hoe dit voorbeeld te gebruiken

LinkElementExample.as

In dit voorbeeld wordt een LinkElement aan een alinea toegevoegd en wordt de standaardopmaak overschreven voor de hoverstatus en wordt de koppelingstekst rood weergegeven.

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 dit voorbeeld wordt het URI-schema event: gebruikt om een gebeurtenis te genereren die ActionScript-code moet uitvoeren wanneer wordt geklikt.

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

Juridische kennisgeving | Online privacybeleid

LinkElement - AS3

Pakkettenx

Taalelementen

Bijlagen

Pakket flashx.textLayout.elements

href

linkState

target

LinkElement

addEventListener

dispatchEvent

hasEventListener

removeEventListener

willTrigger

click

mouseDown

mouseMove

mouseUp

rollOut

rollOver