| Pakket | flash.text.engine |
| Klasse | public final class ElementFormat |
| Overerving | ElementFormat  Object |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Als een ElementFormat-object wordt toegepast op een ContentElement in een TextBlock, wordt het TextBlock niet ongeldig gemaakt. Nadat een ElementFormat-object is toegepast op een ContentElement, wordt de eigenschap locked van het object ingesteld op True. De eigenschappen van een vergrendeld ElementFormat-object kunnen niet worden gewijzigd. Gebruik daarom de methode clone() om een niet-vergrendelde kopie van het object te maken, die u vervolgens kunt aanpassen en toewijzen aan het ContentElement.
Verwante API-elementen
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
| alignmentBaseline : String
Geeft het type van de basislijn in het element aan, waarop de dominante basislijnen van elementen met deze indeling worden uitgelijnd. | ElementFormat | ||
| alpha : Number
Geeft de transparantie aan van de lijnelementen die door dit object worden beïnvloed. | ElementFormat | ||
| baselineShift : Number
Geeft de basislijnverschuiving voor het element in pixels aan. | ElementFormat | ||
| breakOpportunity : String
De regeleindeoptie die op deze tekst wordt toegepast. | ElementFormat | ||
| color : uint
Geeft de kleur van de tekst aan. | ElementFormat | ||
 | constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | |
