| Pacchetto | flash.text.engine |
| Classe | public final class ElementFormat |
| Ereditarietà | ElementFormat  Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Un oggetto ElementFormat che viene applicato a un ContentElement in un TextBlock non invalida l'oggetto TextBlock. Quando un oggetto ElementFormat è stato applicato a un oggetto ContentElement, la relativa proprietà locked è impostata su true. Le proprietà di un oggetto ElementFormat 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 ContentElement.
Altri esempi
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| alignmentBaseline : String
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. | ElementFormat | ||
| alpha : Number
Specifica la trasparenza degli elementi della riga interessati da questo oggetto. | ElementFormat | ||
| baselineShift : Number
Indica lo spostamento della linea di base per l'elemento, espresso in pixel. | ElementFormat | ||
| breakOpportunity : String
L'opportunità di interruzione di riga applicata a questo testo. | ElementFormat | ||
| color : uint
Indica il colore del testo. | ElementFormat | ||
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| digitCase : String
Il tipo di cifre (ascendenti/discendenti) utilizzato per questo testo. | ElementFormat | ||
| digitWidth : String
La larghezza del carattere utilizzata per questo testo. | ElementFormat | ||
| dominantBaseline : String
Specifica la linea di base da utilizzare come linea di base dominante. | ElementFormat | ||
| fontDescription : FontDescription
Un oggetto le cui proprietà descrivono un carattere. | ElementFormat | ||
| fontSize : Number
Le dimensioni in pixel del testo. | ElementFormat | ||
| kerning : String
Le crenature regolano i pixel tra determinate coppie di caratteri per migliorare la leggibilità. | ElementFormat | ||
| ligatureLevel : String
Il livello di legatura utilizzato per questo testo. | ElementFormat | ||
| locale : String
Le impostazioni internazionali del testo. | ElementFormat | ||
| locked : Boolean
Indica se ElementFormat è bloccato. | ElementFormat | ||
| textRotation : String
Imposta la rotazione applicata ai singoli glifi. | ElementFormat | ||
| trackingLeft : Number
Il tracciamento o la crenatura manuale applicata a sinistra di ogni glifo, espressa in pixel. | ElementFormat | ||
| trackingRight : Number
Il tracciamento o la crenatura manuale applicata a destra di ogni glifo, espressa in pixel. | ElementFormat | ||
| typographicCase : String
Il carattere tipografico (maiuscolo/minuscolo) utilizzato per questo testo. | ElementFormat | ||
| Metodo | Definito da | ||
|---|---|---|---|
ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")
Crea un oggetto ElementFormat. | ElementFormat | ||
Crea una copia clonata non bloccata di ElementFormat. | ElementFormat | ||
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.
| ElementFormat | ||
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
alignmentBaseline | proprietà |
alignmentBaseline:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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:
| Valore stringa | Descrizione |
|---|---|
TextBaseline.ROMAN | L'oggetto dominantBaseline si allinea con la linea di base roman della riga. |
TextBaseline.ASCENT | L'oggetto dominantBaseline si allinea con la linea di base ascendente della riga. |
TextBaseline.DESCENT | L'oggetto dominantBaseline si allinea con la linea di base discendente della riga. |
TextBaseline.IDEOGRAPHIC_TOP | L'oggetto dominantBaseline si allinea con la linea di base ideografica superiore della riga. |
TextBaseline.IDEOGRAPHIC_CENTER | L'oggetto dominantBaseline si allinea con la linea di base ideografica centrale della riga. |
TextBaseline.IDEOGRAPHIC_BOTTOM | L'oggetto dominantBaseline si allinea con la linea di base ideografica inferiore della riga. |
TextBaseline.USE_DOMINANT_BASELINE | L'oggetto dominantBaseline si allinea con la stesa linea di base della riga. |
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Imposta la linea di base di allineamento della riga a cui si allinea l'oggetto dominantBaseline dell'elemento grafico. |
GroupElement | Non ha alcun effetto. |
TextElement | Imposta la linea di base di allineamento della riga a cui si allinea l'oggetto dominantBaseline dell'elemento si testo. |
Implementazione
public function get alignmentBaseline():String public function set alignmentBaseline(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di TextBaseline.
| |
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Altri esempi
Elementi API correlati
alpha | proprietà |
alpha:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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.
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Applica il valore alfa specificato all'elemento grafico. Si combina come moltiplicatore con qualsiasi insieme di valori alfa allo stesso oggetto grafico DisplayObject o a TextLine. |
GroupElement | Non ha alcun effetto. |
TextElement | Applica il valore alfa specificato all'elemento di testo. Si combina come moltiplicatore con qualsiasi insieme di valori alfa a TextLine. |
Implementazione
public function get alpha():Number public function set alpha(value:Number):voidGenera
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Altri esempi
Elementi API correlati
baselineShift | proprietà |
baselineShift:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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.
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Allontana il grafico dalla linea di base. |
GroupElement | Non ha alcun effetto. |
TextElement | Allontana il testo dalla linea di base. |
Implementazione
public function get baselineShift():Number public function set baselineShift(value:Number):voidGenera
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Altri esempi
breakOpportunity | proprietà |
breakOpportunity:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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:
| Valore stringa | Descrizione |
|---|---|
BreakOpportunity.AUTO | Le opportunità di interruzione di riga si basano sulle proprietà dei caratteri Unicode standard, ad esempio l'interruzione tra le parole o l'utilizzo di trattini. |
BreakOpportunity.ANY | Tutti i caratteri nell'oggetto ContentElement sono considerati come un'opportunità di interruzione di riga. Potete in genere utilizzare questo valore quando incorporate testo Roman in testo asiatico e desiderate che le interruzioni avvengano al centro delle parole. |
BreakOpportunity.NONE | Nessun carattere nell'intervallo viene gestito come opportunità di interruzione di riga. |
BreakOpportunity.ALL | Tutti i caratteri nell'intervallo vengono gestiti come opportunità di interruzione di riga; ciò significa che dopo ogni carattere viene inserita un'interruzione di riga. Utile per creare effetti come il testo su un tracciato. |
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Non ha alcun effetto. |
GroupElement | Determina l'opportunità di interruzione tra elementi di testo adiacenti nel gruppo. Se elementFormat del gruppo è null, viene utilizzato il formato del primo degli elementi adiacenti. |
TextElement | Determina l'opportunità di interruzione tra i caratteri nell'elemento di testo. |
Implementazione
public function get breakOpportunity():String public function set breakOpportunity(value:String):voidGenera
ArgumentError — Se impostato su un valore che non è un membro di BreakOpportunity.
| |
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Altri esempi
Elementi API correlati
color | proprietà |
color:uint| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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).
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Non ha alcun effetto. |
GroupElement | Non ha alcun effetto. |
TextElement | Imposta il colore del testo. |
Implementazione
public function get color():uint public function set color(value:uint):voidGenera
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
digitCase | proprietà |
digitCase:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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:
| Valore stringa | Descrizione |
|---|---|
DigitCase.DEFAULT | Applica il tipo di cifre (ascendenti/discendenti) predefinito al testo. |
DigitCase.LINING | Applica il tipo di cifre (ascendenti/discendenti) per l'allineamento al testo. |
DigitCase.OLD_STYLE | Applica il tipo di cifre (ascendenti/discendenti) vecchio stile al testo. |
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Non ha alcun effetto. |
GroupElement | Non ha alcun effetto. |
TextElement | Determina il tipo di cifre (ascendenti/discendenti) utilizzato per il testo contenuto nell'elemento. |
Implementazione
public function get digitCase():String public function set digitCase(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di DigitCase.
| |
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Elementi API correlati
digitWidth | proprietà |
digitWidth:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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:
| Valore stringa | Descrizione |
|---|---|
DigitWidth.DEFAULT | Applica la larghezza delle cifre predefinita al testo. |
DigitWidth.PROPORTIONAL | Applica la larghezza delle cifre proporzionale al testo. |
DigitWidth.TABULAR | Applica la larghezza delle cifre tabulare al testo. |
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Non ha alcun effetto. |
GroupElement | Non ha alcun effetto. |
TextElement | Determina la larghezza del carattere utilizzata per il testo contenuto nell'elemento. |
Implementazione
public function get digitWidth():String public function set digitWidth(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di DigitWidth.
| |
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Elementi API correlati
dominantBaseline | proprietà |
dominantBaseline:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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:
| Valore stringa | Descrizione |
|---|---|
TextBaseline.ROMAN | La linea di base roman dell'elemento si allinea con alignmentBaseline. |
TextBaseline.ASCENT | La linea di base ascendente dell'elemento si allinea con alignmentBaseline. |
TextBaseline.DESCENT | La linea di base discendente dell'elemento si allinea con alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_TOP | La linea di base ideografica superiore dell'elemento si allinea con alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_CENTER | La linea di base ideografica centrale dell'elemento si allinea con alignmentBaseline. |
TextBaseline.IDEOGRAPHIC_BOTTOM | La linea di base ideografica inferiore dell'elemento si allinea con alignmentBaseline. |
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Determina quale delle linee di base dell'elemento grafico si allinea con alignmentBaseline. |
GroupElement | Non ha alcun effetto. |
TextElement | Determina quale delle linee di base dell'elemento di testo si allinea con alignmentBaseline. |
Implementazione
public function get dominantBaseline():String public function set dominantBaseline(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di TextBaseline.
| |
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Altri esempi
Elementi API correlati
fontDescription | proprietà |
fontDescription:FontDescription| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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.
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Non ha alcun effetto. |
GroupElement | Non ha alcun effetto. |
TextElement | Determina il carattere utilizzato per il testo contenuto nell'elemento. |
Implementazione
public function get fontDescription():FontDescription public function set fontDescription(value:FontDescription):voidGenera
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Elementi API correlati
fontSize | proprietà |
fontSize:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Le dimensioni in pixel del testo.
Il valore predefinito è 12.0.
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Non ha alcun effetto. |
GroupElement | Non ha alcun effetto. |
TextElement | Determina la dimensione in pixel per il testo contenuto nell'elemento. |
Implementazione
public function get fontSize():Number public function set fontSize(value:Number):voidGenera
ArgumentError — Se impostato su un valore minore di zero.
| |
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
kerning | proprietà |
kerning:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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:
| Valore stringa | Descrizione |
|---|---|
Kerning.ON | La crenatura è attivata. |
Kerning.OFF | La crenatura è disattivata. |
Kerning.AUTO | La crenatura è attivata eccetto nei casi inappropriati per il formato tipografico asiatico. La crenatura viene applicata tra due caratteri, se nessuno di essi è Kanji, Hiragana o Katakana. |
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Non ha alcun effetto. |
GroupElement | Determina se la crenatura viene applicata tra elementi di testo adiacenti nel gruppo. Se elementFormat del gruppo è null, viene utilizzato il formato del primo degli elementi adiacenti. |
TextElement | Determina se la crenatura viene applicata tra i caratteri nell'elemento di testo. |
Implementazione
public function get kerning():String public function set kerning(value:String):voidGenera
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Altri esempi
Elementi API correlati
ligatureLevel | proprietà |
ligatureLevel:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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:
| Valore stringa | Descrizione |
|---|---|
LigatureLevel.NONE | Non vengono create legature. |
LigatureLevel.MINIMUM | Vengono create legature minime. |
LigatureLevel.COMMON | Vengono create legature comuni. |
LigatureLevel.UNCOMMON | Vengono create legature non comuni. |
LigatureLevel.EXOTIC | Vengono create legature particolari. |
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Non ha alcun effetto. |
GroupElement | Determina il livello di legatura tra elementi di testo adiacenti nel gruppo. Se elementFormat del gruppo è null, viene utilizzato il formato del primo degli elementi adiacenti. |
TextElement | Determina il livello di legatura tra i caratteri nell'elemento di testo. |
Implementazione
public function get ligatureLevel():String public function set ligatureLevel(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di LigatureLevel.
| |
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Elementi API correlati
locale | proprietà |
locale:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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".
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Non ha alcun effetto. |
GroupElement | Non ha alcun effetto. |
TextElement | Determina le trasformazioni e la modellazione per il testo contenuto nell'elemento. |
Implementazione
public function get locale():String public function set locale(value:String):voidGenera
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
locked | proprietà |
locked:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5., Flash Lite 4 |
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().
Implementazione
public function get locked():Boolean public function set locked(value:Boolean):voidGenera
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Altri esempi
textRotation | proprietà |
textRotation:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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:
| Valore stringa | Descrizione |
|---|---|
TextRotation.ROTATE_0 | I glifi non vengono ruotati. |
TextRotation.ROTATE_90 | I glifi vengono ruotati di 90 gradi in senso orario. |
TextRotation.ROTATE_180 | I glifi vengono ruotati di 180 gradi. |
TextRotation.ROTATE_270 | I glifi vengono ruotati di 270 gradi in senso orario. |
TextRotation.AUTO | Specifica una rotazione in senso antiorario di 90 gradi solo per i glifi a larghezza intera ed estesi, secondo quanto determinato dalle proprietà Unicode del glifo. Questo valore viene utilizzato di solito per il testo asiatico per ruotare solo i glifi che richiedono la rotazione. Questa rotazione viene applicata solo al testo verticale per ripristinare l'orientamento verticale dei caratteri a larghezza intera ed estesi, senza incidere su altri caratteri. |
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Non ha alcun effetto. |
GroupElement | Non ha alcun effetto. |
TextElement | Determina la rotazione dei glifi nell'elemento di testo. |
Implementazione
public function get textRotation():String public function set textRotation(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di TextRotation.
| |
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Altri esempi
Elementi API correlati
trackingLeft | proprietà |
trackingLeft:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5., Flash Lite 4 |
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.
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Determina il tracciamento applicato sul lato sinistro del grafico. |
GroupElement | Non ha alcun effetto. |
TextElement | Determina il tracciamento applicato sul lato sinistro dei caratteri nell'elemento di testo. |
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;
Implementazione
public function get trackingLeft():Number public function set trackingLeft(value:Number):voidGenera
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Altri esempi
trackingRight | proprietà |
trackingRight:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5., Flash Lite 4 |
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.
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Determina il tracciamento applicato sul lato destro del grafico. |
GroupElement | Non ha alcun effetto. |
TextElement | Determina il tracciamento applicato sul lato destro dei caratteri nell'elemento di testo. |
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;
Implementazione
public function get trackingRight():Number public function set trackingRight(value:Number):voidGenera
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Altri esempi
typographicCase | proprietà |
typographicCase:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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:
| Valore stringa | Descrizione |
|---|---|
TypographicCase.DEFAULT | Specifica che deve essere utilizzato il formato (maiuscolo/minuscolo) normale per tutti i caratteri. |
TypographicCase.TITLE | Specifica che i caratteri maiuscoli useranno glifi in stile titolo nell'output. |
TypographicCase.CAPS | Specifica che la spaziatura viene regolata per i caratteri maiuscoli nell'output. |
TypographicCase.SMALL_CAPS | Specifica che i caratteri maiuscoli useranno glifi in maiuscoletto nell'output. |
TypographicCase.UPPERCASE | Specifica che tutti i caratteri useranno glifi in maiuscolo nell'output. |
TypographicCase.LOWERCASE | Specifica che tutti i caratteri useranno glifi in minuscolo nell'output. |
TypographicCase.CAPS_AND_SMALL_CAPS | Specifica che tutti i caratteri minuscoli useranno glifi in maiuscoletto nell'output. |
| Sottoclasse | Effetto dell'impostazione della proprietà |
|---|---|
GraphicElement | Non ha alcun effetto. |
GroupElement | Non ha alcun effetto. |
TextElement | Determina il carattere tipografico(maiuscolo/minuscolo) utilizzato per il testo contenuto nell'elemento. |
Implementazione
public function get typographicCase():String public function set typographicCase(value:String):voidGenera
ArgumentError — Se impostato su un valore che non è un membro di TypographicCase.
| |
IllegalOperationError — Se impostato dopo che l'oggetto ElementFormat viene bloccato (locked è true).
|
Altri esempi
Elementi API correlati
ElementFormat | () | Funzione di costruzione |
public function ElementFormat(fontDescription:FontDescription = null, fontSize:Number = 12.0, color:uint = 0x000000, alpha:Number = 1.0, textRotation:String = "auto", dominantBaseline:String = "roman", alignmentBaseline:String = "useDominantBaseline", baselineShift:Number = 0.0, kerning:String = "on", trackingRight:Number = 0.0, trackingLeft:Number = 0.0, locale:String = "en", breakOpportunity:String = "auto", digitCase:String = "default", digitWidth:String = "default", ligatureLevel:String = "common", typographicCase:String = "default")| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Crea un oggetto ElementFormat.
ParametrifontDescription:FontDescription (default = null)null. Se non viene fornita una descrizione del carattere, viene creata una descrizione del carattere predefinita.
| |
fontSize:Number (default = 12.0) | |
color:uint (default = 0x000000) | |
alpha:Number (default = 1.0)alpha da applicare a tutti gli atomi delle righe in base al formato dell'elemento.
| |
textRotation:String (default = "auto") | |
dominantBaseline:String (default = "roman") | |
alignmentBaseline:String (default = "useDominantBaseline") | |
baselineShift:Number (default = 0.0) | |
kerning:String (default = "on") | |
trackingRight:Number (default = 0.0) | |
trackingLeft:Number (default = 0.0) | |
locale:String (default = "en") | |
breakOpportunity:String (default = "auto") | |
digitCase:String (default = "default") | |
digitWidth:String (default = "default") | |
ligatureLevel:String (default = "common") | |
typographicCase:String (default = "default") |
Genera
ArgumentError — Il valore fontSize specificato è minore di 0.
| |
ArgumentError — L'oggetto textRotation specificato non è un membro di TextRotation.
| |
ArgumentError — L'oggetto dominantBaseline specificato non è un membro di TextBaseline.
| |
ArgumentError — L'oggetto dominantBaseline specificato non è un membro di TextBaseline.
| |
ArgumentError — L'oggetto kerning specificato non è un membro di Kerning.
| |
ArgumentError — L'oggetto breakOpportunity specificato non è un membro di BreakOpportunity.
| |
ArgumentError — L'oggetto digitCase specificato non è un membro di DigitCase.
| |
ArgumentError — L'oggetto digitWidthspecificato non è un membro di DigitWidth.
| |
ArgumentError — L'oggetto ligatureLevelspecificato non è un membro di LigatureLevel.
| |
ArgumentError — L'oggetto typographicCase specificato non è un membro di TypographicCase.
|
clone | () | metodo |
public function clone():ElementFormat| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Crea una copia clonata non bloccata di ElementFormat.
RestituisceElementFormat — Una copia non bloccata dell'oggetto ElementFormat.
|
Altri esempi
Esempio ( Come utilizzare questo esempio )
Questo esempio crea un oggetto ElementFormat e imposta una FontSize. Viene creato un nuovo TextElement utilizzando ElementFormat (e quindi bloccandolo) e TextElement viene utilizzato come contenuto per un TextBlock. Viene creata una riga di testo da TextBlock.
Per modificare l'oggetto ElementFormat, verificate prima la proprietà locked. Se è true, utilizzate il metodo clone() per creare una copia non bloccata di ElementFormat, modificate le proprietà e 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 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);
}
}
}
getFontMetrics | () | metodo |
public function getFontMetrics():FontMetrics| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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.
FontMetrics — Un oggetto FontMetrics che descrive le proprietà del carattere specificato da fontDescription.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
ElementFormat con assegnato un oggetto FontDescription e viene utilizzato il metodo getFontMetrics per visualizzare le metriche per il carattere scelto a 24 punti.
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;
}
}
}
Tue Jun 12 2018, 02:44 PM Z