ElementFormat  - AS3

Bu biçimdeki öğelerin baskın satır taban çizgilerinin hizalanacağı, kapsayan öğedeki satır taban çizgisini belirtir. Bu özellik için TextBaseline sabitlerini kullanın.

TextBlock.baselineFontDescription ve TextBlock.baselineFontSize öğeleri bu mantığı geçersiz kılacak şekilde ayarlanmadığı sürece, satırdaki en büyük dikey öğe, satır taban çizgilerinin hizalamasını belirler.

Varsayılan değer TextBaseline.USE_DOMINANT_BASELINE şeklindedir.

Bu özelliğin değerlerini ayarlamak için, aşağıdaki dize değerlerini kullanın:

İlgili API Öğeleri

Bu nesne tarafından etkilenen satır öğelerinin saydamlığını belirtir. Geçerli değerler 0 (tam saydam) ile 1 (tam opak) aralığındadır. alpha özelliği 0 olarak ayarlanmış görüntüleme nesneleri görünmez olsa da etkindir.

Varsayılan değer 1'dir.

İlgili API Öğeleri

Öğenin taban çizgisi kaydırmasını piksel cinsinden belirtir.

Öğe, bu miktar kadar dominantBaseline öğesinden kaydırılır. Uzaklık değeri, öğe üyelerinin y konumuna eklenir, böylece döndürülmemiş metinde pozitif bir taban çizgisi uzaklığı, öğeyi aşağı taşırken negatif bir taban çizgisi uzaklığı, öğeyi yukarı taşır.

Varsayılan değer 0.0 olup bu, kaydırma olmadığını belirtir.

Bu metne uygulanan satır kesme olanağı. Sarma metni birden çok satır halinde kesildiğinde, hangi karakterlerin kesme için kullanılabileceğini belirler. Bu özellik için BreakOpportunity sabitlerini kullanın.

Varsayılan değer BreakOpportunity.AUTO şeklindedir.

Bu özelliğin değerlerini ayarlamak için, aşağıdaki dize değerlerini kullanın:

İlgili API Öğeleri

Metnin rengini gösterir. Üç adet 8 bit RGB bileşeni içeren bir tam sayı; örneğin, 0xFF0000 kırmızı ve 0x00FF00 yeşildir.

Varsayılan değer 0x000000 (siyah) şeklindedir.

Bu metin için kullanılan basamak durumu. Basamağın büyük/küçük harf durumu, sayısal karakterlerin stilini ve konumunu etkiler. Bu özellik için DigitCase sabitlerini kullanın.

Varsayılan değer DigitCase.DEFAULT şeklindedir.

Bu özelliğin değerlerini ayarlamak için, aşağıdaki dize değerlerini kullanın:

İlgili API Öğeleri

Bu metin için kullanılan basamak genişliği. Bu özellik için DigitWidth sabitlerini kullanın.

Varsayılan değer DigitWidth.DEFAULT şeklindedir.

Bu özelliğin değerlerini ayarlamak için, aşağıdaki dize değerlerini kullanın:

İlgili API Öğeleri

Baskın satır taban çizgisi olarak kullanılacak satır taban çizgisinin türünü belirtir. Baskın satır taban çizgisi, satırdaki öğenin dikey konumunu belirlemek için hizalama satır taban çizgisiyle hizalanır. Bu özellik için TextBaseline sabitlerini kullanın.

Öğenin içeriği, taban çizgilerini belirler. TextElement olması durumunda, font ve nokta boyutu taban çizgilerini belirler. GraphicElement olması durumunda, öğenin yüksekliği taban çizgilerini belirler.

TextBaseline.ROMAN varsayılan değerdir.

Bu özelliğin değerlerini ayarlamak için, aşağıdaki dize değerlerini kullanın:

İlgili API Öğeleri

Özellikleri bir fontu tanımlayan nesne.

Varsayılan değer, varsayılan olarak oluşturulan FontDescription nesnesidir.

fontDescription özelliği ayarlandığında, sağlanan FontDescription nesnesi kilitlenir: locked özelliği true değerine ayarlanır. Kilitlenmiş bir FontDescription değiştirilemez.

İlgili API Öğeleri

Metnin piksel olarak boyutu.

12.0 varsayılan değerdir.

Karakter aralığı, okunabilirliği artırmak için belirli karakter çiftleri arasındaki pikselleri ayarlar. Karakter aralığı tabloları olan tüm fontlar için karakter aralığı desteklenir.

Varsayılan değer Kerning.ON şeklindedir.

Bu özelliğin değerlerini ayarlamak için, Kerning sınıfındaki şu sabitleri kullanın:

İlgili API Öğeleri

Bu metin için kullanılan birleşik harf düzeyi. İki veya daha fazla harf formunun tek bir glif olarak birleşmesiyle birleşik harf oluşur. Birleşik harfler genellikle ortak bileşenleri paylaşan ardışık karakterlerin yerini alır, örn. 'fi', 'fl' veya 'ae' harf çiftleri. Bunlar hem Latince olan hem de Latince olmayan karakter kümeleriyle kullanılır. Bu özellik için LigatureLevel sabitlerini kullanın.

