ElementFormat  - AS3

Specifica il tipo di linea di base nell'elemento che la contiene a cui vengono allineate le linee di base dominanti degli elementi con questo formato. Utilizzate le costanti TextBaseline per questa proprietà.

L'elemento verticale più grande nella riga determina l'allineamento della linea di base, a meno che TextBlock.baselineFontDescription e TextBlock.baselineFontSize non siano impostate per ignorare tale logica.

Il valore predefinito è TextBaseline.USE_DOMINANT_BASELINE.

Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:

Altri esempi

Elementi API correlati

Specifica la trasparenza degli elementi della riga interessati da questo oggetto. I valori validi sono compresi tra 0 (completamente trasparente) e 1 (completamente opaco). Gli oggetti di visualizzazione con alpha impostato su 0 sono attivi, anche se invisibili.

Il valore predefinito è 1.

Altri esempi

Elementi API correlati

Indica lo spostamento della linea di base per l'elemento, espresso in pixel.

L'elemento viene spostato da dominantBaseline in base al valore specificato. Lo scostamento viene aggiunto alla posizione y dei membri dell'elemento, quindi nel testo non ruotato uno spostamento positivo della linea di base sposta l'elemento in basso, mentre uno spostamento negativo della linea di base sposta l'elemento in alto.

Il valore predefinito è 0.0, che indica nessuno spostamento.

Altri esempi

L'opportunità di interruzione di riga applicata a questo testo. Questa proprietà determina quali caratteri possono essere utilizzati per l'interruzione di riga quando il testo con a capo automatico viene suddiviso su più righe. Utilizzate le costanti BreakOpportunity per questa proprietà.

Il valore predefinito è BreakOpportunity.AUTO.

Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:

Altri esempi

Elementi API correlati

Indica il colore del testo. Un numero intero che contiene tre componenti RGB a 8 bit; ad esempio, 0xFF0000 corrisponde al rosso e 0x00FF00 corrisponde al verde.

Il valore predefinito è 0x000000 (nero).

Il tipo di cifre (ascendenti/discendenti) utilizzato per questo testo. Il tipo di cifre (ascendenti/discendenti) incide sullo stile e sul posizionamento di gruppi di caratteri numerici. Utilizzate le costanti DigitCase per questa proprietà.

Il valore predefinito è DigitCase.DEFAULT.

Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:

Elementi API correlati

La larghezza del carattere utilizzata per questo testo. Utilizzate le costanti DigitWidth per questa proprietà.

Il valore predefinito è DigitWidth.DEFAULT.

Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:

Elementi API correlati

Specifica la linea di base da utilizzare come linea di base dominante. La linea di base dominante è allineata con la linea di base di allineamento per determinare la posizione verticale dell'elemento sulla riga. Utilizzate le costanti TextBaseline per questa proprietà.

Il contenuto dell'elemento determina le linee di base. Nel caso di TextElement, il carattere e la dimensione in punti determina la linea di base. Nel caso di GraphicElement, l'altezza dell'elemento determina la linea di base.

Il valore predefinito è TextBaseline.ROMAN.

Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:

Altri esempi

Elementi API correlati

Un oggetto le cui proprietà descrivono un carattere.

Il valore predefinito è un oggetto FontDescription creato per impostazione predefinita.

Quando la proprietà fontDescription è impostata, l'oggetto FontDescription fornito è bloccato: la proprietà locked è impostata su true. Non è possibile modificare un oggetto FontDescription bloccato.

Elementi API correlati

Le dimensioni in pixel del testo.

Il valore predefinito è 12.0.

Le crenature regolano i pixel tra determinate coppie di caratteri per migliorare la leggibilità. La crenatura è supportata per tutti i caratteri con tabelle di crenatura.

Il valore predefinito è Kerning.ON.

Per impostare i valori per questa proprietà, utilizzate le seguenti costanti nella classe Kerning:

Altri esempi

Elementi API correlati

Il livello di legatura utilizzato per questo testo. Si verifica una legatura nel punto in cui due o più forme di lettere vengono unite in un unico glifo. Le legature sostituiscono in genere caratteri consecutivi che condividono componenti comuni, ad esempio le coppie di lettere 'fi', 'fl' o 'ae'. Vengono utilizzate nei set di caratteri latini e non latini. Utilizzate le costanti LigatureLevel per questa proprietà.

