| Pacchetto | flash.text.engine |
| Classe | public final class FontDescription |
| Ereditarietà | FontDescription  Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Un oggetto FontDescription viene applicato a un ElementFormat, che a sua volta viene applicato a un ContentElement in un TextBlock. Quando un oggetto FontDescription è stato applicato a un oggetto ElementFormat, la relativa proprietà locked è impostata su true. Le proprietà di un oggetto FontDescription bloccato non possono essere modificate. Utilizzate piuttosto il metodo clone() per creare una copia non bloccata dell'oggetto, che può essere modificata e assegnata a ElementFormat.
Nota: FTE (Flash Text Engine) non supporta i caratteri Type 1 o i caratteri bitmap quali Type 3, ATC, CID racchiusi in sfnt, o "Naked CID".
Altri esempi
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| cffHinting : String
Il tipo di approssimazione CFF utilizzato per questo testo. | FontDescription | ||
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| fontLookup : String
Specifica la modalità di ricerca del carattere. | FontDescription | ||
| fontName : String
Il nome del carattere da utilizzare o un elenco di nomi di caratteri separati da virgola. | FontDescription | ||
| fontPosture : String
Specifica il formato del carattere. | FontDescription | ||
| fontWeight : String
Specifica lo spessore del carattere. | FontDescription | ||
| locked : Boolean
Indica se l'oggetto FontDescription è bloccato o meno. | FontDescription | ||
| renderingMode : String
La modalità di rendering utilizzata per questo testo. | FontDescription | ||
| Metodo | Definito da | ||
|---|---|---|---|
FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")
Crea un oggetto FontDescription. | FontDescription | ||
Crea una copia clonata non bloccata di FontDescription. | FontDescription | ||
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
[statico]
Restituisce true se è disponibile un carattere dispositivo utilizzabile con i valori fontName, fontWeight e fontPosture specificati. | FontDescription | ||
[statico]
Restituisce true se è disponibile un carattere incorporato con i valori fontName, fontWeight e fontPosture specificati, dove Font.fontType è flash.text.FontType.EMBEDDED_CFF. | FontDescription | ||
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
cffHinting | proprietà |
cffHinting:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Il tipo di approssimazione CFF utilizzato per questo testo. Utilizzate le costanti CFFHinting per questa proprietà. Questa proprietà si applica solo se la proprietà RenderingMode del testo è impostata su RenderingMode.CFF.
Il tipo di approssimazione CFF (Compact Font Format) utilizzato determina se il runtime Flash forza o meno l'adattamento dei tratti orizzontali spessi a una griglia di pixel o sottopixel.
Si applica solo ai caratteri incorporati.
Il valore predefinito è CFFHinting.HORIZONTAL_STEM.
Per la proprietà CFFHinting potete utilizzare le seguenti costanti della classe CFFHinting:
| Valore stringa | Descrizione |
|---|---|
CFFHinting.NONE | Specifica l'assenza di approssimazione CFF. I tratti orizzontali dei glifi non vengono forzati alla griglia di sottopixel. Si tratta di un'impostazione appropriata per le animazioni o i caratteri con dimensioni elevate. |
CFFHinting.HORIZONTAL_STEM | Specifica l'approssimazione CFF. I tratti orizzontali spessi vengono adattati alla griglia di sottopixel su uno schermo. Per usare questa impostazione, la proprietà RenderingMode deve essere impostata su RenderingMode.CFF. |
Implementazione
public function get cffHinting():String public function set cffHinting(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di CFFHinting.
| |
IllegalOperationError — Se impostato dopo l'oggetto FontDescription è bloccato (locked è true).
|
Altri esempi
Elementi API correlati
fontLookup | proprietà |
fontLookup:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Specifica la modalità di ricerca del carattere.
Il valore predefinito è FontLookup.DEVICE.
Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:
| Valore stringa | Descrizione |
|---|---|
FontLookup.DEVICE | Il runtime cerca un carattere dispositivo con l'attributo name specificato nel sistema locale, da utilizzare per il rendering del testo. |
FontLookup.EMBEDDED_CFF | Il runtime cerca un carattere CFF incorporato con l'attributo name specificato, da utilizzare per il rendering del testo. Vengono considerati solo i caratteri di tipo flash.text.Font.fontType.EMBEDDED_CFF. Se il carattere CFF specificato non è incorporato nel'applicazione, il runtime tenta di utilizzare un carattere dispositivo di riserva per ogni glifo. Questo metodo è meno efficiente della selezione iniziale di un carattere dispositivo. |
Implementazione
public function get fontLookup():String public function set fontLookup(value:String):voidGenera
IllegalOperationError — Se impostato dopo l'oggetto FontDescription è bloccato (locked è true).
|
Altri esempi
Elementi API correlati
fontName | proprietà |
fontName:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
Il nome del carattere da utilizzare o un elenco di nomi di caratteri separati da virgola. Il rendering degli elementi viene eseguito dal runtime utilizzando il primo carattere disponibile nell'elenco. "Arial, Helvetica, _sans", ad esempio, fa in modo venga eseguita automaticamente la ricerca di Arial, quindi di Helvetica se Arial non viene trovato, quindi di _sans se non viene trovato nessuno dei due.
I runtime Flash supportano tre nomi di carattere dispositivo generici: _sans (per i caratteri sans serif), _serif (per i caratteri serif) e _typewriter (per i caratteri mono-space). Questi caratteri vengono mappati a caratteri dispositivo specifici, a seconda della piattaforma.
Il valore predefinito è "_serif".
Nei runtime Flash sono disponibili caratteri di riserva per i glifi che non vengono trovati nel carattere selezionato. Se il glifo non viene trovato nel carattere, a prescindere se il carattere in uso è incorporato o dispositivo, il runtime tenta di eseguire il rendering utilizzando un altro carattere dispositivo che probabilmente contiene tale glifo.
Implementazione
public function get fontName():String public function set fontName(value:String):voidGenera
IllegalOperationError — Se impostato dopo l'oggetto FontDescription è bloccato (locked è true).
|
Elementi API correlati
fontPosture | proprietà |
fontPosture:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Specifica il formato del carattere.
Il valore predefinito è FontPosture.NORMAL.
Per impostare i valori per questa proprietà, utilizzate le seguenti costanti nella classe FontPosture:
| Valore | Descrizione |
|---|---|
FontPosture.NORMAL | Formato del carattere normale. |
FontPosture.ITALIC | Formato del carattere corsivo. |
Implementazione
public function get fontPosture():String public function set fontPosture(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di FontPosture.
| |
IllegalOperationError — Se impostato dopo l'oggetto FontDescription è bloccato (locked è true).
|
Elementi API correlati
fontWeight | proprietà |
fontWeight:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Specifica lo spessore del carattere.
Il valore predefinito è FontWeight.NORMAL.
Per impostare i valori per questa proprietà, utilizzate le seguenti costanti nella classe FontWeight:
| Valore stringa | Descrizione |
|---|---|
FontWeight.NORMAL | Spessore del carattere normale. |
FontWeight.BOLD | Spessore del carattere grassetto. |
Implementazione
public function get fontWeight():String public function set fontWeight(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di FontWeight.
| |
IllegalOperationError — Se impostato dopo l'oggetto FontDescription è bloccato (locked è true).
|
Elementi API correlati
locked | proprietà |
locked:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Indica se l'oggetto FontDescription è bloccato o meno. Se true, l'oggetto FontDescription non può essere modificato. Chiamate FontDescription.clone() per ottenere una copia non bloccata dell'oggetto FontDescription.
Implementazione
public function get locked():Boolean public function set locked(value:Boolean):voidGenera
IllegalOperationError — Se impostato dopo l'oggetto FontDescription è bloccato (locked è true).
|
Altri esempi
renderingMode | proprietà |
renderingMode:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
La modalità di rendering utilizzata per questo testo. Utilizzate le costanti RenderingMode per questa proprietà.
Si applica solo ai caratteri incorporati.
Il valore predefinito è RenderingMode.CFF.
Per impostare i valori per questa proprietà, utilizzate le seguenti costanti nella classe RenderingMode:
| Valore stringa | Descrizione |
|---|---|
RenderingMode.NORMAL | Applica il rendering del testo normale, che corrisponde al tipo di antialiasing utilizzato da Flash Player versione 7 e precedenti. |
RenderingMode.CFF | Applica il rendering CFF (Compact Font Format) che consente di migliorare la leggibilità del testo. (funzione aggiunta in Flash Player 10). Il rendering CFF consente il rendering dei caratteri con una qualità molto alta anche quando sono di piccole dimensioni. |
Implementazione
public function get renderingMode():String public function set renderingMode(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di RenderingMode.
| |
IllegalOperationError — Se impostato dopo l'oggetto FontDescription è bloccato (locked è true).
|
Altri esempi
Elementi API correlati
FontDescription | () | Funzione di costruzione |
public function FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Crea un oggetto FontDescription.
ParametrifontName:String (default = "_serif") | |
fontWeight:String (default = "normal") | |
fontPosture:String (default = "normal") | |
fontLookup:String (default = "device") | |
renderingMode:String (default = "cff")RenderingMode per questa proprietà.
| |
cffHinting:String (default = "horizontalStem")CFFHinting per questa proprietà.
|
Genera
ArgumentError — L'oggetto fontWeight specificato non è un membro di FontWeight.
| |
ArgumentError — L'oggetto fontPosture specificato non è un membro di FontPosture.
| |
ArgumentError — L'oggetto fontLookup specificato non è un membro di FontLookup.
| |
ArgumentError — L'oggetto renderingMode specificato non è un membro di RenderingMode.
| |
ArgumentError — L'oggetto cffHinting specificato non è un membro di CFFHinting.
|
clone | () | metodo |
public function clone():FontDescription| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Crea una copia clonata non bloccata di FontDescription.
RestituisceFontDescription — Una copia non bloccata dell'oggetto FontDescription.
|
Altri esempi
Esempio ( Come utilizzare questo esempio )
In questo esempio viene creato un oggetto FontDescription, a cui viene assegnato un carattere incorporato, vengono impostate varie proprietà e il nuovo oggetto viene assegnato a un oggetto ElementFormat (e bloccato). Viene creato un nuovo TextElement utilizzando ElementFormat e TextElement viene utilizzato come contenuto per un oggetto TextBlock. Viene creata una riga di testo da TextBlock.
Per modificare l'oggetto FontDescription, verificate prima la proprietà locked. Se è true, utilizzate il metodo clone() per creare una copia non bloccata di FontDescription, modificarne le proprietà e assegnarla a un nuovo oggetto ElementFormat. Quindi create un nuovo collegamento da ElementFormat a TextBlock. Quando le righe vengono di nuovo interrotte, alle nuove righe saranno applicate le nuove impostazioni dei caratteri.
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 | () | metodo |
public static function isDeviceFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2 |
Restituisce true se è disponibile un carattere dispositivo utilizzabile con i valori fontName, fontWeight e fontPosture specificati.
Le classi flash.text.engine possono utilizzare solo i caratteri dispositivo OpenType e TrueType. Se utilizzare un carattere basato su una tecnologia di caratteri precedente, il runtime utilizza i caratteri dispositivo conosciuti glifo per glifo per il rendering del testo.
Parametri
fontName:String — Il nome del carattere dispositivo da verificare.
| |
fontWeight:String — Specifica lo spessore del carattere. Utilizzate FontWeight.
| |
fontPosture:String — Specifica il formato del carattere. Utilizzate FontPosture.
|
Boolean — true se è disponibile un carattere dispositivo compatibile; in caso contrario false.
|
Genera
ArgumentError — L'oggetto fontWeight specificato non è un membro di FontWeight.
| |
ArgumentError — L'oggetto fontPosture specificato non è un membro di FontPosture.
|
Elementi API correlati
isFontCompatible | () | metodo |
public static function isFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Restituisce true se è disponibile un carattere incorporato con i valori fontName, fontWeight e fontPosture, dove Font.fontType è flash.text.FontType.EMBEDDED_CFF. A partire da Flash Player 10, nel contenuto dell'applicazione possono essere presenti due tipi di caratteri incorporati. I caratteri incorporati normali vengono utilizzati solo da TextField. I caratteri incorporati CFF vengono utilizzati solo dalle classi flash.text.engine. I due tipi si distinguono in base alla proprietà fontType della classe Fontrestituita dalla funzione enumerateFonts().
Le classi flash.text.engine non possono utilizzare un carattere di tipo EMBEDDED. Se fontLookup è impostato su FontLookup.EMBEDDED_CFF e il solo carattere disponibile in fase di runtime con il nome e lo stile specificati è di tipo EMBEDDED, il runtime utilizza i caratteri dispositivo glifo per glifo, come se non fosse disponibile alcun carattere incorporato con il nome e lo stile specificati per il rendering del testo.
Se i caratteri EMBEDDED e EMBEDDED_CFF sono entrambi disponibili con lo stesso nome, spessore e formato, viene selezionato il carattere EMBEDDED_CFF e il rendering del testo viene eseguito con il carattere EMBEDDED_CFF.
Parametri
fontName:String — Il nome del carattere incorporato da verificare.
| |
fontWeight:String — Specifica lo spessore del carattere. Utilizzate FontWeight.
| |
fontPosture:String — Specifica il formato del carattere. Utilizzate FontPosture.
|
Boolean — true se è disponibile un carattere incorporato compatibile, altrimenti false.
|
Genera
ArgumentError — L'oggetto fontWeight specificato non è un membro di FontWeight.
| |
ArgumentError — L'oggetto fontPosture specificato non è un membro di FontPosture.
|
Elementi API correlati
In questo esempio viene creato un oggetto FontDescription, a cui viene assegnato un carattere incorporato, vengono impostate varie proprietà e il nuovo oggetto viene assegnato a un oggetto ElementFormat. La formattazione aggiuntiva dei caratteri viene effettuata all'interno di ElementFormat. Viene creato un nuovo TextElement utilizzando ElementFormat e TextElement viene utilizzato come contenuto per un oggetto TextBlock. Viene creata una riga di testo da 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, 02:44 PM Z