TextLayoutFormat  - AS3

Specifica la linea di base a cui deve allinearsi la linea di base dominante. Se, ad esempio, impostate dominantBaseline su ASCENT, l'impostazione di alignmentBaseline su DESCENT consente di allineare la parte superiore del testo con la linea di base DESCENT o al di sotto della linea. L'elemento più grande nella riga determina in genere le linee di base.

I valori validi sono TextBaseline.ROMAN, TextBaseline.ASCENT, TextBaseline.DESCENT, TextBaseline.IDEOGRAPHIC_TOP, TextBaseline.IDEOGRAPHIC_CENTER, TextBaseline.IDEOGRAPHIC_BOTTOM, TextBaseline.USE_DOMINANT_BASELINE, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà TextBaseline.USE_DOMINANT_BASELINE.

Elementi API correlati

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flash.text.engine.TextBaseline;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextAlign;

    public class TextLayoutFormat_alignmentBaselineExample extends Sprite
    {
        public function TextLayoutFormat_alignmentBaselineExample()
        {
            // create text flow with dominantBaseline of ASCENT and 3 spans
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();
            paragraph.fontFamily = "Helvetica";
            paragraph.fontSize = 20;
            paragraph.dominantBaseline = TextBaseline.ASCENT    
            var spanOne:SpanElement = new SpanElement();
            var spanTwo:SpanElement = new SpanElement();
            var spanThree:SpanElement = new SpanElement();
            spanOne.text = "Hello, World  ";
            spanTwo.text = "Hello, World  ";
            spanThree.text = "Hello, World";
            
            // add spans to paragraph and specify alignment baseline for each
            paragraph.addChild(spanOne);
            spanOne.alignmentBaseline = TextBaseline.USE_DOMINANT_BASELINE;    
            paragraph.addChild(spanTwo);
            spanTwo.alignmentBaseline = TextBaseline.DESCENT;
            paragraph.addChild(spanThree);
            spanThree.alignmentBaseline = TextBaseline.IDEOGRAPHIC_CENTER;
            
            // add paragraph to TextFlow and set container position
            textFlow.addChild(paragraph);
            this.x = 50;
            this.y = 100;
            
            // update controller to display on stage
            textFlow.flowComposer.addController(new ContainerController(this,400,300));
            textFlow.flowComposer.updateAllControllers();    
        }
    }
}

Valore alfa (trasparenza) per lo sfondo (adotta il valore predefinito se undefined durante la cascata). Un valore 0 è completamente trasparente, mentre un valore 1 è completamente opaco. Gli oggetti di visualizzazione con alpha impostato su 0 sono attivi, anche se invisibili.

I valori consentiti sono numeri compresi tra 0 e 1 e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore 1.

Colore di sfondo del testo (adotta il valore predefinito se undefined durante la cascata). Può essere il valore costante BackgroundColor.TRANSPARENT o un valore esadecimale che specifica i tre valori RGB (rosso, verde, blu) a 8 bit; ad esempio, 0xFF0000 è rosso e 0x00FF00 è verde.

I valori consentiti come stringa sono BackgroundColor.TRANSPARENT, FormatValue.INHERIT e i valori uint da 0x0 a 0xffffffff.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore BackgroundColor.TRANSPARENT.

Elementi API correlati

Quantità di spostamento della linea di base dal valore dominantBaseline. Unità in pixel o percentuale di fontSize. In tal caso, immettete un valore di stringa, ad esempio 140%. I valori positivi spostano la riga verso l'alto per il testo orizzontale (a destra per il verticale), mentre i valori negativi lo spostano verso il basso per il testo orizzontale (a sinistra per il verticale).

I valori validi sono BaselineShift.SUPERSCRIPT, BaselineShift.SUBSCRIPT, FormatValue.INHERIT.

I valori consentiti come numero sono compresi tra -1000 e 1000.

I valori consentiti come percentuale sono numeri compresi tra -1000 e 1000.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 0.0.

Elementi API correlati

Specifica un avanzamento orizzontale o verticale del posizionamento delle righe. Le righe vengono posizionate dall'alto verso il basso (BlockProgression.TB, utilizzato per testo orizzontale) o da destra a sinistra (BlockProgression.RL, utilizzato per testo verticale).

I valori validi sono BlockProgression.RL, BlockProgression.TB, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà BlockProgression.TB.

Elementi API correlati

Controlla il punto in cui sono consentite le interruzioni di riga quando il testo con a capo automatico viene suddiviso su più righe. Impostate su BreakOpportunity.AUTO per interrompere il testo normalmente. Impostate su BreakOpportunity.NONE per non interrompere il testo, a meno che il testo non superi la misura e non siano disponibili altri punti per l'interruzione della riga. Impostate su BreakOpportunity.ANY per consentire l'interruzione in qualsiasi punto della riga, non solo tra le parole. Impostate su BreakOpportunity.ALL per fare in modo che ogni gruppo tipografico verrà inserito su una riga distinta (utile per il testo su un tracciato).

I valori validi sono BreakOpportunity.ALL, BreakOpportunity.ANY, BreakOpportunity.AUTO, BreakOpportunity.NONE, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà BreakOpportunity.AUTO.

Elementi API correlati

Il tipo di approssimazione CFF utilizzato per questo testo. L'approssimazione CFF determina se il runtime Flash forza o meno l'adattamento dei tratti orizzontali spessi a una griglia di pixel o sottopixel. Questa proprietà è pertinente solo se la proprietà renderingMode è impostata su RenderingMode.CFF e il carattere è incorporato (la proprietà fontLookup è impostata su FontLookup.EMBEDDED_CFF). Con dimensioni dello schermo limitate, l'approssimazione produce un testo chiaro e leggibile per i lettori umani.

