ElementFormat  - AS3

Anger den typ av baslinje i behållarelementet efter vilken dominanta baslinjer i element med det här formatet ska justeras. Använd TextBaseline-konstanter för den här egenskapen.

Baslinjejusteringen avgörs av radens största lodräta elementet, om inte TextBlock.baselineFontDescription och TextBlock.baselineFontSize har ställts in så att de åsidosätter detta.

Standardvärdet är TextBaseline.USE_DOMINANT_BASELINE.

Använd följande strängvärden när du ska ange värden för den här egenskapen:

Relaterade API-element

Anger genomskinlighet för de radelement som påverkas av det här objektet. Giltiga värden är från 0 (helt genomskinlig) till 1 (helt ogenomskinlig). Visningsobjekt med alpha inställt på 0 är aktiva trots att de är osynliga.

Standardvärdet är 1.

Relaterade API-element

Anger baslinjeförflyttning för elementet i pixlar.

Så här mycket flyttas elementet från dominantBaseline. Förskjutningen adderas till y-positionen för medlemmarna av elementet. I text som inte roteras innebär en positiv baslinjeförflyttning att elementet flyttas nedåt och en negativ baslinjeförflyttning att elementet flyttas uppåt.

Standardvärdet är 0.0, vilket anger att ingen förflyttning görs.

Radbrytningsmöjligheten som används i denna text. Denna egenskap avgör vilka tecken som kan användas för radbrytning när text bryts ned till flera rader. Använd BreakOpportunity-konstanter för den här egenskapen.

Standardvärdet är BreakOpportunity.AUTO.

Använd följande strängvärden när du ska ange värden för den här egenskapen:

Relaterade API-element

Anger textens färg. Ett heltal som innehåller tre 8-bitars RGB-komponenter. 0xFF0000 är t.ex. rött och 0x00FF00 är grönt.

Standardvärdet är 0x000000, vilket är svart.

Det skiftläge för siffror som används för den här texten. Skiftläge för siffror påverkar format och positionering på grupper av numeriska tecken. Använd DigitCase-konstanter för den här egenskapen.

Standardvärdet är DigitCase.DEFAULT.

Använd följande strängvärden när du ska ange värden för den här egenskapen:

Relaterade API-element

Den sifferbredd som används för den här texten. Använd DigitWidth-konstanter för den här egenskapen.

Standardvärdet är DigitWidth.DEFAULT.

Använd följande strängvärden när du ska ange värden för den här egenskapen:

Relaterade API-element

Anger den typ av baslinje som ska användas som dominant baslinje. Den dominanta baslinjen justeras efter justeringsbaslinjen för att avgöra elementets lodräta position på raden. Använd TextBaseline-konstanter för den här egenskapen.

Innehållet i elementet avgör baslinjerna. För TextElement avgörs baslinjerna av teckensnittet och punktstorleken. För GraphicElement avgörs baslinjerna av elementets höjd.

Standardvärdet är TextBaseline.ROMAN.

Använd följande strängvärden när du ska ange värden för den här egenskapen:

Relaterade API-element

Ett objekt vars egenskaper beskriver ett teckensnitt.

Standardvärdet är ett standardkonstruerat FontDescription-objekt.

När egenskapen fontDescription anges låses det angivna FontDescription-objektet: dess locked-egenskap får värdet true. En låst FontDescription går inte att ändra.

Relaterade API-element

Textstorleken i pixlar.

Standardvärdet är 12.0.

Kerning justerar pixlarna mellan vissa teckenpar för att öka läsbarheten. Kerning stöds för alla teckensnitt som har kerningtabeller.

Standardvärdet är Kerning.ON.

Ange värden för den här egenskapen med följande konstanter i klassen Kerning:

Relaterade API-element

Den ligaturnivå som används för den här texten. En ligatur inträffar där två eller flera bokstavsformer sammanfogas som en enda glyf. Ligaturer ersätter vanligtvis konsekutiva tecken som delar gemensamma komponenter, till exempel bokstavspar 'fi', 'fl' eller 'ae'. De används med både latinska och icke-latinska teckenuppsättningar. Använd LigatureLevel-konstanter för den här egenskapen.

