Pacchetto | mx.core |
Interfaccia | public interface IUITextField extends IIMESupport , IFlexModule , IInvalidating , ISimpleStyleClient , IToolTipManagerClient , IUIComponent , IFlexDisplayObject , IFlexDisplayObject , IBitmapDrawable , IEventDispatcher |
Implementatori | UIFTETextField, UITextField |
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Proprietà | Definito da | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
Le opzioni di accessibilità correnti di questo oggetto di visualizzazione. | IFlexDisplayObject | ||
alpha : Number
Indica il valore della trasparenza alfa dell'oggetto specificato. | IFlexDisplayObject | ||
alwaysShowSelection : Boolean
Quando è impostata su true e il campo di testo non è attivo, Flash Player evidenzia la selezione nel campo di testo in grigio. | IUITextField | ||
antiAliasType : String
Il tipo di antialiasing utilizzato per questo campo di testo. | IUITextField | ||
autoSize : String
Controlla il dimensionamento e l'allineamento automatici dei campi di testo. | IUITextField | ||
background : Boolean
Specifica se il campo di testo ha un riempimento di sfondo. | IUITextField | ||
backgroundColor : uint
Il colore di sfondo del campo di testo. | IUITextField | ||
baselinePosition : Number [sola lettura]
The y-coordinate of the baseline
of the first line of text of the component. | IUIComponent | ||
blendMode : String
Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare. | IFlexDisplayObject | ||
border : Boolean
Specifica se il campo di testo ha un bordo. | IUITextField | ||
borderColor : uint
Il colore del bordo del campo di testo. | IUITextField | ||
bottomScrollV : int [sola lettura]
Un numero intero (indice a base uno) che indica l'ultima riga in basso attualmente visibile nel campo di testo specificato. | IUITextField | ||
cacheAsBitmap : Boolean
Se è impostata su true, nella cache dei runtime Flash viene memorizzata una rappresentazione bitmap interna dell'oggetto di visualizzazione. | IFlexDisplayObject | ||
caretIndex : int [sola lettura]
L'indice della posizione del punto di registrazione (accento circonflesso). | IUITextField | ||
condenseWhite : Boolean
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. | IUITextField | ||
defaultTextFormat : flash.text:TextFormat
Specifica il formato applicato al testo appena immesso, ad esempio al testo digitato da un utente o quello immesso mediante il metodo replaceSelectedText(). | IUITextField | ||
displayAsPassword : Boolean
Specifica se il campo di testo è protetto da password. | IUITextField | ||
document : Object
A reference to the document object associated with this component. | IUIComponent | ||
doubleClickEnabled : Boolean
Specifica se l'oggetto riceve gli eventi doubleClick. | IUITextField | ||
embedFonts : Boolean
Specifica se deve essere eseguito il rendering del campo di testo mediante i profili di carattere incorporati. | IUITextField | ||
enabled : Boolean
Whether the component can accept user interaction. | IUIComponent | ||
enableIME : Boolean [sola lettura]
Specifies whether the IME should be enabled when
this component has focus. | IIMESupport | ||
explicitHeight : Number
The explicitly specified height for the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMaxHeight : Number [sola lettura]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMaxWidth : Number [sola lettura]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinHeight : Number [sola lettura]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinWidth : Number [sola lettura]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitWidth : Number
The explicitly specified width for the component,
in pixels, as the component's coordinates. | IUIComponent | ||
filters : Array
Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione. | IFlexDisplayObject | ||
focusPane : Sprite
A single Sprite object that is shared among components
and used as an overlay for drawing the focus indicator. | IUIComponent | ||
focusRect : Object
Specifica se l'oggetto visualizza un rettangolo di attivazione. | IUITextField | ||
gridFitType : String
Il tipo di adattamento alla griglia utilizzato per questo campo di testo. | IUITextField | ||
height : Number
Indica l'altezza dell'oggetto di visualizzazione espressa in pixel. | IFlexDisplayObject | ||
htmlText : String
Contiene la rappresentazione HTML dei contenuti dei campi di testo. | IUITextField | ||
ignorePadding : Boolean
If true, the paddingLeft and
paddingRight styles will not add space
around the text of the component. | IUITextField | ||
imeMode : String
The IME mode of the component. | IIMESupport | ||
includeInLayout : Boolean
Specifies whether this component is included in the layout of the
parent container. | IUIComponent | ||
inheritingStyles : Object
The beginning of this UITextField's chain of inheriting styles. | IUITextField | ||
isPopUp : Boolean
Set to true by the PopUpManager to indicate
that component has been popped up. | IUIComponent | ||
length : int [sola lettura]
Il numero di caratteri presenti in un campo di testo. | IUITextField | ||
loaderInfo : LoaderInfo [sola lettura]
Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene. | IFlexDisplayObject | ||
mask : DisplayObject
L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato. | IFlexDisplayObject | ||
maxChars : int
Il numero massimo di caratteri immessi da un utente, che il campo di testo può contenere. | IUITextField | ||
maxHeight : Number [sola lettura]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
maxScrollH : int [sola lettura]
Il valore massimo di scrollH. | IUITextField | ||
maxScrollV : int [sola lettura]
Il valore massimo di scrollV. | IUITextField | ||
maxWidth : Number [sola lettura]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
measuredHeight : Number [sola lettura]
The measured height of this object. | IFlexDisplayObject | ||
measuredMinHeight : Number
The default minimum height of the component, in pixels. | IUIComponent | ||
measuredMinWidth : Number
The default minimum width of the component, in pixels. | IUIComponent | ||
measuredWidth : Number [sola lettura]
The measured width of this object. | IFlexDisplayObject | ||
minHeight : Number [sola lettura]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
minWidth : Number [sola lettura]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
mouseEnabled : Boolean
Specifica se questo oggetto riceve messaggi del mouse o di altri dispositivi di input dell'utente. | IUITextField | ||
mouseWheelEnabled : Boolean
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. | IUITextField | ||
mouseX : Number [sola lettura]
Indica la coordinata x del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | IFlexDisplayObject | ||
mouseY : Number [sola lettura]
Indica la coordinata y del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | IFlexDisplayObject | ||
multiline : Boolean
Indica se il campo è un campo di testo multiriga. | IUITextField | ||
name : String
Indica il nome dell'istanza dell'oggetto DisplayObject. | IFlexDisplayObject | ||
nestLevel : int
Depth of this object in the containment hierarchy. | IUITextField | ||
nonInheritingStyles : Object
The beginning of this UITextField's chain of non-inheriting styles. | IUITextField | ||
nonZeroTextHeight : Number [sola lettura]
Unlike textHeight, this returns a non-zero value
even when the text is empty. | IUITextField | ||
numLines : int [sola lettura]
Definisce il numero delle righe di testo in un campo di testo multiriga. | IUITextField | ||
opaqueBackground : Object
Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo. | IFlexDisplayObject | ||
owner : DisplayObjectContainer
The owner of this IVisualElement object. | IUIComponent | ||
parent : DisplayObjectContainer [sola lettura]
Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione. | IFlexDisplayObject | ||
percentHeight : Number
Number that specifies the height of a component as a
percentage of its parent's size. | IUIComponent | ||
percentWidth : Number
Number that specifies the width of a component as a
percentage of its parent's size. | IUIComponent | ||
restrict : String
Indica il set di caratteri che l'utente può immettere in un campo di testo. | IUITextField | ||
root : DisplayObject [sola lettura]
Nel caso di un oggetto di visualizzazione all'interno di un file SWF caricato, la proprietà principale è l'oggetto di visualizzazione più in alto nella porzione della struttura dell'elenco di visualizzazione rappresentata da quel file SWF. | IFlexDisplayObject | ||
rotation : Number
Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale. | IFlexDisplayObject | ||
scale9Grid : Rectangle
La griglia di modifica in scala attualmente attiva. | IFlexDisplayObject | ||
scaleX : Number
Indica la scala orizzontale (percentuale) dell'oggetto applicata dal punto di registrazione. | IFlexDisplayObject | ||
scaleY : Number
Indica la scala verticale (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | IFlexDisplayObject | ||
scrollH : int
La posizione di scorrimento orizzontale corrente. | IUITextField | ||
scrollRect : Rectangle
I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione. | IFlexDisplayObject | ||
scrollV : int
La posizione verticale del testo in un campo. | IUITextField | ||
selectable : Boolean
Un valore booleano che indica se il campo di testo è selezionabile. | IUITextField | ||
selectionBeginIndex : int [sola lettura]
Il valore dell'indice a base zero del primo carattere nella selezione corrente. | IUITextField | ||
selectionEndIndex : int [sola lettura]
Il valore dell'indice a base zero dell'ultimo carattere nella selezione corrente. | IUITextField | ||
sharpness : Number
La precisione dei bordi del glifo in questo campo di testo. | IUITextField | ||
stage : Stage [sola lettura]
Lo stage dell'oggetto di visualizzazione. | IFlexDisplayObject | ||
styleName : Object
The source of this object's style values. | ISimpleStyleClient | ||
styleSheet : StyleSheet
Associa un foglio di stile al campo di testo. | IUITextField | ||
systemManager : ISystemManager
A reference to the SystemManager object for this component. | IUIComponent | ||
tabEnabled : Boolean
Specifica se questo oggetto è incluso nell'ordine di tabulazione. | IUITextField | ||
tabIndex : int
Specifica l'ordine di tabulazione degli oggetti in un file SWF. | IUITextField | ||
text : String
Una stringa che rappresenta il testo corrente nel campo di testo. | IUITextField | ||
textColor : uint
Il colore del testo nel campo di testo, in formato esadecimale. | IUITextField | ||
textHeight : Number [sola lettura]
L'altezza del testo espressa in pixel. | IUITextField | ||
textWidth : Number [sola lettura]
La larghezza del testo espressa in pixel. | IUITextField | ||
thickness : Number
Lo spessore dei bordi del glifo in questo campo di testo. | IUITextField | ||
toolTip : String
The text of this component's tooltip. | IToolTipManagerClient | ||
transform : flash.geom:Transform
Un oggetto con proprietà relative alla matrice, alla trasformazione del colore e ai limiti di pixel di un oggetto di visualizzazione. | IFlexDisplayObject | ||
tweeningProperties : Array
Used by EffectManager. | IUIComponent | ||
type : String
Il tipo di campo di testo. | IUITextField | ||
useRichTextClipboard : Boolean
Specifica se copiare e incollare la formattazione assieme al testo. | IUITextField | ||
visible : Boolean
Determina se l'oggetto di visualizzazione è visibile o meno. | IFlexDisplayObject | ||
width : Number
Indica la larghezza dell'oggetto di visualizzazione espressa in pixel. | IFlexDisplayObject | ||
wordWrap : Boolean
Un valore booleano che indica se per il campo di testo è abilitato il ritorno a capo automatico. | IUITextField | ||
x : Number
Indica la coordinata x dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | IFlexDisplayObject | ||
y : Number
Indica la coordinata y dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | IFlexDisplayObject |
Metodo | Definito da | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | IEventDispatcher | ||
Aggiunge la stringa specificata dal parametro nuovoTesto alla fine del testo del relativo campo. | IUITextField | ||
Invia un evento nel flusso di eventi. | IEventDispatcher | ||
Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace. | IFlexDisplayObject | ||
Restituisce un rettangolo che rappresenta il riquadro di delimitazione del carattere. | IUITextField | ||
Restituisce il valore dell'indice a base zero del carattere nel punto specificato dai parametri x e y. | IUITextField | ||
A convenience method for determining whether to use the
explicit or measured height
| IUIComponent | ||
A convenience method for determining whether to use the
explicit or measured width
| IUIComponent | ||
Dato un indice di carattere, restituisce l'indice del primo carattere nello stesso paragrafo. | IUITextField | ||
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>. | IUITextField | ||
Restituisce il valore dell'indice a base zero della riga nel punto specificato dai parametri x e y. | IUITextField | ||
Restituisce il valore dell'indice a base zero della riga contenente il carattere specificato dal parametro charIndex. | IUITextField | ||
Restituisce il numero di caratteri presenti in una riga di testo specifica. | IUITextField | ||
Restituisce informazioni sulla metrica relative a una data riga di testo. | IUITextField | ||
Restituisce l'indice di carattere del primo carattere nella riga specificata dal parametro lineIndex. | IUITextField | ||
Restituisce il testo della riga specificata dal parametro lineIndex. | IUITextField | ||
Dato un indice di carattere, restituisce la lunghezza del paragrafo contenente il carattere dato. | IUITextField | ||
Restituisce un rettangolo che definisce i bordi dell'oggetto di visualizzazione in base al sistema di coordinate definito dal parametro targetCoordinateSpace, esclusi gli eventuali tratti presenti sulle forme. | IFlexDisplayObject | ||
Gets a style property that has been set anywhere in this
component's style lookup chain. | IUITextField | ||
Restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo compreso tra i parametri indiceIniziale e indiceFinale. | IUITextField | ||
Returns a UITextFormat object that contains formatting information for this component. | IUITextField | ||
Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point. | IFlexDisplayObject | ||
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | IEventDispatcher | ||
Valuta il riquadro di delimitazione dell'oggetto di visualizzazione per verificare se si sovrappone o si interseca con il riquadro di delimitazione dell'oggetto di visualizzazione obj. | IFlexDisplayObject | ||
Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y. | IFlexDisplayObject | ||
Initialize the object. | IUIComponent | ||
Calling this method results in a call to the component's
validateDisplayList() method
before the display list is rendered. | IInvalidating | ||
Calling this method results in a call to the component's
validateProperties() method
before the display list is rendered. | IInvalidating | ||
Calling this method results in a call to the component's
validateSize() method
before the display list is rendered. | IInvalidating | ||
Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point. | IFlexDisplayObject | ||
Moves this object to the specified x and y coordinates. | IFlexDisplayObject | ||
Returns true if the chain of owner properties
points from child to this UIComponent. | IUIComponent | ||
Called by Flex when a UIComponent object is added to or removed from a parent. | IUIComponent | ||
Rimuove un listener dall'oggetto EventDispatcher. | IEventDispatcher | ||
Sostituisce la selezione corrente con il contenuto del parametro value. | IUITextField | ||
Sostituisce un intervallo di caratteri, specificato dai parametri indiceIniziale e indiceFinale, con il contenuto del parametro nuovoTesto. | IUITextField | ||
Sets the actual size of this object. | IFlexDisplayObject | ||
Sets the font color of the text. | IUITextField | ||
Sets the focus to this component. | IUITextField | ||
Imposta come selezionato il testo designato dai valori di indice del primo e ultimo carattere, specificati dai parametri indiceIniziale e indiceFinale. | IUITextField | ||
Applica la formattazione indicata dal parametro format al testo specificato nel campo di testo. | IUITextField | ||
Called when the visible property changes. | IUIComponent | ||
Called when the value of a style property is changed. | ISimpleStyleClient | ||
Truncate text to make it fit horizontally in the area defined for the control,
and append an ellipsis, three periods (...), to the text. | IUITextField | ||
Validates and updates the properties and layout of this object
by immediately calling validateProperties(),
validateSize(), and validateDisplayList(),
if necessary. | IInvalidating | ||
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | IEventDispatcher |
alwaysShowSelection | proprietà |
alwaysShowSelection:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
antiAliasType | proprietà |
antiAliasType:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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:
Valore stringa | Descrizione |
---|---|
flash.text.AntiAliasType.NORMAL | Applica l'antialiasing di testo normale. Questo valore corrisponde al tipo di antialiasing utilizzato da Flash Player versione 7 e precedenti. |
flash.text.AntiAliasType.ADVANCED | Applica l'antialiasing avanzato, che consente di migliorare la leggibilità del testo (funzione aggiunta in Flash Player 8). L'antialiasing avanzato consente di migliorare la leggibilità del testo e di eseguire il rendering dei caratteri con una qualità molto alta anche quando sono di piccole dimensioni. Trova il suo utilizzo ottimale nelle applicazioni con molto testo di piccole dimensioni. L'antialiasing avanzato non è consigliato per i caratteri superiori a 48 punti. |
Implementazione
public function get antiAliasType():String
public function set antiAliasType(value:String):void
autoSize | proprietà |
autoSize:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get autoSize():String
public function set autoSize(value:String):void
background | proprietà |
background:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get background():Boolean
public function set background(value:Boolean):void
backgroundColor | proprietà |
backgroundColor:uint
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
.
Implementazione
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
border | proprietà |
border:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get border():Boolean
public function set border(value:Boolean):void
borderColor | proprietà |
borderColor:uint
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
.
Implementazione
public function get borderColor():uint
public function set borderColor(value:uint):void
bottomScrollV | proprietà |
bottomScrollV:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get bottomScrollV():int
caretIndex | proprietà |
caretIndex:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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).
Implementazione
public function get caretIndex():int
condenseWhite | proprietà |
condenseWhite:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
.
Implementazione
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
defaultTextFormat | proprietà |
defaultTextFormat:flash.text:TextFormat
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
displayAsPassword | proprietà |
displayAsPassword:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
doubleClickEnabled | proprietà |
doubleClickEnabled:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
.
Implementazione
public function get doubleClickEnabled():Boolean
public function set doubleClickEnabled(value:Boolean):void
embedFonts | proprietà |
embedFonts:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
focusRect | proprietà |
focusRect:Object
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get focusRect():Object
public function set focusRect(value:Object):void
gridFitType | proprietà |
gridFitType:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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:
Valore stringa | Descrizione |
---|---|
flash.text.GridFitType.NONE | Specifica nessun adattamento alla griglia. Le linee orizzontali e verticali dei glifi non vengono forzate alla griglia di pixel. Si tratta di un'impostazione consigliata per le animazioni o i caratteri con dimensioni elevate. |
flash.text.GridFitType.PIXEL | Specifica che le linee orizzontali e verticali spesse vengono adattate alla griglia di pixel. Questa impostazione funziona solo per i campi di testo allineati a sinistra. Per usare questa impostazione, la proprietà flash.display.AntiAliasType del campo di testo deve essere impostata su flash.text.AntiAliasType.ADVANCED . Di solito, fornisce il livello migliore di leggibilità per il testo allineato a sinistra. |
flash.text.GridFitType.SUBPIXEL | Specifica che le linee orizzontali e verticali spesse vengono adattate alla griglia di sottopixel su un monitor LCD. Per usare questa impostazione, la proprietà flash.text.AntiAliasType del campo di testo deve essere impostata su flash.text.AntiAliasType.ADVANCED . L'impostazione flash.text.GridFitType.SUBPIXEL è spesso indicata per il testo dinamico allineato a destra o al centro, e talvolta rappresenta un utile compromesso in termini di qualità tra l'animazione e il testo. |
Implementazione
public function get gridFitType():String
public function set gridFitType(value:String):void
htmlText | proprietà |
htmlText:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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:
Entità | Descrizione |
---|---|
< | < (minore di) |
> | > (maggiore di) |
& | & (e commerciale) |
" | " (virgolette doppie) |
' | ' (apostrofo, virgolette singole) |
Flash e AIR supportano inoltre codici di caratteri espliciti, quali & (e commerciale ASCII) e € (simbolo € Unicode).
Implementazione
public function get htmlText():String
public function set htmlText(value:String):void
ignorePadding | proprietà |
ignorePadding:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
If true
, the paddingLeft
and
paddingRight
styles will not add space
around the text of the component.
Implementazione
public function get ignorePadding():Boolean
public function set ignorePadding(value:Boolean):void
inheritingStyles | proprietà |
inheritingStyles:Object
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get inheritingStyles():Object
public function set inheritingStyles(value:Object):void
length | proprietà |
maxChars | proprietà |
maxChars:int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | proprietà |
maxScrollV | proprietà |
mouseEnabled | proprietà |
mouseEnabled:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get mouseEnabled():Boolean
public function set mouseEnabled(value:Boolean):void
mouseWheelEnabled | proprietà |
mouseWheelEnabled:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | proprietà |
multiline:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get multiline():Boolean
public function set multiline(value:Boolean):void
nestLevel | proprietà |
nestLevel:int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get nestLevel():int
public function set nestLevel(value:int):void
nonInheritingStyles | proprietà |
nonInheritingStyles:Object
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get nonInheritingStyles():Object
public function set nonInheritingStyles(value:Object):void
nonZeroTextHeight | proprietà |
nonZeroTextHeight:Number
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get nonZeroTextHeight():Number
numLines | proprietà |
numLines:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get numLines():int
restrict | proprietà |
restrict:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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";
Implementazione
public function get restrict():String
public function set restrict(value:String):void
scrollH | proprietà |
scrollH:int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
.
Implementazione
public function get scrollH():int
public function set scrollH(value:int):void
scrollV | proprietà |
scrollV:int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get scrollV():int
public function set scrollV(value:int):void
selectable | proprietà |
selectable:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get selectable():Boolean
public function set selectable(value:Boolean):void
selectionBeginIndex | proprietà |
selectionBeginIndex:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get selectionBeginIndex():int
selectionEndIndex | proprietà |
selectionEndIndex:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get selectionEndIndex():int
sharpness | proprietà |
sharpness:Number
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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).
Implementazione
public function get sharpness():Number
public function set sharpness(value:Number):void
styleSheet | proprietà |
styleSheet:StyleSheet
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
tabEnabled | proprietà |
tabEnabled:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
.
Implementazione
public function get tabEnabled():Boolean
public function set tabEnabled(value:Boolean):void
tabIndex | proprietà |
tabIndex:int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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;Per invertire l'ordine di tabulazione rispetto all'impostazione predefinita per tre istanze di un oggetto TLFTextField (
tlfInstance1
, tlfInstance2
e tlfInstance3
), utilizzate il codice seguente:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementazione
public function get tabIndex():int
public function set tabIndex(value:int):void
text | proprietà |
text:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.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.
Implementazione
public function get text():String
public function set text(value:String):void
textColor | proprietà |
textColor:uint
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
.
Implementazione
public function get textColor():uint
public function set textColor(value:uint):void
textHeight | proprietà |
textWidth | proprietà |
thickness | proprietà |
thickness:Number
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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).
Implementazione
public function get thickness():Number
public function set thickness(value:Number):void
type | proprietà |
type:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
Implementazione
public function get type():String
public function set type(value:String):void
useRichTextClipboard | proprietà |
useRichTextClipboard:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
.
Implementazione
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
wordWrap | proprietà |
wordWrap:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
.
Implementazione
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
appendText | () | metodo |
public function appendText(newText:String):void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
newText:String — The string to append to the existing text.
|
getCharBoundaries | () | metodo |
public function getCharBoundaries(charIndex:int):Rectangle
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Restituisce un rettangolo che rappresenta il riquadro di delimitazione del carattere.
Parametri
charIndex:int — The zero-based index value for the character (for example, the first
position is 0, the second position is 1, and so on).
|
Rectangle — A rectangle with x and y minimum and maximum values
defining the bounding box of the character.
|
getCharIndexAtPoint | () | metodo |
public function getCharIndexAtPoint(x:Number, y:Number):int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Restituisce il valore dell'indice a base zero del carattere nel punto specificato dai parametri x
e y
.
Parametri
x:Number — The x coordinate of the character.
| |
y:Number — The y coordinate of the character.
|
int — The zero-based index value of the character (for example, the first position is 0,
the second position is 1, and so on). Returns -1 if the point is not over any character.
|
getFirstCharInParagraph | () | metodo |
public function getFirstCharInParagraph(charIndex:int):int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Dato un indice di carattere, restituisce l'indice del primo carattere nello stesso paragrafo.
Parametri
charIndex:int — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — The zero-based index value of the first character in the same paragraph.
|
getImageReference | () | metodo |
public function getImageReference(id:String):DisplayObject
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
id:String — The id to match (in the id attribute of the
<img> tag).
|
DisplayObject — The display object corresponding to the image or SWF file with the matching id
attribute in the <img> tag of the text field. For media loaded from an external source,
this object is a Loader object, and, once loaded, the media object is a child of that Loader object. For media
embedded in the SWF file, it is the loaded object. If no <img> tag with
the matching id exists, the method returns null .
|
getLineIndexAtPoint | () | metodo |
public function getLineIndexAtPoint(x:Number, y:Number):int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Restituisce il valore dell'indice a base zero della riga nel punto specificato dai parametri x
e y
.
Parametri
x:Number — The x coordinate of the line.
| |
y:Number — The y coordinate of the line.
|
int — The zero-based index value of the line (for example, the first line is 0, the
second line is 1, and so on). Returns -1 if the point is not over any line.
|
getLineIndexOfChar | () | metodo |
public function getLineIndexOfChar(charIndex:int):int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Restituisce il valore dell'indice a base zero della riga contenente il carattere specificato dal parametro charIndex
.
Parametri
charIndex:int — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — The zero-based index value of the line.
|
getLineLength | () | metodo |
public function getLineLength(lineIndex:int):int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Restituisce il numero di caratteri presenti in una riga di testo specifica.
Parametri
lineIndex:int — The line number for which you want the length.
|
int — The number of characters in the line.
|
getLineMetrics | () | metodo |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Restituisce informazioni sulla metrica relative a una data riga di testo.
Parametri
lineIndex:int — The line number for which you want metrics information.
|
flash.text:TextLineMetrics — A TextLineMetrics object.
|
getLineOffset | () | metodo |
public function getLineOffset(lineIndex:int):int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Restituisce l'indice di carattere del primo carattere nella riga specificata dal parametro lineIndex
.
Parametri
lineIndex:int — The zero-based index value of the line (for example, the first line is 0,
the second line is 1, and so on).
|
int — The zero-based index value of the first character in the line.
|
getLineText | () | metodo |
public function getLineText(lineIndex:int):String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Restituisce il testo della riga specificata dal parametro lineIndex
.
Parametri
lineIndex:int — The zero-based index value of the line (for example, the first line is 0,
the second line is 1, and so on).
|
String — The text string contained in the specified line.
|
getParagraphLength | () | metodo |
public function getParagraphLength(charIndex:int):int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
charIndex:int — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — Returns the number of characters in the paragraph.
|
getStyle | () | metodo |
public function getStyle(styleProp:String):*
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
styleProp:String — Name of the style property.
|
* — Style value.
|
getTextFormat | () | metodo |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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:
Uso | Descrizione |
---|---|
my_textField.getTextFormat() | Restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo presente nel campo di testo. Solo le proprietà comuni a tutto il testo vengono impostate nell'oggetto TextFormat risultante. Qualunque proprietà mista (ovvero dotata di valori diversi in diversi punti del testo) ha un valore null . |
my_textField.getTextFormat(beginIndex:Number) | Restituisce un oggetto TextFormat che contiene una copia del formato di testo del carattere nella posizione beginIndex . |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo compreso tra beginIndex ed endIndex . Solo le proprietà comuni a tutto il testo nell'intervallo specificato vengono impostate nell'oggetto TextFormat risultante. Qualunque proprietà mista (ovvero dotata di valori diversi in diversi punti dell'intervallo) ha un valore null . |
Parametri
beginIndex:int (default = -1 ) — Optional; an integer that specifies the starting location of a range of text within the text field.
| |
endIndex:int (default = -1 ) — Optional; an integer that specifies the position of the first character after the desired
text span. As designed, if you specify beginIndex and endIndex values,
the text from beginIndex to endIndex-1 is read.
|
flash.text:TextFormat — The TextFormat object that represents the formatting properties for the specified text.
|
getUITextFormat | () | metodo |
public function getUITextFormat():mx.core:UITextFormat
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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()
.
mx.core:UITextFormat — An object that contains formatting information for this component.
|
replaceSelectedText | () | metodo |
public function replaceSelectedText(value:String):void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
value:String — The string to replace the currently selected text.
|
replaceText | () | metodo |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
beginIndex:int — The zero-based index value for the start position of the replacement range.
| |
endIndex:int — The zero-based index position of the first character after the desired
text span.
| |
newText:String — The text to use to replace the specified range of characters.
|
setColor | () | metodo |
setFocus | () | metodo |
public function setFocus():void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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.
setSelection | () | metodo |
public function setSelection(beginIndex:int, endIndex:int):void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
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
beginIndex:int — The zero-based index value of the first character in the selection
(for example, the first character is 0, the second character is 1, and so on).
| |
endIndex:int — The zero-based index value of the last character in the selection.
|
setTextFormat | () | metodo |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Applica la formattazione indicata dal parametro format
al testo specificato nel campo di testo. Il valore di format
deve essere un oggetto TextFormat che specifica le modifiche di formattazione del testo richieste. Solo le proprietà di format
con valori diversi da null vengono applicate al campo di testo. Qualunque proprietà di format
impostata su null
non viene applicata. Per impostazione predefinita, tutte le proprietà di un oggetto TextFormat appena creato sono impostate su null
.
Nota: questo metodo non funziona se al campo di testo è applicato un foglio di stile.
Il metodo setTextFormat()
modifica la formattazione del testo applicata a gruppi di caratteri o all'intero testo presente in un campo di testo. Per applicare le proprietà di format a tutto il testo presente nel campo di testo, non indicate i valori relativi a beginIndex
e endIndex
. Per applicare le proprietà del formato a un intervallo di testo, specificate i valori relativi ai parametri beginIndex
e endIndex
. Potete utilizzare la proprietà length
per determinare i valori di indice.
In un oggetto TextFormat sono presenti due tipi di informazioni sulla formattazione, le informazioni a livello di carattere e quelle a livello di paragrafo. Ogni carattere presente in un campo di testo può avere delle impostazioni di formattazione proprie, quali il nome del carattere, la dimensione, il grassetto e il corsivo.
Per i paragrafi, il primo carattere del paragrafo viene esaminato alla ricerca delle impostazioni di formattazione dell'intero paragrafo. Margine sinistro, margine destro e rientro sono esempi di impostazioni della formattazione del paragrafo.
Qualunque testo inserito manualmente dall'utente, o sostituito dal metodo replaceSelectedText()
, riceve la formattazione predefinita del campo di testo per il nuovo testo e non la formattazione specificata nel punto di inserimento del testo. Per impostare la formattazione predefinita per il nuovo testo, potete usare defaultTextFormat
.
Parametri
format:flash.text:TextFormat — A TextFormat object that contains character and paragraph formatting information.
| |||||||||
beginIndex:int (default = -1 ) — Optional; an integer that specifies the zero-based index position specifying the
first character of the desired range of text.
| |||||||||
endIndex:int (default = -1 ) — Optional; an integer that specifies the first character after the desired text span.
As designed, if you specify beginIndex and endIndex values,
the text from beginIndex to endIndex-1 is updated.
Notice that any text inserted manually by the user, or replaced by the
|
truncateToFit | () | metodo |
public function truncateToFit(truncationIndicator:String = null):Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 3 |
Versioni runtime: | Flash Player 9, AIR 1.1 |
Truncate text to make it fit horizontally in the area defined for the control, and append an ellipsis, three periods (...), to the text.
Parametri
truncationIndicator:String (default = null ) — The text to be appended after truncation.
If you pass null , a localizable string
such as "..." will be used.
|
Boolean — true if the text needed truncation.
|
Tue Jun 12 2018, 02:44 PM Z