I valori validi sono CFFHinting.NONE, CFFHinting.HORIZONTAL_STEM, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà CFFHinting.HORIZONTAL_STEM.

Elementi API correlati

Controlla il modo in cui il testo scorre intorno a un float. Il valore "none" consente al testo di scorrere più da vicino intorno a un float. Il valore "left" fa sì che il testo "salti" qualsiasi porzione del contenitore che presenta un float sinistro. Il valore "right" fa sì che il testo "salti" qualsiasi porzione del contenitore che presenta un float destro. Il valore "both" fa sì che il testo "salti" tutti i float.

I valori validi sono ClearFloats.START, ClearFloats.END, ClearFloats.LEFT, ClearFloats.RIGHT, ClearFloats.BOTH, ClearFloats.NONE e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore ClearFloats.NONE.

Elementi API correlati

Il colore del testo. Un numero esadecimale che specifica tre valori RGB (rosso, verde, blu) a 8 bit. Ad esempio 0xFF0000 è rosso e 0x00FF00 è verde.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 0.

Numero di colonne di testo (utilizza il valore predefinito se è undefined durante la cascata). Il numero di colonne ignora le altre impostazioni delle colonne. Il valore è un numero intero o FormatValue.AUTO se non specificato. Se columnCount non è specificato, viene utilizzato columnWidth per creare quante più colonne è possibile inserire nel contenitore.

I valori consentiti come stringa sono FormatValue.AUTO, FormatValue.INHERIT e i valori int da 1 a 50.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore FormatValue.AUTO.

Elementi API correlati

Specifica la quantità di spazio per il margine, espressa in pixel, da lasciare tra le colonne (utilizza il valore predefinito se è undefined durante la cascata). Il valore è un numero

I valori consentiti sono i numeri compresi tra 0 e 1000 e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore 20.

La larghezza della colonna è espressa in pixel (utilizza il valore predefinito se è undefined durante la cascata). Se specificate la larghezza delle colonne, ma non il numero, TextLayout creerà il numero massimo di colonne per quella larghezza, in base alla larghezza del contenitore e alle impostazioni di columnGap. L'eventuale spazio rimanente viene lasciato dopo l'ultima colonna. Il valore è un numero.

I valori validi come stringa sono FormatValue.AUTO, FormatValue.INHERIT i numeri da 0 a 8000.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore FormatValue.AUTO.

Elementi API correlati

Restituisce il coreStyles per questo TextLayoutFormat. L'oggetto coreStyles incorpora i formati che sono definiti da TextLayoutFormat e sono in TextLayoutFormat.description. L'oggetto coreStyles restituito è composto da un array di coppie nome stile-valore.

Elementi API correlati

Restituisce un oggetto TextLayoutFormat con impostazioni predefinite. Questo metodo restituisce sempre lo stesso oggetto.

Il tipo di cifre (ascendenti/discendenti) utilizzato per questo testo. L'impostazione del valore su DigitCase.OLD_STYLE si avvicina ai formati di lettere in caratteri minuscoli con diversi tratti ascendenti e discendenti. La spaziatura tra le cifre è proporzionale. Questo stile è disponibile solo nei tipi di carattere selezionati, più comunemente in un carattere supplementare o specializzato. L'impostazione DigitCase.LINING applica l'altezza delle lettere maiuscole e di solito ha una spaziatura fissa per l'allineamento nei grafici.

I valori validi sono DigitCase.DEFAULT, DigitCase.LINING, DigitCase.OLD_STYLE, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà DigitCase.DEFAULT.

Elementi API correlati

Il tipo di larghezza delle cifre (ascendenti/discendenti) utilizzato per questo testo. Questo valore può essere DigitWidth.PROPORTIONAL, più adatto per i numeri isolati, oppure DigitWidth.TABULAR, che è più appropriato per i numeri in tabelle, grafici e righe verticali.

DigitCase.DEFAULTDigitWidth.DEFAULT, DigitWidth.PROPORTIONAL, DigitWidth.TABULAR, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà DigitWidth.DEFAULT.

Elementi API correlati

Specifica il livello di incorporamento bidirezionale predefinito del testo nel blocco di testo. Ordine di lettura da sinistra a destra come negli script delle lingue latine oppure da destra a sinistra come in arabo o ebraico. Questa proprietà influisce anche sulla direzione delle colonne quando viene applicata a livello del contenitore. Le colonne possono essere da sinistra a destra o da destra a sinistra, come il testo. Di seguito sono forniti alcuni esempi:

I valori validi sono Direction.LTR, Direction.RTL, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà Direction.LTR.

Elementi API correlati

Specifica quale linea di base dell'elemento si aggancia ad alignmentBaseline per determinare la posizione verticale dell'elemento sulla riga. Un valore TextBaseline.AUTO seleziona la linea di base dominante in base alla proprietà locale del paragrafo principale. Per giapponese e cinese, il valore della linea di base selezionato è TextBaseline.IDEOGRAPHIC_CENTER; per tutte le altre lingue è TextBaseline.ROMAN. Questi valori della linea di base sono determinati dai valori del carattere e della relativa dimensione.

I valori validi sono FormatValue.AUTO, TextBaseline.ROMAN, TextBaseline.ASCENT, TextBaseline.DESCENT, TextBaseline.IDEOGRAPHIC_TOP, TextBaseline.IDEOGRAPHIC_CENTER, TextBaseline.IDEOGRAPHIC_BOTTOM, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà FormatValue.AUTO.

Elementi API correlati

