Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: AIR 30.0 e versioni precedenti, Flash Player 30.0 e versioni precedenti, Flash Lite 4
Flex 4.6 e versioni precedenti, Flash Pro CS6 e versioni precedenti
Nascondi filtri
flash.text.engine 

FontDescription  - AS3

Pacchettoflash.text.engine
Classepublic final class FontDescription
EreditarietàFontDescription Inheritance Object

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5, Flash Lite 4

La classe FontDescription rappresenta le informazioni necessarie per descrivere un carattere.

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".

Vedere gli esempi

Altri esempi

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
  cffHinting : String
Il tipo di approssimazione CFF utilizzato per questo testo.
FontDescription
 Inheritedconstructor : 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
Metodi pubblici
 MetodoDefinito 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
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
  
isDeviceFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean
[statico] Restituisce true se è disponibile un carattere dispositivo utilizzabile con i valori fontName, fontWeight e fontPosture specificati.
FontDescription
  
isFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean
[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
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà

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 stringaDescrizione
CFFHinting.NONESpecifica 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_STEMSpecifica 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):void

Genera
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 stringaDescrizione
FontLookup.DEVICEIl runtime cerca un carattere dispositivo con l'attributo name specificato nel sistema locale, da utilizzare per il rendering del testo.
FontLookup.EMBEDDED_CFFIl 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):void

Genera
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):void

Genera
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:

ValoreDescrizione
FontPosture.NORMALFormato del carattere normale.
FontPosture.ITALICFormato del carattere corsivo.



Implementazione
    public function get fontPosture():String
    public function set fontPosture(value:String):void

Genera
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 stringaDescrizione
FontWeight.NORMALSpessore del carattere normale.
FontWeight.BOLDSpessore del carattere grassetto.



Implementazione
    public function get fontWeight():String
    public function set fontWeight(value:String):void

Genera
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):void

Genera
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 stringaDescrizione
RenderingMode.NORMALApplica il rendering del testo normale, che corrisponde al tipo di antialiasing utilizzato da Flash Player versione 7 e precedenti.
RenderingMode.CFFApplica 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):void

Genera
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

Descrizione della funzione di costruzione

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.

Parametri
fontName:String (default = "_serif") — Il nome del carattere da utilizzare o un elenco di nomi di caratteri separati da virgola.
 
fontWeight:String (default = "normal") — Specifica lo spessore del carattere.
 
fontPosture:String (default = "normal") — Specifica il formato del carattere.
 
fontLookup:String (default = "device") — Specifica come cercare il carattere.
 
renderingMode:String (default = "cff") — La modalità di rendering utilizzata per questo testo. Utilizzate le costanti RenderingMode per questa proprietà.
 
cffHinting:String (default = "horizontalStem") — Il tipo di approssimazione CFF (Compact Font Format) utilizzato per questo testo. Utilizzate le costanti 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.
Descrizione dei metodi

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.

Restituisce
FontDescription — 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.

Restituisce
Booleantrue 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.

Restituisce
Booleantrue 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

FontDescriptionExample.as

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




[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.