Il valore predefinito è LigatureLevel.COMMON.

Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:

Elementi API correlati

Le impostazioni internazionali del testo. Controlla le trasformazioni di maiuscole/minuscole e la modellazione. Vengono utilizzati identificativi per le impostazioni internazionali standard. "en", "en_US" ed "en-US", ad esempio, si riferiscono all'inglese; "ja" al giapponese. Per un elenco dei codici delle versioni localizzate, visitate il sito Web iso639-2 code list.

Il valore predefinito è "en".

Indica se ElementFormat è bloccato. Se true, l'oggetto ElementFormat non può essere modificato. Per ottenere una copia non bloccata dell'oggetto ElementFormat, chiamate ElementFormat.clone().

Altri esempi

Imposta la rotazione applicata ai singoli glifi. Utilizzate le costanti definite nella classe TextRotation per questa proprietà.

Il valore predefinito è TextRotation.AUTO.

La rotazione finale di qualsiasi glifo è la somma di , ElementFormat.textRotation, ContentElement.textRotation e TextBlock.lineRotation.

Solitamente utilizzare questa proprietà per il testo in lingua asiatica in cui i caratteri devono essere ruotati per essere visualizzati correttamente nel layout verticale. A questo scopo, utilizzate TextRotation.AUTO in combinazione con TextBlock.lineRotation = TextRotation.ROTATE_90.

L'impostazione di questa proprietà su caratteri che non contengono informazioni sul layout verticale, può generare risultati indesiderabili. I caratteri che contengono una tabella vmtx o VORG, come il carattere giapponese "MS Mincho", funzionano correttamente perché le tabelle forniscono i dati richiesti dal motore di layout per creare il layout corretto. I caratteri, come Verdana, che non contengono le informazioni necessarie, non funzionano correttamente.

Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:

Altri esempi

Elementi API correlati

Il tracciamento o la crenatura manuale applicata a sinistra di ogni glifo, espressa in pixel. Se kerning è attivata, il valore di trackingLeft viene sommato ai valori nella tabella di crenatura per il carattere. Se kerning è disattivata, il valore di trackingLeft viene usato come valore di crenatura manuale. Supporta sia valori positivi che negativi.

In genere, il valore di tracciamento desiderato viene suddiviso tra trackingRight e trackingLeft. In caso contrario, nel testo con orientamento misto, il valore di tracciamento è doppio in corrispondenza di un limite bidirezionale e assente dall'altro.

Il valore predefinito è 0.0.

Esempio:

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

Altri esempi

Il tracciamento o la crenatura manuale applicata a destra di ogni glifo, espressa in pixel. Se kerning è attivata, il valore di trackingRight viene sommato ai valori nella tabella di crenatura per il carattere. Se kerning è disattivata, il valore di trackingRight viene usato come valore di crenatura manuale. Supporta sia valori positivi che negativi.

In genere, il valore di tracciamento desiderato viene suddiviso tra trackingRight e trackingLeft. In caso contrario, nel testo con orientamento misto, il valore di tracciamento è doppio in corrispondenza di un limite bidirezionale e assente dall'altro.

Il valore predefinito è 0.0.

Esempio:

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

Altri esempi

Il carattere tipografico (maiuscolo/minuscolo) utilizzato per questo testo. Utilizzate le costanti definite nella classe TypographicCase per questa proprietà.

Il valore predefinito è TypographicCase.DEFAULT.

Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:

Altri esempi

Elementi API correlati

Crea un oggetto ElementFormat.

Crea una copia clonata non bloccata di ElementFormat.

Altri esempi

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

Restituisce un oggetto FontMetrics con proprietà che descrivono emBox, la posizione del barrato, lo spessore del barrato, la posizione della sottolineatura e lo spessore della sottolineatura per il carattere specificato da fontDescription e fontSize.

Elementi API correlati

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

In questo esempio vengono creati due oggetti ElementFormat e vengono impostate diverse proprietà. Viene quindi assegnato il nuovo ElementFormats a un oggetto TextElement, che è stato assegnato come contenuto di un TextBlock. La modifica di ElementFormat di un oggetto TextElement non influisce sugli oggetti TextLines creati precedentemente da TextBlock principale.

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