Varsayılan değer LigatureLevel.COMMON şeklindedir.

Bu özelliğin değerlerini ayarlamak için, aşağıdaki dize değerlerini kullanın:

İlgili API Öğeleri

Metnin yerel ayarı. Büyük/küçük harf dönüşümlerini ve şekillendirmeyi denetler. Standart yerel ayar kimlikleri kullanılır. Örneğin "en", "en_US" ve "en-US" İngilizce iken, "ja" Japonca'dır. Yerel ayar kodlarının bir listesi için bkz. iso639-2 kod listesi.

"en" varsayılan değerdir.

ElementFormat öğesinin kilitlenmiş olup olmadığını belirtir. true olursa, ElementFormat değiştirilemez. ElementFormat nesnesinin kilitlenmemiş bir kopyasını almak için, ElementFormat.clone() öğesini çağırın.

Ayrı ayrı gliflere uygulanan döndürme işlemini ayarlar. Bu özellik için TextRotation sınıfında tanımlanan sabitleri kullanın.

Varsayılan değer TextRotation.AUTO şeklindedir.

Herhangi bir glifin son dönüşü, ElementFormat.textRotation, ContentElement.textRotation ve TextBlock.lineRotation öğelerinin toplamıdır.

Genellikle, karakterlerin dikey mizanpajda düzgün şekilde görüntülenmesi için döndürülmesi gerektiği Asya metni için bu özellik uygundur. Bunu gerçekleştirmek için TextRotation.AUTO öğesini, TextBlock.lineRotation = TextRotation.ROTATE_90 ile birlikte kullanın.

Dikey mizanpaj bilgilerini içermeyen fontlarda bu özelliğin ayarlanmasıyla istenmeyen sonuçlar ortaya çıkabilir. Japonca font olan "MS Mincho" gibi vmtx veya VORG tablosu içeren fontlar, bu tablolar doğru mizanpaj için mizanpaj motorlarının gerektirdiği verileri sağladığından, düzgün çalışır. Verdana gibi gerekli bilgileri içermeyen fontlar düzgün çalışmaz.

Bu özelliğin değerlerini ayarlamak için, aşağıdaki dize değerlerini kullanın:

İlgili API Öğeleri

Her glifin soluna uygulanan, piksel cinsinden izleme veya manuel karakter aralığı. kerning etkinleştirilirse, fontun karakter aralığı tablosundaki değerlere trackingLeft değeri eklenir. kerning devre dışı bırakılırsa, elle karakter aralığı değeri olarak trackingLeft değeri kullanılır. Hem pozitif hem de negatif değerleri destekler.

Tipik olarak, istenen izleme değeri trackingRight ile trackingLeft arasında bölünür. Aksi takdirde, karma yönlülük metninde iki yönlü sınırın birinde iki izleme vardır, diğerinde ise yoktur.

0.0 varsayılan değerdir.

Örnek:

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

Her glifin sağına uygulanan, piksel cinsinden izleme veya manuel karakter aralığı. kerning etkinleştirilirse, fontun karakter aralığı tablosundaki değerlere trackingRight değeri eklenir. kerning devre dışı bırakılırsa, elle karakter aralığı değeri olarak trackingRight değeri kullanılır. Hem pozitif hem de negatif değerleri destekler.

Tipik olarak, istenen izleme değeri trackingRight ile trackingLeft arasında bölünür. Aksi takdirde, karma yönlülük metninde iki yönlü sınırın birinde iki izleme vardır, diğerinde ise yoktur.

0.0 varsayılan değerdir.

Örnek:

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

Bu metin için kullanılan tipografik durum. Bu özellik için TypographicCase sınıfında tanımlanan sabitleri kullanın.

Varsayılan değer TypographicCase.DEFAULT şeklindedir.

Bu özelliğin değerlerini ayarlamak için, aşağıdaki dize değerlerini kullanın:

İlgili API Öğeleri

Bir ElementFormat nesnesi oluşturur.

ElementFormat öğesinin kilitlenmemiş, klonlanmış bir kopyasını oluşturur.

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

fontDescription ve fontSize tarafından belirtilen fonta yönelik emBox, üst çizgi konumunu, üst çizgi kalınlığını, alt çizgi konumunu ve alt çizgi kalınlığını açıklayan özelliklere sahip bir FontMetrics nesnesi döndürür.

İlgili API Öğeleri

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

Bu örnek iki ElementFormat nesnesi oluşturur ve bunların birçok özelliğini ayarlar. Daha sonra TextBlock öğesinin içeriği olarak atanmış TextElement nesnesine yeni ElementFormats öğesini atar. Bir TextElement öğesinin ElementFormat öğesinin değiştirilmesi, üst TextBlock tarafından önceden oluşturulmuş TextLines öğesini etkilemez.

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