ContentElement

Pakket	flash.text.engine
Klasse	public class ContentElement
Overerving	ContentElement Object
Subklassen	GraphicElement, GroupElement, TextElement

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

De klasse ContentElement dient als een basisklasse voor de elementtypen die aanwezig kunnen zijn in een GroupElement, namelijk een GraphicElement, een ander GroupElement of een TextElement.

ContentElement is een abstracte basisklasse. Daarom kunt u niet rechtstreeks een instantie van ContentElement starten. Wanneer u new ContentElement() aanroept, wordt een ArgumentError-uitzondering gegenereerd.

U kunt een ContentElement-element toewijzen aan exact één GroupElement of aan de eigenschap content van exact één tekstblok.

Verwante API-elementen

ElementFormat
GraphicElement
GroupElement
TextBlock.content
TextElement
TextLineMirrorRegion
TextRotation

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		elementFormat : ElementFormat Het ElementFormat-object dat voor het element wordt gebruikt.	ContentElement
		eventMirror : EventDispatcher Het object EventDispatcher dat kopieën ontvangt van elke gebeurtenis die naar geldige tekstregels wordt verzonden die op dit content-element zijn gebaseerd.	ContentElement
		groupElement : GroupElement [alleen-lezen] Het GroupElement-object dat dit element bevat, of null als het niet in een groep is.	ContentElement
		rawText : String [alleen-lezen] Een kopie van de tekst in het element, inclusief U+FDEF-tekens.	ContentElement
		text : String [alleen-lezen] Een kopie van de tekst in het element, exclusief U+FDEF-tekens die staan voor grafische elementen in de tekenreeks.	ContentElement
		textBlock : flash.text.engine:TextBlock [alleen-lezen] Het TextBlock waar dit element bij hoort.	ContentElement
		textBlockBeginIndex : int [alleen-lezen] De index in het tekstblok van het eerste teken van dit element.	ContentElement
		textRotation : String De rotatie die wordt toegepast op het element als een eenheid.	ContentElement
		userData : * Hiermee kan de toepassing willekeurige gegevens aan het element koppelen.	ContentElement

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0") Wanneer de constructor new ContentElement() wordt aangeroepen, wordt een ArgumentError-uitzondering gegenereerd.	ContentElement
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		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
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		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

Openbare constanten

	Constante		Gedefinieerd door
		GRAPHIC_ELEMENT : uint = 0xFDEF [statisch] Geeft de aanwezigheid van een grafisch element in de tekst aan.	ContentElement

Eigenschapdetails

elementFormat

eigenschap

elementFormat:ElementFormat

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

Het ElementFormat-object dat voor het element wordt gebruikt.

De standaardwaarde is null.

Als de eigenschap elementFormat wordt ingesteld, wordt het aangeboden ElementFormat-object vergrendeld: de eigenschap locked van het object wordt ingesteld op True. Een vergrendeld object elementFormat kan niet worden gewijzigd.

Implementatie
public function get elementFormat():ElementFormat
public function set elementFormat(value:ElementFormat):void

Verwante API-elementen

ElementFormat
TextBlock
TextElement

eventMirror

eigenschap

eventMirror:EventDispatcher

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

Het object EventDispatcher dat kopieën ontvangt van elke gebeurtenis die naar geldige tekstregels wordt verzonden die op dit content-element zijn gebaseerd. Het opgegeven object kan worden gebruikt om listeners in te stellen voor een tekstkoppeling of een ander interactief stukje tekst. Het kan namelijk moeilijk zijn tijdens runtime te bepalen welke delen van regels het resultaat zijn van bepaalde content-elementen. U kunt ook listeners gebruiken om decoraties, zoals onderstrepingen, toe te passen waarvan u de metingen pas kunt bepalen nadat de tekst is opgemaakt. De standaardwaarde is null, hetgeen betekent dat er geen gespiegelde gebeurtenissen worden verzonden.

Gebeurtenisspiegels zijn in tekstregels opgenomen als instanties van de klasse TextLineMirrorRegion. Afhankelijk van bidirectionele verwerking en regeldoorloop, kunnen een of meer spiegelgebieden worden gemaakt.

De standaardwaarde is null.

Implementatie
public function get eventMirror():EventDispatcher
public function set eventMirror(value:EventDispatcher):void

Verwante API-elementen

flash.events.EventDispatcher
TextLineMirrorRegion

groupElement

eigenschap

