IUITextField  - AS3 Flex

Quando è impostata su true e il campo di testo non è attivo, Flash Player evidenzia la selezione nel campo di testo in grigio. Quando è impostata su false e il campo di testo non è attivo, Flash Player non evidenzia la selezione nel campo di testo.

Il tipo di antialiasing utilizzato per questo campo di testo. Utilizzate le costanti flash.text.AntiAliasType per questa proprietà. È possibile controllare questa impostazione solo se il carattere è incorporato (con la proprietà embedFonts impostata su true). L'impostazione predefinita è flash.text.AntiAliasType.NORMAL.

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

Controlla il dimensionamento e l'allineamento automatici dei campi di testo. I valori accettabili per le costanti TextFieldAutoSize sono: TextFieldAutoSize.NONE (predefinito), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT e TextFieldAutoSize.CENTER.

Se autoSize è impostata su TextFieldAutoSize.NONE (il valore predefinito), non viene effettuato alcun ridimensionamento.

Se autoSize è impostata su TextFieldAutoSize.LEFT, il testo viene considerato giustificato a sinistra, pertanto il margine sinistro del campo di testo rimane fisso e l'eventuale ridimensionamento di una riga singola del campo viene effettuato sul margine destro. Se il testo contiene un'interruzione di riga (ad esempio "\n" o "\r"), anche il lato inferiore viene ridimensionato in modo da rientrare nella riga di testo successiva. Se anche wordWrap viene impostata su true, solo il lato inferiore del campo di testo viene ridimensionato mentre il lato destro rimane fisso.

Se autoSize è impostata su TextFieldAutoSize.RIGHT, il testo viene considerato giustificato a destra, pertanto il margine destro del campo di testo rimane fisso e l'eventuale ridimensionamento di una riga singola del campo viene effettuato sul margine sinistro. Se il testo contiene un'interruzione di riga (ad esempio "\n" or "\r"), anche il lato inferiore viene ridimensionato in modo da rientrare nella riga di testo successiva. Se anche wordWrap viene impostata su true, solo il lato inferiore del campo di testo viene ridimensionato mentre il lato sinistro rimane fisso.

Se autoSize è impostata su TextFieldAutoSize.CENTER, il testo viene considerato giustificato al centro, pertanto l'eventuale ridimensionamento di una riga singola del campo di testo viene distribuito equamente sui margini destro e sinistro. Se il testo contiene un'interruzione di riga (ad esempio "\n" o "\r"), anche il lato inferiore viene ridimensionato in modo da rientrare nella riga di testo successiva. Se anche wordWrap viene impostata su true, solo il lato inferiore del campo di testo viene ridimensionato mentre i lati sinistro e destro rimangono fissi.

Specifica se il campo di testo ha un riempimento di sfondo. Se true, il campo di testo ha un riempimento di sfondo. Se false, il campo di testo non ha un riempimento di sfondo. Utilizzate la proprietà backgroundColor per impostare il colore di sfondo di un campo di testo.

Il colore di sfondo del campo di testo. Il valore predefinito è 0xFFFFFF (bianco). Questa proprietà può essere recuperata o impostata, anche se non è presente uno sfondo e il colore è visibile solo se il campo di testo ha la proprietà background impostata su true.

Specifica se il campo di testo ha un bordo. Se true, il campo di testo presenta un bordo. Se false, il campo di testo è privo di bordo. Utilizzate la proprietà borderColor per impostare il colore del bordo.

Il colore del bordo del campo di testo. Il valore predefinito è 0x000000 (nero). Questa proprietà può essere recuperata o impostata, anche se non è presente un bordo e il colore è visibile solo se il campo di testo ha la proprietà border impostata su true.

Un numero intero (indice a base uno) che indica l'ultima riga in basso attualmente visibile nel campo di testo specificato. Il campo di testo può essere considerato come una finestra sopra un blocco di testo. La proprietà scrollV è l'indice a base 1 della prima riga visibile in alto nella finestra.

