| Pacchetto | fl.controls |
| Classe | public class TextArea |
| Ereditarietà | TextArea  UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Implementa | IFocusManagerComponent |
| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
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 se Flash Player evidenzia una selezione nel campo di testo quando quest'ultimo non è l'elemento attivo. | TextArea | ||
| 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 TextArea che contiene testo HTML. | TextArea | ||
| 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 un'istanza del componente TextArea è il campo di testo per una password. | TextArea | ||
| 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 testo nel componente. | TextArea | ||
| enabled : Boolean [override]
Ottiene o imposta un valore che indica se il componente può accettare l'interazione dell'utente. | TextArea | ||
| 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 | |
| horizontalScrollBar : UIScrollBar [sola lettura]
Ottiene un riferimento alla barra di scorrimento orizzontale. | TextArea | ||
| horizontalScrollPolicy : String
Ottiene o imposta lo scorrimento della barra di scorrimento orizzontale. | TextArea | ||
| horizontalScrollPosition : Number
Ottiene o imposta la modifica della posizione della casella di scorrimento della barra di scorrimento, espressa in pixel, dopo che l'utente ha effettuato un scorrimento orizzontale del campo di testo. | TextArea | ||
| htmlText : String
Ottiene o imposta la rappresentazione HTML della stringa contenuta nel campo di testo. | TextArea | ||
| imeMode : String
Ottiene o imposta la modalità IME (Input Method Editor). | TextArea | ||
| length : Number [sola lettura]
Ottiene il conteggio dei caratteri presenti nel componente TextArea. | TextArea | ||
| 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. | TextArea | ||
| maxHorizontalScrollPosition : int [sola lettura]
Ottiene il valore massimo della proprietà horizontalScrollPosition. | TextArea | ||
| maxVerticalScrollPosition : int [sola lettura]
Ottiene il valore massimo della proprietà verticalScrollPosition. | TextArea | ||
| 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. | TextArea | ||
| 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 la posizione di indice del primo carattere selezionato in una selezione di uno o più caratteri. | TextArea | ||
| selectionEndIndex : int [sola lettura]
Ottiene la posizione di indice dell'ultimo carattere selezionato in una selezione di uno o più caratteri. | TextArea | ||
| 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. | TextArea | ||
| textField : flash.text:TextField
Un riferimento al campo di testo interno del componente TextArea. | TextArea | ||
| textHeight : Number [sola lettura]
Ottiene l'altezza del testo, espressa in pixel. | TextArea | ||
| textSnapshot : flash.text:TextSnapshot [sola lettura]
Restituisce un oggetto TextSnapshot per questa istanza DisplayObjectContainer. | DisplayObjectContainer | |
| textWidth : Number [sola lettura]
Ottiene la larghezza del testo, espressa in pixel. | TextArea | ||
| 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 | |
| verticalScrollBar : UIScrollBar [sola lettura]
Ottiene un riferimento alla barra di scorrimento verticale. | TextArea | ||
| verticalScrollPolicy : String
Ottiene o imposta lo scorrimento della barra di scorrimento verticale. | TextArea | ||
| verticalScrollPosition : Number
Ottiene o imposta la modifica della posizione della casella di scorrimento della barra di scorrimento, espressa in pixel, dopo che l'utente ha effettuato un scorrimento verticale del campo di testo. | TextArea | ||
| 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 | |
| wordWrap : Boolean
Ottiene o imposta un valore booleano che indica se il testo ha il ritorno a capo automatico alla fine della riga. | TextArea | ||
| 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 | ||
|---|---|---|---|
TextArea()
Crea una nuova istanza del componente TextArea. | TextArea | ||
|
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 nel componente TextArea. | TextArea | ||
|
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. | TextArea | ||
|
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. | TextArea | ||
|
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. | TextArea | ||
|
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. | TextArea | ||
|
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 cambia il testo nel componente TextArea a seguito dell'interazione dell'utente. | TextArea | |||
| 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 mentre si trova nel componente. | TextArea | |||
| [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 il contenuto viene fatto scorrere. | TextArea | |||
| 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, elimina o incolla un testo nel componente. | TextArea | |||
| 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 La classe che fornisce lo sfondo per il componente TextArea quando la sua proprietà enabled è impostata su false.
Il valore predefinito è TextArea_disabledSkin. | TextArea | ||
| 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. | TextArea | ||
| 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 è 3. | TextArea | ||
upSkin | Tipo: Class Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 La classe che fornisce lo sfondo per il componente TextArea. Il valore predefinito è TextArea_upSkin. | TextArea | ||
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 se Flash Player evidenzia una selezione nel campo di testo quando quest'ultimo non è l'elemento attivo. Se questo valore è impostato su true e il campo di testo non è attivo, Flash Player evidenzia la selezione in grigio. Se questo valore è impostato su false e il campo di testo non è attivo, Flash Player non evidenzia la selezione.
Il valore predefinito è false.
Implementazione
public function get alwaysShowSelection():Boolean public function set alwaysShowSelection(value:Boolean):voidElementi API correlati
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 TextArea 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
Esempio ( Come utilizzare questo esempio )
L'esempio seguente utilizza un componente CheckBox per attivare la proprietà
condenseWhite del componente TextArea:
import fl.controls.CheckBox;
import fl.controls.ScrollPolicy;
import fl.controls.TextArea;
var str:String;
var plainTextArea:TextArea = new TextArea();
plainTextArea.verticalScrollPolicy = ScrollPolicy.ON;
plainTextArea.setSize(260, 360);
plainTextArea.move(10, 10);
addChild(plainTextArea);
var htmlTextArea:TextArea = new TextArea();
htmlTextArea.verticalScrollPolicy = ScrollPolicy.ON;
htmlTextArea.condenseWhite = true;
htmlTextArea.setSize(260, 360);
htmlTextArea.move(280, 10);
addChild(htmlTextArea);
var condenseCheckBox:CheckBox = new CheckBox();
condenseCheckBox.textField.autoSize = TextFieldAutoSize.LEFT;
condenseCheckBox.label = "condenseWhite:";
condenseCheckBox.selected = htmlTextArea.condenseWhite;
condenseCheckBox.move(htmlTextArea.x, htmlTextArea.y + htmlTextArea.height);
condenseCheckBox.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(condenseCheckBox);
var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/lorem.html"));
function completeHandler(event:Event):void {
str = event.target.data as String;
plainTextArea.text = str;
htmlTextArea.htmlText = str;
}
function clickHandler(event:MouseEvent):void {
var sel:Boolean = event.currentTarget.selected;
htmlTextArea.condenseWhite = sel;
htmlTextArea.htmlText = str;
}
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 un'istanza del componente TextArea è il campo di testo per una password. Il valore true indica che l'istanza corrente è stata creata per contenere una password; il valore false indica che non è stata creata per tale scopo.
Se il valore di questa proprietà è true, i caratteri immessi dall'utente nell'area di testo non sono visibili. Viene invece visualizzato un asterisco al posto di ciascun carattere immesso. Inoltre, i comandi Taglia e Copia e i relativi tasti di scelta rapida sono disabilitati per impedire il recupero di una password da un computer incustodito.
Il valore predefinito è false.
Implementazione
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):voideditable | 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 testo nel componente. Il valore true indica che l'utente può modificare il testo contenuto nel componente; 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):voidhorizontalScrollBar | proprietà |
horizontalScrollBar:UIScrollBar [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene un riferimento alla barra di scorrimento orizzontale.
Implementazione
public function get horizontalScrollBar():UIScrollBarElementi API correlati
horizontalScrollPolicy | proprietà |
horizontalScrollPolicy:String| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta lo scorrimento della barra di scorrimento orizzontale. Questa proprietà può essere uno dei seguenti valori:
- ScrollPolicy.ON: la barra di scorrimento è sempre attiva.
- ScrollPolicy.OFF: la barra di scorrimento è sempre disattivata.
- ScrollPolicy.AUTO: la barra di scorrimento viene attivata quando necessario.
Il valore predefinito è ScrollPolicy.AUTO.
Implementazione
public function get horizontalScrollPolicy():String public function set horizontalScrollPolicy(value:String):voidElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un'istanza del componente TextArea e imposta la relativa proprietà
horizontalScrollPolicy su ScrollPolicy.ON, in modo che la barra di scorrimento orizzontale sia sempre visibile, indipendentemente dalla quantità di contenuto presente nell'area di testo:
import fl.controls.TextArea; import fl.controls.ScrollPolicy; var myTextArea:TextArea = new TextArea(); myTextArea.wordWrap = false; myTextArea.horizontalScrollPolicy = ScrollPolicy.ON; myTextArea.text = "The quick brown fox jumped over the lazy dog."; myTextArea.setSize(320, 120); myTextArea.move(10, 10); addChild(myTextArea);
horizontalScrollPosition | proprietà |
horizontalScrollPosition:Number| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta la modifica della posizione della casella di scorrimento della barra di scorrimento, espressa in pixel, dopo che l'utente ha effettuato un scorrimento orizzontale del campo di testo. Se questo valore è 0, per il campo di testo non è stato effettuato uno scorrimento orizzontale.
Il valore predefinito è 0.
Implementazione
public function get horizontalScrollPosition():Number public function set horizontalScrollPosition(value:Number):voidElementi API correlati
htmlText | proprietà |
htmlText: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 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'istanza del componente TextArea e utilizza vari tag HTML per applicare lo stile al testo:
import fl.controls.TextArea; var myText:String = ""; myText += "<p>You can use the <b> tag to create <b>bold</b> text.</p>"; myText += "<p>You can use the <i> tag to create <i>italic</i> text.</p>"; myText += "<p>You can use the <u> tag to create <u>underlined</a> text.</p>"; myText += "<p>You can use the <a> tag to create <a href='http://www.adobe.com'>links to other sites</a>.</p>"; myText += "<p>You can use the <br> tag to create<br>new lines of text<br>whenever you want.</p>"; myText += "<p>You can use the <font> tag to specificy different font <font color='#FF0000'>colors</font>, <font size='16'>sizes</font>, or <font face='Times New Roman'>faces</font>.</p>"; myText += "<p>You can use the <img> tag to load images or SWF files:<br><img src='http://www.helpexamples.com/flash/images/logo.png'>.</p>"; var myTextArea:TextArea = new TextArea(); myTextArea.htmlText = myText; myTextArea.setSize(320, 240); myTextArea.move(10, 10); addChild(myTextArea);
L'esempio seguente crea un'istanza del componente TextArea e collegamenti mediante il tag di ancoraggio HTML:
import fl.controls.TextArea;
var str:String = "<p>Check out the following links:</p>";
str += "<li><a href=\"event:flash\"><u>Flash</u></a></li>";
str += "<li><a href=\"event:flex\"><u>Flex</u></a></li>";
str += "<li><a href=\"event:devnet\"><u>Developer Center</u></a></li>";
var myTextArea:TextArea = new TextArea();
myTextArea.htmlText += str;
myTextArea.setSize(320, 120);
myTextArea.move(10, 10);
myTextArea.addEventListener(TextEvent.LINK, linkHandler);
addChild(myTextArea);
function linkHandler(event:TextEvent):void {
var url:String = "http://www.adobe.com/go/" + event.text;
var urlReq:URLRequest = new URLRequest(url);
navigateToURL(urlReq);
}
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):voidElementi API correlati
length | proprietà |
length:Number [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene il conteggio dei caratteri presenti nel componente TextArea.
Il valore predefinito è 0.
Implementazione
public function get length():NumberElementi API correlati
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'istanza del componente TextArea e imposta la relativa proprietà
maxChars per limitare la quantità di testo che può essere immessa nell'area di testo:
import fl.controls.Label;
import fl.controls.TextArea;
var myTextArea:TextArea = new TextArea();
myTextArea.maxChars = 500;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(TextEvent.TEXT_INPUT, textInputHandler);
addChild(myTextArea);
var charCountLabel:Label = new Label();
charCountLabel.autoSize = TextFieldAutoSize.LEFT;
charCountLabel.move(myTextArea.x, myTextArea.y + myTextArea.height);
addChild(charCountLabel);
charCountLabel.text = myTextArea.length + " of " + myTextArea.maxChars;
function textInputHandler(event:TextEvent):void {
updateCount();
}
function updateCount():void {
charCountLabel.text = myTextArea.length + " of " + myTextArea.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 il valore massimo della proprietà horizontalScrollPosition.
Il valore predefinito è 0.
Implementazione
public function get maxHorizontalScrollPosition():intElementi API correlati
maxVerticalScrollPosition | proprietà |
maxVerticalScrollPosition: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 massimo della proprietà verticalScrollPosition.
Il valore predefinito è 1.
Implementazione
public function get maxVerticalScrollPosition():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 la posizione 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
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 TextArea.
textHeight | proprietà |
textHeight:Number [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene l'altezza del testo, espressa in pixel.
Il valore predefinito è 0.
Implementazione
public function get textHeight():NumberElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un'istanza del componente TextArea e visualizza le proprietà
textWidth e textHeight quando viene inviato l'evento change:
import fl.controls.Label;
import fl.controls.TextArea;
var myTextArea:TextArea = new TextArea()
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextArea);
var widthLabel:Label = new Label();
widthLabel.autoSize = TextFieldAutoSize.LEFT;
widthLabel.text = "textWidth: " + myTextArea.textWidth;
widthLabel.move(340, 10);
addChild(widthLabel);
var heightLabel:Label = new Label();
heightLabel.autoSize = TextFieldAutoSize.LEFT;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
heightLabel.move(340, 30);
addChild(heightLabel);
function changeHandler(event:Event):void {
widthLabel.text = "textWidth: " + myTextArea.textWidth;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
}
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 |
Ottiene 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 TextArea e visualizza le proprietà
textWidth e textHeight quando viene inviato l'evento change:
import fl.controls.Label;
import fl.controls.TextArea;
var myTextArea:TextArea = new TextArea()
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextArea);
var widthLabel:Label = new Label();
widthLabel.autoSize = TextFieldAutoSize.LEFT;
widthLabel.text = "textWidth: " + myTextArea.textWidth;
widthLabel.move(340, 10);
addChild(widthLabel);
var heightLabel:Label = new Label();
heightLabel.autoSize = TextFieldAutoSize.LEFT;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
heightLabel.move(340, 30);
addChild(heightLabel);
function changeHandler(event:Event):void {
widthLabel.text = "textWidth: " + myTextArea.textWidth;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
}
verticalScrollBar | proprietà |
verticalScrollBar:UIScrollBar [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene un riferimento alla barra di scorrimento verticale.
Implementazione
public function get verticalScrollBar():UIScrollBarElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un'istanza del componente TextArea e imposta la proprietà
pageSize della barra di scorrimento verticale del componente:
import fl.controls.TextArea;
import fl.events.ScrollEvent;
var myTextArea:TextArea = new TextArea();
myTextArea.setSize(160, 120);
myTextArea.move(10, 10);
myTextArea.verticalScrollBar.pageSize = 1;
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea);
var myURLLoader:URLLoader = new URLLoader();
myURLLoader.addEventListener(Event.COMPLETE, completeHandler);
myURLLoader.load(new URLRequest("http://www.helpexamples.com/flash/lorem.txt"));
function scrollHandler(event:ScrollEvent):void {
trace("scroll: " + myTextArea.verticalScrollPosition + " of " + myTextArea.maxVerticalScrollPosition);
}
function completeHandler(event:Event):void {
var txt:String = URLLoader(event.currentTarget).data as String;
myTextArea.text = txt;
}
verticalScrollPolicy | proprietà |
verticalScrollPolicy:String| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta lo scorrimento della barra di scorrimento verticale. Questa proprietà può essere uno dei seguenti valori:
- ScrollPolicy.ON: la barra di scorrimento è sempre attiva.
- ScrollPolicy.OFF: la barra di scorrimento è sempre disattivata.
- ScrollPolicy.AUTO: la barra di scorrimento viene attivata quando necessario.
Il valore predefinito è ScrollPolicy.AUTO.
Implementazione
public function get verticalScrollPolicy():String public function set verticalScrollPolicy(value:String):voidElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente crea un'istanza del componente TextArea e imposta la relativa proprietà
verticalScrollPolicy su ScrollPolicy.ON, in modo che la barra di scorrimento verticale sia sempre visibile, indipendentemente dalla quantità di contenuto presente nell'area di testo:
import fl.controls.TextArea; import fl.controls.ScrollPolicy; var myTextArea:TextArea = new TextArea(); myTextArea.verticalScrollPolicy = ScrollPolicy.ON; myTextArea.text = "The quick brown fox jumped over the lazy dog."; myTextArea.setSize(160, 120); myTextArea.move(10, 10); addChild(myTextArea);
verticalScrollPosition | proprietà |
verticalScrollPosition:Number| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta la modifica della posizione della casella di scorrimento della barra di scorrimento, espressa in pixel, dopo che l'utente ha effettuato un scorrimento verticale del campo di testo. Se questo valore è 1, per il campo di testo non è stato effettuato uno scorrimento verticale.
Il valore predefinito è 1.
Implementazione
public function get verticalScrollPosition():Number public function set verticalScrollPosition(value:Number):voidElementi API correlati
Esempio ( Come utilizzare questo esempio )
L'esempio seguente utilizza un componente Slider per scorrere il contenuto di un componente TextArea:
import fl.controls.ScrollPolicy;
import fl.controls.Slider;
import fl.controls.SliderDirection
import fl.controls.TextArea;
import fl.events.ScrollEvent;
import fl.events.SliderEvent;
var myTextArea:TextArea = new TextArea();
myTextArea.horizontalScrollPolicy = ScrollPolicy.OFF;
myTextArea.verticalScrollPolicy = ScrollPolicy.OFF;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea)
var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.snapInterval = 1;
mySlider.tickInterval = 1;
mySlider.width = myTextArea.width;
mySlider.move(myTextArea.x, myTextArea.y + myTextArea.height + 10);
var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt"));
function completeHandler(event:Event):void {
var txt:String = event.target.data as String;
myTextArea.text = txt;
myTextArea.drawNow();
mySlider.minimum = myTextArea.verticalScrollPosition;
mySlider.maximum = myTextArea.maxVerticalScrollPosition;
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);
}
function scrollHandler(event:ScrollEvent):void {
trace("scrolled:");
mySlider.value = event.position;
}
function changeHandler(event:SliderEvent):void {
trace("changed:");
myTextArea.verticalScrollPosition = event.value;
}
wordWrap | proprietà |
wordWrap: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 il testo ha il ritorno a capo automatico alla fine della riga. Il valore true indica che è impostato il ritorno a capo automatico; il valore false indica che non lo è.
Il valore predefinito è true.
Implementazione
public function get wordWrap():Boolean public function set wordWrap(value:Boolean):voidElementi API correlati
Descrizione della funzione di costruzione
TextArea | () | Funzione di costruzione |
public function TextArea()| 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 TextArea.
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 nel componente 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(lineIndex: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
lineIndex:int — Il numero della riga per cui devono essere recuperate le informazioni.
|
flash.text:TextLineMetrics |
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(setSelection: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. 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
setSelection:int — La posizione di indice del primo carattere nella selezione.
| |
endIndex:int — La posizione di indice dell'ultimo carattere nella selezione.
|
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 cambia il testo nel componente TextArea a seguito dell'interazione dell'utente. Questo evento non viene inviato quando il codice ActionScript modifica il componente.
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 mentre si trova nel componente.
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. |
scroll | Evento |
Tipo di oggetto evento:
proprietà ScrollEvent.type =
Esempio ( Come utilizzare questo esempio )
fl.events.ScrollEventproprietà ScrollEvent.type =
fl.events.ScrollEvent.SCROLL| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Inviato quando il contenuto viene fatto scorrere.
Definisce il valore della proprietàtype di un oggetto evento scroll.
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. |
delta | 1; valore che indica la portata dello scorrimento.
|
direction | vertical; direzione di ScrollBar. |
position | 0; posizione della casella di scorrimento Scrollbar dopo lo spostamento. |
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. |
Esempio ( Come utilizzare questo esempio )
L'esempio seguente carica del testo in un componente TextArea e traccia la direzione e la posizione di scorrimento e la posizione di scorrimento massima quando l'utente scorre l'area di testo:
import fl.controls.ScrollBarDirection;
import fl.controls.TextArea;
import fl.events.ScrollEvent;
var myTextArea:TextArea = new TextArea();
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea);
var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt"));
function completeHandler(event:Event):void {
var txt:String = event.target.data as String;
myTextArea.text = txt;
}
function scrollHandler(event:ScrollEvent):void {
var myTA:TextArea = event.currentTarget as TextArea;
var pos:Number = event.position;
var maxPos:Number;
if (event.direction == ScrollBarDirection.VERTICAL) {
maxPos = myTA.maxVerticalScrollPosition;
} else {
maxPos = myTA.maxHorizontalScrollPosition;
}
trace("scroll: " + event.direction + " (" + pos.toFixed(2) + " of " + maxPos + ")");
}
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, elimina o incolla un testo nel componente.
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. |
TextAreaExample.as
Questo esempio mostra come intercettare gli eventi di un'istanza della classe TextArea
- Trascinate un componente TextArea nello stage e denominatelo
ta1. - Trascinate un componente TextArea nello stage e denominatelo
ta2. - Salvate questo codice come TextAreaExample.as nella stessa directory del FLA.
- Impostate DocumentClass nel FLA su TextAreaExample.
package
{
import flash.display.Sprite;
import flash.events.Event;
import flash.events.TextEvent;
import flash.text.TextField;
import fl.events.ComponentEvent;
import fl.controls.TextArea;
public class TextAreaExample extends Sprite
{
private var testString:String = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Vivamus quis nisl vel tortor nonummy vulputate. Quisque sit amet eros sed purus euismod tempor. Morbi tempor. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos. Curabitur diam. Suspendisse at purus in ipsum volutpat viverra. Nulla pellentesque libero id libero. Proin pretium suscipit lectus. Donec in sapien vel nulla egestas semper. Mauris massa. In aliquet sem ac libero. In eget orci. Sed feugiat. Vestibulum vel felis in lectus imperdiet scelerisque. Vestibulum vestibulum neque at est. Etiam purus quam, laoreet quis, accumsan sed, porttitor ut, erat. Proin volutpat. In facilisis dolor gravida felis. Curabitur nisi lacus, euismod non, pharetra et, mollis a, tellus. Donec lectus orci, viverra at, luctus ac, sodales id, quam. Phasellus faucibus lacus ut est. Curabitur id diam eu massa bibendum lobortis. Vivamus quis elit. Donec mi justo, dictum vitae, cursus sit amet, lacinia consectetuer, d ut, vulputate sed, molestie et, arcu. Nullam mi.';
private var testStringHTML:String = 'This is <font color="#FF0000">HTML text</font> in a <b>TextArea control</b>. Use the <u>htmlText property</u> of the <font color="#008800">TextArea control</font> to include basic HTML markup in your text.';
public function TextAreaExample() {
ta1.text = testString;
ta2.htmlText = testStringHTML;
configureListeners(ta1);
configureListeners(ta2);
}
private function configureListeners(ta:TextArea):void {
ta.addEventListener(TextEvent.TEXT_INPUT,announceEvent);
ta.addEventListener(Event.CHANGE,announceEvent);
ta.addEventListener(ComponentEvent.ENTER,announceEvent);
ta.addEventListener(Event.SCROLL,announceEvent);
}
private function announceEvent(e:Event):void {
trace(e.toString());
}
}
}
Tue Jun 12 2018, 02:44 PM Z