| Pacchetto | fl.controls |
| Classe | public class TextInput |
| Ereditarietà | TextInput  UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Implementa | IFocusManagerComponent |
| Sottoclassi | DataGridCellEditor |
| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
In un'applicazione, un componente TextInput può essere abilitato o disabilitato. Quando è disabilitato, non può ricevere l'input dal mouse o dalla tastiera. Quando è abilitato, segue le stesse regole di attivazione, selezione e navigazione di un oggetto TextField di ActionScript.
È possibile utilizzare gli stili per personalizzare il componente TextInput modificandone l'aspetto, ad esempio quando è disabilitato. In alternativa, è anche possibile personalizzare questo componente formattandolo con l'HTML o configurandolo come un campo per password il cui testo deve essere nascosto.
Elementi API correlati
Proprietà pubbliche
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
L'implementazione di accessibilità corrente (AccessibilityImplementation) di questa istanza InteractiveObject. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
Le opzioni di accessibilità correnti di questo oggetto di visualizzazione. | DisplayObject | |
| alpha : Number
Indica il valore della trasparenza alfa dell'oggetto specificato. | DisplayObject | |
| alwaysShowSelection : Boolean
Ottiene o imposta un valore booleano che indica come viene visualizzata una selezione quando il campo di testo non è l'elemento attivo. | TextInput | ||
| blendMode : String
Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare. | DisplayObject | |
| blendShader : Shader [sola scrittura]
Imposta uno shader utilizzato per la fusione dei colori di primo piano e sfondo. | DisplayObject | |
| buttonMode : Boolean
Specifica la modalità pulsante di questo sprite. | Sprite | |
| cacheAsBitmap : Boolean
Se è impostata su true, nella cache dei runtime Flash viene memorizzata una rappresentazione bitmap interna dell'oggetto di visualizzazione. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Se il valore è diverso da null, questo oggetto Matrix definisce il modo in cui viene eseguito il rendering di un oggetto di visualizzazione quando cacheAsBitmap è impostato su true. | DisplayObject | |
| condenseWhite : Boolean
Ottiene o imposta un valore booleano che indica se deve essere rimosso lo spazio vuoto supplementare da un componente TextInput che contiene testo HTML. | TextInput | ||
| constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| contextMenu : NativeMenu
Specifica il menu di scelta rapida associato all'oggetto. | InteractiveObject | |
| displayAsPassword : Boolean
Ottiene o imposta un valore booleano che indica se l'istanza corrente del componente TextInput è stata creata per contenere una password o per contenere del testo. | TextInput | ||
| doubleClickEnabled : Boolean
Specifica se l'oggetto riceve gli eventi doubleClick. | InteractiveObject | |
| dropTarget : DisplayObject [sola lettura]
Specifica l'oggetto di visualizzazione sopra il quale viene trascinato lo sprite o sul quale viene rilasciato. | Sprite | |
| editable : Boolean
Ottiene o imposta un valore booleano che indica se l'utente può modificare il campo di testo. | TextInput | ||
| enabled : Boolean [override]
Ottiene o imposta un valore che indica se il componente può accettare l'interazione dell'utente. | TextInput | ||
| filters : Array
Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione. | DisplayObject | |
| focusEnabled : Boolean
Ottiene o imposta un valore booleano che indica se il componente può ricevere l'attivazione quando un utente fa clic su di esso. | UIComponent | |
| focusManager : IFocusManager
Ottiene o imposta il FocusManager che controlla l'attivazione di questo componente e dei suoi pari. | UIComponent | |
| focusRect : Object
Specifica se l'oggetto visualizza un rettangolo di attivazione. | InteractiveObject | |
| graphics : Graphics [sola lettura]
Specifica l'oggetto Graphics che appartiene a questo oggetto Sprite, in cui possono essere eseguiti i comandi di disegno vettoriale. | Sprite | |
| height : Number [override]
Ottiene o imposta l'altezza del componente in pixel. | UIComponent | |
| hitArea : Sprite
Definisce un altro sprite come area attiva di uno sprite. | Sprite | |
| horizontalScrollPosition : int
Ottiene o imposta la posizione della casella di scorrimento della barra di scorrimento orizzontale. | TextInput | ||
| htmlText : String
Contiene la rappresentazione HTML della stringa contenuta nel campo di testo. | TextInput | ||
| imeMode : String
Ottiene o imposta la modalità IME (Input Method Editor). | TextInput | ||
| length : int [sola lettura]
Ottiene il numero di caratteri presenti in un componente TextInput. | TextInput | ||
| loaderInfo : LoaderInfo [sola lettura]
Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene. | DisplayObject | |
| mask : DisplayObject
L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato. | DisplayObject | |
| maxChars : int
Ottiene o imposta il numero massimo di caratteri che un utente può immettere nel campo di testo. | TextInput | ||
| maxHorizontalScrollPosition : int [sola lettura]
Ottiene o imposta un valore che descrive la posizione più lontana fino a cui è possibile scorrere il campo di testo verso destra. | TextInput | ||
| metaData : Object
Ottiene l’oggetto di metadati dell’istanza DisplayObject se i metadati sono stati memorizzati insieme all’istanza di questo DisplayObject nel file SWF mediante un tag PlaceObject4. | DisplayObject | |
| mouseChildren : Boolean
Determina se gli elementi secondari dell'oggetto sono abilitati o meno per il mouse o per il dispositivo di input dell'utente. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Specifica se questo oggetto riceve messaggi del mouse o di altri dispositivi di input dell'utente. | InteractiveObject | |
| mouseFocusEnabled : Boolean
Ottiene o imposta un valore che indica se il componente può ricevere l'attivazione quando un utente fa clic su di esso. | UIComponent | |
| mouseX : Number [sola lettura]
Indica la coordinata x del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | DisplayObject | |
| mouseY : Number [sola lettura]
Indica la coordinata y del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | DisplayObject | |
| name : String
Indica il nome dell'istanza dell'oggetto DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Specifica se deve essere visualizzata una tastiera virtuale (una tastiera software a video) quando questa istanza InteractiveObject riceve lo stato di attivazione. | InteractiveObject | |
| numChildren : int [sola lettura]
Restituisce il numero di elementi secondari di questo oggetto. | DisplayObjectContainer | |
| opaqueBackground : Object
Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo. | DisplayObject | |
| parent : DisplayObjectContainer [sola lettura]
Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione. | DisplayObject | |
| restrict : String
Ottiene o imposta la stringa di caratteri che il campo di testo accetta da un utente. | TextInput | ||
| 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. | DisplayObject | |
| rotation : Number
Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale. | DisplayObject | |
| rotationX : Number
Indica la rotazione dell'asse x dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | |
| rotationY : Number
Indica la rotazione dell'asse y dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | |
| rotationZ : Number
Indica la rotazione dell'asse z dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | |
| scale9Grid : Rectangle
La griglia di modifica in scala attualmente attiva. | DisplayObject | |
| scaleX : Number [override]
Moltiplica la larghezza corrente del componente per un fattore di scala. | UIComponent | |
| scaleY : Number [override]
Moltiplica l'altezza corrente del componente per un fattore di scala. | UIComponent | |
| scaleZ : Number
Indica la scala di profondità (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | DisplayObject | |
| scrollRect : Rectangle
I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione. | DisplayObject | |
| selectionBeginIndex : int [sola lettura]
Ottiene il valore di indice del primo carattere selezionato in una selezione di uno o più caratteri. | TextInput | ||
| selectionEndIndex : int [sola lettura]
Ottiene la posizione di indice dell'ultimo carattere selezionato in una selezione di uno o più caratteri. | TextInput | ||
| softKeyboard : String
Controlla l'aspetto della tastiera software. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Definisce l’area che deve rimanere visibile sullo schermo quando è visualizzata una tastiera virtuale (non disponibile in iOS). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Controlla il suono nello sprite. | Sprite | |
| stage : Stage [sola lettura]
Lo stage dell'oggetto di visualizzazione. | DisplayObject | |
| tabChildren : Boolean
Determina se gli elementi secondari dell'oggetto sono abilitati per la tabulazione. | DisplayObjectContainer | |
| tabEnabled : Boolean
Specifica se questo oggetto è incluso nell'ordine di tabulazione. | InteractiveObject | |
| tabIndex : int
Specifica l'ordine di tabulazione degli oggetti in un file SWF. | InteractiveObject | |
| text : String
Ottiene o imposta una stringa che contiene il testo che si trova nel componente TextInput. | TextInput | ||
| textField : flash.text:TextField
Un riferimento al campo di testo interno del componente TextInput. | TextInput | ||
| textHeight : Number [sola lettura]
L'altezza del testo, espressa in pixel. | TextInput | ||
| textSnapshot : flash.text:TextSnapshot [sola lettura]
Restituisce un oggetto TextSnapshot per questa istanza DisplayObjectContainer. | DisplayObjectContainer | |
| textWidth : Number [sola lettura]
La larghezza del testo, espressa in pixel. | TextInput | ||
| 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. | DisplayObject | |
| useHandCursor : Boolean
Un valore booleano che indica se viene visualizzato un cursore a forma di mano quando il puntatore passa sopra uno sprite in cui la proprietà buttonMode è impostata su true. | Sprite | |
| visible : Boolean [override]
Ottiene o imposta un valore che indica se l'istanza corrente del componente è visibile. | UIComponent | |
| width : Number [override]
Ottiene o imposta la larghezza del componente in pixel. | UIComponent | |
| x : Number [override]
Ottiene o imposta la coordinata x che rappresenta la posizione del componente sull'asse x nel contenitore principale. | UIComponent | |
| y : Number [override]
Ottiene o imposta la coordinata y che rappresenta la posizione del componente sull'asse y nel contenitore principale. | UIComponent | |
| z : Number
Indica la posizione della coordinata z lungo l'asse z dell'istanza DisplayObject relativa al contenitore principale 3D. | DisplayObject | |
Metodi pubblici
| Metodo | Definito da | ||
|---|---|---|---|
Crea una nuova istanza del componente TextInput. | TextInput | ||
|
Aggiunge un'istanza secondaria DisplayObject a questa istanza DisplayObjectContainer. | DisplayObjectContainer | |
|
Aggiunge un'istanza secondaria DisplayObject a questa istanza DisplayObjectContainer. | DisplayObjectContainer | |
| 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. | EventDispatcher | |
Aggiunge la stringa specificata dopo l'ultimo carattere contenuto in TextArea. | TextInput | ||
|
Indica se le restrizioni di sicurezza possono determinare l'omissione di eventuali oggetti di visualizzazione dall'elenco restituito dalla chiamata al metodo DisplayObjectContainer.getObjectsUnderPoint() con il punto specificato. | DisplayObjectContainer | |
|
Elimina una proprietà di stile dall'istanza del componente. | UIComponent | |
|
Determina se l'oggetto di visualizzazione specificato è un elemento secondario dell'istanza DisplayObjectContainer oppure è l'istanza stessa. | DisplayObjectContainer | |
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
[override]
Mostra o nasconde l'indicatore di attivazione sul componente. | TextInput | ||
|
Avvia un'azione di disegno immediata, senza invalidare tutto come fa invalidateNow. | UIComponent | |
|
Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace. | DisplayObject | |
|
Restituisce l'istanza dell'oggetto di visualizzazione secondario che si trova in corrispondenza della posizione di indice specificata. | DisplayObjectContainer | |
|
Restituisce l'oggetto di visualizzazione secondario al quale corrisponde il nome specificato. | DisplayObjectContainer | |
|
Restituisce la posizione di indice di un'istanza DisplayObject secondaria. | DisplayObjectContainer | |
|
Recupera l'oggetto che è l'elemento attivo corrente. | UIComponent | |
Recupera le informazioni su una riga di testo specificata. | TextInput | ||
|
Restituisce un array di oggetti che si trovano sotto il punto specificato e sono elementi secondari (di uno o più livelli inferiori) di questa istanza DisplayObjectContainer. | DisplayObjectContainer | |
|
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. | DisplayObject | |
|
Recupera una proprietà style impostata nella catena di ricerca dello stile del componente. | UIComponent | |
[statico]
Recupera la mappa di stile predefinita del componente corrente. | TextInput | ||
|
Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point. | DisplayObject | |
|
Converte un punto bidimensionale dalle coordinate dello stage (globali) in quelle (locali) di un oggetto di visualizzazione tridimensionale. | DisplayObject | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
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. | DisplayObject | |
|
Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y. | DisplayObject | |
|
Contrassegna una proprietà come non valida e ridisegna il componente sul fotogramma successivo salvo diversa indicazione. | UIComponent | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Converte un punto tridimensionale delle coordinate (locali) dell'oggetto di visualizzazione tridimensionale in un punto bidimensionale nelle coordinate dello stage (globali). | DisplayObject | |
|
Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point. | DisplayObject | |
| [statico]
Unisce gli stili di più classi in un unico oggetto. | UIComponent | |
|
Sposta il componente in una posizione specificata all'interno del relativo elemento principale. | UIComponent | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove l'istanza DisplayObject secondaria specificata dall'elenco degli elementi secondari dell'istanza DisplayObjectContainer. | DisplayObjectContainer | |
|
Rimuove un'istanza DisplayObject secondaria dalla posizione di indice specificata nell'elenco degli elementi secondari di DisplayObjectContainer. | DisplayObjectContainer | |
|
Rimuove tutte le istanze DisplayObject secondarie dall'elenco degli elementi secondari dell'istanza DisplayObjectContainer. | DisplayObjectContainer | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
|
Alza una tastiera virtuale. | InteractiveObject | |
|
Cambia la posizione di un elemento secondario nel contenitore di oggetto di visualizzazione. | DisplayObjectContainer | |
|
Imposta questo componente come elemento attivo. | UIComponent | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
Imposta l'intervallo di una selezione effettuata in un'area di testo attiva. | TextInput | ||
|
Imposta il componente sulla larghezza e sull'altezza specificate. | UIComponent | |
|
Imposta una proprietà di stile per l'istanza del componente. | UIComponent | |
|
Consente all'utente di trascinare lo sprite specificato. | Sprite | |
|
Consente all'utente di trascinare lo sprite specificato su un dispositivo abilitato per il tocco. | Sprite | |
|
Interrompe in modo ricorsivo l’esecuzione della linea temporale di qualsiasi MovieClips che ha origine in questo oggetto. | DisplayObjectContainer | |
|
Termina il metodo startDrag(). | Sprite | |
|
Termina il metodo startTouchDrag(), utilizzato con i dispositivi abilitati per il tocco. | Sprite | |
|
Scambia lo z-order (ordine di profondità) degli oggetti secondari specificati. | DisplayObjectContainer | |
|
Scambia lo z-order (ordine di profondità) degli oggetti secondari nelle due posizioni di indice specificate nell'elenco degli elementi secondari. | DisplayObjectContainer | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Convalida e aggiorna le proprietà e il layout di questo oggetto e lo ridisegna, se necessario. | UIComponent | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
Metodi protetti
Eventi
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | ||
| Inviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione. | DisplayObject | ||
| Inviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione sullo stage, sia direttamente o mediante l'aggiunta di una sottostruttura ad albero che contiene l'oggetto di visualizzazione. | DisplayObject | ||
| Inviato quando l'input dell'utente modifica il testo nel componente TextInput. | TextInput | |||
| Inviato quando l'utente sceglie "Cancella" (o "Elimina") dal menu di scelta rapida per il testo. | InteractiveObject | ||
| Inviato quando l'utente preme e rilascia il pulsante principale del dispositivo di puntamento sopra lo stesso InteractiveObject. | InteractiveObject | ||
| Inviato quando un'azione dell'utente causa la visualizzazione del menu di scelta rapida associato a questo oggetto interattivo in un'applicazione AIR. | InteractiveObject | ||
| Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di tagliare oppure sceglie "Taglia" dal menu di scelta rapida per il testo. | InteractiveObject | ||
| Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di tagliare oppure sceglie "Taglia" dal menu di scelta rapida testuale. | InteractiveObject | ||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| Inviato quando l'utente preme e rilascia il pulsante principale di un dispositivo di puntamento due volte in rapida successione sopra la stessa istanza InteractiveObject quando il flag doubleClickEnabled dell'oggetto è impostato su true. | InteractiveObject | ||
| Inviato quando l'utente preme il tasto Invio. | TextInput | |||
| [evento di trasmissione] Inviato quando l'indicatore di riproduzione sta entrando in un nuovo fotogramma. | DisplayObject | ||
| [evento di trasmissione] Inviato quando l'indicatore di riproduzione sta per uscire dal fotogramma corrente. | DisplayObject | ||
| Inviato dopo che un oggetto di visualizzazione ha ricevuto lo stato di attivazione. | InteractiveObject | ||
| Inviato dopo che un oggetto di visualizzazione ha perso lo stato di attivazione. | InteractiveObject | ||
| [evento di trasmissione] Inviato dopo l'esecuzione delle funzioni di costruzione degli oggetti di visualizzazione dei fotogrammi, ma prima dell'esecuzione degli script di fotogramma. | DisplayObject | ||
| Inviato quanto l’utente crea un punto di contatto lungo il bordo della superficie di contatto con un’istanza di InteractiveObject (ad esempio toccando bordo della superficie di contatto in Siri Remote per Apple TV). Alcuni dispositivi possono inoltre interpretare questo contatto come una combinazione di più eventi touch. | InteractiveObject | ||
| Inviato quanto l'utente preme due punti di contatto sulla stessa istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, preme e rilascia due dita su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato quanto l'utente sposta un punto di contatto sull'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, sposta un dito da sinistra a destra su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato quanto l'utente esegue un'operazione di rotazione in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con due dita e le ruota su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato quanto l'utente esegue un'operazione di tocco in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con tre dita e quindi le sposta parallelamente su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato quanto l'utente crea un punto di contatto con un'istanza InteractiveObject, quindi tocca un dispositivo abilitato per il tocco (ad esempio, posiziona più dita su un oggetto di visualizzazione per aprire un menu e quindi tocca con un dito per selezionare una voce di menu su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato quanto l'utente esegue un'operazione di zoom in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con due dita e allontana velocemente le dita su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato dopo che il componente è passato da visibile a invisibile. | UIComponent | ||
| Questo evento viene inviato a qualsiasi applicazione client che supporti input in linea con un IME. | InteractiveObject | ||
| Inviato quando l'utente preme un tasto. | InteractiveObject | ||
| Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando la tastiera. | InteractiveObject | ||
| Inviato quando l'utente rilascia un tasto. | InteractiveObject | ||
| Inviato quando l'utente preme e rilascia il pulsante centrale del dispositivo di puntamento sopra lo stesso InteractiveObject. | InteractiveObject | ||
| Inviato quando un utente preme il pulsante centrale del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando un dispositivo di puntamento. | InteractiveObject | ||
| Inviato quando l'utente sposta il dispositivo di puntamento mentre si trova sopra un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato quando si fa ruotare la rotella del mouse su un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato dopo che il componente viene spostato. | UIComponent | ||
| Inviato dall'iniziatore del trascinamento InteractiveObject quando l'utente rilascia il trascinamento. | InteractiveObject | ||
| Inviato dall'InteractiveObject di destinazione quando un oggetto trascinato viene rilasciato su di esso e il rilascio è stato accettato con una chiamata a DragManager.acceptDragDrop(). | InteractiveObject | ||
| Inviato da un InteractiveObject quando un trascinamento entra nei suoi limiti. | InteractiveObject | ||
| Inviato da un InteractiveObject quando un trascinamento esce dai propri limiti. | InteractiveObject | ||
| Inviato continuamente da un InteractiveObject mentre un'azione di trascinamento rimane all'interno dei suoi limiti. | InteractiveObject | ||
| Inviato all'inizio di un'operazione di trascinamento dall'InteractiveObject che è specificato come iniziatore del trascinamento nella chiamata a DragManager.doDrag(). | InteractiveObject | ||
| Inviato durante un'operazione di trascinamento dall'InteractiveObject che è specificato come iniziatore del trascinamento nella chiamata a DragManager.doDrag(). | InteractiveObject | ||
| Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di incollare oppure sceglie "Incolla" dal menu di scelta rapida testuale. | InteractiveObject | ||
| Inviato quando l'utente abbassa uno stilo attivo oltre la soglia di rilevamento della prossimità dello schermo. | InteractiveObject | ||
| Inviato quando l'utente solleva uno stilo attivo sopra la soglia di rilevamento della prossimità dello schermo. | InteractiveObject | ||
| Inviato quando l'utente sposta uno stilo attivo sullo schermo rimanendo entro la soglia di rilevamento della prossimità. | InteractiveObject | ||
| Inviato quando l'utente allontana uno stilo attivo da questo InteractiveObject rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo. | InteractiveObject | ||
| Inviato quando l'utente sposta uno stilo attivo direttamente sopra questo InteractiveObject rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo. | InteractiveObject | ||
| Inviato quando l'utente allontana uno stilo attivo da questo InteractiveObject o da qualsiasi suo elemento secondario rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo. | InteractiveObject | ||
| Inviato quando l'utente sposta uno stilo attivo sopra questo InteractiveObject dall'esterno della struttura di discendenti dell'oggetto nell'elenco di visualizzazione (rimanendo entro la soglia di rilevamento della prossimità dello schermo). | InteractiveObject | ||
| Inviato quando un utente rilascia il pulsante del dispositivo di puntamento dopo averlo premuto sopra un’istanza InteractiveObject e aver quindi spostato il dispositivo di puntamento fuori dell’istanza stessa. | InteractiveObject | ||
| Inviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione. | DisplayObject | ||
| Inviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione sullo stage, sia direttamente o mediante la rimozione di una sottostruttura ad albero che contiene l'oggetto di visualizzazione. | DisplayObject | ||
| [evento di trasmissione] Inviato quando stanno per essere eseguiti l'aggiornamento e il rendering dell'elenco di visualizzazione. | DisplayObject | ||
| Inviato dopo che il componente viene ridimensionato. | UIComponent | ||
| Inviato quando l'utente preme e rilascia il pulsante destro del dispositivo di puntamento sopra lo stesso InteractiveObject. | InteractiveObject | ||
| Inviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject. | InteractiveObject | ||
| Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di selezionare tutto oppure sceglie "Seleziona tutto" dal menu di scelta rapida testuale. | InteractiveObject | ||
| Inviato dopo che il componente è passato da invisibile a visibile. | UIComponent | ||
| Inviato immediatamente dopo la visualizzazione della tastiera software. | InteractiveObject | ||
| Inviato immediatamente prima della visualizzazione della tastiera software. | InteractiveObject | ||
| Inviato immediatamente dopo la chiusura della tastiera software. | InteractiveObject | ||
| Inviato quando cambia il valore del flag tabChildren dell'oggetto. | InteractiveObject | ||
| Inviato quando cambia il flag tabEnabled dell'oggetto. | InteractiveObject | ||
| Inviato quando cambia il valore della proprietà tabIndex dell'oggetto. | InteractiveObject | ||
| Inviato quando l'utente immette un testo. | TextInput | |||
| Inviato quanto l'utente stabilisce per la prima volta un contatto con un dispositivo abilitato per il tocco (ad esempio, tocca con un dito un cellulare o un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato quanto l'utente rimuove il contatto con un dispositivo abilitato per il tocco (ad esempio, solleva un dito da un cellulare o un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato quando l'utente tocca il dispositivo, e viene inviato in modo continuativo finché il punto di contatto non viene rimosso. | InteractiveObject | ||
| Inviato quanto l'utente sposta il punto di contatto lontano da un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un oggetto di visualizzazione a un altro disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato quanto l'utente sposta il punto di contatto su un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un punto esterno a un oggetto di visualizzazione a un punto su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato quanto l'utente sposta il punto di contatto lontano da un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un oggetto di visualizzazione a un punto esterno a un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato quanto l'utente sposta il punto di contatto su un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un punto esterno a un oggetto di visualizzazione a un punto su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | ||
| Inviato quanto l'utente solleva il punto di contatto sulla stessa istanza InteractiveObject in corrispondenza della quale è stato iniziato il contatto su un dispositivo abilitato per il tocco (ad esempio, preme e rilascia un dito da un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | ||
Stili
Gli stili sono di tipo comune oppure associati a un tema specifico. Se lo stile è comune, può essere utilizzato con qualunque tema. Se è associato a un tema specifico, può essere utilizzato solo se la vostra applicazione ne fa uso.
Stili comuni
| Stile | Descrizione | Definito da | ||
|---|---|---|---|---|
disabledSkin | Tipo: Class Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 Il nome della classe da utilizzare come sfondo per il componente TextInput quando la sua proprietà enabled è impostata su false.
Il valore predefinito è TextInput_disabledSkin. | TextInput | ||
| Tipo: flash.text.TextFormat Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 L'oggetto TextFormat da utilizzare per il rendering dell'etichetta del componente quando il pulsante è disattivato. | UIComponent | ||
embedFonts | Tipo: Boolean Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 Indica se i profili di carattere incorporati vengono utilizzati per il rendering del campo di testo. Se questo valore è impostato su true, Flash Player esegue 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 impostate la proprietà false. | TextInput | ||
| Tipo: Number Formato: Length Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 Il riempimento che separa i margini esterni del componente dai bordi esterni dell'indicatore di attivazione, in pixel. | UIComponent | ||
| Tipo: Class Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 Lo skin da utilizzare per la visualizzazione degli indicatori di attivazione. | UIComponent | ||
| Tipo: flash.text.TextFormat Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 L'oggetto TextFormat da utilizzare per il rendering dell'etichetta del componente. | UIComponent | ||
textPadding | Tipo: Number Formato: Length Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 Il riempimento che separa il bordo del componente dal testo, in pixel. Il valore predefinito è 0. | TextInput | ||
upSkin | Tipo: Class Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 Il nome della classe da utilizzare come sfondo per il componente TextInput. Il valore predefinito è TextInput_upSkin. | TextInput | ||
Costanti pubbliche
Descrizione delle proprietà
alwaysShowSelection | proprietà |
alwaysShowSelection:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta un valore booleano che indica come viene visualizzata una selezione quando il campo di testo non è l'elemento attivo.
Quando questo valore è impostato su true e il campo di testo non è attivo, Flash Player evidenzia la selezione nel campo di testo in grigio. Quando questo valore è impostato su false e il campo di testo non è attivo, Flash Player non evidenzia la selezione nel campo di testo.
Il valore predefinito è false.
Implementazione
public function get alwaysShowSelection():Boolean public function set alwaysShowSelection(value:Boolean):voidEsempio ( Come utilizzare questo esempio )
L'esempio seguente crea un componente TextInput e seleziona del testo mediante il metodo
setSelection():
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
condenseWhite | proprietà |
condenseWhite:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta un valore booleano che indica se deve essere rimosso lo spazio vuoto supplementare da un componente TextInput che contiene testo HTML. Tra gli spazi vuoti supplementari presenti nel componente figurano ad esempio gli spazi e le interruzioni di riga. Il valore true indica che lo spazio vuoto supplementare viene rimosso; il valore false indica che non viene rimosso.
Questa proprietà agisce solo sul testo che viene impostato mediante la proprietà htmlText e non su quello impostato mediante la proprietà text. Se il testo viene impostato con la proprietà text, la proprietà condenseWhite viene ignorata.
Se la proprietà condenseWhite è impostata su true, utilizzate comandi HTML standard quali <br> e <p> per inserire le interruzioni di riga nel campo di testo.
Il valore predefinito è false.
Implementazione
public function get condenseWhite():Boolean public function set condenseWhite(value:Boolean):voidElementi API correlati
displayAsPassword | proprietà |
displayAsPassword:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta un valore booleano che indica se l'istanza corrente del componente TextInput è stata creata per contenere una password o per contenere del testo. Il valore true indica che l'istanza del componente è un campo di testo per password; il valore false indica che è un campo di testo normale.
Quando questa proprietà è impostata su true, l'istanza del componente TextInput visualizza un asterisco per ogni carattere immesso dall'utente nel campo di testo. Inoltre, i comandi Taglia e Copia e i relativi tasti di scelta rapida sono disabilitati. Queste misure servono per impedire il recupero di una password da un computer lasciato incustodito.
Il valore predefinito è false.
Implementazione
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):voidElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea due istanze del componente TextInput; in una la proprietà
displayAsPassword è impostata su true, mentre nell'altra su false:
import fl.controls.Label; import fl.controls.TextInput; var usernameLabel:Label = new Label(); usernameLabel.text = "User name:"; usernameLabel.move(10, 10); addChild(usernameLabel); var usernameTextInput:TextInput = new TextInput(); usernameTextInput.move(90, 10); addChild(usernameTextInput); var passwordLabel:Label = new Label(); passwordLabel.text = "Password:"; passwordLabel.move(10, 40); addChild(passwordLabel); var passwordTextInput:TextInput = new TextInput(); passwordTextInput.displayAsPassword = true; passwordTextInput.move(90, 40); addChild(passwordTextInput);
editable | proprietà |
editable:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta un valore booleano che indica se l'utente può modificare il campo di testo. Il valore true indica che l'utente può modificare il campo di testo; il valore false indica che non può.
Il valore predefinito è true.
Implementazione
public function get editable():Boolean public function set editable(value:Boolean):voidenabled | proprietà |
enabled:Boolean[override] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta un valore che indica se il componente può accettare l'interazione dell'utente. Il valore true indica che il componente può accettare l'interazione dell'utente, mentre il valore false indica che non può.
Se impostate la proprietà enabled su false, il contenitore è visualizzato in grigio e l'input dell'utente viene bloccato (ad eccezione dei componenti Label e ProgressBar).
Implementazione
override public function get enabled():Boolean override public function set enabled(value:Boolean):voidhorizontalScrollPosition | proprietà |
horizontalScrollPosition:int| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta la posizione della casella di scorrimento della barra di scorrimento orizzontale.
Il valore predefinito è 0.
Implementazione
public function get horizontalScrollPosition():int public function set horizontalScrollPosition(value:int):voidElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un'istanza del componente TextInput e visualizza il valore corrente delle relative proprietà
horizontalScrollPosition e maxHorizontalScrollPosition:
import fl.controls.Label;
import fl.controls.Slider;
import fl.controls.TextInput;
import fl.events.SliderEvent;
var myTextInput:TextInput = new TextInput();
myTextInput.text = "The quick brown fox jumped over the lazy dog.";
myTextInput.width = 120;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, textInputChangeHandler);
myTextInput.textField.addEventListener(Event.SCROLL, scrollHandler);
addChild(myTextInput);
var mySlider:Slider = new Slider();
mySlider.snapInterval = 1;
mySlider.tickInterval = 10;
mySlider.minimum = 0;
mySlider.maximum = myTextInput.maxHorizontalScrollPosition;
mySlider.value = myTextInput.horizontalScrollPosition;
mySlider.liveDragging = true;
mySlider.addEventListener(SliderEvent.CHANGE, sliderChangeHandler);
mySlider.width = 120;
mySlider.move(10, 40);
addChild(mySlider);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 50);
addChild(myLabel);
getScrollPosition();
function getScrollPosition():void {
myTextInput.drawNow();
var scrollPos:uint = myTextInput.horizontalScrollPosition;
var maxScrollPos:uint = myTextInput.maxHorizontalScrollPosition;
myLabel.text = "scrollPosition: " + scrollPos + " of " + maxScrollPos;
mySlider.value = scrollPos;
mySlider.maximum = maxScrollPos;
}
function scrollHandler(event:Event):void {
getScrollPosition();
}
function sliderChangeHandler(event:SliderEvent):void {
myTextInput.horizontalScrollPosition = event.value;
getScrollPosition();
}
function textInputChangeHandler(event:Event):void {
getScrollPosition();
}
htmlText | proprietà |
htmlText:String| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Contiene la rappresentazione HTML della stringa contenuta nel campo di testo.
Il valore predefinito è "".
Implementazione
public function get htmlText():String public function set htmlText(value:String):voidElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un componente TextInput non modificabile e imposta la proprietà
htmlText per applicare la formattazione HTML al testo del campo di testo:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.editable = false; myTextInput.enabled = false; myTextInput.htmlText = "(<i>auto assigned</i>)"; myTextInput.move(10, 10); addChild(myTextInput);
imeMode | proprietà |
imeMode:String| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta la modalità IME (Input Method Editor). La modalità IME consente agli utenti di utilizzare una tastiera di tipo QWERTY per immettere dei caratteri appartenenti ai set di caratteri cinese, giapponese e coreano.
Flash imposta la modalità IME specificata quando il componente diventa attivo e reimposta il valore originale quando il componente non è più attivo.
La classe flash.system.IMEConversionMode definisce le costanti per i valori validi per questa proprietà. Impostate questa proprietà su null per impedire l'utilizzo della modalità IME con il componente.
Implementazione
public function get imeMode():String public function set imeMode(value:String):voidlength | proprietà |
length:int [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene il numero di caratteri presenti in un componente TextInput.
Il valore predefinito è 0.
Implementazione
public function get length():intElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un componente TextInput e imposta le relative proprietà
maxChars e restrict per limitare i caratteri che l'utente può immettere:
import fl.controls.Label;
import fl.controls.TextInput;
var myTextInput:TextInput = new TextInput();
myTextInput.restrict = "0-9A-F";
myTextInput.maxChars = 6;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
myLabel.move(10, 30);
addChild(myLabel);
function changeHandler(event:Event):void {
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
}
maxChars | proprietà |
maxChars:int| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta il numero massimo di caratteri che un utente può immettere nel campo di testo.
Il valore predefinito è 0.
Implementazione
public function get maxChars():int public function set maxChars(value:int):voidElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un componente TextInput e imposta le relative proprietà
maxChars e restrict per limitare i caratteri che l'utente può immettere:
import fl.controls.Label;
import fl.controls.TextInput;
var myTextInput:TextInput = new TextInput();
myTextInput.restrict = "0-9A-F";
myTextInput.maxChars = 6;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
myLabel.move(10, 30);
addChild(myLabel);
function changeHandler(event:Event):void {
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
}
maxHorizontalScrollPosition | proprietà |
maxHorizontalScrollPosition:int [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta un valore che descrive la posizione più lontana fino a cui è possibile scorrere il campo di testo verso destra.
Il valore predefinito è 0.
Implementazione
public function get maxHorizontalScrollPosition():intElementi API correlati
restrict | proprietà |
restrict:String| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta la stringa di caratteri che il campo di testo accetta da un utente. Si noti che i caratteri che non sono inclusi in questa stringa sono accettati nel campo di testo se immessi a livello di codice.
La lettura dei caratteri nella stringa viene eseguita da sinistra a destra. Potete specificare un intervallo di caratteri utilizzando il carattere trattino (-).
Se il valore di questa proprietà è null, il campo di testo accetta qualsiasi carattere. Se questa proprietà è impostata su una stringa vuota (""), il campo di testo non accetta alcun carattere.
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.
Il valore predefinito è null.
Implementazione
public function get restrict():String public function set restrict(value:String):voidElementi API correlati
selectionBeginIndex | proprietà |
selectionBeginIndex:int [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene il valore di indice del primo carattere selezionato in una selezione di uno o più caratteri.
La posizione di indice di una carattere selezionato è un valore con base zero e viene calcolata a partire dal primo carattere visualizzato nell'area di testo. Se non è stata effettuata alcuna selezione, il valore viene impostato sulla posizione del punto di inserimento.
Il valore predefinito è 0.
Implementazione
public function get selectionBeginIndex():intElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un componente Label che visualizza le proprietà
selectionBeginIndex e selectionEndIndex per un componente TextInput. Questo esempio crea inoltre due istanze del componente Slider, che possono essere utilizzate per impostare l'indice iniziale della selezione e l'indice finale della selezione a livello di codice mediante il metodo setSelection():
import fl.controls.Label;
import fl.controls.Slider;
import fl.controls.TextInput;
import fl.events.SliderEvent;
var myTextInput:TextInput = new TextInput();
myTextInput.alwaysShowSelection = true;
myTextInput.text = "The quick brown fox jumped over the lazy dog.";
myTextInput.width = 120;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
myTextInput.addEventListener(FocusEvent.FOCUS_IN, focusInHandler);
myTextInput.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler);
addChild(myTextInput);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 30);
addChild(myLabel);
var beginSlider:Slider = new Slider();
beginSlider.maximum = myTextInput.length;
beginSlider.snapInterval = 1;
beginSlider.liveDragging = true;
beginSlider.width = 120;
beginSlider.move(10, 65);
beginSlider.addEventListener(SliderEvent.CHANGE, beginChangeHandler);
addChild(beginSlider);
var endSlider:Slider = new Slider();
endSlider.maximum = myTextInput.length;
endSlider.snapInterval = 1;
endSlider.liveDragging = true;
endSlider.width = 120;
endSlider.move(10, 85);
endSlider.addEventListener(SliderEvent.CHANGE, endChangeHandler);
addChild(endSlider);
var t:Timer = new Timer(50);
t.addEventListener(TimerEvent.TIMER, timerHandler);
function changeHandler(event:Event):void {
beginSlider.maximum = myTextInput.length;
endSlider.maximum = myTextInput.length;
updateUI();
}
function focusInHandler(event:FocusEvent):void {
t.start();
}
function focusOutHandler(event:FocusEvent):void {
t.stop();
}
function beginChangeHandler(event:SliderEvent):void {
myTextInput.setSelection(event.value, myTextInput.selectionEndIndex);
updateUI();
}
function endChangeHandler(event:SliderEvent):void {
myTextInput.setSelection(myTextInput.selectionBeginIndex, event.value);
updateUI();
}
function timerHandler(event:TimerEvent):void {
updateUI();
}
function updateUI():void {
myLabel.text = "selectionBeginIndex:" + myTextInput.selectionBeginIndex + "\n";
myLabel.text += "selectionEndIndex:" + myTextInput.selectionEndIndex;
beginSlider.value = myTextInput.selectionBeginIndex;
endSlider.value = myTextInput.selectionEndIndex;
}
selectionEndIndex | proprietà |
selectionEndIndex:int [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene la posizione di indice dell'ultimo carattere selezionato in una selezione di uno o più caratteri.
La posizione di indice di una carattere selezionato è un valore con base zero e viene calcolata a partire dal primo carattere visualizzato nell'area di testo. Se non è stata effettuata alcuna selezione, il valore viene impostato sulla posizione del punto di inserimento.
Il valore predefinito è 0.
Implementazione
public function get selectionEndIndex():intElementi API correlati
text | proprietà |
text:String| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta una stringa che contiene il testo che si trova nel componente TextInput. Questa proprietà contiene testo non formattato e senza tag HTML. Per recuperare questo testo in formato HTML, utilizzate la proprietà htmlText.
Il valore predefinito è "".
Implementazione
public function get text():String public function set text(value:String):voidElementi API correlati
textField | proprietà |
public var textField:flash.text:TextField| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Un riferimento al campo di testo interno del componente TextInput.
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un'istanza del componente TextInput e utilizza la proprietà
textField per accedere all'oggetto TextField nativo sottostante di ActionScript e chiamare il relativo metodo replaceText():
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.textField.replaceText(41, 44, "fox"); myTextInput.textField.replaceText(16, 19, "dog"); addChild(myTextInput);
textHeight | proprietà |
textWidth | proprietà |
textWidth:Number [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
La larghezza del testo, espressa in pixel.
Il valore predefinito è 0.
Implementazione
public function get textWidth():NumberElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un'istanza del componente TextInput e traccia le proprietà
textWidth e textHeight quando il contenuto del campo di testo viene modificato:
import fl.controls.TextInput;
var myTextInput:TextInput = new TextInput();
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);
function changeHandler(event:Event):void {
trace("textWidth:" + myTextInput.textWidth + ", textHeight:" + myTextInput.textHeight);
}
Descrizione della funzione di costruzione
TextInput | () | Funzione di costruzione |
public function TextInput()| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Crea una nuova istanza del componente TextInput.
Descrizione dei metodi
appendText | () | metodo |
public function appendText(text:String):void| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Aggiunge la stringa specificata dopo l'ultimo carattere contenuto in TextArea. Questo metodo è più efficace della concatenazione di due stringhe mediante un'assegnazione addizione su una proprietà di testo, come ad esempio myTextArea.text += moreText. Questo metodo è particolarmente utile quando il componente TextArea contiene una quantità significativa di contenuti.
Parametri
text:String — La stringa da aggiungere al testo esistente.
|
drawFocus | () | metodo |
override public function drawFocus(draw:Boolean):void| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Mostra o nasconde l'indicatore di attivazione sul componente.
La classe UIComponent implementa questo metodo mediante la creazione e il posizionamento di un'istanza della classe specificata dallo stile focusSkin.
Parametri
draw:Boolean — Indica se mostrare o nascondere l'indicatore di attivazione. Se il valore è impostato su true, l'indicatore di attivazione è visibile, se invece il valore è impostato su false, l'indicatore è nascosto.
|
getLineMetrics | () | metodo |
public function getLineMetrics(index:int):flash.text:TextLineMetrics| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Recupera le informazioni su una riga di testo specificata.
Parametri
index:int — Il numero della riga per cui devono essere recuperate le informazioni.
|
flash.text:TextLineMetrics |
Esempio ( Come utilizzare questo esempio )
L'esempio seguente disegna un rettangolo rosso sopra il valore ascent di un input di testo rispetto alla linea di base e un rettangolo blu sopra il valore descent dell'input di testo rispetto alla linea di base:
var format:TextFormat = new TextFormat();
format.size = 72;
format.font = "Georgia";
import fl.controls.TextInput;
var ti:TextInput = new TextInput();
addChild(ti);
ti.setSize(393,82);
ti.move(10,10);
ti.setStyle("textFormat",format);
ti.text = "Hello World";
ti.drawNow();
var metrics:TextLineMetrics = ti.getLineMetrics(0);
var ascenderColoring:Shape = new Shape();
var descenderColoring:Shape = new Shape();
ti.addChild(ascenderColoring);
ti.addChild(descenderColoring);
ascenderColoring.graphics.clear();
ascenderColoring.graphics.beginFill(0xFF0000,0.2);
ascenderColoring.graphics.drawRect(0, 0, metrics.width, metrics.ascent);
descenderColoring.graphics.clear();
descenderColoring.graphics.beginFill(0x0000FF,0.2);
descenderColoring.graphics.drawRect(0, metrics.ascent + 2, metrics.width, metrics.descent);
getStyleDefinition | () | metodo |
public static function getStyleDefinition():Object| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Recupera la mappa di stile predefinita del componente corrente. La mappa di stile contiene il tipo appropriato per il componente, in base allo stile utilizzato dal componente. Ad esempio, lo stile disabledTextFormat contiene un valore null o un oggetto TextFormat. È possibile utilizzare questi stili e chiamare setStyle() sul componente corrente. Il codice seguente consente di ignorare lo stile disabledTextFormat predefinito sul componente specificato:
componentInstance.setStyle("disabledTextFormat", new TextFormat());Object — Oggetto stili predefinito.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un browser di stili per varie classi di componenti:
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;
var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } );
dp.addItem( { label: "Button", data:Button } );
dp.addItem( { label: "CellRenderer", data:CellRenderer } );
dp.addItem( { label: "CheckBox", data:CheckBox } );
dp.addItem( { label: "ColorPicker", data:ColorPicker } );
dp.addItem( { label: "ComboBox", data:ComboBox } );
dp.addItem( { label: "DataGrid", data:DataGrid } );
dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } );
dp.addItem( { label: "ImageCell", data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label", data:Label } );
dp.addItem( { label: "List", data:List } );
dp.addItem( { label: "NumericStepper", data:NumericStepper } );
dp.addItem( { label: "ProgressBar", data:ProgressBar } );
dp.addItem( { label: "RadioButton", data:RadioButton } );
dp.addItem( { label: "ScrollPane", data:ScrollPane } );
dp.addItem( { label: "Slider", data:Slider } );
dp.addItem( { label: "TextArea", data:TextArea } );
dp.addItem( { label: "TextInput", data:TextInput } );
dp.addItem( { label: "TileList", data:TileList } );
dp.addItem( { label: "UILoader", data:UILoader } );
dp.addItem( { label: "UIComponent", data:UIComponent } );
var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);
var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);
function showStyleDefinition(e:Event):void {
var componentClass:Class = e.target.selectedItem.data as Class;
var styles:Object = componentClass["getStyleDefinition"].call(this);
trace(styles.toString());
var styleData:DataProvider = new DataProvider();
for(var i:* in styles) {
trace(i + " : " + styles[i]);
styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
}
styleData.sortOn("StyleName");
dg.dataProvider = styleData;
}
setSelection | () | metodo |
public function setSelection(beginIndex:int, endIndex:int):void| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Imposta l'intervallo di una selezione effettuata in un'area di testo attiva. L'intervallo di selezione inizia in corrispondenza dell'indice specificato nel parametro start e termina in corrispondenza dell'indice specificato nel parametro end. Se i valori dei parametri che specificano l'intervallo di selezione sono uguali, questo metodo imposta il punto di inserimento del testo allo stesso modo della proprietà caretIndex.
Il testo selezionato viene considerato una stringa con base zero di caratteri in cui il primo carattere selezionato si trova in corrispondenza dell'indice 0, il secondo carattere si trova in corrispondenza dell'indice 1 e così via.
Questo metodo non ha effetto se non è attivo alcun campo di testo.
Parametri
beginIndex:int — La posizione di indice del primo carattere nella selezione.
| |
endIndex:int — La posizione di indice dell'ultimo carattere nella selezione.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente immette del testo in un'istanza TextInput e imposta la selezione sulla seconda parola:
import fl.controls.TextInput; var ti:TextInput = new TextInput(); addChild(ti); ti.text = "Hello World"; ti.setFocus(); ti.setSelection(6, 11);
L'esempio seguente crea un componente TextInput e seleziona del testo mediante il metodo
setSelection():
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
Descrizione degli eventi
change | Evento |
Tipo di oggetto evento:
proprietà Event.type =
flash.events.Eventproprietà Event.type =
flash.events.Event.CHANGE| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Inviato quando l'input dell'utente modifica il testo nel componente TextInput.
Nota: questo evento non si verifica se si utilizza il codice ActionScript per modificare il testo.
La costanteEvent.CHANGE definisce il valore della proprietà type di un oggetto evento change.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | true |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto il cui valore è stato modificato. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento. |
enter | Evento |
Tipo di oggetto evento:
proprietà ComponentEvent.type =
fl.events.ComponentEventproprietà ComponentEvent.type =
fl.events.ComponentEvent.ENTER| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Inviato quando l'utente preme il tasto Invio.
Definisce il valore della proprietàtype di un oggetto evento enter.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto event con un listener di eventi. |
target | L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà currentTarget per accedere all'oggetto che intercetta l'evento. |
textInput | Evento |
Tipo di oggetto evento:
proprietà TextEvent.type =
flash.events.TextEventproprietà TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Inviato quando l'utente immette un testo.
Definisce il valore della proprietàtype di un oggetto evento textInput.
Nota: questo evento non viene inviato per il tasto Canc o Backspace.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | true |
cancelable | true; chiama il metodo preventDefault() per annullare il comportamento predefinito. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | Il campo di testo in cui vengono immessi i caratteri. Il target non è sempre l'oggetto contenuto nell'elenco di visualizzazione, che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento. |
text | Il carattere o la sequenza di caratteri immessi dall'utente. |
TextInputExample.as
Questo esempio mostra come creare un sistema di login di base mediante la classe TextInput
- Aggiungete i componenti TextInput, Label e Button alla libreria
- Salvate questo codice come TextInputExample.as nella stessa directory del FLA
- Impostate DocumentClass nel FLA su TextInputExample
package
{
import flash.display.Sprite;
import flash.events.MouseEvent;
import flash.events.Event;
import fl.controls.TextInput;
import fl.controls.Label;
import fl.controls.Button;
public class TextInputExample extends Sprite
{
private var ti1:TextInput;
private var ti2:TextInput;
private var label1:Label;
private var label2:Label;
private var submitBtn:Button;
public function TextInputExample() {
setupLabels();
setupInputFields();
setupButton();
}
private function setupInputFields():void {
ti1 = new TextInput();
ti2 = new TextInput();
ti1.move(50,10);
ti2.move(50,40);
ti2.displayAsPassword = true;
ti1.addEventListener(Event.CHANGE, textEntered);
ti2.addEventListener(Event.CHANGE, textEntered);
addChild(ti1);
addChild(ti2);
}
private function setupLabels():void {
label1 = new Label();
label2 = new Label();
label1.move(10,10);
label2.move(10,40);
label1.text = "User:";
label2.text = "Pass:"
addChild(label1);
addChild(label2);
}
private function setupButton():void {
submitBtn = new Button();
submitBtn.move(150,70);
submitBtn.label = "Go";
submitBtn.enabled = false;
submitBtn.setSize(50,20);
submitBtn.addEventListener(MouseEvent.CLICK, submitLogin);
addChild(submitBtn);
}
private function textEntered(e:Event):void {
if(ti1.text != "" && ti2.text != "") {
submitBtn.enabled = true;
}
else {
submitBtn.enabled = false;
}
}
private function submitLogin(e:MouseEvent):void {
var submitLabel:Label = new Label();
submitLabel.move(10,70);
submitLabel.autoSize = "left";
submitLabel.text = "Login has been submitted."
addChild(submitLabel);
submitBtn.removeEventListener(MouseEvent.CLICK, submitLogin);
}
}
}
Tue Jun 12 2018, 02:44 PM Z