Specifica la posizione della linea di base della prima riga nel contenitore. La linea di base a cui si riferisce la proprietà dipende dalla versione locale a livello del contenitore. Per giapponese e cinese è TextBaseline.IDEOGRAPHIC_BOTTOM; per tutte le altre lingue è TextBaseline.ROMAN. L'offset dal margine interno superiore (o destro se blockProgression è RL) del contenitore rispetto alla linea di base della prima riga può essere BaselineOffset.ASCENT, ovvero uguale all'ascendente della riga, BaselineOffset.LINE_HEIGHT, ovvero uguale all'altezza della prima riga oppure un valore numerico fisso che specifica una distanza assoluta. BaselineOffset.AUTO allinea l'ascendente della riga con il margine interno superiore del contenitore.

I valori validi come stringa sono BaselineOffset.AUTO, BaselineOffset.ASCENT, BaselineOffset.LINE_HEIGHT, FormatValue.INHERIT e i numeri da 0 a 1000.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà BaselineOffset.AUTO.

Elementi API correlati

Il nome del carattere da utilizzare o un elenco di nomi di caratteri separati da virgola. Il rendering degli elementi viene eseguito dal runtime Flash utilizzando il primo carattere disponibile nell'elenco. Arial, Helvetica, _sans, ad esempio, fa in modo che 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.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà Arial.

La ricerca di caratteri da utilizzare. Specificando FontLookup.DEVICE vengono utilizzati i caratteri installati nel sistema su cui viene eseguito il file SWF. Con i caratteri del dispositivo le dimensioni del filmato sono inferiori, ma il rendering del testo non è uguale in tutti i sistemi e in tutte le piattaforme. Specificando FontLookup.EMBEDDED_CFF vengono utilizzati i profili di carattere incorporati nel file SWF pubblicato. Con i caratteri incorporati la dimensione del file SWF aumenta (a volte anche in modo significativo), ma il testo viene visualizzato in modo coerente nel carattere scelto.

I valori validi sono FontLookup.DEVICE, FontLookup.EMBEDDED_CFF, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà FontLookup.DEVICE.

Elementi API correlati

La dimensione del testo in pixel.

I valori consentiti sono i numeri compresi tra 1 e 720 e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 12.

Lo stile del testo. Può essere FontPosture.NORMAL, per il testo semplice, oppure FontPosture.ITALIC per il corsivo. Questa proprietà può essere applicata solo ai caratteri del dispositivo (la proprietà fontLookup è impostata su flash.text.engine.FontLookup.DEVICE).

I valori validi sono FontPosture.NORMAL, FontPosture.ITALIC, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà FontPosture.NORMAL.

Elementi API correlati

Lo spessore del testo. Può essere FontWeight.NORMAL per il testo semplice, oppure FontWeight.BOLD. Può essere applicato solo ai caratteri del dispositivo (la proprietà fontLookup è impostata su flash.text.engine.FontLookup.DEVICE).

I valori validi sono FontWeight.NORMAL, FontWeight.BOLD, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà FontWeight.NORMAL.

Elementi API correlati

La regola utilizzata per la giustificazione del testo in un paragrafo. Il valore predefinito è FormatValue.AUTO, che giustifica il testo in base alla proprietà locale del paragrafo. Per tutte le lingue, ad eccezione di giapponese e cinese, il valoreFormatValue.AUTO diventa JustificationRule.SPACE e aggiunge spazio supplementare ai caratteri spazio. Per giapponese e cinese, FormatValue.AUTO diventa JustficationRule.EAST_ASIAN. La giustificazione modifica in parte la spaziatura della punteggiatura. Nella versione delle lingue romane la virgola e i punti del giapponese hanno la larghezza di un carattere completo, ma nelle lingue dell'Est Asiatico il testo è solo la metà della larghezza di un carattere. La spaziatura tra la punteggiatura sequenziale, inoltre, diventa inferiore, in base alle convenzioni tipografiche tradizionali delle lingue dell'Est Asiatico. Osservate inoltre, nell'esempio seguente, l'interlinea applicata alla seconda riga del paragrafo. Nella versione per l'Est Asiatico le ultime due righe sono allineate a sinistra. Nella versione per le lingue romane la seconda riga e le successive sono allineate a sinistra.

I valori validi sono JustificationRule.EAST_ASIAN, JustificationRule.SPACE, FormatValue.AUTO, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà FormatValue.AUTO.

Elementi API correlati

Lo stile utilizzato per la giustificazione del paragrafo. Utilizzato solo in associazione a un'impostazione justificationRule di JustificationRule.EAST_ASIAN. Il valore predefinito di FormatValue.AUTO viene risolto in JustificationStyle.PUSH_IN_KINSOKU per tutte le impostazioni internazionali. Le costanti definite dalla classe JustificationStyle specificano le opzioni per la gestione dei caratteri giapponesi kinsoku, che non possono essere visualizzati all'inizio o alla fine di una riga. Se desiderate maggiore spaziatura per il testo, specificate JustificationStyle.PUSH-OUT-ONLY. Se desiderate un comportamento simile a quello ottenuto con justificationRule di JustificationRule.SPACE, utilizzate JustificationStyle.PRIORITIZE-LEAST-ADJUSTMENT.

I valori validi sono JustificationStyle.PRIORITIZE_LEAST_ADJUSTMENT, JustificationStyle.PUSH_IN_KINSOKU, JustificationStyle.PUSH_OUT_ONLY, FormatValue.AUTO, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà FormatValue.AUTO.

Elementi API correlati

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.

I valori validi sono Kerning.ON, Kerning.OFF, Kerning.AUTO, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà Kerning.AUTO.

Elementi API correlati

Specifica il modello di interlinea, che corrisponde a una combinazione di base e direzione dell'interlinea. La base dell'interlinea è la linea di base a cui si riferisce la proprietà lineHeight. La direzione dell'interlinea determina se la proprietà lineHeight si riferisce alla distanza della linea di base di una riga rispetto a quella della riga precedente o successiva. Il valore predefinito di FormatValue.AUTO viene risolto in base alla proprietà locale del paragrafo. Per le lingue giapponese e cinese, è LeadingModel.IDEOGRAPHIC_TOP_DOWN. Per tutte le altre lingue è LeadingModel.ROMAN_UP.