groupElement:GroupElement [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

Het GroupElement-object dat dit element bevat, of null als het niet in een groep is.

De standaardwaarde is null.

Implementatie
public function get groupElement():GroupElement

Verwante API-elementen

GroupElement

rawText

eigenschap

rawText:String [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

Een kopie van de tekst in het element, inclusief U+FDEF-tekens. Het Unicode-teken U+FDEF markeert de locatie van een grafisch element in de tekenreeks.

Implementatie
public function get rawText():String

text

eigenschap

text:String [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

Een kopie van de tekst in het element, exclusief U+FDEF-tekens die staan voor grafische elementen in de tekenreeks.

Implementatie
public function get text():String

Verwante API-elementen

TextElement.text

textBlock

eigenschap

textBlock:flash.text.engine:TextBlock [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

Het TextBlock waar dit element bij hoort.

De standaardwaarde is null.

Implementatie
public function get textBlock():flash.text.engine:TextBlock

Verwante API-elementen

TextBlock

textBlockBeginIndex

eigenschap

textBlockBeginIndex:int [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

De index in het tekstblok van het eerste teken van dit element. Deze waarde wordt niet in de cache opgeslagen, maar wordt berekend wanneer deze methode wordt aangeroepen.

De standaardwaarde is -1.

Implementatie
public function get textBlockBeginIndex():int

textRotation

eigenschap

textRotation:String

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

De rotatie die wordt toegepast op het element als een eenheid. Gebruik constanten van TextRotation voor deze eigenschap.

De standaardwaarde is TextRotation.ROTATE_0.

De laatste rotatie van een glyph is de som van , ElementFormat.textRotation, ContentElement.textRotation en TextBlock.lineRotation.

ContentElement.textRotation wordt gebruikt om een kort stuk tekst te maken waarvan de rotatie anders is dan de regel waar die tekst op staat. TCY-stukken in Japanse tekst zijn hiervan een voorbeeld. TCY staat voor Tate-Chu-Yoko en verwijst naar een kleine horizontale tekstrun (normaal gesproken een getal) binnen verticale Japanse tekst. Ga als volgt te werk om een alinea met verticale Japanse tekst met een TCY-stuk tekst te maken:

Stel TextBlock.lineRotation=TextRotation.ROTATE_90 in
Stel TextBlock.content in op een GroupElement dat bestaat uit drie TextElement-objecten. Het eerste van deze elementen is de Japanse tekst vóór de TCY-run, het tweede is de romeinse tekst van de TCY-run en het derde is de Japanse tekst na de TCY-run.
Stel de eigenschap textRotation van de TCY TextElement in op TextRotation.ROTATE_270. Het TCY-tekstelement draait als geheel. Het begint met een rotatie van 90 graden, die is overgeërfd van de regel. Als daar nog eens 270 graden bij opgeteld worden, komt het element weer horizontaal.

Gedraaide content-elementen kunnen niet worden genest. In elke hiërarchie van content-elementen, hoe complex ook, kan van slechts één content-element de eigenschap textRotation worden ingesteld. De volgende methoden en eigenschapinstellingen resulteren in een argumentfout als geneste rotaties worden gevonden:

ContentElement.textRotation
GroupElement.setElements
GroupElement.replaceElements

Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:

Tekenreekswaarde	Beschrijving
`TextRotation.ROTATE_0`	Element is niet gedraaid.
`TextRotation.ROTATE_90`	Element wordt 90 graden rechtsom gedraaid.
`TextRotation.ROTATE_180`	Element wordt 180 graden gedraaid.
`TextRotation.ROTATE_270`	Element wordt 270 graden rechtsom gedraaid.
`TextRotation.AUTO`	Niet ondersteund.

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

Gegenereerde uitzondering

	`ArgumentError` — Indien ingesteld op een waarde die geen lid is van TextRotation.

	`ArgumentError` — Indien ingesteld op `TextRotation.AUTO`.

	`ArgumentError` — Als de bewerking resulteert in geneste rotaties binnen GroupElement.

Verwante API-elementen

TextRotation
ElementFormat.textRotation
TextBlock.lineRotation

userData

eigenschap

public var userData:*

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee kan de toepassing willekeurige gegevens aan het element koppelen.

De standaardwaarde is null.

Constructordetails

()

Constructor

public function ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

Wanneer de constructor new ContentElement() wordt aangeroepen, wordt een ArgumentError-uitzondering gegenereerd. U kunt echter wel constructors aanroepen voor de volgende subklassen van ContentElement:

new GraphicElement()
new GroupElement()
new TextElement()

Parameters

	`elementFormat:ElementFormat` (default = `null`) — De elementopmaak voor de tekst in het element. De standaardwaarde is `null`.

	`eventMirror:EventDispatcher` (default = `null`) — Het object `EventDispatcher` dat kopieën ontvangt van elke gebeurtenis die naar geldige tekstregels wordt verzonden die op dit contentelement zijn gebaseerd. De standaardwaarde is `null`.

	`textRotation:String` (default = "`rotate0`") — De rotatie die op het element als eenheid wordt toegepast. Gebruik constanten van `TextRotation` voor deze eigenschap. De standaardwaarde is `TextRotation.ROTATE_0`.

Constantedetails

GRAPHIC_ELEMENT

Constante

public static const GRAPHIC_ELEMENT:uint = 0xFDEF

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5, Flash Lite 4

Geeft de aanwezigheid van een grafisch element in de tekst aan.

Verwante API-elementen

rawText

Juridische kennisgeving | Online privacybeleid

ContentElement - AS3

Pakkettenx

Taalelementen

Bijlagen

Pakket flash.text.engine

elementFormat

eventMirror

groupElement

rawText

text

textBlock

textBlockBeginIndex

textRotation

userData

ContentElement

GRAPHIC_ELEMENT