| digitCase : String
Het cijfertype dat voor deze tekst wordt gebruikt. | ElementFormat | ||
| digitWidth : String
De cijferbreedte die voor deze tekst wordt gebruikt. | ElementFormat | ||
| dominantBaseline : String
Geeft het type basislijn aan, dat u als dominante basislijn moet gebruiken. | ElementFormat | ||
| fontDescription : FontDescription
Een object waarvan de eigenschappen een lettertype beschrijven. | ElementFormat | ||
| fontSize : Number
De grootte van de tekst, in pixels | ElementFormat | ||
| kerning : String
Met tekenspatiëring worden de pixels tussen bepaalde tekenparen aangepast om de leesbaarheid te verbeteren. | ElementFormat | ||
| ligatureLevel : String
Het ligatuurniveau dat voor deze tekst wordt gebruikt. | ElementFormat | ||
| locale : String
De landinstelling van de tekst. | ElementFormat | ||
| locked : Boolean
Hiermee wordt aangegeven of het object ElementFormat al dan niet vergrendeld is. | ElementFormat | ||
| textRotation : String
Stelt de rotatie in die wordt toegepast op individuele glyphs. | ElementFormat | ||
| trackingLeft : Number
De (handmatige) tekstspatiëring die links van elke glyph wordt toegepast, in pixels. | ElementFormat | ||
| trackingRight : Number
De (handmatige) tekstspatiëring die rechts van elke glyph wordt toegepast, in pixels. | ElementFormat | ||
| typographicCase : String
De typografische optie die voor deze tekst wordt gebruikt. | ElementFormat | ||
| Methode | Gedefinieerd door | ||
|---|---|---|---|
ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")
Maakt een ElementFormat-object. | ElementFormat | ||
Hiermee wordt een niet-vergrendelde, gekloonde kopie van het ElementFormat-object gemaakt. | ElementFormat | ||
Retourneert een FontMetrics-object met eigenschappen die de emBox, doorhalingspositie, doorhalingsdikte, onderstrepingspositie en onderstrepingsdikte voor het lettertype beschrijven die zijn opgegeven door fontDescription en fontSize.
| ElementFormat | ||
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
|
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | |
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
alignmentBaseline | eigenschap |
alignmentBaseline:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Geeft het type van de basislijn in het element aan, waarop de dominante basislijnen van elementen met deze indeling worden uitgelijnd. Gebruik TextBaseline-constanten voor deze eigenschap.
Het grootste verticale element op de regel bepaalt de uitlijning van de basislijnen, tenzij TextBlock.baselineFontDescription en TextBlock.baselineFontSize zijn ingesteld om die logica te overschrijven.
De standaardwaarde is TextBaseline.USE_DOMINANT_BASELINE.
Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:
| Tekenreekswaarde | Beschrijving |
|---|---|
TextBaseline.ROMAN | De dominantBaseline wordt uitgelijnd op de romeinse basislijn van de regel. |
TextBaseline.ASCENT | De dominantBaseline wordt uitgelijnd op de ascent-basislijn van de regel. |
TextBaseline.DESCENT | De dominantBaseline wordt uitgelijnd op de descent-basislijn van de regel. |
TextBaseline.IDEOGRAPHIC_TOP | De dominantBaseline wordt uitgelijnd op de ideografische top-basislijn van de regel. |
TextBaseline.IDEOGRAPHIC_CENTER | De dominantBaseline wordt uitgelijnd op de ideografische midden-basislijn van de regel. |
TextBaseline.IDEOGRAPHIC_BOTTOM | De dominantBaseline wordt uitgelijnd op de ideografische onder-basislijn van de regel. |
TextBaseline.USE_DOMINANT_BASELINE | De dominantBaseline wordt uitgelijnd op dezelfde basislijn van de regel. |
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Stelt de basislijn voor uitlijning in voor de regel waarop de dominantBaseline van het grafische element wordt uitgelijnd. |
GroupElement | Heeft geen effect. |
TextElement | Stelt de basislijn voor uitlijning in voor de regel waarop de dominantBaseline van het tekstelement wordt uitgelijnd. |
Implementatie
public function get alignmentBaseline():String public function set alignmentBaseline(value:String):voidGegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is van TextBaseline.
| |
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
Verwante API-elementen
alpha | eigenschap |
alpha:Number| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Geeft de transparantie aan van de lijnelementen die door dit object worden beïnvloed. Geldige waarden liggen tussen 0 (volledig transparant) en 1 (volledig dekkend). Weergaveobjecten met alpha ingesteld op 0 zijn actief, ook al zijn ze onzichtbaar.
De standaardwaarde is 1.
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Past de opgegeven alpha toe op het grafische element. Wordt vermenigvuldigd met een alpha die op het grafische DisplayObject zelf of op de TextLine is ingesteld. |
GroupElement | Heeft geen effect. |
TextElement | Past de opgegeven alpha toe op het tekstelement. Wordt vermenigvuldigd met elke alpha die is ingesteld op de TextLine. |
Implementatie
public function get alpha():Number public function set alpha(value:Number):voidGegenereerde uitzondering
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
Verwante API-elementen
baselineShift | eigenschap |
baselineShift:Number| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Geeft de basislijnverschuiving voor het element in pixels aan.
Het element wordt met dit aantal pixels verschoven ten opzichte van de dominantBaseline. De verschuiving wordt opgeteld bij de y-positie van de leden van het element, zodat, bij niet-gedraaide tekst, het element bij een positieve verschuiving omlaag schuift en bij een negatieve verschuiving omhoog schuift.
De standaardwaarde is 0,0, hetgeen geen verschuiving betekent.
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Verschuift de afbeelding ten opzichte van de basislijn. |
GroupElement | Heeft geen effect. |
TextElement | Verschuift de tekst ten opzichte van de basislijn. |
Implementatie
public function get baselineShift():Number public function set baselineShift(value:Number):voidGegenereerde uitzondering
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
breakOpportunity | eigenschap |
breakOpportunity:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
De regeleindeoptie die op deze tekst wordt toegepast. Deze eigenschap bepaalt welke karakters voor afbreking kunnen worden gebruikt wanneer doorlopende tekst op meerdere regels wordt afgebroken. Gebruik BreakOpportunity-constanten voor deze eigenschap.
De standaardwaarde is BreakOpportunity.AUTO.
Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:
| Tekenreekswaarde | Beschrijving |
|---|---|
BreakOpportunity.AUTO | Regeleindeopties zijn gebaseerd op standaardeigenschappen van Unicode-tekens, zoals afbreking tussen woorden en bij afbreekstreepjes. |
BreakOpportunity.ANY | Elk teken in het object ContentElement wordt behandeld als een regeleindeoptie. Deze waarde wordt meestal gebruikt wanneer romeinse tekst is ingesloten in Aziatische tekst en afbrekingen binnen woorden mogelijk moeten zijn. |
BreakOpportunity.NONE | Geen tekens in het bereik worden als regeleindeopties behandeld. |
BreakOpportunity.ALL | Alle tekens in het bereik worden behandeld als regeleindemogelijkheden, zodat er na elk teken een regeleinde komt. Nuttig voor het maken van effecten als tekst op een pad. |
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Heeft geen effect. |
GroupElement | Bepaalt de regeleindeoptie tussen aaneengrenzende tekstelementen in de groep. Als de elementFormat van de groep null is, wordt de opmaak van het eerste aangrenzende element gebruikt. |
TextElement | Bepaalt de regeleindeoptie tussen de tekens in het tekstelement. |
Implementatie
public function get breakOpportunity():String public function set breakOpportunity(value:String):voidGegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is van BreakOpportunity.
| |
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
Verwante API-elementen
color | eigenschap |
color:uint| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Geeft de kleur van de tekst aan. Een geheel getal bestaande uit drie 8-bits RGB-componenten, 0xFF0000 is bijvoorbeeld rood en 0x00FF00 is groen.
De standaardwaarde is 0x000000 (zwart).
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Heeft geen effect. |
GroupElement | Heeft geen effect. |
TextElement | Hiermee wordt de kleur van de tekst ingesteld. |
Implementatie
public function get color():uint public function set color(value:uint):voidGegenereerde uitzondering
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
digitCase | eigenschap |
digitCase:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Het cijfertype dat voor deze tekst wordt gebruikt. Cijfertype bepaalt de stijl en plaatsing van groepen numerieke tekens. Gebruik DigitCase-constanten voor deze eigenschap.
De standaardwaarde is DigitCase.DEFAULT.
Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:
| Tekenreekswaarde | Beschrijving |
|---|---|
DigitCase.DEFAULT | Past standaardcijfertype op de tekst toe. |
DigitCase.LINING | Past lijncijfertype op de tekst toe. |
DigitCase.OLD_STYLE | Past cijfertype van oude stijl op de tekst toe. |
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Heeft geen effect. |
GroupElement | Heeft geen effect. |
TextElement | Bepaalt welk cijfertype wordt gebruikt voor de tekst in het element. |
Implementatie
public function get digitCase():String public function set digitCase(value:String):voidGegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is van DigitCase.
| |
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
Verwante API-elementen
digitWidth | eigenschap |
digitWidth:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
De cijferbreedte die voor deze tekst wordt gebruikt. Gebruik DigitWidth-constanten voor deze eigenschap.
De standaardwaarde is DigitWidth.DEFAULT.
Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:
| Tekenreekswaarde | Beschrijving |
|---|---|
DigitWidth.DEFAULT | Past standaardcijferbreedte op de tekst toe. |
DigitWidth.PROPORTIONAL | Past proportionele cijferbreedte op de tekst toe. |
DigitWidth.TABULAR | Past tabcijferbreedte op de tekst toe. |
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Heeft geen effect. |
GroupElement | Heeft geen effect. |
TextElement | Bepaalt welke cijferbreedte wordt gebruikt voor de tekst in het element. |
Implementatie
public function get digitWidth():String public function set digitWidth(value:String):voidGegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is van DigitWidth.
| |
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
Verwante API-elementen
dominantBaseline | eigenschap |
dominantBaseline:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Geeft het type basislijn aan, dat u als dominante basislijn moet gebruiken. De dominante basislijn wordt uitgelijnd op de uitlijningsbasislijn, zodat de verticale positie van het element op de regel kan worden vastgesteld. Gebruik TextBaseline-constanten voor deze eigenschap.
De inhoud van het element bepaalt de basislijnen. Bij een TextElement bepalen lettertype en lettergrootte de basislijnen. Bij een GraphicElement worden de basislijnen bepaald door de hoogte van het element.
De standaardwaarde is TextBaseline.ROMAN.
Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:
| Tekenreekswaarde | Beschrijving |
|---|---|
TextBaseline.ROMAN | De romeinse basislijn van het element wordt uitgelijnd op de alignmentBaseline. |
TextBaseline.ASCENT | De ascent-basislijn van het element wordt uitgelijnd op de alignmentBaseline. |
TextBaseline.DESCENT | De descent-basislijn van het element wordt uitgelijnd op de alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_TOP | De ideografische top-basislijn van het element wordt uitgelijnd op de alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_CENTER | De ideografische midden-basislijn van het element wordt uitgelijnd op de alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_BOTTOM | De ideografische onder-basislijn van het element wordt uitgelijnd op de alignmentBaseline. |
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Bepaalt welke basislijnen van het grafische element worden uitgelijnd op de alignmentBaseline. |
GroupElement | Heeft geen effect. |
TextElement | Bepaalt welke basislijnen van het tekstelement worden uitgelijnd op de alignmentBaseline. |
Implementatie
public function get dominantBaseline():String public function set dominantBaseline(value:String):voidGegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is van TextBaseline.
| |
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
Verwante API-elementen
fontDescription | eigenschap |
fontDescription:FontDescription| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Een object waarvan de eigenschappen een lettertype beschrijven.
De standaardwaarde is een standaard geconstrueerd FontDescription-object.
Als de eigenschap fontDescription is ingesteld, wordt het aangeboden object FontDescription vergrendeld: de eigenschap locked van het object is ingesteld op true. Een vergrendeld object FontDescription kan niet worden gewijzigd.
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Heeft geen effect. |
GroupElement | Heeft geen effect. |
TextElement | Bepaalt welk lettertype wordt gebruikt voor de tekst in het element. |
Implementatie
public function get fontDescription():FontDescription public function set fontDescription(value:FontDescription):voidGegenereerde uitzondering
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
Verwante API-elementen
fontSize | eigenschap |
fontSize:Number| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
De grootte van de tekst, in pixels
De standaardwaarde is 12,0.
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Heeft geen effect. |
GroupElement | Heeft geen effect. |
TextElement | Bepaalt de tekengrootte voor de tekst in het element, in pixels. |
Implementatie
public function get fontSize():Number public function set fontSize(value:Number):voidGegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde kleiner dan nul.
| |
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
kerning | eigenschap |
kerning:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Met tekenspatiëring worden de pixels tussen bepaalde tekenparen aangepast om de leesbaarheid te verbeteren. Tekenspatiëring wordt ondersteund voor alle lettertypen die tabellen voor tekenspatiëring hebben.
De standaardwaarde is Kerning.ON.
Als u waarden wilt instellen voor deze eigenschap, kunt u de volgende constanten in de Kerning-klasse gebruiken:
| Tekenreekswaarde | Beschrijving |
|---|---|
Kerning.ON | Tekenspatiëring is ingeschakeld. |
Kerning.OFF | Tekenpatiëring is uitgeschakeld. |
Kerning.AUTO | Kerning is ingeschakeld, tenzij dit niet correct is in Aziatische typografie. Tussen twee tekens wordt tekenspatiëring toegepast als geen van beide tekens Kanji, Hiragana of Katakana is. |
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Heeft geen effect. |
GroupElement | Bepaalt of tekenspatiëring wordt toegepast tussen aaneengrenzende tekstelementen in de groep. Als de elementFormat van de groep null is, wordt de opmaak van het eerste aangrenzende element gebruikt. |
TextElement | Bepaalt of tekenspatiëring wordt toegepast tussen de tekens in het tekstelement. |
Implementatie
public function get kerning():String public function set kerning(value:String):voidGegenereerde uitzondering
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
Verwante API-elementen
ligatureLevel | eigenschap |
ligatureLevel:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Het ligatuurniveau dat voor deze tekst wordt gebruikt. Een ligatuur ontstaat wanneer twee of meer lettervormen samen één glyph vormen. Ligaturen vervangen normaal gesproken opeenvolgende tekens die gemeenschappelijke componenten hebben, zoals de letterparen 'fi', 'fl' of 'ae'. Deze worden in Latijnse en niet-Latijnse tekensets gebruikt. Gebruik LigatureLevel-constanten voor deze eigenschap.
De standaardwaarde is LigatureLevel.COMMON.
Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:
| Tekenreekswaarde | Beschrijving |
|---|---|
LigatureLevel.NONE | Er worden geen ligaturen gemaakt. |
LigatureLevel.MINIMUM | Er worden minimale ligaturen gemaakt. |
LigatureLevel.COMMON | Er worden normale ligaturen gemaakt. |
LigatureLevel.UNCOMMON | Er worden ongewone ligaturen gemaakt. |
LigatureLevel.EXOTIC | Er worden exotische ligaturen gemaakt. |
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Heeft geen effect. |
GroupElement | Bepaalt het ligatuurniveau tussen aaneengrenzende tekstelementen in de groep. Als de elementFormat van de groep null is, wordt de opmaak van het eerste aangrenzende element gebruikt. |
TextElement | Bepaalt het ligatuurniveau tussen de tekens in het tekstelement. |
Implementatie
public function get ligatureLevel():String public function set ligatureLevel(value:String):voidGegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is van LigatureLevel.
| |
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
Verwante API-elementen
locale | eigenschap |
locale:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
De landinstelling van de tekst. Bepaalt transformaties en vormen van letters. Er wordt gebruik gemaakt van standaardlandinstellings-id's. Bijvoorbeeld 'en', 'en_US' en 'en-US' zijn id's voor Engels en 'ja' voor Japans. Raadpleeg iso639-2 code list voor een lijst met landinstellingscodes.
De standaardwaarde is 'en'.
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Heeft geen effect. |
GroupElement | Heeft geen effect. |
TextElement | Bepaalt de transformaties en vormen voor de tekst in het element. |
Implementatie
public function get locale():String public function set locale(value:String):voidGegenereerde uitzondering
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
locked | eigenschap |
locked:Boolean| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Hiermee wordt aangegeven of het object ElementFormat al dan niet vergrendeld is. true betekent dat het object ElementFormat niet kan worden gewijzigd. Roep ElementFormat.clone() aan om een niet-vergrendelde versie van het object ElementFormat te maken.
Implementatie
public function get locked():Boolean public function set locked(value:Boolean):voidGegenereerde uitzondering
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
textRotation | eigenschap |
textRotation:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Stelt de rotatie in die wordt toegepast op individuele glyphs. Gebruik constanten die zijn gedefinieerd in de TextRotation-klasse voor deze eigenschap.
De standaardwaarde is TextRotation.AUTO.
De laatste rotatie van een glyph is de som van , ElementFormat.textRotation, ContentElement.textRotation en TextBlock.lineRotation.
Deze eigenschap wordt voornamelijk gebruikt voor Aziatische tekst waarbij de karakters moeten worden gedraaid voor een correcte weergave bij een verticale indeling. Gebruik TextRotation.AUTO in combinatie met TextBlock.lineRotation = TextRotation.ROTATE_90 om dit te bewerkstelligen.
Als u deze eigenschappen instelt op lettertypen die geen verticale-opmaakinformatie bevatten, kan dit ongewenste resultaten geven. Lettertypen met een vmtx- of VORG-tabel, zoals het Japanse lettertype 'MS Mincho', werken goed omdat die tabellen de gegevens verschaffen die de opmaakengine nodig heeft om de opmaak correct uit te voeren. Lettertypen als Verdana, die niet de benodigde informatie bevatten, doen dit niet.
Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:
| Tekenreekswaarde | Beschrijving |
|---|---|
TextRotation.ROTATE_0 | Glyphs worden niet gedraaid. |
TextRotation.ROTATE_90 | Glyphs worden 90 graden rechtsom gedraaid. |
TextRotation.ROTATE_180 | Glyphs worden 180 graden gedraaid. |
TextRotation.ROTATE_270 | Glyphs worden 270 graden rechtsom gedraaid. |
TextRotation.AUTO | Geeft een rotatie van 90 graden tegen de klok in aan, alleen voor volle breedte en brede glyphs, zoals bepaald door de Unicode-eigenschappen van de glyph. Deze waarde wordt gewoonlijk gebruikt bij Aziatische tekst om alleen die glyphs te draaien waarvoor rotatie vereist is. Deze rotatie wordt alleen in verticale tekst toegepast om brede karakters op volle breedte in een verticale stand te zetten zonder andere karakters te draaien. |
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Heeft geen effect. |
GroupElement | Heeft geen effect. |
TextElement | Bepaalt de rotatie van de glyphs in het tekstelement. |
Implementatie
public function get textRotation():String public function set textRotation(value:String):voidGegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is van TextRotation.
| |
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
Verwante API-elementen
trackingLeft | eigenschap |
trackingLeft:Number| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5., Flash Lite 4 |
De (handmatige) tekstspatiëring die links van elke glyph wordt toegepast, in pixels. Als tekenspatiëring is ingeschakeld, wordt de waarde voor trackingLeft opgeteld bij de waarden in de tekenspatiëringstabel voor het lettertype. Als tekenspatiëring is uitgeschakeld, wordt de waarde voor trackingLeft gebruikt als een waarde voor handmatige tekenspatiëring. Ondersteunt zowel positieve als negatieve waarden.
De gewenste waarde voor tekstspatiëring wordt normaal gesproken gesplitst tussen trackingRight en trackingLeft. Anders is er, bij tekst met gemengde richtingen, tweemaal de tekstspatiëring bij de ene bidirectionele begrenzing en geen bij de andere.
De standaardwaarde is 0.0.
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Bepaalt welke tekstspatiëring wordt toegepast aan de linkerkant van de afbeelding. |
GroupElement | Heeft geen effect. |
TextElement | Bepaalt welke tekstspatiëring wordt toegepast aan de linkerkant van karakters in het tekstelement. |
Voorbeeld:
//positive tracking added to kerning
var ef1:ElementFormat = new ElementFormat();
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingLeft = 0.5;
//negative manual kerning
var ef2:ElementFormat = new ElementFormat();
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.trackingLeft = -1.0;
Implementatie
public function get trackingLeft():Number public function set trackingLeft(value:Number):voidGegenereerde uitzondering
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
trackingRight | eigenschap |
trackingRight:Number| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5., Flash Lite 4 |
De (handmatige) tekstspatiëring die rechts van elke glyph wordt toegepast, in pixels. Als tekenspatiëring is ingeschakeld, wordt de waarde voor trackingRight opgeteld bij de waarden in de tekenspatiëringstabel voor het lettertype. Als tekenspatiëring is uitgeschakeld, wordt de waarde voor trackingRight gebruikt als een waarde voor handmatige tekenspatiëring. Ondersteunt zowel positieve als negatieve waarden.
De gewenste waarde voor tekstspatiëring wordt normaal gesproken gesplitst tussen trackingRight en trackingLeft. Anders is er, bij tekst met gemengde richtingen, tweemaal de tekstspatiëring bij de ene bidirectionele begrenzing en geen bij de andere.
De standaardwaarde is 0.0.
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Bepaalt welke tekstspatiëring wordt toegepast aan de rechterkant van de afbeelding. |
GroupElement | Heeft geen effect. |
TextElement | Bepaalt welke tekstspatiëring wordt toegepast aan de rechterkant van karakters in het tekstelement. |
Voorbeeld:
//positive tracking added to kerning
var ef1:ElementFormat = new ElementFormat();
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingRight = 0.5;
//negative manual kerning
var ef2:ElementFormat = new ElementFormat();
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.trackingRight = -1.0;
Implementatie
public function get trackingRight():Number public function set trackingRight(value:Number):voidGegenereerde uitzondering
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
typographicCase | eigenschap |
typographicCase:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
De typografische optie die voor deze tekst wordt gebruikt. Gebruik constanten die zijn gedefinieerd in de TypographicCase-klasse voor deze eigenschap.
De standaardwaarde is TypographicCase.DEFAULT.
Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:
| Tekenreekswaarde | Beschrijving |
|---|---|
TypographicCase.DEFAULT | Geeft aan dat de standaardinstelling voor hoofdletters en kleine letters wordt gebruikt voor alle tekens. |
TypographicCase.TITLE | Geeft aan dat hoofdletters bij afdrukken titelglyphs gebruiken. |
TypographicCase.CAPS | Geeft aan dat de spatiëring bij afdrukken wordt aangepast voor hoofdletters. |
TypographicCase.SMALL_CAPS | Geeft aan dat hoofdletters bij afdrukken glyphs in kleine kapitalen gebruiken. |
TypographicCase.UPPERCASE | Geeft aan dat alle tekens bij afdrukken glyphs in hoofdletters gebruiken. |
TypographicCase.LOWERCASE | Geeft aan dat alle tekens bij afdrukken glyphs in kleine letters gebruiken. |
TypographicCase.CAPS_AND_SMALL_CAPS | Geeft aan dat kleine letters bij afdrukken glyphs in kleine kapitalen gebruiken. |
| Subklasse | Effect van ingestelde eigenschap |
|---|---|
GraphicElement | Heeft geen effect. |
GroupElement | Heeft geen effect. |
TextElement | Bepaalt welke typografische optie wordt gebruikt voor de tekst in het element. |
Implementatie
public function get typographicCase():String public function set typographicCase(value:String):voidGegenereerde uitzondering
ArgumentError — Indien ingesteld op een waarde die geen lid is van TypographicCase.
| |
IllegalOperationError — Als het instellen gebeurt nadat het ElementFormat-object is vergrendeld (locked is true).
|
Verwante API-elementen
ElementFormat | () | Constructor |
public function ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Maakt een ElementFormat-object.
ParametersfontDescription:FontDescription (default = null)null. Als er geen lettertypebeschrijving is gegeven, wordt een standaardbeschrijving gemaakt.
| |
fontSize:Number (default = 12.0) | |
color:uint (default = 0x000000) | |
alpha:Number (default = 1.0)alpha die wordt toegepast op alle regelatomen op basis van de elementopmaak.
| |
textRotation:String (default = "auto") | |
dominantBaseline:String (default = "roman") | |
alignmentBaseline:String (default = "useDominantBaseline") | |
baselineShift:Number (default = 0.0) | |
kerning:String (default = "on") | |
trackingRight:Number (default = 0.0) | |
trackingLeft:Number (default = 0.0) | |
locale:String (default = "en") | |
breakOpportunity:String (default = "auto") | |
digitCase:String (default = "default") | |
digitWidth:String (default = "default") | |
ligatureLevel:String (default = "common") | |
typographicCase:String (default = "default") |
Gegenereerde uitzondering
ArgumentError — De opgegeven FontSize is kleiner dan 0.
| |
ArgumentError — De opgegeven textRotation is geen lid van TextRotation.
| |
ArgumentError — De opgegeven dominantBaseline is geen lid van TextBaseline.
| |
ArgumentError — De opgegeven alignmentBaseline is geen lid van TextBaseline.
| |
ArgumentError — De opgegeven kerning is geen lid van Kerning.
| |
ArgumentError — De opgegeven breakOpportunity is geen lid van BreakOpportunity.
| |
ArgumentError — De opgegeven digitCase is geen lid van DigitCase.
| |
ArgumentError — De opgegeven digitWidth is geen lid van DigitWidth.
| |
ArgumentError — De opgegeven ligatureLevel is geen lid van LigatureLevel.
| |
ArgumentError — De opgegeven typographicCase is geen lid van TypographicCase.
|
clone | () | methode |
public function clone():ElementFormat| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Hiermee wordt een niet-vergrendelde, gekloonde kopie van het ElementFormat-object gemaakt.
Geretourneerde waardeElementFormat — Een niet-vergrendelde kopie van het ElementFormat-object.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
In dit voorbeeld wordt een ElementFormat-object gemaakt en wordt de eigenschap FontSize van het object ingesteld. Er wordt een nieuw TextElement gemaakt, met het object ElementFormat (wat resulteert in een vergrendeld element), waarna het TextElement wordt gebruikt als inhoud voor een TextBlock. Van het TextBlock wordt een regel tekst gemaakt.
Als u het object ElementFormat wilt wijzigen, controleert u eerst de eigenschap locked van het object. Als deze eigenschap is ingesteld op true, gebruikt u de methode clone() om een niet-vergrendelde kopie van het object ElementFormat te maken. Vervolgens wijzigt u de eigenschappen van de kopie en koppelt u het nieuwe object ElementFormat aan het TextBlock. Wanneer de regels opnieuw worden afgebroken, gelden de nieuwe lettertype-instellingen voor de nieuwe regels.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class ElementFormat_cloneExample extends Sprite {
private var ef1:ElementFormat;
private var ef2:ElementFormat;
public function ElementFormat_cloneExample():void {
var fd:FontDescription = new FontDescription();
fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
fd.fontName = "Palatino";
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize=20;
var str:String = "This is flash text 0123456789";
var tb:TextBlock = new TextBlock();
var te1:TextElement = new TextElement(str, ef1);
tb.content = te1;
var line1:TextLine = tb.createTextLine(null, 600);
addChild(line1);
ef2 = (ef1.locked) ? ef1.clone() : ef1;
ef2.fontSize = 32;
tb.content.elementFormat=ef2;
var line2:TextLine = tb.createTextLine(null, 600);
addChild(line2);
}
}
}
getFontMetrics | () | methode |
public function getFontMetrics():FontMetrics| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Retourneert een FontMetrics-object met eigenschappen die de emBox, doorhalingspositie, doorhalingsdikte, onderstrepingspositie en onderstrepingsdikte voor het lettertype beschrijven die zijn opgegeven door fontDescription en fontSize
FontMetrics — Een FontMetrics-object dat de eigenschappen van het lettertype beschrijft die zijn aangegeven door fontDescription.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
ElementFormat-object gemaakt waaraan een FontDescription is toegewezen en wordt de methode getFontMetrics gebruikt om metingen voor het gekozen lettertype met 24 punten weer te geven.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class FontMetricsExample extends Sprite {
public function FontMetricsExample():void {
var fd:FontDescription = new FontDescription();
fd.fontName = "Garamond";
fd.fontWeight = flash.text.engine.FontWeight.BOLD;
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize = 24;
var fm1:FontMetrics = ef1.getFontMetrics();
trace(fm1.emBox);
trace(fm1.strikethroughOffset);
trace(fm1.strikethroughThickness);
trace(fm1.subscriptScale);
trace(fm1.subscriptOffset);
trace(fm1.superscriptScale);
trace(fm1.superscriptOffset);
trace(fm1.underlineOffset);
trace(fm1.underlineThickness);
}
}
}
In dit voorbeeld worden twee ElementFormat-objecten gemaakt en diverse eigenschappen voor die objecten ingesteld. Daarna worden de nieuwe ElementFormat-objecten toegewezen aan een TextElement-object dat is toegewezen als de inhoud van een TextBlock. Let erop dat als u de ElementFormat van een TextElement wijzigt, dit niet van invloed is op tekstregels die al eerder zijn gemaakt met het bovenliggende TextBlock.
package {
import flash.display.Sprite;
import flash.text.engine.*;
public class ElementFormatExample extends Sprite {
public function ElementFormatExample():void {
var fd:FontDescription = new FontDescription();
fd.fontName = "Garamond";
fd.fontWeight = flash.text.engine.FontWeight.BOLD;
var ef1:ElementFormat = new ElementFormat(fd);
ef1.fontSize = 30;
ef1.color = 0xFF0000;
ef1.alpha = 100;
ef1.kerning = flash.text.engine.Kerning.ON;
ef1.trackingRight = 2;
ef1.typographicCase = flash.text.engine.TypographicCase.UPPERCASE;
ef1.alignmentBaseline = flash.text.engine.TextBaseline.DESCENT;
ef1.ligatureLevel = flash.text.engine.LigatureLevel.EXOTIC;
var ef2:ElementFormat = new ElementFormat(fd);
ef2.fontSize = 30;
ef2.color = 0xFF0000;
ef2.alpha = 0.3;
ef2.kerning = flash.text.engine.Kerning.OFF;
ef2.typographicCase = flash.text.engine.TypographicCase.LOWERCASE;
ef2.digitCase = flash.text.engine.DigitCase.OLD_STYLE;
ef2.textRotation = flash.text.engine.TextRotation.ROTATE_180;
var str:String = "This is flash text 0123456789";
var tb:TextBlock = new TextBlock();
var te1:TextElement = new TextElement(str, ef1);
tb.content = te1;
var line1:TextLine = tb.createTextLine(null, 600);
addChild(line1);
line1.x = 15;
line1.y = 30;
tb.content.elementFormat = ef2;
var line2:TextLine = tb.createTextLine(null, 600);
addChild(line2);
line2.x = 15;
line2.y = 60;
}
}
}
Wed Jun 13 2018, 11:42 AM Z