Base interlinea:

Direzione interlinea:

I valori validi sono LeadingModel.ROMAN_UP, LeadingModel.IDEOGRAPHIC_TOP_UP, LeadingModel.IDEOGRAPHIC_CENTER_UP, LeadingModel.IDEOGRAPHIC_TOP_DOWN, LeadingModel.IDEOGRAPHIC_CENTER_DOWN, LeadingModel.APPROXIMATE_TEXT_FIELD, LeadingModel.ASCENT_DESCENT_UP, LeadingModel.BOX, LeadingModel.AUTO, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà LeadingModel.AUTO.

Elementi API correlati

Controlla quali legature definite nel carattere possono essere utilizzate nel testo. Le legature visualizzate per ognuna di queste impostazioni dipende dal carattere. 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. Le legature abilitate dai valori della classe LigatureLevel, ovvero MINIMUM, COMMON, UNCOMMON e EXOTIC, sono additive. Ogni valore abilita un nuovo set di ligature, ma include anche quelle dei tipi precedenti.

Nota: quando usate caratteri arabi o siriani, ligatureLevel deve essere impostato su MINIMUM o su un valore superiore.

I valori validi sono LigatureLevel.MINIMUM, LigatureLevel.COMMON, LigatureLevel.UNCOMMON, LigatureLevel.EXOTIC, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà LigatureLevel.COMMON.

Elementi API correlati

Controlla il ritorno a capo automatico all'interno del contenitore (adotta il valore predefinito se undefined durante la cascata). Il testo all'interno del contenitore può essere impostato in modo che si adatti alla larghezza del contenitore (LineBreak.TO_FIT) o in modo che venga interrotto solo in corrispondenza di caratteri di avanzamento riga o ritorno a capo (LineBreak.EXPLICIT).

I valori validi sono LineBreak.EXPLICIT, LineBreak.TO_FIT, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore LineBreak.TO_FIT.

Elementi API correlati

Controllo di interlinea (Leading) per il testo. La distanza dalla linea di base della riga precedente o successiva (in base a LeadingModel) rispetto alla linea di base della riga corrente è uguale alla quantità massima dell'interlinea applicata a qualsiasi carattere della riga. Un numero o una percentuale. Se specificate una percentuale, immettete un valore di stringa, ad esempio 140%.

I valori consentiti come numero vanno da -720 a 720.

I valori consentiti come percentuale sono numeri compresi tra -1000% e 1000%.

Il valore consentito è FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 120%.

Se true, applica il carattere barrato, ovvero una linea tracciata a metà del testo.

I valori validi sono true, false e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà false.

Definisce gli attributi di formattazione utilizzati per i collegamenti nello stato normal. Questo valore viene riflesso nella gerarchia e applicato agli eventuali collegamenti discendenti. Accetta inherit, un ITextLayoutFormat oppure converte un array di oggetti con chiave e valore come membri di un TextLayoutFormat.

Il valore consentito è FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà null.

Definisce gli attributi di formattazione utilizzati per i collegamenti nello stato hover, quando il mouse è all'interno dei limiti di un collegamento (rollover). Questo valore viene riflesso nella gerarchia e applicato agli eventuali collegamenti discendenti. Accetta inherit, un ITextLayoutFormat oppure converte un array di oggetti con chiave e valore come membri di un TextLayoutFormat.

Il valore consentito è FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà null.

Definisce gli attributi di formattazione utilizzati per i collegamenti nello stato normal. Questo valore viene riflesso nella gerarchia e applicato agli eventuali collegamenti discendenti. Accetta inherit, un ITextLayoutFormat oppure converte un array di oggetti con chiave e valore come membri di un TextLayoutFormat.

Il valore consentito è FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà null.

Specifica un rientro automatico per il bordo iniziale degli elenchi quando il valore di riempimento dell'elenco su quel lato è auto.

I valori consentiti sono i numeri compresi tra -1000 e 1000 e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 40.

Definisce i marcatori di elenco degli attributi di formattazione. Questo valore viene riflesso nella gerarchia e applicato agli eventuali collegamenti discendenti. Accetta inherit, un IListMarkerFormat oppure converte un array di oggetti con chiave e valore come membri di un ListMarkerFormat.

Il valore consentito è FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà null.

i valori validi sono ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà ListStylePosition.OUTSIDE.

Elementi API correlati

I valori validi sono ListStyleType.UPPER_ALPHA, ListStyleType.LOWER_ALPHA, ListStyleType.UPPER_ROMAN, ListStyleType.LOWER_ROMAN, ListStyleType.NONE, ListStyleType.DISC, ListStyleType.CIRCLE, ListStyleType.SQUARE, ListStyleType.BOX, ListStyleType.CHECK, ListStyleType.DIAMOND, ListStyleType.HYPHEN, ListStyleType.ARABIC_INDIC, ListStyleType.BENGALI, ListStyleType.DECIMAL, ListStyleType.DECIMAL_LEADING_ZERO, ListStyleType.DEVANAGARI, ListStyleType.GUJARATI, ListStyleType.GURMUKHI, ListStyleType.KANNADA, ListStyleType.PERSIAN, ListStyleType.THAI, ListStyleType.URDU, ListStyleType.CJK_EARTHLY_BRANCH, ListStyleType.CJK_HEAVENLY_STEM, ListStyleType.HANGUL, ListStyleType.HANGUL_CONSTANT, ListStyleType.HIRAGANA, ListStyleType.HIRAGANA_IROHA, ListStyleType.KATAKANA, ListStyleType.KATAKANA_IROHA, ListStyleType.LOWER_ALPHA, ListStyleType.LOWER_GREEK, ListStyleType.LOWER_LATIN, ListStyleType.UPPER_ALPHA, ListStyleType.UPPER_GREEK, ListStyleType.UPPER_LATIN, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà ListStyleType.DISC.