Tutto il testo compreso tra le righe indicate da scrollV e bottomScrollV è visibile nel campo di testo.

L'indice della posizione del punto di registrazione (accento circonflesso). Se non viene visualizzato alcun punto di registrazione, il valore è rappresentato dalla posizione in cui il punto di registrazione si troverebbe se fosse ripristinata l'attivazione del campo (solitamente, l'ultima posizione in cui si trovava il punto di registrazione, oppure 0 se il campo non è attivato).

Gli indici delle estensioni di selezione sono a base zero (ad esempio, la prima posizione è 0, la seconda è 1 e così via).

Un valore booleano che specifica se viene rimosso lo spazio vuoto supplementare (spazi, interruzioni di riga, e così via) di un campo di testo HTML. Il valore predefinito è false. La proprietà condenseWhite ha effetto solo sul testo impostato con la proprietà htmlText, non con la proprietà text. Se il testo viene impostato con la proprietà text, condenseWhite viene ignorato.

Se condenseWhite è impostato su true, utilizzate comandi HTML standard quali <BR> e <P> per inserire le interruzioni di riga nel campo di testo.

Impostate la proprietà condenseWhite prima della proprietà htmlText.

Specifica il formato applicato al testo appena immesso, ad esempio al testo digitato da un utente o quello immesso mediante il metodo replaceSelectedText().

Nota: quando si selezionano i caratteri da sostituire con setSelection() e replaceSelectedText(), defaultTextFormat si applica solo se il testo è stato selezionato fino all'ultimo carattere incluso. Di seguito viene fornito un esempio:

     var my_txt:TextField new TextField();
     my_txt.text = "Flash Macintosh version";
     var my_fmt:TextFormat = new TextFormat();
     my_fmt.color = 0xFF0000;
     my_txt.defaultTextFormat = my_fmt;
     my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied
     my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied
     my_txt.replaceSelectedText("Windows version");
     

Quando si accede alla proprietà defaultTextFormat, l'oggetto TextFormat restituito ha tutte le proprietà definite. Nessuna proprietà è null.

Nota: questa proprietà non può essere impostata se al campo di testo è applicato un foglio di stile.

Specifica se il campo di testo è protetto da password. Se il valore di questa proprietà è true, il campo di testo è considerato come se fosse protetto da password e nasconde i caratteri immessi visualizzando degli asterischi invece che i caratteri veri e propri. Se invece è false, il campo di testo non è considerato come protetto da password. Quando è abilitata la modalità di protezione mediante password, i comandi Taglia e Copia e i rispettivi tasti di scelta rapida non funzionano. Questo meccanismo di sicurezza impedisce a un eventuale utente malintenzionato di utilizzare i tasti di scelta rapida per scoprire la password di un computer non sorvegliato.

Specifica se l'oggetto riceve gli eventi doubleClick. Il valore predefinito è false e indica che, per impostazione predefinita, un'istanza InteractiveObject non riceve gli eventi doubleClick. Se la proprietà doubleClickEnabled è impostata su true, l'istanza riceve gli eventi doubleClick nei propri limiti. Anche la proprietà mouseEnabled dell'istanza InteractiveObject deve essere impostata su true affinché l'oggetto possa ricevere gli eventi doubleClick.

Nessun evento viene inviato impostando questa proprietà. È necessario utilizzare il metodo addEventListener() per aggiungere un listener di eventi per l'evento doubleClick.

Specifica se deve essere eseguito il rendering del campo di testo mediante i profili di carattere incorporati. Se è impostato su false, Flash Player esegue il rendering del campo di testo utilizzando i caratteri dispositivo.

Se si imposta la proprietà embedFonts su true per un campo di testo, è necessario specificare un carattere per il testo mediante la proprietà font di un oggetto TextFormat applicato al campo di testo. Se il carattere specificato non è incorporato nel file SWF, il testo non viene visualizzato.

Specifica se l'oggetto visualizza un rettangolo di attivazione. Può assumere uno di questi tre valori: true, false o null. I valori true e false funzionano come previsto, specificando se il rettangolo di attivazione viene visualizzato o meno. Il valore null indica che questo oggetto obbedisce alla proprietà stageFocusRect dello stage.

Il tipo di adattamento alla griglia utilizzato per questo campo di testo. Questa proprietà si applica solo se la proprietà flash.text.AntiAliasType del campo di testo è impostata su flash.text.AntiAliasType.ADVANCED.

Il tipo di adattamento alla griglia utilizzato determina se Flash Player forza l'adattamento delle righe orizzontali e verticali spesse a una griglia di pixel o sottopixel.

Per impostare i valori per la proprietà flash.text.GridFitType, utilizzate i valori stringa seguenti:

Contiene la rappresentazione HTML dei contenuti dei campi di testo.

Flash Player supporta i tag HTML seguenti:

Flash Player e AIR supportano le seguenti entità HTML:

Flash e AIR supportano inoltre codici di caratteri espliciti, quali & (e commerciale ASCII) e € (simbolo € Unicode).

If true, the paddingLeft and paddingRight styles will not add space around the text of the component.

The beginning of this UITextField's chain of inheriting styles. The getStyle() method accesses inheritingStyles[styleName] to search the entire prototype-linked chain. This object is set up by the initProtoChain() method. You typically never need to access this property directly.

Il numero di caratteri presenti in un campo di testo. Il carattere di tabulazione (\t) viene contato come un carattere.

Il numero massimo di caratteri immessi da un utente, che il campo di testo può contenere. Uno script può inserire testi di lunghezza maggiore di quella consentita dalla proprietà maxChars, che indica solo la lunghezza massima del testo che può essere immesso da un utente. Se il valore di questa proprietà è 0, non vi sono limitazioni al testo che l'utente può immettere.

Il valore massimo di scrollH.

Il valore massimo di scrollV.

Specifica se questo oggetto riceve messaggi del mouse o di altri dispositivi di input dell'utente. Il valore predefinito è true e indica che, per impostazione predefinita, qualunque istanza InteractiveObject inclusa nell'elenco di visualizzazione riceve gli eventi del mouse o di altri dispositivi di input dell'utente. Se mouseEnabled è impostato su false, l'istanza non riceve alcun evento del mouse (o altri eventi di input dell'utente quali gli eventi della tastiera). L'impostazione non influisce sugli eventuali elementi secondari dell'istanza presenti nell'elenco di visualizzazione. Per cambiare il comportamento mouseEnabled di tutti gli elementi secondari di un oggetto dell'elenco di visualizzazione, utilizzate flash.display.DisplayObjectContainer.mouseChildren.

Nessun evento viene inviato impostando questa proprietà. Dovete utilizzare il metodo addEventListener() per creare la funzionalità interattiva.

Un valore booleano che indica se Flash Player scorre automaticamente i campi di testo multiriga quando l'utente fa clic su un campo di testo e utilizza la rotella del mouse. Per impostazione predefinita, questo valore corrisponde a true. Questa proprietà è utile se desiderate impedire che la rotella del mouse effettui lo scorrimento dei campi di testo o se si desidera implementare uno scorrimento personalizzato per i campi di testo.

Indica se il campo è un campo di testo multiriga. Se questo valore è true, il campo di testo è composto da più righe; se è false, il campo di testo è costituito da una sola riga di testo. In un campo di tipo TextFieldType.INPUT, il valore multiline determina se il tasto Invio crea una nuova riga (con una valore false, il tasto Invio viene ignorato). Se si incolla del testo in TextField con un valore multiline impostato su false, i caratteri newline vengono rimossi dal testo.

Depth of this object in the containment hierarchy. This number is used by the measurement and layout code. The value is 0 if this component is not on the DisplayList.

The beginning of this UITextField's chain of non-inheriting styles. The getStyle() method accesses nonInheritingStyles[styleName] method to search the entire prototype-linked chain. This object is set up by the initProtoChain() method. You typically never need to access this property directly.

Unlike textHeight, this returns a non-zero value even when the text is empty. In this case, it returns what the textHeight would be if the text weren't empty.

Definisce il numero delle righe di testo in un campo di testo multiriga. Se la proprietà wordWrap è impostata su true, il numero di righe aumenta quando il testo va a capo.

Indica il set di caratteri che l'utente può immettere in un campo di testo. Se il valore della proprietà restrict è null, è possibile immettere qualsiasi carattere. Se il valore della proprietà restrict è una stringa vuota, non è possibile immettere alcun carattere. Se il valore della proprietà restrict è una stringa di caratteri, è possibile immettere nel campo di testo soltanto i caratteri presenti nella stringa. La scansione della stringa viene eseguita da sinistra a destra. È possibile specificare un intervallo di caratteri utilizzando un carattere trattino (-). Soltanto le interazioni dell'utente sono limitate; uno script può invece immettere qualsiasi testo nel campo di testo. Tale proprietà non è sincronizzabile con le opzioni carattere Incorpora della finestra di ispezione Proprietà.

Se la stringa comincia con il simbolo ^, vengono accettati tutti i caratteri a eccezione di quelli che seguono questo valore nella stringa. Se la stringa non comincia con (^), non viene accettato alcun carattere ad eccezione di quelli indicati nella stringa.

Nell'esempio seguente è consentita l'immissione solo di caratteri in lettere maiuscole, spazi e numeri in un campo di testo:

     my_txt.restrict = "A-Z 0-9";
     

Nell'esempio seguente sono inclusi tutti i caratteri, eccetto le lettere minuscole:

     my_txt.restrict = "^a-z";
     

È possibile utilizzare una barra rovesciata per immettere ^ o - così come è scritto. Le sequenze di barre rovesciate che vengono accettate sono \-, \^ o \\. La barra rovesciata deve essere un carattere effettivo nella stringa, quindi quando viene utilizzata nel codice ActionScript, è necessario specificare una doppia barra rovesciata. Ad esempio, il codice seguente include solo il trattino (-) e l'accento circonflesso (^):

     my_txt.restrict = "\\-\\^";
     

Il carattere ^ può essere utilizzato in qualsiasi punto della stringa per passare alternativamente dall'inclusione all'esclusione di caratteri. Nell'esempio seguente sono inclusi solo i caratteri in lettere maiuscole, esclusa la lettera maiuscola Q:

     my_txt.restrict = "A-Z^Q";
     

È possibile utilizzare la sequenza di escape \u per creare stringhe restrict. Il codice seguente include solo i caratteri da ASCII 32 (spazio) ad ASCII 126 (tilde).

     my_txt.restrict = "\u0020-\u007E";
     

La posizione di scorrimento orizzontale corrente. Se la proprietà scrollH è impostata su 0, non è possibile scorrere in orizzontale il testo. Il valore di questa proprietà è un numero intero che rappresenta la posizione orizzontale in pixel.

Le unità dello scorrimento orizzontale sono i pixel, mentre quelle dello scorrimento verticale sono le righe. Lo scorrimento orizzontale viene misurato in pixel poiché la maggior parte dei caratteri più diffusi ha una spaziatura proporzionale, ovvero i singoli caratteri possono avere larghezze diverse. Flash effettua lo scorrimento verticale in base alle righe per consentire agli utenti di visualizzare una riga di testo integralmente. Anche se in una riga sono presenti caratteri diversi, l'altezza della riga viene adattata al carattere più grande.

Nota: la proprietà scrollH è a base zero e non a base 1 come la proprietà dello scorrimento verticale scrollV.

La posizione verticale del testo in un campo. La proprietà scrollV è utile per indirizzare gli utenti verso un paragrafo specifico all'interno di un brano lungo o per creare campi di testo a scorrimento.

Le unità dello scorrimento verticale sono le righe, mentre quelle dello scorrimento orizzontale sono i pixel. Se la prima riga visualizzata è la prima riga del campo di testo, scrollV è impostato su 1 (non su 0). Lo scorrimento orizzontale viene misurato in pixel poiché la maggior parte dei caratteri ha una spaziatura proporzionale, ovvero i singoli caratteri possono avere larghezze diverse. Flash effettua lo scorrimento verticale in base alle righe per consentire agli utenti di visualizzare una riga di testo integralmente. Anche se in una riga sono presenti caratteri diversi, l'altezza della riga viene adattata al carattere più grande.

Un valore booleano che indica se il campo di testo è selezionabile. Il valore true indica che il testo è selezionabile. La proprietà selectable controlla se un campo di testo è selezionabile, non se è modificabile. Ad esempio, un campo di testo dinamico può essere selezionabile anche se non è modificabile. Se un campo di testo dinamico non è selezionabile, non è possibile selezionarne il testo.

Se selectable è impostata su false, il testo del campo di testo non risponde ai comandi di selezione del mouse o della tastiera e il testo non può essere copiato mediante il comando Copia. Se selectable è impostata su true, il testo del campo di testo può essere selezionato mediante il mouse o la tastiera e copiato mediante il comando Copia. In tal modo potete selezionare il testo anche se il campo di testo è dinamico e non di input.

Il valore dell'indice a base zero del primo carattere nella selezione corrente. (Ad esempio, il primo carattere è 0, il secondo è 1, e così via.) Questa proprietà è il valore di caretIndex se nessuna parte di testo viene selezionata.

Il valore dell'indice a base zero dell'ultimo carattere nella selezione corrente. (Ad esempio, il primo carattere è 0, il secondo è 1, e così via.) Questa proprietà è il valore di caretIndex se nessuna parte di testo viene selezionata.

La precisione dei bordi del glifo in questo campo di testo. Questa proprietà si applica solo se la proprietà flash.text.AntiAliasType del campo di testo è impostata su flash.text.AntiAliasType.ADVANCED. L'intervallo valido per sharpness è un numero compreso tra -400 e 400. Se tentate di impostare sharpness su un valore non compreso nell'intervallo, Flash utilizza il valore più vicino presente nell'intervallo (-400 o 400).

Associa un foglio di stile al campo di testo. Per informazioni sulla creazione di fogli di stile, vedete la classe StyleSheet e la Guida per gli sviluppatori di ActionScript 3.0.

Il foglio di stile associato a un campo di testo può essere modificato in qualsiasi momento. Se il foglio di stile in uso viene modificato, il campo di testo viene ridisegnato utilizzando il nuovo foglio di stile. Per rimuovere il foglio di stile, impostatelo su null o undefined. Se il foglio di stile in uso viene rimosso, il campo di testo viene ridisegnato senza foglio di stile.

Nota: se il foglio di stile viene rimosso, il contenuto di TextField.text e TextField.htmlText cambia in modo da incorporare la formattazione precedentemente applicata al foglio di stile. Per conservare il contenuto TextField.htmlText originale senza la formattazione, salvate il valore in una variabile prima di rimuovere il foglio di stile.

Specifica se questo oggetto è incluso nell'ordine di tabulazione. Se questo oggetto è nell'ordine di tabulazione, il valore è true, in caso contrario è false. Per impostazione predefinita, il valore è false, a eccezione dei casi seguenti:

• Per un oggetto SimpleButton, il valore è true.
• Per un oggetto TextField con type = "input", il valore è true.
• Per un oggetto Sprite o un oggetto MovieClip con buttonMode = true, il valore è true.

Specifica l'ordine di tabulazione degli oggetti in un file SWF. Il valore predefinito di questa proprietà tabIndex è -1 e indica che per l'oggetto non è impostato un indice di tabulazione.

Se un qualunque oggetto visualizzato nel file SWF contiene una proprietà tabIndex, l'ordine di tabulazione automatico viene disabilitato e viene calcolato in base alle proprietà tabIndex degli oggetti presenti nel file SWF. L'ordine di tabulazione personalizzato include solo gli oggetti dotati delle proprietà tabIndex.

La proprietà tabIndex può essere un numero intero non negativo. Gli oggetti vengono ordinati in base alle relative proprietà tabIndex, in ordine ascendente. Un oggetto con un valore tabIndex di 1 precede un oggetto con il valore tabIndex di 2. È sconsigliabile utilizzare lo stesso valore di tabIndex per più oggetti.

L'ordine di tabulazione personalizzato definito dalla proprietà tabIndex è di tipo flat. In altre parole, non viene prestata alcuna attenzione alle relazioni gerarchiche degli oggetti nel file SWF. Tutti gli oggetti del file SWF dotati delle proprietà tabIndex vengono inseriti nell'ordine di tabulazione, il quale viene determinato dall'ordine dei valori tabIndex.

Nota: per impostare l'ordine di tabulazione per le istanze TLFTextField, inserite l'oggetto di visualizzazione secondario del TLFTextField come InteractiveObject, quindi impostate la proprietà tabIndex. Ad esempio:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Una stringa che rappresenta il testo corrente nel campo di testo. Le righe sono separate dal carattere di ritorno a capo ('\r', ASCII 13). Questa proprietà contiene testo non formattato nel campo di testo, senza tag HTML.

Per ottenere il testo in formato HTML, utilizzate la proprietà htmlText.

Nota: se viene applicato un foglio di stile al campo di testo, il contenuto della proprietà text sarà interpretato come HTML.

Il colore del testo nel campo di testo, in formato esadecimale. Il sistema dei colori esadecimali utilizza sei cifre per rappresentare i valori dei colori. Ogni cifra ha sedici possibili valori o caratteri. I caratteri vanno da 0 a 9 e da A a F. Il nero, ad esempio, è rappresentato da 0x000000; il bianco da 0xFFFFFF.

L'altezza del testo espressa in pixel.

La larghezza del testo espressa in pixel.

Lo spessore dei bordi del glifo in questo campo di testo. Questa proprietà funziona solo quando flash.text.AntiAliasType è impostato su flash.text.AntiAliasType.ADVANCED.

L'intervallo valido per thickness è un numero compreso tra -200 e 200. Se tentate di impostare thickness su un valore non compreso nell'intervallo, la proprietà viene impostata sul valore più vicino presente nell'intervallo (-200 o 200).

Il tipo di campo di testo. Una delle due costanti TextFieldType seguenti: TextFieldType.DYNAMIC, che indica un campo di testo dinamico non modificabile dall'utente, o TextFieldType.INPUT, che specifica un campo di testo di input modificabile dall'utente.

Specifica se copiare e incollare la formattazione assieme al testo. Quando è impostata su true, Flash Player copia e incolla da un campo di testo all'altro anche la formattazione (allineamento, grassetto e corsivo). I campi di testo di origine e di destinazione dell'operazione di copia e incolla devono avere la proprietà useRichTextClipboard impostata su true. Il valore predefinito è false.

Un valore booleano che indica se per il campo di testo è abilitato il ritorno a capo automatico. Se il valore di wordWrap è true, il campo di testo ha il ritorno a capo; se è false, il campo di testo non ha il ritorno a capo. Il valore predefinito è false.

Aggiunge la stringa specificata dal parametro newText alla fine del testo del relativo campo. Questo metodo è più efficiente rispetto a un'assegnazione addizione (+=) applicata a una proprietà text (ad esempio someTextField.text += moreText), in particolare nel caso di un campo di testo con una quantità di contenuto significativa.

Parametri

Restituisce un rettangolo che rappresenta il riquadro di delimitazione del carattere.

Parametri

Restituisce il valore dell'indice a base zero del carattere nel punto specificato dai parametri x e y.

Parametri

Dato un indice di carattere, restituisce l'indice del primo carattere nello stesso paragrafo.

Parametri

Restituisce un riferimento DisplayObject per l'id dato, relativo a un'immagine o a un file SWF che è stato aggiunto a un campo di testo con formattazione HTML mediante un tag <img>. Il tag <img> è nel seguente formato:

   <img src = 'filename.jpg' id = 'instanceName' >

Parametri

Restituisce il valore dell'indice a base zero della riga nel punto specificato dai parametri x e y.

Parametri

Restituisce il valore dell'indice a base zero della riga contenente il carattere specificato dal parametro charIndex.

Parametri

Restituisce il numero di caratteri presenti in una riga di testo specifica.

Parametri

Restituisce informazioni sulla metrica relative a una data riga di testo.

Parametri

Restituisce l'indice di carattere del primo carattere nella riga specificata dal parametro lineIndex.

Parametri

Restituisce il testo della riga specificata dal parametro lineIndex.

Parametri

Dato un indice di carattere, restituisce la lunghezza del paragrafo contenente il carattere dato. La lunghezza è relativa al primo carattere del paragrafo (secondo quanto restituito da getFirstCharInParagraph()) e non all'indice di carattere passato.

Parametri

Gets a style property that has been set anywhere in this component's style lookup chain.

This same method is used to get any kind of style property, so the value returned can be a Boolean, String, Number, int, uint (for an RGB color), Class (for a skin), or any kind of object. Therefore the return type is simply specified as *.

If you are getting a particular style property, you know its type and often want to store the result in a variable of that type. No casting from * to that type is necessary.

var backgroundColor:uint = getStyle("backgroundColor");

If the style property has not been set anywhere in the style lookup chain, the value returned by getStyle() is undefined. Note that undefined is a special value that is not the same as false, "", NaN, 0, or null. No valid style value is ever undefined. You can use the method IStyleManager2.isValidStyleValue() to test whether the value was set.

Parametri

Restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo compreso tra i parametri beginIndex e endIndex. Solo le proprietà comuni a tutto il testo specificato vengono impostate nell'oggetto TextFormat risultante. Qualunque proprietà mista (ovvero dotata di valori diversi in diversi punti del testo) ha un valore null.

Se non vengono specificati i valori di questi parametri, questo metodo viene applicato a tutto il testo presente nel campo di testo.

Nella tabella seguente sono descritti tre possibili utilizzi:

Parametri

Returns a UITextFormat object that contains formatting information for this component. This method is similar to the getTextFormat() method of the flash.text.TextField class, but it returns a UITextFormat object instead of a TextFormat object.

The UITextFormat class extends the TextFormat class to add the text measurement methods measureText() and measureHTMLText().

Sostituisce la selezione corrente con il contenuto del parametro value. Il testo viene inserito nella posizione della selezione corrente, utilizzando il formato predefinito corrente per il carattere e il paragrafo. La stringa di testo non viene considerata come HTML.

È possibile utilizzare il metodo replaceSelectedText() per inserire ed eliminare il testo senza interrompere la formattazione del carattere e del paragrafo per il resto del testo.

Nota: questo metodo non funziona se al campo di testo è applicato un foglio di stile.

Parametri

Sostituisce un intervallo di caratteri, specificato dai parametri beginIndex e endIndex, con il contenuto del parametro newText. Come indicato, il testo compreso tra beginIndex e endIndex-1 viene sostituito.

Nota: questo metodo non funziona se al campo di testo è applicato un foglio di stile.

Parametri

Sets the font color of the text.

Parametri

Sets the focus to this component. The component can in turn pass focus to a subcomponent.

Note: Only the TextInput and TextArea controls show a highlight when this method sets the focus. All controls show a highlight when the user tabs to the control.

Imposta come selezionato il testo designato dai valori di indice del primo e ultimo carattere, specificati dai parametri beginIndex e endIndex. Se i valori dei due parametri sono uguali, questo metodo imposta il punto di inserimento, come se si impostasse la proprietà caretIndex.

Parametri