Pacchetto | flashx.textLayout.compose |
Classe | public final class TextFlowLine |
Ereditarietà | TextFlowLine Object |
Implementa | IVerticalJustificationLine |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Utilizzate questa classe per accedere alle informazioni sulla modalità di composizione di una riga di testo, ad esempio: la posizione, l'altezza, la larghezza e così via. Quando il flusso di testo (TextFlow) viene modificato, le righe immediatamente prima e in corrispondenza della modifica vengono contrassegnate come non valide, in quanto devono essere ricomposte. Le righe successive al punto corrispondente alla modifica potrebbero non essere danneggiate immediatamente, ma potrebbero venire rigenerate dopo la composizione del testo. Potete accedere a una classe TextFlowLine danneggiato, tuttavia qualsiasi valore a cui accedete riflette il precedente stato di TextFlow. Quando TextFlow viene ricomposto, genera nuove righe e potete ottenere la nuova riga per una determinata posizione chiamando TextFlow.flowComposer.findLineAtPosition()
.
Proprietà | Definito da | ||
---|---|---|---|
absoluteStart : int [sola lettura]
La posizione della riga come posizione del carattere assoluta nell'oggetto TextFlow. | TextFlowLine | ||
ascent : Number [sola lettura]
Specifica il numero di pixel dalla linea di base all'estremità superiore dell'altezza della riga, espressa in pixel. | TextFlowLine | ||
columnIndex : int [sola lettura] Il numero della colonna in cui è stata inserita la riga, dove il numero della prima colonna è 0. | TextFlowLine | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
controller : ContainerController [sola lettura]
Il controller (oggetto ContainerController) per il contenitore in cui è stata inserita la riga. | TextFlowLine | ||
descent : Number [sola lettura]
Specifica il numero di pixel dalla linea di base alla estremità inferiore massima dei caratteri discendenti nella riga. | TextFlowLine | ||
height : Number [sola lettura] L'altezza della riga espressa in pixel. | TextFlowLine | ||
lineOffset : Number [sola lettura]
L'offset della riga, espresso in pixel, dall'interno del contenitore appropriato (secondo quanto specificato dalla direzione del paragrafo e dall'avanzamento del blocco del contenitore), prima dell'allineamento delle righe nel paragrafo. | TextFlowLine | ||
location : int [sola lettura]
Uno dei valori di TextFlowLineLocation per specificare la posizione di una riga all'interno di un paragrafo. | TextFlowLine | ||
paragraph : ParagraphElement [sola lettura]
Il paragrafo (ParagraphElement) in cu risiede la riga. | TextFlowLine | ||
spaceAfter : Number [sola lettura]
La quantità di spazio da lasciare dopo la riga. | TextFlowLine | ||
spaceBefore : Number [sola lettura]
La quantità di spazio da lasciare prima della riga. | TextFlowLine | ||
textHeight : Number [sola lettura]
L'altezza della riga di testo, che è uguale ad ascent più descent. | TextFlowLine | ||
textLength : int [sola lettura]
Il numero di caratteri prima della riga successiva, inclusi gli spazi finali. | TextFlowLine | ||
textLineExists : Boolean [sola lettura]
Indica se è presente l'oggetto flash.text.engine.TextLine per questa TextFlowLine. | TextFlowLine | ||
unjustifiedTextWidth : Number [sola lettura]
La larghezza della riga, se non è stata giustificata. | TextFlowLine | ||
validity : String [sola lettura] Il valore validity della riga. | TextFlowLine | ||
x : Number
La posizione orizzontale della riga rispetto al relativo contenitore, espressa come l'offset in pixel dal lato sinistro del contenitore. | TextFlowLine | ||
y : Number
La posizione verticale della riga rispetto al relativo contenitore, espressa come l'offset in pixel dal lato superiore del contenitore. | TextFlowLine |
Metodo | Definito da | ||
---|---|---|---|
TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0) Funzione di costruzione - crea una nuova istanza TextFlowLine. | TextFlowLine | ||
Restituisce i limiti della riga sotto forma di rettangolo. | TextFlowLine | ||
Restituisce l'oggetto flash.text.engine.TextLine per questa riga, che può essere ricreata se non è presente a causa di un'operazione di garbage collection. | TextFlowLine | ||
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 |
absoluteStart | proprietà |
ascent | proprietà |
ascent:Number
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Specifica il numero di pixel dalla linea di base all'estremità superiore dell'altezza della riga, espressa in pixel. Per un oggetto TextLine che contiene solo un elemento grafico, ascent
è impostato su 0.
Implementazione
public function get ascent():Number
columnIndex | proprietà |
controller | proprietà |
controller:ContainerController
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Il controller (oggetto ContainerController) per il contenitore in cui è stata inserita la riga.
Implementazione
public function get controller():ContainerController
Elementi API correlati
descent | proprietà |
descent:Number
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Specifica il numero di pixel dalla linea di base alla estremità inferiore massima dei caratteri discendenti nella riga. Per un oggetto TextLine che contiene solo un elemento grafico, descent
è impostato su 0.
Implementazione
public function get descent():Number
height | proprietà |
lineOffset | proprietà |
lineOffset:Number
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
L'offset della riga, espresso in pixel, dall'interno del contenitore appropriato (secondo quanto specificato dalla direzione del paragrafo e dall'avanzamento del blocco del contenitore), prima dell'allineamento delle righe nel paragrafo.
Implementazione
public function get lineOffset():Number
location | proprietà |
paragraph | proprietà |
paragraph:ParagraphElement
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Il paragrafo (ParagraphElement) in cu risiede la riga.
Implementazione
public function get paragraph():ParagraphElement
Elementi API correlati
spaceAfter | proprietà |
spaceAfter:Number
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
La quantità di spazio da lasciare dopo la riga.
Se la riga è l'ultima di un paragrafo dopo il quale è presente uno spazio, il valore della riga è spaceAfter
. Se la riga si trova alla fine di una colonna, il valore spaceAfter
viene ignorato. Diversamente, la riga precede un'altra riga nella colonna e la riga successiva deve essere posizionata verticalmente per assicurare che tra quest'ultima riga del paragrafo e la prima riga del paragrafo successivo rimanga almeno tale spazio.
Implementazione
public function get spaceAfter():Number
Elementi API correlati
spaceBefore | proprietà |
spaceBefore:Number
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
La quantità di spazio da lasciare prima della riga.
Se la riga è la prima di un paragrafo prima del quale è presente uno spazio, il valore della riga è spaceBefore
. Se la riga si trova all'inizio di una colonna, il valore spaceBefore
viene ignorato. Diversamente, la riga segue un'altra riga nella colonna e viene posizionata verticalmente per assicurare che tra questa riga e l'ultima riga del paragrafo precedente rimanga almeno tale spazio.
Implementazione
public function get spaceBefore():Number
Elementi API correlati
textHeight | proprietà |
textHeight:Number
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
L'altezza della riga di testo, che è uguale ad ascent
più descent
. Il valore viene calcolato in base alla differenza tra le linee di base che delimitano la riga, sia ideografiche superiori e inferiori o ascendenti e discendenti, a seconda che la linea di base in corrispondenza di y=0 sia ideografica (ad esempio TextBaseline.IDEOGRAPHIC_TOP) o meno.
Implementazione
public function get textHeight():Number
Elementi API correlati
textLength | proprietà |
textLineExists | proprietà |
textLineExists:Boolean
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Indica se è presente l'oggetto flash.text.engine.TextLine
per questa TextFlowLine. Il valore ètrue
se l'oggetto TextLine non è stato sottoposto a garbage collection; false
se lo è stato.
Implementazione
public function get textLineExists():Boolean
Elementi API correlati
unjustifiedTextWidth | proprietà |
unjustifiedTextWidth:Number
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
La larghezza della riga, se non è stata giustificata. Per il testo non giustificato, questo valore è lo stesso di textLength
. Per il testo giustificato, questo valore corrisponde alla lunghezza che avrebbe avuto il testo senza giustificazione e textLength
rappresenta la larghezza effettiva della riga. Quando, ad esempio, la stringa seguente viene giustificata e e viene assegnata una larghezza 500, la larghezza effettiva sarà 500 mentre quella non giustificata sarà pari a 268,9921875.
Implementazione
public function get unjustifiedTextWidth():Number
validity | proprietà |
validity:String
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Il valore validity della riga.
Una riga può non essere valida se il testo, gli attributi applicati al testo o le impostazioni del controller sono state modificate dal momento in cui è stata creata. Una riga non valida può tuttavia essere visualizzata e utilizzata, ma i valori utilizzati saranno quelli specificati al momento della sua creazione. Anche le riga restituita da getTextLine()
sarà in uno stato non valido.
Implementazione
public function get validity():String
Elementi API correlati
x | proprietà |
x:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
La posizione orizzontale della riga rispetto al relativo contenitore, espressa come l'offset in pixel dal lato sinistro del contenitore.
Nota: anche se questa proprietà è tecnicamente di lettura/scrittura
, consideratela come di sola lettura
. La funzione setter è presente solo per soddisfare i requisiti dell'interfaccia IVerticalJustificationLine che definisce entrambe le funzioni getter e setter per questa proprietà. L'utilizzo di setter, sebbene possibile, causa risultati imprevedibili.
Implementazione
public function get x():Number
public function set x(value:Number):void
Elementi API correlati
y | proprietà |
y:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
La posizione verticale della riga rispetto al relativo contenitore, espressa come l'offset in pixel dal lato superiore del contenitore.
Nota: anche se questa proprietà è tecnicamente di lettura/scrittura
, consideratela come di sola lettura
. La funzione setter è presente solo per soddisfare i requisiti dell'interfaccia IVerticalJustificationLine che definisce entrambe le funzioni getter e setter per questa proprietà. L'utilizzo di setter, sebbene possibile, causa risultati imprevedibili.
Implementazione
public function get y():Number
public function set y(value:Number):void
Elementi API correlati
TextFlowLine | () | Funzione di costruzione |
public function TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Funzione di costruzione - crea una nuova istanza TextFlowLine.
Nota: questa funzione non deve essere chiamata da alcun client. Viene esposta affinché possiate scrivere una funzione di composizione personalizzata.
ParametritextLine:flash.text.engine:TextLine — L'oggetto di visualizzazione TextLine da utilizzare per questa riga.
| |
paragraph:ParagraphElement — Il paragrafo (ParagraphElement) in cu inserire la riga.
| |
outerTargetWidth:Number (default = 0 ) — La larghezza in base a cui viene composta la riga, escludendo i rientri.
| |
lineOffset:Number (default = 0 ) — L'offset della riga, espresso in pixel, dall'interno del contenitore appropriato (secondo quanto specificato dalla direzione del paragrafo e dall'avanzamento del blocco del contenitore), prima dell'allineamento delle righe nel paragrafo.
| |
absoluteStart:int (default = 0 ) — La posizione del carattere nel flusso di testo da cui inizia la riga.
| |
numChars:int (default = 0 ) — Il numero di caratteri presenti nella riga.
|
Elementi API correlati
getBounds | () | metodo |
getTextLine | () | metodo |
public function getTextLine(forceValid:Boolean = false):flash.text.engine:TextLine
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Restituisce l'oggetto flash.text.engine.TextLine
per questa riga, che può essere ricreata se non è presente a causa di un'operazione di garbage collection. Impostate forceValid
sutrue
per fare in modo che TextLine venga rigenerato. Restituisce null se l'oggetto TextLine non può essere ricreato.
Parametri
forceValid:Boolean (default = false ) — se true, l'oggetto TextLine viene rigenerato se esiste ma non è valido.
|
flash.text.engine:TextLine — oggetto per questa riga o null se l'oggetto TextLine non può essere ricreato.
|
Elementi API correlati
Tue Jun 12 2018, 02:44 PM Z