Elementi API correlati

Le impostazioni internazionali del testo. Controlla le trasformazioni di maiuscole/minuscole e la modellazione. Vengono utilizzati identificatori della versione locale standard come descritto nello standard tecnico Unicode n. 35, ad esempio en, en_US ed en-GB si riferiscono all'inglese, mentre ja è per il giapponese.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà it.

Margine inferiore in pixel. Il valore predefinito di auto è zero, tranne che negli elenchi il cui riempimento laterale iniziale è di 45. (utilizza il valore predefinito se è undefined durante la cascata). Spazio tra il bordo inferiore del contenitore e il testo. Il valore è un numero oppure auto.

Con testo orizzontale, in contenitori scorrevoli con più colonne, la prima colonna e le seguenti mostreranno il riempimento come spazio vuoto sul fondo del contenitore, ma per l'ultima colonna, se il testo non può essere contenuto tutto, potrebbe essere necessario scorrere per visualizzare il riempimento.

I valori validi come stringa sono FormatValue.AUTO, FormatValue.INHERIT e i numeri da -8000 a 8000.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore FormatValue.AUTO.

Elementi API correlati

Margine sinistro in pixel. Il valore predefinito di auto è zero, tranne che negli elenchi il cui riempimento laterale iniziale è di 45. (utilizza il valore predefinito se è undefined durante la cascata). Spazio tra il bordo sinistro del contenitore e il testo. Il valore è un numero oppure auto.

Con testo verticale, in contenitori scorrevoli con più colonne, la prima colonna e le seguenti mostreranno il riempimento come spazio vuoto alla fine del contenitore, ma per l'ultima colonna, se il testo non può essere contenuto tutto, potrebbe essere necessario scorrere per visualizzare il riempimento.

I valori validi come stringa sono FormatValue.AUTO, FormatValue.INHERIT e i numeri da -8000 a 8000.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore FormatValue.AUTO.

Elementi API correlati

Margine destro in pixel. Il valore predefinito di auto è zero, tranne che negli elenchi il cui riempimento laterale iniziale è di 45. (utilizza il valore predefinito se è undefined durante la cascata). Spazio tra il bordo destro del contenitore e il testo. Il valore è un numero oppure auto.

I valori validi come stringa sono FormatValue.AUTO, FormatValue.INHERIT e i numeri da -8000 a 8000.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore FormatValue.AUTO.

Elementi API correlati

Margine superiore in pixel. Il valore predefinito di auto è zero, tranne che negli elenchi il cui riempimento laterale iniziale è di 45. (utilizza il valore predefinito se è undefined durante la cascata). Spazio tra il bordo superiore del contenitore e il testo. Il valore è un numero oppure auto.

I valori validi come stringa sono FormatValue.AUTO, FormatValue.INHERIT e i numeri da -8000 a 8000.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore FormatValue.AUTO.

Elementi API correlati

Un numero che specifica, in pixel, la quantità di rientro del bordo finale del paragrafo. Si riferisce al bordo destro nel testo da sinistra a destra e al bordo sinistro nel testo da destra a sinistra.

I valori consentiti sono i numeri compresi tra 0 e 8000 e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 0.

Un numero che specifica la quantità di spazio, in pixel, da lasciare dopo il paragrafo. Viene compresso insieme a paragraphSpaceBefore.

I valori consentiti sono i numeri compresi tra 0 e 8000 e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 0.

Un numero che specifica la quantità di spazio, in pixel, da lasciare prima del paragrafo. Viene compresso insieme a paragraphSpaceAfter.

I valori consentiti sono i numeri compresi tra 0 e 8000 e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 0.

Un numero che specifica, in pixel, la quantità di rientro del bordo iniziale del paragrafo. Si riferisce al bordo sinistro nel testo da sinistra a destra e al bordo destro nel testo da destra a sinistra.

I valori consentiti sono i numeri compresi tra 0 e 8000 e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 0.

La modalità di rendering utilizzata per questo testo. Si applica tolo ai caratteri incorporati (la proprietà fontLookup è impostata su FontLookup.EMBEDDED_CFF).

i valori validi sono RenderingMode.NORMAL, RenderingMode.CFF, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà RenderingMode.CFF.

Elementi API correlati

Assegna una classe identificativa all'elemento, rendendo possibile l'impostazione di uno stile per l'elemento mediante un riferimento allo styleName.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore null.

Restituisce gli stili per questo TextLayoutFormat. Tenete presente che la proprietà getter esegue una copia del dizionario degli stili. L'oggetto coreStyles incorpora tutti gli stili impostati nella proprietà format, compresi gli stili principali e gli stili utente. L'oggetto restituito è composto da un array di coppie nome stile-valore.

Elementi API correlati

Specifica le tabulazioni associate al paragrafo. Le funzioni setter possono accettare un array di TabStopFormat, una rappresentazione di stringa ridotta, undefined o FormatValue.INHERIT. La rappresentazione condensata in formato stringa viene sempre convertita in un array di TabStopFormat.

Il formato basato su stringa è un elenco di arresti di tabulazione dove ogni tabulazione è delimitata da uno o più spazi.

Un arresto di tabulazione ha il formato seguente: <tipo di allineamento><posizione allineamento>|<token allineamento>.

Il tipo di allineamento è un solo carattere e può essere S, E, C o D (maiuscole o minuscole). S o s per inizio (start), E o e per fine (end), C o c per centro, D o d per decimale. Il tipo di allineamento è opzionale e, se non viene specificato, il valore predefinito è S.

La posizione di allineamento è un numero e segue la specifica FXG per i numeri (notazione decimale o scientifica). La posizione di allineamento è obbligatoria.