Standardvärdet är LigatureLevel.COMMON.

Använd följande strängvärden när du ska ange värden för den här egenskapen:

Relaterade API-element

Textens språkinställning. Styr skiftlägesomvandlingar och -formning. Standardidentifierare för språk används. Till exempel används "en", "en_US" och "en-US" för engelska och "ja" för japanska. Den här iso639-2-kodlistan innehåller en lista över språkkoder.

Standardvärdet är "en".

Anger om ElementFormat är låst. Om true, går det inte att ändra ElementFormat. Anropa ElementFormat.clone() för att hämta en olåst kopia av ElementFormat-objektet.

Ställer in rotationen som används för enskilda glyfer. Använd konstanter som definieras i klassen TextRotation för den här egenskapen.

Standardvärdet är TextRotation.AUTO.

Den slutliga rotationen för en glyf är summan av ElementFormat.textRotation, ContentElement.textRotation och TextBlock.lineRotation.

Den här egenskapen används vanligtvis för asiatisk text, där tecknen måste roteras för att visas korrekt i en lodrät layout. Använd TextRotation.AUTO i kombination med TextBlock.lineRotation = TextRotation.ROTATE_90 för att uppnå detta.

Om den här egenskapen anges för teckensnitt som inte innehåller lodrät layoutinformation kan det ge oönskade resultat. Teckensnitt som innehåller en vmtx- eller VORG-tabell, t.ex. det japanska teckensnittet MS Mincho, fungerar korrekt eftersom tabellerna anger de data som layoutmotorn kräver för korrekt layout. Teckensnitt, t.ex. Verdana, som inte innehåller den nödvändiga informationen gör inte det.

Använd följande strängvärden när du ska ange värden för den här egenskapen:

Relaterade API-element

Den spårning eller manuella kerning som används till vänster om varje glyf i pixlar. Om kerning är aktiverad läggs trackingLeft-värdet till bland värdena i kerningtabellen för teckensnittet. Om kerning är inaktiverad används trackingLeft-värdet som ett manuellt kerningvärde. Stöder både positiva och negativa värden.

Det önskade spårningsvärdet delas vanligtvis mellan trackingRight och trackingLeft. Annars är spårningen i text med blandad riktning dubbelt så stor som spårning vid en bidi-gräns och ingen vid den andra.

Standardvärdet är 0.0.

Exempel:

          //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;
     

Den spårning eller manuella kerning som används till höger om varje glyf i pixlar. Om kerning är aktiverad läggs trackingRight-värdet till bland värdena i kerningtabellen för teckensnittet. Om kerning är inaktiverad används trackingRight-värdet som ett manuellt kerningvärde. Stöder både positiva och negativa värden.

Det önskade spårningsvärdet delas vanligtvis mellan trackingRight och trackingLeft. Annars är spårningen i text med blandad riktning dubbelt så stor som spårning vid en bidi-gräns och ingen vid den andra.

Standardvärdet är 0.0.

Exempel:

          //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;
     

Den skiftlägestypografi som används för den här texten. Använd konstanter som definieras i klassen TypographicCase för den här egenskapen.

Standardvärdet är TypographicCase.DEFAULT.

Använd följande strängvärden när du ska ange värden för den här egenskapen:

Relaterade API-element

Skapar ett ElementFormat-objekt.

Skapar en olåst, klonad kopia av ElementFormat.

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

Returnerar ett FontMetrics-objekt med egenskaper som beskriver emBox, genomstrykningsposition, genomstrykningstjocklek, understrykningsposition och understrykningstjocklek för det teckensnitt som anges av fontDescription och fontSize.

Relaterade API-element

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

Det här exemplet skapar två ElementFormat-objekt och ställer in flera av deras egenskaper. Exemplet tilldelar sedan de nya ElementFormats till ett TextElement-objekt, som har tilldelats som innehåll för ett TextBlock. Observera att om du ändrar ElementFormat för ett TextElement påverkas inte TextLines som tidigare har skapats av överordnat 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;
            
        }
    }    
}