Paket | flash.text.engine |
Sınıf | public final class FontDescription |
Miras Alma | FontDescription Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
ElementFormat öğesine bir FontDescription nesnesi uygulanır daha sonra da bu öğe TextBlock öğesindeki bir ContentElement öğesine uygulanır. ElementFormat öğesine bir FontDescription uygulandıktan sonra, locked
özelliği true
değerine ayarlanır. Kilitlenmiş bir FontDescription nesnesinin özellikleri değiştirilemez. Bunun yerine, değiştirilip ElementFormat öğesine atanabilen, nesnenin kilitlenmemiş bir kopyasını oluşturmak için clone()
yöntemini kullanın.
Not: FTE (Flash Text Engine), Type 1 fontları veya Type 3, ATC, sfnt-sarılı CID ya da Naked CID gibi bitmap fontlarını desteklemez.
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
cffHinting : String
Bu metin için kullanılan CFF düzeltme türü. | FontDescription | ||
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
fontLookup : String
Fontun nasıl aranması gerektiğini belirtir. | FontDescription | ||
fontName : String
Kullanılacak fontun adı veya font adlarının virgülle ayrılmış bir listesi. | FontDescription | ||
fontPosture : String
Font duruşunu belirtir. | FontDescription | ||
fontWeight : String
Font ağırlığını belirtir. | FontDescription | ||
locked : Boolean
FontDescription öğesinin kilitlenmiş olup olmadığını belirtir. | FontDescription | ||
renderingMode : String
Bu metin için kullanılan oluşturma modu. | FontDescription |
Yöntem | Tanımlayan: | ||
---|---|---|---|
FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")
Bir FontDescription nesnesi oluşturur. | FontDescription | ||
FontDescription öğesinin kilitlenmemiş, klonlanmış bir kopyasını oluşturur. | FontDescription | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
[statik]
Belirtilen fontName, fontWeight ve fontPosture ile kullanılabilir bir aygıt fontu varsa, true değerini döndürür. | FontDescription | ||
[statik]
Gömülü bir font, belirtilen fontName, fontWeight ve fontPosture ile mevcutsa, true değerini döndürür; burada Font.fontType, flash.text.FontType.EMBEDDED_CFF öğesidir. | FontDescription | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | ||
Belirtilen nesnenin temel değerini döndürür. | Object |
cffHinting | özellik |
cffHinting:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Bu metin için kullanılan CFF düzeltme türü. Bu özellik için CFFHinting
sabitlerini kullanın. Yalnızca metnin RenderingMode
özelliği RenderingMode.CFF
olarak ayarlanırsa bu özellik geçerlidir.
Kullanılan CFF (Compact Font Format) düzeltme türü, Flash çalışma zamanının güçlü yatay gövdeleri bir alt piksel ızgarasına sığmaya zorlayıp zorlamayacağını belirler.
Yalnızca gömülü fontlar için geçerlidir.
Varsayılan değer CFFHinting.HORIZONTAL_STEM
şeklindedir.
CFFHinting
özelliği için, CFFHinting sınıfından şu sabitleri kullanabilirsiniz:
Dize değeri | Açıklama |
---|---|
CFFHinting.NONE | CFF düzeltme özelliğinin olmadığını belirtir. Gliflerdeki yatay gövdeler, alt piksel ızgarasına zorlanmaz. Bu ayar animasyon veya büyük font boyutları için uygundur. |
CFFHinting.HORIZONTAL_STEM | CFF düzeltme özelliğini belirtir. Güçlü yatay gövdeler, bir ekrandaki alt piksel ızgarasına sığdırılır. Bu ayarın kullanılması için RenderingMode özelliğinin RenderingMode.CFF olarak ayarlanması gerekir. |
Uygulama
public function get cffHinting():String
public function set cffHinting(value:String):void
Atar
ArgumentError — CFFHinting öğesinin üyesi olmayan herhangi bir değere ayarlanırsa.
| |
IllegalOperationError — FontDescription nesnesi kilitlendikten sonra (locked true olur) ayarlanırsa.
|
İlgili API Öğeleri
fontLookup | özellik |
fontLookup:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Fontun nasıl aranması gerektiğini belirtir.
Varsayılan değer FontLookup.DEVICE
şeklindedir.
Bu özelliğin değerlerini ayarlamak için, aşağıdaki dize değerlerini kullanın:
Dize değeri | Açıklama |
---|---|
FontLookup.DEVICE | Çalışma zamanı, metnin oluşturulacağı yerel sistemde belirtilen name öğesine sahip bir aygıt fontunu arar. |
FontLookup.EMBEDDED_CFF | Çalışma zamanı, metnin oluşturulacağı, belirtilen name öğesine sahip gömülü bir CFF fontunu arar. Yalnızca flash.text.Font.fontType.EMBEDDED_CFF türündeki fontlar göz önünde bulundurulur. Belirtilen CFF fontu uygulamada gömülü değilse, çalışma zamanı her glif için geri dönüş aygıt fontunu kullanmayı dener. Bu yöntem, ilk başta bir aygıt fontu seçilmesine göre daha az etkilidir. |
Uygulama
public function get fontLookup():String
public function set fontLookup(value:String):void
Atar
IllegalOperationError — FontDescription nesnesi kilitlendikten sonra (locked true olur) ayarlanırsa.
|
İlgili API Öğeleri
fontName | özellik |
fontName:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Kullanılacak fontun adı veya font adlarının virgülle ayrılmış bir listesi. Çalışma zamanı, listedeki ilk kullanılabilir fontla öğeyi oluşturur. Örneğin, "Arial, Helvetica, _sans" öğesi, Player'ın önce Arial'i aramasına, sonra Arial bulunmazsa Helvetica'yı ve o da bulunmazsa _sans'ı aramasına neden olur.
Flash çalışma zamanları üç genel aygıt fontu adını destekler: _sans (sans serif fontları için), _serif (serif fontları için) ve _typewriter (mono-space fontları için). Bunlar platforma bağlı olarak belirli aygıt fontlarına eşlenir.
"_serif"
varsayılan değerdir.
Flash çalışma zamanları, seçili fontta bulunmayan glifler için font geri dönüşü sağlar. Kullanılan font gömülü font veya aygıt fontu da olsa, fontta glif bulunmazsa, çalışma zamanı glif içerme olasılığı olan başka bir aygıt fontunu kullanarak bunu oluşturmayı dener.
Uygulama
public function get fontName():String
public function set fontName(value:String):void
Atar
IllegalOperationError — FontDescription nesnesi kilitlendikten sonra (locked true olur) ayarlanırsa.
|
İlgili API Öğeleri
fontPosture | özellik |
fontPosture:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Font duruşunu belirtir.
Varsayılan değer FontPosture.NORMAL
şeklindedir.
Bu özelliğin değerlerini ayarlamak için, FontPosture sınıfındaki şu sabitleri kullanın:
Değer | Açıklama |
---|---|
FontPosture.NORMAL | Normal font duruşu. |
FontPosture.ITALIC | İtalik font duruşu. |
Uygulama
public function get fontPosture():String
public function set fontPosture(value:String):void
Atar
ArgumentError — FontPosture öğesinin üyesi olmayan herhangi bir değere ayarlanırsa.
| |
IllegalOperationError — FontDescription nesnesi kilitlendikten sonra (locked true olur) ayarlanırsa.
|
İlgili API Öğeleri
fontWeight | özellik |
fontWeight:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Font ağırlığını belirtir.
Varsayılan değer FontWeight.NORMAL
şeklindedir.
Bu özelliğin değerlerini ayarlamak için, FontWeight sınıfındaki şu sabitleri kullanın:
Dize değeri | Açıklama |
---|---|
FontWeight.NORMAL | Normal font ağırlığı. |
FontWeight.BOLD | Kalın font ağırlığı |
Uygulama
public function get fontWeight():String
public function set fontWeight(value:String):void
Atar
ArgumentError — FontWeight öğesinin üyesi olmayan herhangi bir değere ayarlanırsa.
| |
IllegalOperationError — FontDescription nesnesi kilitlendikten sonra (locked true olur) ayarlanırsa.
|
İlgili API Öğeleri
locked | özellik |
locked:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5., Flash Lite 4 |
FontDescription öğesinin kilitlenmiş olup olmadığını belirtir. true
olursa, FontDescription değiştirilemez. FontDescription nesnesinin kilitlenmemiş bir kopyasını almak için, FontDescription.clone()
öğesini çağırın.
Uygulama
public function get locked():Boolean
public function set locked(value:Boolean):void
Atar
IllegalOperationError — FontDescription nesnesi kilitlendikten sonra (locked true olur) ayarlanırsa.
|
renderingMode | özellik |
renderingMode:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Bu metin için kullanılan oluşturma modu. Bu özellik için RenderingMode
sabitlerini kullanın.
Yalnızca gömülü fontlar için geçerlidir.
Varsayılan değer RenderingMode.CFF
şeklindedir.
Bu özelliğin değerlerini ayarlamak için, RenderingMode sınıfındaki şu sabitleri kullanın:
Dize değeri | Açıklama |
---|---|
RenderingMode.NORMAL | Flash Player 7 ve önceki sürümlerin kullandığı oluşturma türüyle eşleşen normal metin oluşturmayı uygular. |
RenderingMode.CFF | Metni daha okunaklı hale getiren CFF (Compact Font Format) oluşturmayı uygular. (Bu özellik Flash Player 10'da kullanılmaya başladı.) CFF oluşturması, küçük boyutlarda font yüzlerinin yüksek kaliteli oluşturulmasını sağlar. |
Uygulama
public function get renderingMode():String
public function set renderingMode(value:String):void
Atar
ArgumentError — RenderingMode öğesinin üyesi olmayan herhangi bir değere ayarlanırsa.
| |
IllegalOperationError — FontDescription nesnesi kilitlendikten sonra (locked true olur) ayarlanırsa.
|
İlgili API Öğeleri
FontDescription | () | Yapıcı |
public function FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Bir FontDescription nesnesi oluşturur.
ParametrelerfontName:String (default = "_serif ") — Kullanılacak fontun adı veya font adlarının virgülle ayrılmış bir listesi.
| |
fontWeight:String (default = "normal ") — Font ağırlığını belirtir.
| |
fontPosture:String (default = "normal ") — Font duruşunu belirtir.
| |
fontLookup:String (default = "device ") — Fontun nasıl aranacağını belirtir.
| |
renderingMode:String (default = "cff ") — Bu metin için kullanılan oluşturma modu. Bu özellik için RenderingMode sabitlerini kullanın.
| |
cffHinting:String (default = "horizontalStem ") — Bu metin için kullanılan CFF (Compact Font Format) düzeltme türü. Bu özellik için CFFHinting sabitlerini kullanın.
|
Atar
ArgumentError — Belirtilen fontWeight , FontWeight öğesinin bir üyesi değildir.
| |
ArgumentError — Belirtilen fontPosture , FontPosture öğesinin bir üyesi değildir.
| |
ArgumentError — Belirtilen fontLookup , FontLookup öğesinin bir üyesi değildir.
| |
ArgumentError — Belirtilen renderingMode , RenderingMode öğesinin bir üyesi değildir.
| |
ArgumentError — Belirtilen cffHinting , CFFHinting öğesinin bir üyesi değildir.
|
clone | () | yöntem |
public function clone():FontDescription
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
FontDescription öğesinin kilitlenmemiş, klonlanmış bir kopyasını oluşturur.
DöndürürFontDescription — FontDescription nesnesinin kilitlenmemiş bir kopyası.
|
Örnek ( Bu örnek nasıl kullanılır? )
Bu örnek bir FontDescription
nesnesi oluşturur, bu nesneye bir aygıt fontu atar, çeşitli font özelliklerini ayarlar ve ElementFormat
nesnesine yeni nesneyi atar. (Böylece nesneyi kilitler.) TextBlock
için içerik olarak ElementFormat
ve TextElement
kullanılarak yeni bir TextElement
oluşturulur. TextBlock
öğesinden bir metin satırı oluşturulur.
FontDescription
nesnesini değiştirmek için öncelikle nesnenin locked
özelliğini kontrol edin. Bu özellik true değerindeyse, clone()
yöntemini kullanarak FontDescription
öğesinin kilitlenmemiş bir kopyasını oluşturun, özelliklerini değiştirin ve yeni bir ElementFormat nesnesine bunu atayın. Ardından yeni ElementFormat
öğesini TextBlock
öğesine yeniden bağlayın. Satırlar yeniden kesildiğinde, yeni satırlar yeni font ayarlarına sahip olur.
package { import flash.display.Sprite; import flash.text.engine.*; public class FontDescription_cloneExample extends Sprite { private var fd:FontDescription; private var fd2:FontDescription; public function FontDescription_cloneExample():void { fd = new FontDescription(); fd.fontLookup = flash.text.engine.FontLookup.DEVICE; fd.fontName = "Palatino"; fd.fontWeight = flash.text.engine.FontWeight.BOLD; fd.fontPosture = flash.text.engine.FontPosture.ITALIC; var ef1:ElementFormat = new ElementFormat(fd); 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); fd2 = (fd.locked) ? fd.clone() : fd; fd2.fontWeight = flash.text.engine.FontWeight.NORMAL; var ef2:ElementFormat = new ElementFormat(fd2); tb.content.elementFormat=ef2; var line2:TextLine = tb.createTextLine(null, 600); addChild(line2); } } }
isDeviceFontCompatible | () | yöntem |
public static function isDeviceFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Belirtilen fontName
, fontWeight
ve fontPosture
. ile kullanılabilir bir aygıt fontu varsa, true değerini döndürür.
flash.text.engine sınıfları yalnızca OpenType ve TrueType aygıt fontlarını kullanabilir. Daha eski bir teknoloji temelli font kullanılırsa, çalışma zamanı metin oluşturmak için glif glif bilinen iyi aygıt fontlarına geri döner.
Parametreler
fontName:String — Kontrol edilecek aygıt fontunun adı.
| |
fontWeight:String — Font ağırlığını belirtir. FontWeight öğesini kullanın.
| |
fontPosture:String — Font duruşunu belirtir. FontPosture öğesini kullanın.
|
Boolean — Uyumlu bir aygıt fontu varsa, true ; aksi takdirde false .
|
Atar
ArgumentError — Belirtilen fontWeight , FontWeight öğesinin bir üyesi değildir.
| |
ArgumentError — Belirtilen fontPosture , FontPosture öğesinin bir üyesi değildir.
|
İlgili API Öğeleri
isFontCompatible | () | yöntem |
public static function isFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Gömülü bir font, belirtilen fontName
, fontWeight
ve fontPosture
ile mevcutsa, true değerini döndürür; burada Font.fontType
, flash.text.FontType.EMBEDDED_CFF
öğesidir. Flash Player 10 ve sonraki sürümlerinde, uygulama içeriğinde iki gömülü font çeşidi görüntülenebilir. Normal gömülü fontlar yalnızca TextField tarafından kullanılır. CFF gömülü fontları yalnızca flash.text.engine sınıfları tarafından kullanılır. enumerateFonts()
işlevinin döndürdüğü haliyle, Font
sınıfının fontType
özelliği tarafından iki tür ayırt edilir.
flash.text.engine sınıfları, EMBEDDED
türünde bir font kullanamaz. fontLookup
öğesi FontLookup.EMBEDDED_CFF
olarak ayarlanırsa ve çalışma zamanında belirtilen ad, ağırlık ve duruşa sahip olarak kullanılabilen tek font EMBEDDED
türündeyse, çalışma zamanı, belirtilen ad ve stilde gömülü bir font yokmuş gibi metni oluşturmak için glif glif aygıt fontlarına geri döner.
Aynı ad, ağırlık ve duruşa sahip hem EMBEDDED
hem de EMBEDDED_CFF
fontları varsa, EMBEDDED_CFF
fontu seçilir ve EMBEDDED_CFF
fontuyla metin oluşturulur.
Parametreler
fontName:String — Denetlenecek gömülü fontun adı.
| |
fontWeight:String — Font ağırlığını belirtir. FontWeight öğesini kullanın.
| |
fontPosture:String — Font duruşunu belirtir. FontPosture öğesini kullanın.
|
Boolean — Uyumlu bir gömülü font mevcutsa true ; değilse false olur.
|
Atar
ArgumentError — Belirtilen fontWeight , FontWeight öğesinin bir üyesi değildir.
| |
ArgumentError — Belirtilen fontPosture , FontPosture öğesinin bir üyesi değildir.
|
İlgili API Öğeleri
Bu örnek bir FontDescription
nesnesi oluşturur, bu nesneye bir aygıt fontu atar, çeşitli font özelliklerini ayarlar ve ElementFormat
nesnesine yeni nesneyi atar. Ek font biçimlendirmesi, ElementFormat
içinde yapılır. TextBlock
için içerik olarak ElementFormat
ve TextElement
kullanılarak yeni bir TextElement
oluşturulur. TextBlock
öğesinden bir metin satırı oluşturulur.
package { import flash.display.Sprite; import flash.text.engine.*; public class FontDescriptionExample extends Sprite { public function FontDescriptionExample():void { var fd:FontDescription = new FontDescription(); fd.fontLookup = flash.text.engine.FontLookup.DEVICE; fd.fontName = "Palatino"; fd.fontWeight = flash.text.engine.FontWeight.BOLD; fd.fontPosture = flash.text.engine.FontPosture.ITALIC; var ef1:ElementFormat = new ElementFormat(fd); ef1.fontSize = 30; ef1.color = 0xFF0000; 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); } } }
Tue Jun 12 2018, 01:09 PM Z