La barra verticale viene utilizzata per separare la posizione di allineamento dal token di allineamento e dovrebbe essere presente solo se il token di allineamento è presente.

Il token di allineamento è opzionale se il tipo di allineamento è D e non dovrebbe essere presente se il tipo di allineamento è diverso da D. Può essere una sequenza di caratteri qualsiasi che si conclude con lo spazio che termina l'arresto di tabulazione (per l'ultimo arresto di tabulazione lo spazio di terminazione è opzionale; il token di fine allineamento è implicito). Uno spazio può fare parte del token di allineamento se si utilizza una barra rovesciata (\) come carattere di escape. Una barra rovesciata può fare parte del token di allineamento se si utilizza un'altra barra rovesciata (\\) come carattere di escape. Se il tipo di allineamento è D e il token di allineamento non viene specificato, verrà utilizzato il valore predefinito null.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà null.

Elementi API correlati

L'allineamento delle righe nel paragrafo in relazione al contenitore. TextAlign.LEFT allinea le righe al bordo sinistro del contenitore. TextAlign.RIGHT allinea le righe al bordo destro. TextAlign.CENTER posiziona la riga equidistante dai bordi sinistro e destro. TextAlign.JUSTIFY distribuisce le righe in modo da riempire lo spazio. TextAlign.START equivale all'impostazione su sinistra nel testo da sinistra a destra o su destra nel testo da destra a sinistra. TextAlign.END equivale all'impostazione su destra nel testo da sinistra a destra o su sinistra nel testo da destra a sinistra.

I valori validi sono TextAlign.LEFT, TextAlign.RIGHT, TextAlign.CENTER, TextAlign.JUSTIFY, TextAlign.START, TextAlign.END, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà TextAlign.START.

Elementi API correlati

L'allineamento dell'ultima o della sola riga nel paragrafo in relazione al contenitore con testo giustificato. Se textAlign è impostato suTextAlign.JUSTIFY, textAlignLast specifica la modalità di allineamento dell'ultima riga (o della sola riga, se si tratta di un blocco di una riga). I valori sono simili a textAlign.

I valori validi sono TextAlign.LEFT, TextAlign.RIGHT, TextAlign.CENTER, TextAlign.JUSTIFY, TextAlign.START, TextAlign.END, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà TextAlign.START.

Elementi API correlati

Valore alfa (trasparenza) per il testo. Un valore 0 è completamente trasparente, mentre un valore 1 è completamente opaco. Gli oggetti di visualizzazione con textAlpha impostato su 0 sono attivi, anche se invisibili.

I valori consentiti sono numeri compresi tra 0 e 1 e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 1.

La formattazione del testo. Utilizzate questa funzione per applicare la sottolineatura; il valore predefinito è none (nessuno).

I valori validi sono TextDecoration.NONE, TextDecoration.UNDERLINE, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà TextDecoration.NONE.

Elementi API correlati

Un valore Number che specifica, in pixel, la quantità di rientro della prima riga del paragrafo. Con un rientro negativo la riga risulta all'esterno del margine e a volte anche del contenitore.

I valori consentiti sono i numeri compresi tra -8000 e 8000 e FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 0.

Specifica le opzioni per la giustificazione del testo. Il valore predefinito è TextJustify.INTER_WORD, e ciò significa che viene aggiunto spazio supplementare ai caratteri spazio. TextJustify.DISTRIBUTE aggiunge spazio supplementare ai caratteri spazio e tra le singole lettere. Utilizzato solo insieme a un valore justificationRule di JustificationRule.SPACE.

I valori validi sono TextJustify.INTER_WORD, TextJustify.DISTRIBUTE, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà TextJustify.INTER_WORD.

Elementi API correlati

Determina il numero di gradi di rotazione di questo testo.

I valori validi sono TextRotation.ROTATE_0, TextRotation.ROTATE_180, TextRotation.ROTATE_270, TextRotation.ROTATE_90, TextRotation.AUTO, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà TextRotation.AUTO.

Elementi API correlati

Numero espresso in pixel (o percentuale di fontSize, ad esempio 120%) che indica la quantità di tracciamento (crenatura manuale) da applicare a sinistra di ogni carattere. Se la crenatura è attivata, il valore di trackingLeft viene sommato ai valori nella tabella di crenatura per il carattere. Se la crenatura è disattivata, il valore di trackingLeft viene usato come valore di crenatura manuale. Supporta sia valori positivi che negativi.

I valori consentiti come numero sono compresi tra -1000 e 1000.

I valori consentiti come percentuale sono numeri compresi tra -1000% e 1000%.

Il valore consentito è FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 0.

Numero espresso in pixel (o percentuale di fontSize, ad esempio 120%) che indica la quantità di tracciamento (crenatura manuale) da applicare a destra di ogni carattere. Se la crenatura è attivata, il valore di trackingRight viene sommato ai valori nella tabella di crenatura per il carattere. Se la crenatura è disattivata, il valore di trackingRight viene usato come valore di crenatura manuale. Supporta sia valori positivi che negativi.

I valori consentiti come numero sono compresi tra -1000 e 1000.

I valori consentiti come percentuale sono numeri compresi tra -1000% e 1000%.

Il valore consentito è FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 0.

Il tipo di carattere tipografico (maiuscolo/minuscolo) utilizzato per questo testo. Di seguito sono forniti alcuni esempi.

I valori validi sono TLFTypographicCase.DEFAULT, TLFTypographicCase.CAPS_TO_SMALL_CAPS, TLFTypographicCase.UPPERCASE, TLFTypographicCase.LOWERCASE, TLFTypographicCase.LOWERCASE_TO_SMALL_CAPS, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà TLFTypographicCase.DEFAULT.

Elementi API correlati

