Paket | flash.text.engine |
Klass | public final class FontDescription |
Arv | FontDescription Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Ett FontDescription-objekt används på ett ElementFormat, som i sin tur används på ett ContentElement i ett TextBlock. När ett FontDescription har använts på ett ElementFormat ställs dess locked
-egenskap in på true
. Egenskaperna för ett låst FontDescription-objekt kan inte ändras. Använd i stället metoden clone()
för att skapa en olåst kopia av objeket som kan ändras och tilldelas till ElementFormat.
Obs! FTE (Flash Text Engine) har inte stöd för Type 1-teckensnitt eller bitmappsteckensnitt som Type 3, ATC, sfnt-wrapped CID och Naked CID.
Relaterade API-element
Egenskap | Definieras med | ||
---|---|---|---|
cffHinting : String
Den typ av CFF-indikering som används för denna text. | FontDescription | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
fontLookup : String
Anger hur teckensnittet ska slås upp. | FontDescription | ||
fontName : String
Namnet på det teckensnitt som ska användas eller en kommaavgränsad lista med teckensnittsnamn. | FontDescription | ||
fontPosture : String
Anger teckensnittsläge. | FontDescription | ||
fontWeight : String
Anger teckensnittsstil. | FontDescription | ||
locked : Boolean
Anger om FontDescription är låst eller inte. | FontDescription | ||
renderingMode : String
Det återgivningsläge som används för den här texten. | FontDescription |
Metod | Definieras med | ||
---|---|---|---|
FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")
Skapar ett FontDescription-objekt. | FontDescription | ||
Skapar en olåst, klonad kopia av FontDescription. | FontDescription | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
[statisk]
Returnerar true om ett användbart enhetsteckensnitt är tillgängligt med angivna fontName, fontWeight och fontPosture. | FontDescription | ||
[statisk]
Returnerar true om ett inbäddat teckensnitt är tillgängligt med angivet fontName, angiven fontWeight och angivet fontPosture, där Font.fontType är flash.text.FontType.EMBEDDED_CFF. | FontDescription | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
Returnerar det angivna objektets strängbeteckning. | Object | ||
Returnerar det angivna objektets primitiva värde. | Object |
cffHinting | egenskap |
cffHinting:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Den typ av CFF-indikering som används för denna text. Använd CFFHinting
-konstanter för den här egenskapen. Den här egenskapen gäller bara om egenskapen RenderingMode
för texten är inställd på RenderingMode.CFF
.
Den typ av CFF-utjämning (Compact Font Format) som används avgör om Flash-miljön tvingar in kraftiga vågräta linjer mot rutnätet under pixelnivå eller inte.
Gäller endast inbäddade teckensnitt.
Standardvärdet är CFFHinting.HORIZONTAL_STEM
.
För egenskapen CFFHinting
kan du använda följande konstanter från klassen CFFHinting:
Strängvärde | Beskrivning |
---|---|
CFFHinting.NONE | Använder inte CFF-indikering. Vågräta linjer i specialtecken tvingas inte mot rutnätet under pixelnivå. Inställningen passar vid animering och för stora teckenstorlekar. |
CFFHinting.HORIZONTAL_STEM | Använder CFF-indikering. Kraftiga vågräta linjer passas in mot rutnätet under pixelnivå på en skärm. Om du vill använda den här inställningen måste egenskapen RenderingMode vara inställd på RenderingMode.CFF . |
Implementering
public function get cffHinting():String
public function set cffHinting(value:String):void
Utlöser
ArgumentError — Om den anges till ett värde som inte är medlem av CFFHinting .
| |
IllegalOperationError — Om det anges efter att FontDescription-objektet har låsts (locked är true ).
|
Relaterade API-element
fontLookup | egenskap |
fontLookup:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Anger hur teckensnittet ska slås upp.
Standardvärdet är FontLookup.DEVICE
.
Använd följande strängvärden när du ska ange värden för den här egenskapen:
Strängvärde | Beskrivning |
---|---|
FontLookup.DEVICE | Miljön söker efter ett enhetsteckensnitt med angivet name på det lokala systemet och använder det för att återge texten. |
FontLookup.EMBEDDED_CFF | Miljön söker efter ett inbäddat CFF-teckensnitt med angivet name och använder det för att återge texten. Endast teckensnitt av typen flash.text.Font.fontType.EMBEDDED_CFF är aktuella. Om det angivna CFF-teckensnittet inte är inbäddat i programmet försöker miljön använda ett reservenhetsteckensnitt för varje specialtecken. Denna metod är inte lika effektiv som att välja ett enhetsteckensnitt. |
Implementering
public function get fontLookup():String
public function set fontLookup(value:String):void
Utlöser
IllegalOperationError — Om det anges efter att FontDescription-objektet har låsts (locked är true ).
|
Relaterade API-element
fontName | egenskap |
fontName:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Namnet på det teckensnitt som ska användas eller en kommaavgränsad lista med teckensnittsnamn. Miljön återger elementet med det första tillgängliga teckensnittet i listan. ”Arial, Helvetica, _sans” medför till exempel att spelaren söker efter Arial först, sedan efter Helvetica om Arial inte hittas och slutligen efter _sans, om ingendera hittas.
Flash-miljöer har stöd för tre allmänna enhetsteckensnittsnamn: _sans (för sans serif-teckensnitt), _serif (för serif-teckensnitt) och _typewriter (för teckensnitt med fast teckenbredd). Dessa mappas till särskilda enhetsteckensnitt beroende på plattformen.
Standardvärdet är "_serif"
.
Flash-miljöer har reservteckensnitt för specialtecken som inte hittas i det valda teckensnittet. Om specialtecknet inte hittas i teckensnittet försöker miljön återge det med ett annat enhetsteckensnitt som kan tänkas innehålla specialtecknet (oavsett om det teckensnitt som används är ett inbäddat teckensnitt eller ett enhetsteckensnitt).
Implementering
public function get fontName():String
public function set fontName(value:String):void
Utlöser
IllegalOperationError — Om det anges efter att FontDescription-objektet har låsts (locked är true ).
|
Relaterade API-element
fontPosture | egenskap |
fontPosture:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Anger teckensnittsläge.
Standardvärdet är FontPosture.NORMAL
.
Ange värden för den här egenskapen med följande konstanter i klassen FontPosture:
Värde | Beskrivning |
---|---|
FontPosture.NORMAL | Normalt teckensnittsläge. |
FontPosture.ITALIC | Kursivt teckensnittsläge. |
Implementering
public function get fontPosture():String
public function set fontPosture(value:String):void
Utlöser
ArgumentError — Om den anges till ett värde som inte är medlem av FontPosture .
| |
IllegalOperationError — Om det anges efter att FontDescription-objektet har låsts (locked är true ).
|
Relaterade API-element
fontWeight | egenskap |
fontWeight:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Anger teckensnittsstil.
Standardvärdet är FontWeight.NORMAL
.
Ange värden för den här egenskapen med följande konstanter i klassen FontWeight:
Strängvärde | Beskrivning |
---|---|
FontWeight.NORMAL | Normal stil. |
FontWeight.BOLD | Fet stil. |
Implementering
public function get fontWeight():String
public function set fontWeight(value:String):void
Utlöser
ArgumentError — Om den anges till ett värde som inte är medlem av FontWeight .
| |
IllegalOperationError — Om det anges efter att FontDescription-objektet har låsts (locked är true ).
|
Relaterade API-element
locked | egenskap |
locked:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Anger om FontDescription är låst eller inte. Om true
, går det inte att ändra FontDescription. Anropa FontDescription.clone()
för att hämta en olåst kopia av FontDescription-objektet.
Implementering
public function get locked():Boolean
public function set locked(value:Boolean):void
Utlöser
IllegalOperationError — Om det anges efter att FontDescription-objektet har låsts (locked är true ).
|
renderingMode | egenskap |
renderingMode:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Det återgivningsläge som används för den här texten. Använd RenderingMode
-konstanter för den här egenskapen.
Gäller endast inbäddade teckensnitt.
Standardvärdet är RenderingMode.CFF
.
Ange värden för den här egenskapen med följande konstanter i klassen RenderingMode:
Strängvärde | Beskrivning |
---|---|
RenderingMode.NORMAL | Använder vanlig textrendering som motsvarar den typ av rendering som användes i Flash Player version 7 och tidigare. |
RenderingMode.CFF | Använder CFF-återgivning (Compact Font Format), vilket gör texten mer lättläst. (Funktionen är tillgänglig i Flash Player 10.) Med CFF-rendering kan typsnitt återges med mycket hög kvalitet även vid små teckenstorlekar. |
Implementering
public function get renderingMode():String
public function set renderingMode(value:String):void
Utlöser
ArgumentError — Om den anges till ett värde som inte är medlem av RenderingMode .
| |
IllegalOperationError — Om det anges efter att FontDescription-objektet har låsts (locked är true ).
|
Relaterade API-element
FontDescription | () | Konstruktor |
public function FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Skapar ett FontDescription-objekt.
ParametrarfontName:String (default = "_serif ") — Namnet på det teckensnitt som ska användas eller en kommaavgränsad lista med teckensnittsnamn.
| |
fontWeight:String (default = "normal ") — Anger teckensnittsstil.
| |
fontPosture:String (default = "normal ") — Anger teckensnittsläge.
| |
fontLookup:String (default = "device ") — Anger hur teckensnittet slås upp.
| |
renderingMode:String (default = "cff ") — Det återgivningsläge som används för den här texten. Använd RenderingMode -konstanter för den här egenskapen.
| |
cffHinting:String (default = "horizontalStem ") — Den typ av CFF-utjämning (Compact Font Format) som används för denna text. Använd CFFHinting -konstanter för den här egenskapen.
|
Utlöser
ArgumentError — Angiven fontWeight är inte medlem av FontWeight .
| |
ArgumentError — Angiven fontPosture är inte medlem av FontPosture .
| |
ArgumentError — Angiven fontLookup är inte medlem av FontLookup .
| |
ArgumentError — Angivet renderingMode är inte medlem av RenderingMode .
| |
ArgumentError — Angiven cffHinting är inte medlem av CFFHinting .
|
clone | () | metod |
public function clone():FontDescription
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Skapar en olåst, klonad kopia av FontDescription.
ReturnerarFontDescription — En olåst kopia av FontDescription -objektet.
|
Exempel ( Så här använder du exemplet )
Det här exemplet skapar ett FontDescription
-objekt, tilldelar det ett enhetsteckensnitt, anger olika egenskaper för teckensnitt och tilldelar det nya objektet (som därför blir låst) till ett ElementFormat
-objekt. Ett nytt TextElement
skapas med ElementFormat
, och TextElement
används som innehåll för ett TextBlock
. En textrad skapas från TextBlock
.
Om du vill ändra FontDescription
-objektet kontrollerar du först dess locked
-egenskap. Om värdet är true använder du metoden clone()
för att skapa en olåst kopia av FontDescription
, ändra dess egenskaper och tilldela den till ett nytt ElementFormat-objekt. Länka sedan om det nya ElementFormat
till TextBlock
. När raderna bryts på nytt får de nya raderna de nya teckensnittsinställningarna.
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 | () | metod |
public static function isDeviceFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Returnerar true om ett användbart enhetsteckensnitt är tillgängligt med angivna fontName
, fontWeight
och fontPosture
.
flash.text.engine-klasser kan bara använda OpenType- och TrueType-enhetsteckensnitt. Om ett teckensnitt som bygger på äldre teckensnittsteknik används ersätts det med kända, fungerande teckensnitt som tecken för tecken återger texten.
Parametrar
fontName:String — Namnet på det enhetsteckensnitt som ska kontrolleras.
| |
fontWeight:String — Anger teckensnittsstil. Använd FontWeight .
| |
fontPosture:String — Anger teckensnittsläge. Använd FontPosture .
|
Boolean — true om ett kompatibelt enhetsteckensnitt är tillgängligt, i annat fall false .
|
Utlöser
ArgumentError — Angiven fontWeight är inte medlem av FontWeight .
| |
ArgumentError — Angiven fontPosture är inte medlem av FontPosture .
|
Relaterade API-element
isFontCompatible | () | metod |
public static function isFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Returnerar true om ett inbäddat teckensnitt är tillgängligt med angivet fontName
, angiven fontWeight
och angivet fontPosture
, där Font.fontType
är flash.text.FontType.EMBEDDED_CFF
. Från och med Flash Player 10 kan två olika typer av inbäddade teckensnitt visas i programinnehåll. Normalt inbäddade teckensnitt används endast av TextField-objekt. CFF-inbäddade teckensnitt används endast av klasserna flash.text.enginge. De två typerna särskiljs med fontType
-egenskapen för klassen Font
, som de returneras av funktionen enumerateFonts()
.
flash.text.engine-klasserna kan inte använda ett teckensnitt av typen EMBEDDED
. Om fontLookup
är inställt på FontLookup.EMBEDDED_CFF
, och det enda teckensnitt som är tillgängligt vid körning med det namn, den stil och det läge som anges är av typen EMBEDDED
, används i stället enhetsteckensnitt på teckenbasis för att återge texten, som om inget inbäddat teckensnitt med angivet namn och format finns.
Om det finns både EMBEDDED
- och EMBEDDED_CFF
-teckensnitt med samma namn, stil och läge tillgängliga, väljs EMBEDDED_CFF
-teckensnittet och texten återges med teckensnittet EMBEDDED_CFF
.
Parametrar
fontName:String — Namnet på det inbäddade teckensnittet ska undersökas.
| |
fontWeight:String — Anger teckensnittsstil. Använd FontWeight .
| |
fontPosture:String — Anger teckensnittsläge. Använd FontPosture .
|
Boolean — true om ett kompatibelt inbäddat teckensnitt är tillgängligt, i annat fall false .
|
Utlöser
ArgumentError — Angiven fontWeight är inte medlem av FontWeight .
| |
ArgumentError — Angiven fontPosture är inte medlem av FontPosture .
|
Relaterade API-element
Det här exemplet skapar ett FontDescription
-objekt, tilldelar det ett enhetsteckensnitt, anger olika egenskaper för teckensnitt och tilldelar det nya objektet till ett ElementFormat
-objekt. Ytterligare teckensnittsformatering görs i ElementFormat
. Ett nytt TextElement
skapas med ElementFormat
, och TextElement
används som innehåll för ett TextBlock
. En textrad skapas från TextBlock
.
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:40 PM Z