Restituisce l'oggetto userStyles per questo TextLayoutFormat. L'oggetto userStyles incorpora i formati che sono definiti da TextLayoutFormat e non sono in TextLayoutFormat.description. L'oggetto userStyles restituito è composto da un array di coppie nome stile-valore.

Elementi API correlati

Allineamento verticale o giustificazione (utilizza il valore predefinito se è undefined durante la cascata). Determina in che modo gli elementi TextFlow vengono allineati al contenitore.

I valori validi sono VerticalAlign.TOP, VerticalAlign.MIDDLE, VerticalAlign.BOTTOM, VerticalAlign.JUSTIFY, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà avrà il valore VerticalAlign.TOP.

Elementi API correlati

Comprime o mantiene gli spazi vuoti durante l'importazione del testo in un oggetto TextFlow. WhiteSpaceCollapse.PRESERVE mantiene tutti i caratteri spazio vuoto. WhiteSpaceCollapse.COLLAPSE rimuove i caratteri nuova riga, di tabulazione e interlinea o spazi vuoti in un blocco di testo importato. I tag di interruzione riga () e i caratteri di separazione riga Unicode vengono mantenuti.

I valori validi sono WhiteSpaceCollapse.PRESERVE, WhiteSpaceCollapse.COLLAPSE, FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà erediterà il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà WhiteSpaceCollapse.COLLAPSE.

Elementi API correlati

Specifica la spaziatura ottimale, minima e massima (come moltiplicatore della larghezza di uno spazio normale) da utilizzare tra le parole durante la giustificazione. Lo spazio ottimale viene utilizzato per indicare la dimensione desiderata di uno spazio, come frazione del valore definito nel font. I valori minimo e massimo sono utilizzati quando textJustify è distribuito per determinare quanto possono diventare larghi o stretti gli spazi tra le parole prima che venga utilizzata la spaziatura tra lettere per giustificare la riga.

I valori consentiti come percentuale sono numeri compresi tra -1000% e 1000%.

Il valore consentito è FormatValue.INHERIT.

Il valore predefinito è undefined e indica che non è impostato.

Se durante la cascata i valori sono undefined, questa proprietà eredita il valore da un elemento antenato. Se nessun antenato ha impostato questa proprietà, il valore sarà 100%, 50%, 150%.

Crea un nuovo oggetto TextLayoutFormat. Tutte le impostazioni sono vuote o, opzionalmente, vengono inizializzate dall'oggetto initialValues fornito.

Elementi API correlati

Sostituisce i valori della proprietà in questo oggetto TextLayoutFormat con i valori delle proprietà che vengono impostati nell'istanza di ITextLayoutFormat incoming. Le proprietà undefined nell'istanza incoming di ITextLayoutFormat non vengono modificate in questo oggetto.

Parametri

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_applyExample extends Sprite
    {
        public function TextLayoutFormat_applyExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes in the first one
            textLayoutFormat.textIndent = 8;
            textLayoutFormat.color = 0x336633;
            textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
            textLayoutFormat.fontSize = 24;
            // set some of the same attributes on the second one
            textLayoutFormat2.color = 0x0000CC;
            textLayoutFormat2.fontSize = 12;
            textLayoutFormat2.textIndent = 24;
            // add text to the span, the span to the paragraph, and the paragraph to the text flow.
            span.text = "Notice that fontFamily is unchanged because it was undefined in textLayoutFormat2.";
            p.addChild( span);
            textFlow.addChild(p);
            // use apply() to apply textLayoutFormat2 format settings; assign format to the text flow
            textLayoutFormat.apply(textLayoutFormat2);  
            textFlow.hostFormat = textLayoutFormat;  
            // add paragraph to textFlow and update controller to display it
            textFlow.addChild(p);
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();  
        }
    }
}

Concatena i valori delle proprietà nell'istanza di ITextLayoutFormat incoming con i valori di questo oggetto TextLayoutFormat. In questo oggetto TextLayoutFormat (receiving), le proprietà i cui valori sono FormatValue.INHERIT e le proprietà che ereditano i cui valori sono undefined otterranno nuovi valori dall'oggetto incoming. Le proprietà che non ereditano e i cui valori sono undefined otterranno i propri valori predefiniti. I valori di tutte le altre proprietà rimarranno invariati.

Parametri

Elementi API correlati

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_concatExample extends Sprite
    {
        public function TextLayoutFormat_concatExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes in the first one
            textLayoutFormat.textIndent = 8;
            textLayoutFormat.color = 0x336633;
            textLayoutFormat.fontSize = 18;
            // set some of the same attributes on the second one
            textLayoutFormat2.textIndent = 24;
            textLayoutFormat2.color = 0x0000CC;
            textLayoutFormat2.fontSize = 12;
            textLayoutFormat2.fontFamily = "Arial, Helvetica, _sans";
            // concat textLayoutFormat2 settings; assign format to the text flow
            textLayoutFormat.concat(textLayoutFormat2);    
            textFlow.hostFormat = textLayoutFormat; 
            // add text to the span, the span to the paragraph, and the paragraph to the text flow.
            span.text = "Notice that fontFamily value has been added from textLayout2 to textLayout but " +
                "the other values have not been changed.";     
            p.addChild( span);
            textFlow.addChild(p);
            // update controller to display it
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers(); 
        }
    }
}

Concatena i valori delle proprietà nell'istanza di ITextLayoutFormat incoming con i valori di questo oggetto TextLayoutFormat. In questo oggetto TextLayoutFormat (receiving), le proprietà i cui valori sono FormatValue.INHERIT e le proprietà che ereditano i cui valori sono undefined otterranno nuovi valori dall'oggetto incoming. I valori di tutte le altre proprietà rimarranno invariati.

Parametri

Elementi API correlati

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_concatInheritOnlyExample extends Sprite
    {
        public function TextLayoutFormat_concatInheritOnlyExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes in the first one
            textLayoutFormat.color = 0xFF0000;
            textLayoutFormat.fontSize = undefined;            
            // set attributes on the second one (fontSize set here, too)
            textLayoutFormat2.color = 0x00FF00;
            textLayoutFormat2.backgroundColor = 0x00CCCC;
            textLayoutFormat2.fontSize = 16;
            textLayoutFormat2.fontFamily = "Times Roman";
            // concat textLayoutFormat2 settings; assign format to the text flow
            textLayoutFormat.concatInheritOnly(textLayoutFormat2);    
            textFlow.hostFormat = textLayoutFormat; 
            // add text to the span, the span to the paragraph, and the paragraph to the text flow.
            span.text = "Notice that the value of backgroundColor is "
            span.text += textLayoutFormat.backgroundColor;
            span.text += ", even though it is set in textLayoutFormat2. This is because " +
                "this property does not inherit. Also notice that font color does not change " +
                "because it is not undefined."
            p.addChild( span);
            textFlow.addChild(p);
            // update controller to display it
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();  
        }
    }
}

Copia le impostazioni di TextLayoutFormat dall'istanza values di ITextLayoutFormat in questo oggetto TextLayoutFormat. Se values è null, questo oggetto TextLayoutFormat viene inizializzato con values su undefined per tutte le proprietà.

Parametri

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_copyExample extends Sprite
    {
        public function TextLayoutFormat_copyExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes in the second one
            textLayoutFormat2.textIndent = 8;
            textLayoutFormat2.color = 0x336633;
            textLayoutFormat2.fontFamily = "Times Roman";
            textLayoutFormat2.fontSize = 18;
            // add text to the span, the span to the paragraph, and the paragraph to the text flow.
            span.text = "Notice that formatting values set in textLayoutFormat2 override " +
                "the default values in textLayoutFormat."; 
            p.addChild(span);
            textFlow.addChild(p);
            // copy format settings of textLayoutFormat2; assign format to the text flow
            textLayoutFormat.copy(textLayoutFormat2);
            textFlow.hostFormat = textLayoutFormat;  
            // add paragraph to textFlow and update controller to display it
            textFlow.addChild(p);
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();      
        }
    }
}

Crea un nuovo oggetto TextLayoutFormat. Tutte le impostazioni sono vuote o, opzionalmente, vengono inizializzate dall'oggetto initialValues fornito.

Parametri

Restituisce il valore dello stile specificato dal parametro styleProp, che specifica il nome dello stile.

Parametri

Confronta le proprietà nell'istanza di ITextLayoutFormat p1 con le proprietà nell'istanza di ITextLayoutFormat p2 e restituisce true se tutte le proprietà corrispondono.

Parametri

Imposta le proprietà in questo oggetto TextLayoutFormat su undefined se non corrispondono a quelle presenti nell'istanza di ITextLayoutFormat incoming.

Parametri

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_removeClashingExample extends Sprite
    {
        public function TextLayoutFormat_removeClashingExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes for textLayoutFormat2
            textLayoutFormat.textIndent = 8;
            textLayoutFormat.color = 0x336633;
            textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
            textLayoutFormat.fontSize = 24;
            // set fontFamily to same value for textLayoutFormat2            
            textLayoutFormat2.fontFamily = "Arial, Helvetica, _sans";
            // add text to the span, the span to the paragraph, and the paragraph to the text flow.
            span.text = "Notice that fontFamily (Arial, Helvetica, _sans) is applied." 
            p.addChild( span);
            textFlow.addChild(p);    
            // call removeClashing(), cancelling any values that clash with textLayoutFormat; 
            // assign it to the text flow
            textLayoutFormat.removeClashing(textLayoutFormat2);  
            textFlow.hostFormat = textLayoutFormat;  
            // add paragraph to textFlow and update controller to display it
            textFlow.addChild(p);
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();  
        }
    }
}

Imposta le proprietà in questo oggetto TextLayoutFormat su undefined se corrispondono a quelle presenti nell'istanza di ITextLayoutFormat incoming.

Parametri

package flashx.textLayout.formats.examples {
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class TextLayoutFormat_removeMatchingExample extends Sprite
    {
        public function TextLayoutFormat_removeMatchingExample()
        {
            // create a container and add it to the stage
            var container:Sprite = new Sprite();
            this.stage.addChild(container);
            // create TextFlow, ParagraphElement, and SpanElement objects
            var textFlow:TextFlow = new TextFlow();
            var p:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement();
            // create two TextLayoutFormat objects
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var textLayoutFormat2:TextLayoutFormat = new TextLayoutFormat();
            // set format attributes for textLayoutFormat
            textLayoutFormat.textIndent = 8;
            textLayoutFormat.color = 0x336633;
            textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
            textLayoutFormat.fontSize = 24;
            // add text to the span, the span to the paragraph, and the paragraph to the text flow
            span.text = "Notice that fontFamily (Arial, Helvetica, _sans) is not applied." 
            p.addChild( span);
            textFlow.addChild(p);
            // set fontFamily to same value for textLayoutFormat2            
            textLayoutFormat2.fontFamily = "Arial, Helvetica, _sans";        
            // call removeMatching() to remove any values that match textLayoutFormat2; 
            // assign textLayoutFormat to the text flow
            textLayoutFormat.removeMatching(textLayoutFormat2);
            textFlow.hostFormat = textLayoutFormat;  
            // add paragraph to textFlow and update controller to display it
            textFlow.addChild(p);
            var controller:ContainerController = new ContainerController(container, 200, 200 );
            textFlow.flowComposer.addController(controller);
            textFlow.flowComposer.updateAllControllers();  
        }
    }
}

Imposta lo stile specificato dal parametro styleProp sul valore specificato dal parametro newValue.

Parametri