Pacchetto | flash.text |
Classe | public class TextField |
Ereditarietà | TextField InteractiveObject DisplayObject EventDispatcher Object |
Sottoclassi | FlexTextField |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Per creare un campo di testo in modo dinamico, utilizzate la funzione di costruzione TextField()
.
I metodi della classe TextField consentono di impostare, selezionare e gestire il testo in un campo di testo dinamico o di input creato in fase di runtime o di creazione.
ActionScript fornisce svariati modi per formattare il testo in fase di runtime. La classe TextFormat consente di impostare la formattazione dei caratteri e dei paragrafi per gli oggetti TextField. È possibile applicare stili CSS (Cascading Style Sheets) ai campi di testo utilizzando la proprietà TextField.styleSheet
e la classe StyleSheet. Gli stili CSS possono essere utilizzati per specificare lo stile dei tag HTML incorporati, definire nuovi tag di formattazione o applicare stili. Potete assegnare testo in formato HTML, che utilizza eventualmente gli stili CSS, direttamente a un campo di testo. Il testo HTML assegnato a un campo di testo può includere contenuti multimediali incorporati, ad esempio clip filmato e file SWF, GIF, PNG e JPEG. Il testo viene disposto intorno all'oggetto multimediale incorporato nello stesso modo in cui in un browser il testo si dispone intorno a oggetti multimediali incorporati in un documento HTML.
Flash Player supporta inoltre un sottoinsieme di tag HTML utilizzabili per formattare il testo. Per un elenco dei tag HTML supportati, vedete la descrizione della proprietà htmlText
.
Altri esempi
Visualizzazione del testo HTML
Uso delle immagini nei campi di testo
Scorrimento del testo in un campo di testo
Selezione ed elaborazione del testo
Rilevamento dell'input di testo
Limitazione dell'input di testo
Formattazione di testo
Operazioni con il testo statico
Esempio di TextField: formattazione del testo nello stile di un quotidiano
Altre informazioni
Elementi fondamentali della programmazione degli elementi visivi
Classi di visualizzazione di base
Scelta di una sottoclasse DisplayObject
Nozioni fondamentali sulle operazioni con il testo
Uso della classe TextField
Visualizzazione del testo
Rendering avanzato del testo
Elementi API correlati
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
Quando è impostata su true e il campo di testo non è attivo, Flash Player evidenzia la selezione nel campo di testo in grigio. | TextField | ||
antiAliasType : String
Il tipo di antialiasing utilizzato per questo campo di testo. | TextField | ||
autoSize : String
Controlla il dimensionamento e l'allineamento automatici dei campi di testo. | TextField | ||
background : Boolean
Specifica se il campo di testo ha un riempimento di sfondo. | TextField | ||
backgroundColor : uint
Il colore di sfondo del campo di testo. | TextField | ||
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 | ||
border : Boolean
Specifica se il campo di testo ha un bordo. | TextField | ||
borderColor : uint
Il colore del bordo del campo di testo. | TextField | ||
bottomScrollV : int [sola lettura]
Un numero intero (indice a base uno) che indica l'ultima riga in basso attualmente visibile nel campo di testo specificato. | TextField | ||
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 | ||
caretIndex : int [sola lettura]
L'indice della posizione del punto di registrazione (accento circonflesso). | TextField | ||
condenseWhite : Boolean
Un valore booleano che specifica se viene rimosso lo spazio vuoto supplementare (spazi, interruzioni di riga, e così via) di un campo di testo HTML. | TextField | ||
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 | ||
defaultTextFormat : flash.text:TextFormat
Specifica il formato applicato al testo appena immesso, ad esempio al testo digitato da un utente o quello immesso mediante il metodo replaceSelectedText(). | TextField | ||
displayAsPassword : Boolean
Specifica se il campo di testo è protetto da password. | TextField | ||
doubleClickEnabled : Boolean
Specifica se l'oggetto riceve gli eventi doubleClick. | InteractiveObject | ||
embedFonts : Boolean
Specifica se deve essere eseguito il rendering del campo di testo mediante i profili di carattere incorporati. | TextField | ||
filters : Array
Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione. | DisplayObject | ||
focusRect : Object
Specifica se l'oggetto visualizza un rettangolo di attivazione. | InteractiveObject | ||
gridFitType : String
Il tipo di adattamento alla griglia utilizzato per questo campo di testo. | TextField | ||
height : Number
Indica l'altezza dell'oggetto di visualizzazione espressa in pixel. | DisplayObject | ||
htmlText : String
Contiene la rappresentazione HTML dei contenuti dei campi di testo. | TextField | ||
length : int [sola lettura]
Il numero di caratteri presenti in un campo di testo. | TextField | ||
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
Il numero massimo di caratteri immessi da un utente, che il campo di testo può contenere. | TextField | ||
maxScrollH : int [sola lettura]
Il valore massimo di scrollH. | TextField | ||
maxScrollV : int [sola lettura]
Il valore massimo di scrollV. | TextField | ||
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 | ||
mouseEnabled : Boolean
Specifica se questo oggetto riceve messaggi del mouse o di altri dispositivi di input dell'utente. | InteractiveObject | ||
mouseWheelEnabled : Boolean
Un valore booleano che indica se Flash Player scorre automaticamente i campi di testo multiriga quando l'utente fa clic su un campo di testo e utilizza la rotella del mouse. | TextField | ||
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 | ||
multiline : Boolean
Indica se il campo è un campo di testo multiriga. | TextField | ||
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 | ||
numLines : int [sola lettura]
Definisce il numero delle righe di testo in un campo di testo multiriga. | TextField | ||
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
Indica il set di caratteri che l'utente può immettere in un campo di testo. | TextField | ||
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
Indica la scala orizzontale (percentuale) dell'oggetto applicata dal punto di registrazione. | DisplayObject | ||
scaleY : Number
Indica la scala verticale (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | DisplayObject | ||
scaleZ : Number
Indica la scala di profondità (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | DisplayObject | ||
scrollH : int
La posizione di scorrimento orizzontale corrente. | TextField | ||
scrollRect : Rectangle
I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione. | DisplayObject | ||
scrollV : int
La posizione verticale del testo in un campo. | TextField | ||
selectable : Boolean
Un valore booleano che indica se il campo di testo è selezionabile. | TextField | ||
selectionBeginIndex : int [sola lettura]
Il valore dell'indice a base zero del primo carattere nella selezione corrente. | TextField | ||
selectionEndIndex : int [sola lettura]
Il valore dell'indice a base zero dell'ultimo carattere nella selezione corrente. | TextField | ||
sharpness : Number
La precisione dei bordi del glifo in questo campo di testo. | TextField | ||
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 | ||
stage : Stage [sola lettura]
Lo stage dell'oggetto di visualizzazione. | DisplayObject | ||
styleSheet : StyleSheet
Associa un foglio di stile al campo di testo. | TextField | ||
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
Una stringa che rappresenta il testo corrente nel campo di testo. | TextField | ||
textColor : uint
Il colore del testo nel campo di testo, in formato esadecimale. | TextField | ||
textHeight : Number [sola lettura]
L'altezza del testo espressa in pixel. | TextField | ||
textInteractionMode : String [sola lettura]
La proprietà modalità di interazione. Il valore predefinito è TextInteractionMode.NORMAL. | TextField | ||
textWidth : Number [sola lettura]
La larghezza del testo espressa in pixel. | TextField | ||
thickness : Number
Lo spessore dei bordi del glifo in questo campo di testo. | TextField | ||
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 | ||
type : String
Il tipo di campo di testo. | TextField | ||
useRichTextClipboard : Boolean
Specifica se copiare e incollare la formattazione assieme al testo. | TextField | ||
visible : Boolean
Determina se l'oggetto di visualizzazione è visibile o meno. | DisplayObject | ||
width : Number
Indica la larghezza dell'oggetto di visualizzazione espressa in pixel. | DisplayObject | ||
wordWrap : Boolean
Un valore booleano che indica se per il campo di testo è abilitato il ritorno a capo automatico. | TextField | ||
x : Number
Indica la coordinata x dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | DisplayObject | ||
y : Number
Indica la coordinata y dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | DisplayObject | ||
z : Number
Indica la posizione della coordinata z lungo l'asse z dell'istanza DisplayObject relativa al contenitore principale 3D. | DisplayObject |
Metodo | Definito da | ||
---|---|---|---|
Crea una nuova istanza TextField. | TextField | ||
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 dal parametro nuovoTesto alla fine del testo del relativo campo. | TextField | ||
Invia un evento nel flusso di eventi. | EventDispatcher | ||
Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace. | DisplayObject | ||
Restituisce un rettangolo che rappresenta il riquadro di delimitazione del carattere. | TextField | ||
Restituisce il valore dell'indice a base zero del carattere nel punto specificato dai parametri x e y. | TextField | ||
Dato un indice di carattere, restituisce l'indice del primo carattere nello stesso paragrafo. | TextField | ||
Restituisce un riferimento DisplayObject per l'id dato, relativo a un'immagine o a un file SWF che è stato aggiunto a un campo di testo con formattazione HTML mediante un tag <img>. | TextField | ||
Restituisce il valore dell'indice a base zero della riga nel punto specificato dai parametri x e y. | TextField | ||
Restituisce il valore dell'indice a base zero della riga contenente il carattere specificato dal parametro charIndex. | TextField | ||
Restituisce il numero di caratteri presenti in una riga di testo specifica. | TextField | ||
Restituisce informazioni sulla metrica relative a una data riga di testo. | TextField | ||
Restituisce l'indice di carattere del primo carattere nella riga specificata dal parametro lineIndex. | TextField | ||
Restituisce il testo della riga specificata dal parametro lineIndex. | TextField | ||
Dato un indice di carattere, restituisce la lunghezza del paragrafo contenente il carattere dato. | TextField | ||
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 | ||
Restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo compreso tra i parametri indiceIniziale e indiceFinale. | TextField | ||
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 | ||
[statico]
Restituisce true se è disponibile un carattere incorporato con i valori fontName e fontStyle specificati, dove Font.fontType è flash.text.FontType.EMBEDDED. | TextField | ||
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 | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | ||
Sostituisce la selezione corrente con il contenuto del parametro value. | TextField | ||
Sostituisce un intervallo di caratteri, specificato dai parametri indiceIniziale e indiceFinale, con il contenuto del parametro nuovoTesto. | TextField | ||
Alza una tastiera virtuale. | InteractiveObject | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Imposta come selezionato il testo designato dai valori di indice del primo e ultimo carattere, specificati dai parametri indiceIniziale e indiceFinale. | TextField | ||
Applica la formattazione indicata dal parametro format al testo specificato nel campo di testo. | TextField | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
Restituisce il valore di base dell'oggetto specificato. | Object | ||
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher |
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 dopo la modifica del valore di un controllo, a differenza dell'evento textInput che viene inviato prima della modifica del valore. | TextField | |||
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 | |||
[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 | |||
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 un utente fa clic su un collegamento ipertestuale in un campo di testo abilitato per HTML, dove l'URL inizia con "event:". | TextField | |||
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 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 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 da un oggetto TextField dopo che l'utente ha eseguito lo scorrimento. | TextField | |||
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 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 | |||
Flash Player invia l'evento textInput quando un utente immette uno o più caratteri di testo. | TextField | |||
Flash Player invia l'evento textInteractionModeChange quando un utente cambia la modalità di interazione di un campo di testo. | TextField | |||
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 |
alwaysShowSelection | proprietà |
alwaysShowSelection:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Quando è impostata su true
e il campo di testo non è attivo, Flash Player evidenzia la selezione nel campo di testo in grigio. Quando è impostata su false
e il campo di testo non è attivo, Flash Player non evidenzia la selezione nel campo di testo.
Il valore predefinito è false.
Implementazione
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_alwaysShowSelection extends Sprite { public function TextField_alwaysShowSelection() { var label1:TextField = createCustomTextField(0, 20, 200, 20); label1.text = "This text is selected."; label1.setSelection(0, 9); label1.alwaysShowSelection = true; var label2:TextField = createCustomTextField(0, 50, 200, 20); label2.text = "Drag to select some of this text."; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
antiAliasType | proprietà |
antiAliasType:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Il tipo di antialiasing utilizzato per questo campo di testo. Utilizzate le costanti flash.text.AntiAliasType
per questa proprietà. È possibile controllare questa impostazione solo se il carattere è incorporato (con la proprietà embedFonts
impostata su true
). L'impostazione predefinita è flash.text.AntiAliasType.NORMAL
.
Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:
Valore stringa | Descrizione |
---|---|
flash.text.AntiAliasType.NORMAL | Applica l'antialiasing di testo normale. Questo valore corrisponde al tipo di antialiasing utilizzato da Flash Player versione 7 e precedenti. |
flash.text.AntiAliasType.ADVANCED | Applica l'antialiasing avanzato, che consente di migliorare la leggibilità del testo (funzione aggiunta in Flash Player 8). L'antialiasing avanzato consente di migliorare la leggibilità del testo e di eseguire il rendering dei caratteri con una qualità molto alta anche quando sono di piccole dimensioni. Trova il suo utilizzo ottimale nelle applicazioni con molto testo di piccole dimensioni. L'antialiasing avanzato non è consigliato per i caratteri superiori a 48 punti. |
Implementazione
public function get antiAliasType():String
public function set antiAliasType(value:String):void
Elementi API correlati
autoSize | proprietà |
autoSize:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Controlla il dimensionamento e l'allineamento automatici dei campi di testo. I valori accettabili per le costanti TextFieldAutoSize
sono: TextFieldAutoSize.NONE
(predefinito), TextFieldAutoSize.LEFT
, TextFieldAutoSize.RIGHT
e TextFieldAutoSize.CENTER
.
Se autoSize
è impostata su TextFieldAutoSize.NONE
(il valore predefinito), non viene effettuato alcun ridimensionamento.
Se autoSize
è impostata su TextFieldAutoSize.LEFT
, il testo viene considerato giustificato a sinistra, pertanto il margine sinistro del campo di testo rimane fisso e l'eventuale ridimensionamento di una riga singola del campo viene effettuato sul margine destro. Se il testo contiene un'interruzione di riga (ad esempio "\n"
o "\r"
), anche il lato inferiore viene ridimensionato in modo da rientrare nella riga di testo successiva. Se anche wordWrap
viene impostata su true
, solo il lato inferiore del campo di testo viene ridimensionato mentre il lato destro rimane fisso.
Se autoSize
è impostata su TextFieldAutoSize.RIGHT
, il testo viene considerato giustificato a destra, pertanto il margine destro del campo di testo rimane fisso e l'eventuale ridimensionamento di una riga singola del campo viene effettuato sul margine sinistro. Se il testo contiene un'interruzione di riga (ad esempio "\n" or "\r")
, anche il lato inferiore viene ridimensionato in modo da rientrare nella riga di testo successiva. Se anche wordWrap
viene impostata su true
, solo il lato inferiore del campo di testo viene ridimensionato mentre il lato sinistro rimane fisso.
Se autoSize
è impostata su TextFieldAutoSize.CENTER
, il testo viene considerato giustificato al centro, pertanto l'eventuale ridimensionamento di una riga singola del campo di testo viene distribuito equamente sui margini destro e sinistro. Se il testo contiene un'interruzione di riga (ad esempio "\n"
o "\r"
), anche il lato inferiore viene ridimensionato in modo da rientrare nella riga di testo successiva. Se anche wordWrap
viene impostata su true
, solo il lato inferiore del campo di testo viene ridimensionato mentre i lati sinistro e destro rimangono fissi.
Implementazione
public function get autoSize():String
public function set autoSize(value:String):void
Genera
ArgumentError — Il valore di autoSize specificato non è un membro di flash.text.TextFieldAutoSize.
|
Elementi API correlati
background | proprietà |
background:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Specifica se il campo di testo ha un riempimento di sfondo. Se true
, il campo di testo ha un riempimento di sfondo. Se false
, il campo di testo non ha un riempimento di sfondo. Utilizzate la proprietà backgroundColor
per impostare il colore di sfondo di un campo di testo.
Il valore predefinito è false.
Implementazione
public function get background():Boolean
public function set background(value:Boolean):void
Elementi API correlati
backgroundColor | proprietà |
backgroundColor:uint
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Il colore di sfondo del campo di testo. Il valore predefinito è 0xFFFFFF
(bianco). Questa proprietà può essere recuperata o impostata, anche se non è presente uno sfondo e il colore è visibile solo se il campo di testo ha la proprietà background
impostata su true
.
Implementazione
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
Elementi API correlati
border | proprietà |
border:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Specifica se il campo di testo ha un bordo. Se true
, il campo di testo presenta un bordo. Se false
, il campo di testo è privo di bordo. Utilizzate la proprietà borderColor
per impostare il colore del bordo.
Il valore predefinito è false.
Implementazione
public function get border():Boolean
public function set border(value:Boolean):void
Elementi API correlati
borderColor | proprietà |
borderColor:uint
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Il colore del bordo del campo di testo. Il valore predefinito è 0x000000
(nero). Questa proprietà può essere recuperata o impostata, anche se non è presente un bordo e il colore è visibile solo se il campo di testo ha la proprietà border
impostata su true
.
Implementazione
public function get borderColor():uint
public function set borderColor(value:uint):void
Elementi API correlati
bottomScrollV | proprietà |
bottomScrollV:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un numero intero (indice a base uno) che indica l'ultima riga in basso attualmente visibile nel campo di testo specificato. Il campo di testo può essere considerato come una finestra sopra un blocco di testo. La proprietà scrollV
è l'indice a base 1 della prima riga visibile in alto nella finestra.
Tutto il testo compreso tra le righe indicate da scrollV
e bottomScrollV
è visibile nel campo di testo.
Implementazione
public function get bottomScrollV():int
Elementi API correlati
caretIndex | proprietà |
caretIndex:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
L'indice della posizione del punto di registrazione (accento circonflesso). Se non viene visualizzato alcun punto di registrazione, il valore è rappresentato dalla posizione in cui il punto di registrazione si troverebbe se fosse ripristinata l'attivazione del campo (solitamente, l'ultima posizione in cui si trovava il punto di registrazione, oppure 0 se il campo non è attivato).
Gli indici delle estensioni di selezione sono a base zero (ad esempio, la prima posizione è 0, la seconda è 1 e così via).
Implementazione
public function get caretIndex():int
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
printCursorPosition
. In quel caso, vengono generati i valori delle proprietà caretIndex
, selectionBeginIndex
e selectionEndIndex
.
Eseguite questo esempio e provate a fare clic all'interno di TextField per selezionare del testo. Quindi, fate clic nel campo senza selezionare il testo. Quando fate clic nel testo senza effettuare una selezione, la proprietà caretIndex
indica dove si trova il punto di registrazione, e le proprietà selectionBeginIndex
e selectionEndIndex
equivalgono al valore della proprietà caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
condenseWhite | proprietà |
condenseWhite:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un valore booleano che specifica se viene rimosso lo spazio vuoto supplementare (spazi, interruzioni di riga, e così via) di un campo di testo HTML. Il valore predefinito è false
. La proprietà condenseWhite
ha effetto solo sul testo impostato con la proprietà htmlText
, non con la proprietà text
. Se il testo viene impostato con la proprietà text
, condenseWhite
viene ignorato.
Se condenseWhite
è impostato su true
, utilizzate comandi HTML standard quali <BR>
e <P>
per inserire le interruzioni di riga nel campo di testo.
Impostate la proprietà condenseWhite
prima della proprietà htmlText
.
Implementazione
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
condenseWhite
su false
e su true
:
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_condenseWhite extends Sprite { public function TextField_condenseWhite() { var tf1:TextField = createCustomTextField(0, 0, 200, 50); tf1.condenseWhite = false; tf1.htmlText = "keep on\n\ttruckin'"; var tf2:TextField = createCustomTextField(0, 120, 200, 50); tf2.condenseWhite = true; tf2.htmlText = "keep on\n\ttruckin'"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; addChild(result); return result; } } }
defaultTextFormat | proprietà |
defaultTextFormat:flash.text:TextFormat
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Specifica il formato applicato al testo appena immesso, ad esempio al testo digitato da un utente o quello immesso mediante il metodo replaceSelectedText()
.
Nota: quando si selezionano i caratteri da sostituire con setSelection()
e replaceSelectedText()
, defaultTextFormat
si applica solo se il testo è stato selezionato fino all'ultimo carattere incluso. Di seguito viene fornito un esempio:
var my_txt:TextField new TextField(); my_txt.text = "Flash Macintosh version"; var my_fmt:TextFormat = new TextFormat(); my_fmt.color = 0xFF0000; my_txt.defaultTextFormat = my_fmt; my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied my_txt.replaceSelectedText("Windows version");
Quando si accede alla proprietà defaultTextFormat
, l'oggetto TextFormat restituito ha tutte le proprietà definite. Nessuna proprietà è null
.
Nota: questa proprietà non può essere impostata se al campo di testo è applicato un foglio di stile.
Implementazione
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
Genera
Error — Questo metodo non può essere utilizzato in un campo di testo con un foglio di stile.
|
Elementi API correlati
displayAsPassword | proprietà |
displayAsPassword:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Specifica se il campo di testo è protetto da password. Se il valore di questa proprietà è true
, il campo di testo è considerato come se fosse protetto da password e nasconde i caratteri immessi visualizzando degli asterischi invece che i caratteri veri e propri. Se invece è false
, il campo di testo non è considerato come protetto da password. Quando è abilitata la modalità di protezione mediante password, i comandi Taglia e Copia e i rispettivi tasti di scelta rapida non funzionano. Questo meccanismo di sicurezza impedisce a un eventuale utente malintenzionato di utilizzare i tasti di scelta rapida per scoprire la password di un computer non sorvegliato.
Il valore predefinito è false.
Implementazione
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
embedFonts | proprietà |
embedFonts:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Specifica se deve essere eseguito il rendering del campo di testo mediante i profili di carattere incorporati. Se è impostato su false
, Flash Player esegue il rendering del campo di testo utilizzando i caratteri dispositivo.
Se si imposta la proprietà embedFonts
su true
per un campo di testo, è necessario specificare un carattere per il testo mediante la proprietà font
di un oggetto TextFormat applicato al campo di testo. Se il carattere specificato non è incorporato nel file SWF, il testo non viene visualizzato.
Il valore predefinito è false.
Implementazione
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
Elementi API correlati
gridFitType | proprietà |
gridFitType:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Il tipo di adattamento alla griglia utilizzato per questo campo di testo. Questa proprietà si applica solo se la proprietà flash.text.AntiAliasType
del campo di testo è impostata su flash.text.AntiAliasType.ADVANCED
.
Il tipo di adattamento alla griglia utilizzato determina se Flash Player forza l'adattamento delle righe orizzontali e verticali spesse a una griglia di pixel o sottopixel.
Per impostare i valori per la proprietà flash.text.GridFitType
, utilizzate i valori stringa seguenti:
Valore stringa | Descrizione |
---|---|
flash.text.GridFitType.NONE | Specifica nessun adattamento alla griglia. Le linee orizzontali e verticali dei glifi non vengono forzate alla griglia di pixel. Si tratta di un'impostazione consigliata per le animazioni o i caratteri con dimensioni elevate. |
flash.text.GridFitType.PIXEL | Specifica che le linee orizzontali e verticali spesse vengono adattate alla griglia di pixel. Questa impostazione funziona solo per i campi di testo allineati a sinistra. Per usare questa impostazione, la proprietà flash.display.AntiAliasType del campo di testo deve essere impostata su flash.text.AntiAliasType.ADVANCED . Di solito, fornisce il livello migliore di leggibilità per il testo allineato a sinistra. |
flash.text.GridFitType.SUBPIXEL | Specifica che le linee orizzontali e verticali spesse vengono adattate alla griglia di sottopixel su un monitor LCD. Per usare questa impostazione, la proprietà flash.text.AntiAliasType del campo di testo deve essere impostata su flash.text.AntiAliasType.ADVANCED . L'impostazione flash.text.GridFitType.SUBPIXEL è spesso indicata per il testo dinamico allineato a destra o al centro, e talvolta rappresenta un utile compromesso in termini di qualità tra l'animazione e il testo. |
Il valore predefinito è pixel.
Implementazione
public function get gridFitType():String
public function set gridFitType(value:String):void
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
gridFitType
. Quando usate questo esempio, osservate la differenza di leggibilità per le prime due righe. Potete inoltre notare l'ottimo uso di GridFitType.PIXEL
per il testo allineato a sinistra e GridFitType.SUBPIXEL
per il testo allineato a destra.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; public class gridFitTypeExample extends Sprite { public function gridFitTypeExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=12; var tf1:TextField = createCustomTextField(0,0,format1,"NONE",TextFieldAutoSize.LEFT,GridFitType.NONE); var tf2:TextField = createCustomTextField(0,30,format1,"PIXEL",TextFieldAutoSize.LEFT,GridFitType.PIXEL); var tf3:TextField = createCustomTextField(300,60,format1,"SUBPIXEL",TextFieldAutoSize.RIGHT,GridFitType.SUBPIXEL); } private function createCustomTextField(x:Number,y:Number,fm:TextFormat,tl:String,tfs:String,gft:String):TextField { var result:TextField = new TextField(); result.x=x; result.y=y; result.embedFonts=true; result.antiAliasType=AntiAliasType.ADVANCED; result.text="This text uses a gridFitType of " + tl; result.autoSize=tfs; result.gridFitType=gft; result.setTextFormat(fm); addChild(result); return result; } } }
htmlText | proprietà |
htmlText:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Contiene la rappresentazione HTML dei contenuti dei campi di testo.
Flash Player supporta i tag HTML seguenti:
Flash Player e AIR supportano le seguenti entità HTML:
Entità | Descrizione |
---|---|
< | < (minore di) |
> | > (maggiore di) |
& | & (e commerciale) |
" | " (virgolette doppie) |
' | ' (apostrofo, virgolette singole) |
Flash e AIR supportano inoltre codici di caratteri espliciti, quali & (e commerciale ASCII) e € (simbolo € Unicode).
Implementazione
public function get htmlText():String
public function set htmlText(value:String):void
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
tf1
e viene assegnata una stringa di testo in formato HTML alla proprietà text
del campo creato. Quando viene tracciata la proprietà htmlText
del campo, l'output è la stringa in formato HTML e Flash Player aggiunge automaticamente dei tag aggiuntivi, quali <P> e <FONT>. Quando viene tracciato il valore della proprietà text
, viene visualizzata la stringa non formattata e priva dei tag HTML.
Per fare un confronto, le stesse operazioni vengono eseguite su un altro oggetto TextField denominato tf2
, con l'aggiunta di un oggetto StyleSheet che viene assegnato alla proprietà styleSheet
di tf2
prima che venga impostata la sua proprietà htmlText
. In quel caso, quando la proprietà htmlText
viene tracciata, include solo il testo HTML esatto che era stato originariamente assegnato alla proprietà htmlText
, a prova del fatto che Flash Player non ha aggiunto altri tag
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
length | proprietà |
maxChars | proprietà |
maxChars:int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Il numero massimo di caratteri immessi da un utente, che il campo di testo può contenere. Uno script può inserire testi di lunghezza maggiore di quella consentita dalla proprietà maxChars
, che indica solo la lunghezza massima del testo che può essere immesso da un utente. Se il valore di questa proprietà è
0
, non vi sono limitazioni al testo che l'utente può immettere.
Il valore predefinito è 0.
Implementazione
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | proprietà |
maxScrollV | proprietà |
mouseWheelEnabled | proprietà |
mouseWheelEnabled:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Un valore booleano che indica se Flash Player scorre automaticamente i campi di testo multiriga quando l'utente fa clic su un campo di testo e utilizza la rotella del mouse. Per impostazione predefinita, questo valore corrisponde a true
. Questa proprietà è utile se desiderate impedire che la rotella del mouse effettui lo scorrimento dei campi di testo o se si desidera implementare uno scorrimento personalizzato per i campi di testo.
Implementazione
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | proprietà |
multiline:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica se il campo è un campo di testo multiriga. Se questo valore è true
, il campo di testo è composto da più righe; se è false
, il campo di testo è costituito da una sola riga di testo. In un campo di tipo TextFieldType.INPUT
, il valore multiline
determina se il tasto Invio
crea una nuova riga (con una valore false
, il tasto Invio
viene ignorato). Se si incolla del testo in TextField
con un valore multiline
impostato su false
, i caratteri newline vengono rimossi dal testo.
Il valore predefinito è false.
Implementazione
public function get multiline():Boolean
public function set multiline(value:Boolean):void
Elementi API correlati
numLines | proprietà |
numLines:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Definisce il numero delle righe di testo in un campo di testo multiriga. Se la proprietà wordWrap
è impostata su true
, il numero di righe aumenta quando il testo va a capo.
Implementazione
public function get numLines():int
Elementi API correlati
restrict | proprietà |
restrict:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica il set di caratteri che l'utente può immettere in un campo di testo. Se il valore della proprietà restrict
è null
, è possibile immettere qualsiasi carattere. Se il valore della proprietà restrict
è una stringa vuota, non è possibile immettere alcun carattere. Se il valore della proprietà restrict
è una stringa di caratteri, è possibile immettere nel campo di testo soltanto i caratteri presenti nella stringa. La scansione della stringa viene eseguita da sinistra a destra. È possibile specificare un intervallo di caratteri utilizzando un carattere trattino (-). Soltanto le interazioni dell'utente sono limitate; uno script può invece immettere qualsiasi testo nel campo di testo. Tale proprietà non è sincronizzabile con le opzioni carattere Incorpora della finestra di ispezione Proprietà.
Se la stringa comincia con il simbolo ^, vengono accettati tutti i caratteri a eccezione di quelli che seguono questo valore nella stringa. Se la stringa non comincia con (^), non viene accettato alcun carattere ad eccezione di quelli indicati nella stringa.
Nell'esempio seguente è consentita l'immissione solo di caratteri in lettere maiuscole, spazi e numeri in un campo di testo:
my_txt.restrict = "A-Z 0-9";
Nell'esempio seguente sono inclusi tutti i caratteri, eccetto le lettere minuscole:
my_txt.restrict = "^a-z";
È possibile utilizzare una barra rovesciata per immettere ^ o - così come è scritto. Le sequenze di barre rovesciate che vengono accettate sono \-, \^ o \\. La barra rovesciata deve essere un carattere effettivo nella stringa, quindi quando viene utilizzata nel codice ActionScript, è necessario specificare una doppia barra rovesciata. Ad esempio, il codice seguente include solo il trattino (-) e l'accento circonflesso (^):
my_txt.restrict = "\\-\\^";
Il carattere ^ può essere utilizzato in qualsiasi punto della stringa per passare alternativamente dall'inclusione all'esclusione di caratteri. Nell'esempio seguente sono inclusi solo i caratteri in lettere maiuscole, esclusa la lettera maiuscola Q:
my_txt.restrict = "A-Z^Q";
È possibile utilizzare la sequenza di escape \u
per creare stringhe restrict
. Il codice seguente include solo i caratteri da ASCII 32 (spazio) ad ASCII 126 (tilde).
my_txt.restrict = "\u0020-\u007E";
Il valore predefinito è null.
Implementazione
public function get restrict():String
public function set restrict(value:String):void
scrollH | proprietà |
scrollH:int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La posizione di scorrimento orizzontale corrente. Se la proprietà scrollH
è impostata su 0, non è possibile scorrere in orizzontale il testo. Il valore di questa proprietà è un numero intero che rappresenta la posizione orizzontale in pixel.
Le unità dello scorrimento orizzontale sono i pixel, mentre quelle dello scorrimento verticale sono le righe. Lo scorrimento orizzontale viene misurato in pixel poiché la maggior parte dei caratteri più diffusi ha una spaziatura proporzionale, ovvero i singoli caratteri possono avere larghezze diverse. Flash effettua lo scorrimento verticale in base alle righe per consentire agli utenti di visualizzare una riga di testo integralmente. Anche se in una riga sono presenti caratteri diversi, l'altezza della riga viene adattata al carattere più grande.
Nota: la proprietà scrollH
è a base zero e non a base 1 come la proprietà dello scorrimento verticale scrollV
.
Implementazione
public function get scrollH():int
public function set scrollH(value:int):void
Elementi API correlati
scrollV | proprietà |
scrollV:int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La posizione verticale del testo in un campo. La proprietà scrollV
è utile per indirizzare gli utenti verso un paragrafo specifico all'interno di un brano lungo o per creare campi di testo a scorrimento.
Le unità dello scorrimento verticale sono le righe, mentre quelle dello scorrimento orizzontale sono i pixel. Se la prima riga visualizzata è la prima riga del campo di testo, scrollV è impostato su 1 (non su 0). Lo scorrimento orizzontale viene misurato in pixel poiché la maggior parte dei caratteri ha una spaziatura proporzionale, ovvero i singoli caratteri possono avere larghezze diverse. Flash effettua lo scorrimento verticale in base alle righe per consentire agli utenti di visualizzare una riga di testo integralmente. Anche se in una riga sono presenti caratteri diversi, l'altezza della riga viene adattata al carattere più grande.
Implementazione
public function get scrollV():int
public function set scrollV(value:int):void
Elementi API correlati
selectable | proprietà |
selectable:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un valore booleano che indica se il campo di testo è selezionabile. Il valore true
indica che il testo è selezionabile. La proprietà selectable
controlla se un campo di testo è selezionabile, non se è modificabile. Ad esempio, un campo di testo dinamico può essere selezionabile anche se non è modificabile. Se un campo di testo dinamico non è selezionabile, non è possibile selezionarne il testo.
Se selectable
è impostata su false
, il testo del campo di testo non risponde ai comandi di selezione del mouse o della tastiera e il testo non può essere copiato mediante il comando Copia. Se selectable
è impostata su true
, il testo del campo di testo può essere selezionato mediante il mouse o la tastiera e copiato mediante il comando Copia. In tal modo potete selezionare il testo anche se il campo di testo è dinamico e non di input.
Il valore predefinito è true.
Implementazione
public function get selectable():Boolean
public function set selectable(value:Boolean):void
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
selectable
impostata su true
e l'altro con la proprietà selectable
impostata su false
. Quando usate questo esempio, provate a selezionare il testo in questi campi con il mouse o la tastiera.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class selectableExample extends Sprite { public function selectableExample() { var tf1:TextField = createCustomTextField(10, 10); tf1.text="This text can be selected"; tf1.selectable=true; var tf2:TextField = createCustomTextField(10, 30); tf2.text="This text cannot be selected"; tf2.selectable=false; } private function createCustomTextField(x:Number, y:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.autoSize=TextFieldAutoSize.LEFT; addChild(result); return result; } } }
selectionBeginIndex | proprietà |
selectionBeginIndex:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Il valore dell'indice a base zero del primo carattere nella selezione corrente. (Ad esempio, il primo carattere è 0, il secondo è 1, e così via.) Questa proprietà è il valore di caretIndex
se nessuna parte di testo viene selezionata.
Implementazione
public function get selectionBeginIndex():int
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
printCursorPosition
. In quel caso, vengono generati i valori delle proprietà caretIndex
, selectionBeginIndex
e selectionEndIndex
.
Eseguite questo esempio e provate a fare clic all'interno di TextField per selezionare del testo. Quindi, fate clic nel campo senza selezionare il testo. Quando fate clic nel testo senza effettuare una selezione, la proprietà caretIndex
indica dove si trova il punto di registrazione, e le proprietà selectionBeginIndex
e selectionEndIndex
equivalgono al valore della proprietà caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
selectionEndIndex | proprietà |
selectionEndIndex:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Il valore dell'indice a base zero dell'ultimo carattere nella selezione corrente. (Ad esempio, il primo carattere è 0, il secondo è 1, e così via.) Questa proprietà è il valore di caretIndex
se nessuna parte di testo viene selezionata.
Implementazione
public function get selectionEndIndex():int
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
printCursorPosition
. In quel caso, vengono generati i valori delle proprietà caretIndex
, selectionBeginIndex
e selectionEndIndex
.
Eseguite questo esempio e provate a fare clic all'interno di TextField per selezionare del testo. Quindi, fate clic nel campo senza selezionare il testo. Quando fate clic nel testo senza effettuare una selezione, la proprietà caretIndex
indica dove si trova il punto di registrazione, e le proprietà selectionBeginIndex
e selectionEndIndex
equivalgono al valore della proprietà caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
sharpness | proprietà |
sharpness:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
La precisione dei bordi del glifo in questo campo di testo. Questa proprietà si applica solo se la proprietà flash.text.AntiAliasType
del campo di testo è impostata su flash.text.AntiAliasType.ADVANCED
. L'intervallo valido per sharpness
è un numero compreso tra -400 e 400. Se tentate di impostare sharpness
su un valore non compreso nell'intervallo, Flash utilizza il valore più vicino presente nell'intervallo (-400 o 400).
Il valore predefinito è 0.
Implementazione
public function get sharpness():Number
public function set sharpness(value:Number):void
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
sharpness
per un oggetto TextField. Dovete incorporare il carattere e impostare la proprietà antiAliasType
su ADVANCED
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class sharpnessExample extends Sprite { public function sharpnessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-400); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,400); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldSharpness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.sharpness=fldSharpness; result..setTextFormat(format); addChild(result); return result; } } }
styleSheet | proprietà |
styleSheet:StyleSheet
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Associa un foglio di stile al campo di testo. Per informazioni sulla creazione di fogli di stile, vedete la classe StyleSheet e la Guida per gli sviluppatori di ActionScript 3.0.
Il foglio di stile associato a un campo di testo può essere modificato in qualsiasi momento. Se il foglio di stile in uso viene modificato, il campo di testo viene ridisegnato utilizzando il nuovo foglio di stile. Per rimuovere il foglio di stile, impostatelo su null
o undefined
. Se il foglio di stile in uso viene rimosso, il campo di testo viene ridisegnato senza foglio di stile.
Nota: se il foglio di stile viene rimosso, il contenuto di TextField.text
e TextField.htmlText
cambia in modo da incorporare la formattazione precedentemente applicata al foglio di stile. Per conservare il contenuto TextField.htmlText
originale senza la formattazione, salvate il valore in una variabile prima di rimuovere il foglio di stile.
Implementazione
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
stylesheet
prima di impostare il contenuto.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.StyleSheet; public class TextStylesheetExample extends Sprite { var myLabel:TextField = new TextField(); var labelText:String = "Hello world."; var newStyle:StyleSheet = new StyleSheet(); public function TextStylesheetExample() { var styleObj:Object = new Object(); styleObj.fontWeight = "bold"; styleObj.color = "#660066"; newStyle.setStyle(".defStyle", styleObj); myLabel.styleSheet=newStyle; myLabel.htmlText=labelText; addChild(myLabel); } } }
text | proprietà |
text:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Una stringa che rappresenta il testo corrente nel campo di testo. Le righe sono separate dal carattere di ritorno a capo ('\r'
, ASCII 13). Questa proprietà contiene testo non formattato nel campo di testo, senza tag HTML.
Per ottenere il testo in formato HTML, utilizzate la proprietà htmlText
.
Nota: se viene applicato un foglio di stile al campo di testo, il contenuto della proprietà text
sarà interpretato come HTML.
Implementazione
public function get text():String
public function set text(value:String):void
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
tf1
e viene assegnata una stringa di testo in formato HTML alla proprietà text
del campo creato. Quando viene tracciata la proprietà htmlText
del campo, l'output è la stringa in formato HTML e Flash Player aggiunge automaticamente dei tag aggiuntivi, quali <P> e <FONT>. Quando viene tracciato il valore della proprietà text
, viene visualizzata la stringa non formattata e priva dei tag HTML.
Per fare un confronto, le stesse operazioni vengono eseguite su un altro oggetto TextField denominato tf2
, con l'aggiunta di un oggetto StyleSheet che viene assegnato alla proprietà styleSheet
di tf2
prima che venga impostata la sua proprietà htmlText
. In quel caso, quando la proprietà htmlText
viene tracciata, include solo il testo HTML esatto che era stato originariamente assegnato alla proprietà htmlText
, a prova del fatto che Flash Player non ha aggiunto altri tag
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textColor | proprietà |
textColor:uint
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Il colore del testo nel campo di testo, in formato esadecimale. Il sistema dei colori esadecimali utilizza sei cifre per rappresentare i valori dei colori. Ogni cifra ha sedici possibili valori o caratteri. I caratteri vanno da 0 a 9 e da A a F. Il nero, ad esempio, è rappresentato da 0x000000
; il bianco da 0xFFFFFF
.
Il valore predefinito è 0 (0x000000).
Implementazione
public function get textColor():uint
public function set textColor(value:uint):void
Esempio ( Come utilizzare questo esempio )
textColor
in red (0xFF0000
).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textColor extends Sprite { public function TextField_textColor() { var tf:TextField = createCustomTextField(10, 10, 100, 300); tf.text = "This will be red text"; tf.textColor = 0xFF0000; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textHeight | proprietà |
textHeight:Number
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
L'altezza del testo espressa in pixel.
Implementazione
public function get textHeight():Number
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
trace
visualizzano i valori delle proprietà textWidth
e textHeight
. Per consentire un confronto, sono visualizzate anche le proprietà width
e height
. Potete notare che i valori di textHeight
e textWidth
possono variare a seconda del carattere utilizzato nel computer.
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
textInteractionMode | proprietà |
textInteractionMode:String
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 11, Flash Lite 4 |
La proprietà modalità di interazione. Il valore predefinito è TextInteractionMode.NORMAL. Sulle piattaforme mobili, la modalità normale implica la possibilità di far scorrere il testo ma non di selezionarlo. È possibile passare alla modalità selezionabile tramite il menu contestuale incorporato nel campo di testo. Sul desktop, la modalità normale implica la possibilità sia di far scorrere il testo che di selezionarlo.
Implementazione
public function get textInteractionMode():String
textWidth | proprietà |
textWidth:Number
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La larghezza del testo espressa in pixel.
Implementazione
public function get textWidth():Number
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
trace
visualizzano i valori delle proprietà textWidth
e textHeight
. Per consentire un confronto, sono visualizzate anche le proprietà width
e height
. Potete notare che i valori di textHeight
e textWidth
possono variare a seconda del carattere utilizzato nel computer.
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
thickness | proprietà |
thickness:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Lo spessore dei bordi del glifo in questo campo di testo. Questa proprietà funziona solo quando flash.text.AntiAliasType
è impostato su flash.text.AntiAliasType.ADVANCED
.
L'intervallo valido per thickness
è un numero compreso tra -200 e 200. Se tentate di impostare thickness
su un valore non compreso nell'intervallo, la proprietà viene impostata sul valore più vicino presente nell'intervallo (-200 o 200).
Il valore predefinito è 0.
Implementazione
public function get thickness():Number
public function set thickness(value:Number):void
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
thickness
per un oggetto TextField. Dovete incorporare il carattere e impostare la proprietà antiAliasType
su ADVANCED
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class thicknessExample extends Sprite { public function thicknessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-200); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,200); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldThickness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.thickness=fldThickness; result.setTextFormat(format); addChild(result); return result; } } }
type | proprietà |
type:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Il tipo di campo di testo. Una delle due costanti TextFieldType seguenti: TextFieldType.DYNAMIC
, che indica un campo di testo dinamico non modificabile dall'utente, o TextFieldType.INPUT
, che specifica un campo di testo di input modificabile dall'utente.
Il valore predefinito è dynamic.
Implementazione
public function get type():String
public function set type(value:String):void
Genera
ArgumentError — Il tipo (type ) specificato non è un membro di flash.text.TextFieldType.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
tfDynamic
e tfInput
. In entrambi viene immesso del testo. Tuttavia, tfDynamic
ha la proprietà type
impostata su TextFieldType.DYNAMIC
, mentre tfInput
ha la proprietà type
impostata su TextFieldType.INPUT
, quindi l'utente può modificare il testo in tfInput
ma può solo visualizzare il testo in tfDynamic
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_type extends Sprite { public function TextField_type() { var tfDynamic:TextField = createCustomTextField(10, 10, 100, 20); tfDynamic.type = TextFieldType.DYNAMIC; tfDynamic.text = "hello"; var tfInput:TextField = createCustomTextField(10, 45, 100, 20); tfInput.type = TextFieldType.INPUT; tfInput.text = "world"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
useRichTextClipboard | proprietà |
useRichTextClipboard:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Specifica se copiare e incollare la formattazione assieme al testo. Quando è impostata su true
, Flash Player copia e incolla da un campo di testo all'altro anche la formattazione (allineamento, grassetto e corsivo). I campi di testo di origine e di destinazione dell'operazione di copia e incolla devono avere la proprietà useRichTextClipboard
impostata su true
. Il valore predefinito è false
.
Implementazione
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
Esempio ( Come utilizzare questo esempio )
tf1
) e due campi di testo dinamici (tf2
e tf3
). Il codice assegna a ogni campo di testo dinamico un oggetto TextFormat (carattere Courier grassetto). Per il campo di testo tf2
la proprietà useRichTextClipboard
è impostata su false
. Per il campo di testo tf3
la proprietà useRichTextClipboard
è impostata su true
. Quando copiate il testo dal campo di testo tf2
e lo incollate nel campo di testo tf1
, il testo incollato non include la formattazione. Quando copiate il testo dal campo di testo tf3
(la cui proprietà useRichTextClipboard
è impostata su true
) e lo incollate nel campo di testo tf1
, il testo incollato include la formattazione.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; public class useRichTextClipboard extends Sprite { public function useRichTextClipboard() { var format1:TextFormat = new TextFormat(); format1.font="Courier"; format1.bold=true; var tf1:TextField = createCustomTextField(10, 10, 200, 20); tf1.type=TextFieldType.INPUT; tf1.useRichTextClipboard=true; var tf2:TextField = createCustomTextField(220, 10, 200, 20); tf2.text="1.Text loses format"; tf2.setTextFormat(format1); tf2.useRichTextClipboard=false; var tf3:TextField = createCustomTextField(220, 50, 200, 20); tf3.text="2.Text includes format"; tf3.setTextFormat(format1); tf3.useRichTextClipboard=true; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
wordWrap | proprietà |
wordWrap:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un valore booleano che indica se per il campo di testo è abilitato il ritorno a capo automatico. Se il valore di wordWrap
è true
, il campo di testo ha il ritorno a capo; se è false
, il campo di testo non ha il ritorno a capo. Il valore predefinito è false
.
Implementazione
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
Esempio ( Come utilizzare questo esempio )
wordWrap
su true
oppure su false
. Vengono create due istanze TextField con contenuti troppo estesi per la loro larghezza. La proprietà wordWrap
della prima istanza (denominata tfWrap
) viene impostata su true
, mentre viene impostata su false
per la seconda istanza (tfNoWrap
).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_wordWrap extends Sprite { public function TextField_wordWrap() { var tfWrap:TextField = createCustomTextField(10, 10, 100, 100); tfWrap.wordWrap = true; tfWrap.text = "(wordWrap = true):\nThis is very long text that will certainly extend beyond the width of this text field"; var tfNoWrap:TextField = createCustomTextField(10, 150, 100, 100); tfNoWrap.wordWrap = false; tfNoWrap.text = "(wordWrap = false):\nThis is very long text that will certainly extend beyond the width of this text field"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
TextField | () | Funzione di costruzione |
public function TextField()
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea una nuova istanza TextField. Dopo che è stata creata l'istanza TextField, chiamare il metodo addChild()
o il metodo addChildAt()
dell'oggetto DisplayObjectContainer principale per aggiungere l'istanza TextField all'elenco di visualizzazione.
Le dimensioni predefinite di un campo di testo sono di 100 x 100 pixel.
Esempio ( Come utilizzare questo esempio )
var theTextField:TextField = new TextField(); theTextField.type = TextFieldType.INPUT; theTextField.border = true; theTextField.x = 10; theTextField.y = 10; theTextField.multiline = true; theTextField.wordWrap = true; addChild(theTextField);
appendText | () | metodo |
public function appendText(newText:String):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Aggiunge la stringa specificata dal parametro newText
alla fine del testo del relativo campo. Questo metodo è più efficiente rispetto a un'assegnazione addizione (+=
) applicata a una proprietà text
(ad esempio someTextField.text += moreText
), in particolare nel caso di un campo di testo con una quantità di contenuto significativa.
Parametri
newText:String — La stringa da aggiungere al testo esistente.
|
Esempio ( Come utilizzare questo esempio )
Il campo di testo outputText
viene impostato automaticamente in modo da ridimensionarsi a seconda del testo e di effettuare l'allineamento a sinistra tramite la proprietà autoSize
. La proprietà outputText.text
scrive la prima linea del contenuto e il metodo appendText()
allega la restante parte del contenuto (non è necessario cominciare con la proprietà text
; il metodo appendText()
può essere utilizzato anche per allegare testo dall'esterno). Se impostate la proprietà text
una seconda volta il testo originale verrà sovrascritto. Utilizzate l'operatore +=
per allegare del contenuto assieme alla proprietà text
.
La dichiarazione if
controlla se la data odierna è sabato (6) o domenica (0). In caso contrario il metodo toLocaleTimeString()
restituisce l'ora locale che viene allegata al contenuto del campo di testo.
La proprietà length
del campo di testo viene utilizzata per leggere il numero di caratteri fino al momento in cui la funzione viene chiamata mentre la proprietà numLines
viene utilizzata per contare il numero di linee nel campo di testo. Notate che il numero di linee comprende anche le linee vuote e che la lunghezza del contenuto comprende anche i caratteri corrispondenti agli spazi vuoti e alle interruzioni di linea (\n).
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_appendTextExample extends Sprite { public function TextField_appendTextExample() { var outputText:TextField = new TextField(); var today:Date = new Date(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.text = "WHAT TIME IS IT?" + "\n\n"; if((today.day == 0) || (today.day == 6)) { outputText.appendText("It's the weekend."); outputText.appendText("\n\n"); } else { outputText.appendText("The time is: "); outputText.appendText(today.toLocaleTimeString() + ".\n\n"); } outputText.appendText("Number of characters including line breaks and spaces so far: "); outputText.appendText(outputText.length.toString() + "\n"); outputText.appendText("Number of lines in the outputText: "); outputText.appendText(outputText.numLines.toString()); this.addChild(outputText); } } }
getCharBoundaries | () | metodo |
public function getCharBoundaries(charIndex:int):Rectangle
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce un rettangolo che rappresenta il riquadro di delimitazione del carattere.
Parametri
charIndex:int — Gli indici a base zero del carattere (ad esempio, la prima posizione è 0, la seconda è 1, e così via).
|
Rectangle — Un rettangolo con i valori x e y massimi e minimi che definiscono il riquadro di delimitazione del carattere.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
getCharBoundaries()
viene utilizzato per evidenziare un carattere selezionato dall'utente.
La classe definisce l'oggetto spotlight
Shape che verrà utilizzato per tracciare un rettangolo attorno ad ognuno dei caratteri selezionati. Quando l'utente fa clic sul campo di testo myTextField
viene richiamato il metodo clickHandler()
.
All'interno del metodo clickHandler()
il metodo getCharIndexAtPoint()
ottiene l'indice del carattere tramite le coordinate localX
e localY
del clic del mouse corrispondenti allo Sprite
contenitore. Il metodo getCharIndexAtPoint()
restituisce -1
se il punto (clic del mouse ) non corrisponde ad alcun carattere. Poiché il campo di testo potrebbe essere più ampio del testo, viene effettuato un controllo sul numero intero restituito (index
) così da essere sicuri che l'utente abbia fatto clic su un carattere. Il numero intero index
viene utilizzato anche da getCharBoundaries()
per ottenere un oggetto Rectangle
da sistemare sui limiti esterni del carattere. Il metodo clear()
cancella tutti gli oggetti spotlight
Shape precedentemente visualizzati. Nella posizione in cui si trova il carattere (coordinate del punto di partenza (10, 10)) viene prodotto un nuovo rettangolo le cui dimensioni corrispondono alla larghezza e all'altezza del carattere utilizzando le coordinate x e y del rettangolo frame
restituito. L'oggetto spotlight
viene riempito di colore giallo per evidenziare il carattere; viene anche impostato il valore dell'opacità al 35% così da rendere il carattere visibile. Notate che anche gli spazi vengono considerati caratteri.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; import flash.display.Shape; public class TextField_getCharBoundariesExample extends Sprite { private var myTextField:TextField = new TextField(); private var spotlight:Shape = new Shape(); public function TextField_getCharBoundariesExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.selectable = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "Selected a character from this text by clicking on it." myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(spotlight); } private function clickHandler (e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { var frame:Rectangle = myTextField.getCharBoundaries(index); spotlight.graphics.clear(); spotlight.graphics.beginFill(0xFFFF00, .35); spotlight.graphics.drawRect((frame.x + 10), (frame.y + 10), frame.width, frame.height); spotlight.graphics.endFill(); } } } }
getCharIndexAtPoint | () | metodo |
public function getCharIndexAtPoint(x:Number, y:Number):int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce il valore dell'indice a base zero del carattere nel punto specificato dai parametri x
e y
.
Parametri
x:Number — La coordinata x del carattere.
| |
y:Number — La coordinata y del carattere.
|
int — Gli indici a base zero del carattere (ad esempio, la prima posizione è 0, la seconda è 1, e così via). Restituisce -1 se il punto non si trova sopra ad alcun carattere.
|
Esempio ( Come utilizzare questo esempio )
Il primo campo di testo contiene il testo che l'utente deve selezionare. Per far sì che sul testo venga fatto clic ma non effettuata la selezione, la proprietà selectable
viene impostata su false. Quando l'utente fa clic sul campo di testo firstTextField
viene richiamato il metodo clickHandler()
.
All'interno del metodo clickHandler()
il metodo getCharIndexAtPoint()
ottiene l'indice del carattere tramite le coordinate localX
e localY
del clic del mouse. Poiché il campo di testo potrebbe essere più ampio del testo, viene effettuato un controllo sul numero intero restituito (index
) così da essere sicuri che l'utente abbia fatto clic su un carattere (il metodo getCharIndexAtPoint()
restituisce -1
se il punto (clic del mouse ) non corrisponde ad alcun carattere). Le coordinate del mouse vengono utilizzate per impostare le coordinate del nuovo campo di testo nel punto in cui il carattere copiato dovrà apparire. Il colore del carattere nel secondo campo di testo viene impostato su rosso. Infine viene impostato il testo nel secondo campo in modo da corrispondere al carattere selezionato che viene recuperato per mezzo del metodo charAt()
. Notate che utilizzando la proprietà text
al posto del metodo appendText()
il carattere recuperato andrà a sostituire il testo presente nel secondo campo di testo invece di aggiungersi allo stesso.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; public class TextField_getCharIndexAtPointExample extends Sprite { private var firstTextField:TextField = new TextField(); private var secondTextField:TextField = new TextField(); public function TextField_getCharIndexAtPointExample() { firstTextField.x = 100; firstTextField.y = 100; firstTextField.width = 260; firstTextField.height = 20; firstTextField.border = true; firstTextField.background = true; firstTextField.selectable = false; firstTextField.text = "Selected a character from this text by clicking on it." firstTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(firstTextField); this.addChild(secondTextField); } private function clickHandler (e:MouseEvent):void { var index:int = firstTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { secondTextField.x = mouseX; secondTextField.y = 70; secondTextField.border = true; secondTextField.selectable = false; secondTextField.background = true; secondTextField.textColor = 0xFF0000; secondTextField.autoSize = TextFieldAutoSize.LEFT; secondTextField.text = firstTextField.text.charAt(index); } } } }
getFirstCharInParagraph | () | metodo |
public function getFirstCharInParagraph(charIndex:int):int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dato un indice di carattere, restituisce l'indice del primo carattere nello stesso paragrafo.
Parametri
charIndex:int — Gli indici a base zero del carattere (ad esempio, il primo carattere è 0, il secondo è 1, e così via).
|
int — Il valore dell'indice a base zero del primo carattere nello stesso paragrafo.
|
Genera
RangeError — L'indice del carattere specificato non rientra nell'intervallo.
|
Esempio ( Come utilizzare questo esempio )
Nella funzione di costruzione, il campo di testo myTextField
viene impostato per l'a capo automatico. Il metodo getTextFormat
restituisce il formato originale del primo carattere del contenuto del campo di testo situato nell'oggetto TextFormat originalFormat
. Viene definito inoltre un nuovo oggetto TextFormat (newFormat
) la cui proprietà align
viene impostata sull'allineamento a destra. Quando l'utente fa clic sul campo di testo, viene richiamato il metodo clickHandler()
.
All'interno del metodo clickHandler()
il metodo getCharIndexAtPoint()
ottiene l'indice del carattere tramite le coordinate localX
e localY
del clic del mouse. La prima dichiarazione if
controlla se l'utente ha fatto clic su un carattere. Utilizzando il numero intero clickIndex
restituito dal metodo getCharIndexAtPoint()
, il metodo getFirstCharInParagraph()
restituisce l'indice del primo carattere nel paragrafo su cui l'utente ha fatto clic. L'indice dell'ultimo carattere nel paragrafo viene determinato aggiungendo la lunghezza del paragrafo (tramite il metodo getParagraphLength()
) all'indice del primo carattere nel paragrafo, meno l'ultimo carattere (corrispondente a \n
). La seconda dichiarazione if
controlla il formato del primo carattere nel paragrafo. Se il valore del suo allineamento corrisponde al formato originale (allineamento a sinistra), il nuovo formato viene applicato a tutti i caratteri del paragrafo. In caso contrario il formato del paragrafo viene riportato al suo stato originario. L'allineamento, insieme al rientro di prima riga, al punto di elenco, alla tabulazione, ai margini destro e sinistro sono formati propri dei paragrafi. Notate che quando si utilizza l'a capo automatico o l'interruzione di linea, la formattazione verrà applicata solo alla prima linea del paragrafo a meno che l'argomento endIndex
del metodo setTextFormat()
non sia stato definito.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFormatAlign; public class TextField_getFirstCharInParagraphExample extends Sprite { private var myTextField:TextField = new TextField(); private var originalFormat:TextFormat = new TextFormat(); private var newFormat:TextFormat = new TextFormat(); public function TextField_getFirstCharInParagraphExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 300; myTextField.background = true; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime.\n\n"); originalFormat = myTextField.getTextFormat(0); newFormat.align = TextFormatAlign.RIGHT; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var clickIndex:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(clickIndex != -1) { var paragraphFirstIndex:int = myTextField.getFirstCharInParagraph(clickIndex); var paragraphEndIndex:int = paragraphFirstIndex + ((myTextField.getParagraphLength(clickIndex) - 1)); if (myTextField.getTextFormat(paragraphFirstIndex).align == originalFormat.align) { myTextField.setTextFormat(newFormat, paragraphFirstIndex, paragraphEndIndex); }else { myTextField.setTextFormat(originalFormat, paragraphFirstIndex, paragraphEndIndex); } } } } }
getImageReference | () | metodo |
public function getImageReference(id:String):DisplayObject
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce un riferimento DisplayObject per l'id
dato, relativo a un'immagine o a un file SWF che è stato aggiunto a un campo di testo con formattazione HTML mediante un tag <img>
. Il tag <img>
è nel seguente formato:
<img src = 'filename.jpg' id = 'instanceName' >
Parametri
id:String — L'id a cui far corrispondere l'attributo id del tag <img> .
|
DisplayObject — L'oggetto di visualizzazione corrispondente all'immagine o al file SWF con l'attributo corrispondente id nel tag <img> del campo di testo. Per il contenuto multimediale caricato da una fonte esterna, questo oggetto è un oggetto Loader e, una volta caricato, l'oggetto multimediale è un elemento secondario di quell'oggetto Loader. Per i contenuti multimediali incorporati nel file SWF, è l'oggetto caricato. Se non esiste un tag <img> con id corrispondente, il metodo restituisce null .
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
L'immagine (image.jpg
) è viene allegata tramite HTML. Si presume che nella stessa directory del file SWF si trovi un file immagine. È necessario definire un attributo id
per il tag img
in modo da poter accedere all'immagine attraverso il metodo getImageReference()
. Per includere il contenuto di stringhe formattate in HTML si utilizza la proprietà htmlText
. Quando l'utente fa clic sul campo di testo myTextField
viene richiamato il metodo clickHandler()
.
All'interno del metodo clickHandler()
, il metodo getImageReference()
restituisce un riferimento all'immagine come DisplayObject
. Tale riferimento può essere utilizzato per manipolare l'immagine come qualsiasi altro oggetto DisplayObject
. In questo caso vengono impostate le proprietà alpha
(per l'opacità) e rotation
(per la rotazione). Per accedere alla matrice dell'oggetto visualizzato, trasformate il colore e i contorni dei pixel, si può utilizzare la proprietà transform
. Notate anche che è necessario importare flash.display.DisplayObject
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.Event; import flash.events.MouseEvent; import flash.display.DisplayObject; import flash.text.TextFieldAutoSize; public class TextField_getImageReferenceExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_getImageReferenceExample() { var myText1:String = "<p>Here is an image we want to mainpulate: <img src='image.jpg' id='testimage'></p>"; myTextField.x = 10; myTextField.y = 10; myTextField.width = 250; myTextField.height = 250; myTextField.background = true; myTextField.border = true; myTextField.border = true; myTextField.multiline = true; myTextField.htmlText = myText1; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var imageRef:DisplayObject = myTextField.getImageReference("testimage"); imageRef.rotation += 90; imageRef.x = 125; imageRef.y = 125; imageRef.alpha = 0.25; } } }
getLineIndexAtPoint | () | metodo |
public function getLineIndexAtPoint(x:Number, y:Number):int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce il valore dell'indice a base zero della riga nel punto specificato dai parametri x
e y
.
Parametri
x:Number — La coordinata x della riga.
| |
y:Number — La coordinata y della riga.
|
int — Gli indici a base zero della riga (ad esempio, la prima riga è 0, la seconda è 1, e così via). Restituisce -1 se il punto non si trova sopra alcuna riga.
|
Esempio ( Come utilizzare questo esempio )
Nella funzione di costruzione, per il campo di testo poem
viene scelta l'impostazione senza a capo automatico (perché si tratta di una poesia). Viene utilizzata anche la proprietà autoSize
per impostare il testo in modo che si sistemi automaticamente e si disponga con allineamento a sinistra. Il campo di testo poemCopy
viene situato al di sotto del campo di testo poem
. Quando un utente fa clic su una linea della poesia, viene richiamato il metodo clickHandler()
.
All'interno del metodo clickHandler()
il metodo getLineIndexAtPoint()
restituisce l'indice della linea sulla quale l'utente ha fatto clic tramite le coordinate localX
e localY
del clic del mouse (poiché in questo caso la poesia originale rientra nelle dimensioni del campo di testo, non è necessario il controllo per un errore di intervallo (RangeError
) effettuato dal metodo getCharIndexAtPoint()
). L'indice della linea viene quindi utilizzato per ottenere il contenuto della linea in formato stringa tramite il metodo getLineText()
; tale contenuto viene successivamente allegato al contenuto del campo di testo poemCopy
. L'operazione di copiatura può così essere effettuata indefinitamente, ma da un certo punto in poi il testo finirà al di fuori dell'area visibile del campo di testo poemCopy
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexAtPointExample extends Sprite { private var poem:TextField = new TextField(); private var poemCopy:TextField = new TextField(); public function TextField_getLineIndexAtPointExample() { poem.border = true; poem.autoSize = TextFieldAutoSize.LEFT; poem.x = 10; poem.wordWrap = false; poemCopy.height = 250; poemCopy.width = 270; poemCopy.y = 230; poemCopy.x = 10; poemCopy.background = true; poemCopy.border = true; poemCopy.wordWrap = false; poem.appendText("Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved."); poem.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(poem); this.addChild(poemCopy); } private function clickHandler(e:MouseEvent):void { var index:int = poem.getLineIndexAtPoint(e.localX, e.localY); var s:String; s = poem.getLineText(index); poemCopy.appendText(s + "\n"); } } }
getLineIndexOfChar | () | metodo |
public function getLineIndexOfChar(charIndex:int):int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce il valore dell'indice a base zero della riga contenente il carattere specificato dal parametro charIndex
.
Parametri
charIndex:int — Gli indici a base zero del carattere (ad esempio, il primo carattere è 0, il secondo è 1, e così via).
|
int — Il valore dell'indice a base zero della riga.
|
Genera
RangeError — L'indice del carattere specificato non rientra nell'intervallo.
|
Esempio ( Come utilizzare questo esempio )
getLineIndexOfChar()
restituisce i numeri di linea dei caratteri numero 100 e 500 del campo di testo.
Il campo di testo myTextField
viene definito in modo da andare a capo automaticamente ed essere allineato a sinistra. Il metodo getLineIndexOfChar()
restituisce l'indice della linea per gli indici dei caratteri specificati (100 and 500). Questa informazioni viene quindi allegata di seguito al paragrafo. Notate che poiché l'indice di linea comincia con 0, l'indice (index
) viene incrementato di 1 per ottenere il numero di linea. Inoltre se il display viene ridimensionato il numero di linea potrebbe cambiare; in questo caso tuttavia l'informazione rimarrà invariato perché il metodo viene richiamato una sola volta.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexOfCharExample extends Sprite { public function TextField_getLineIndexOfCharExample() { var myTextField:TextField = new TextField(); myTextField.x = 10; myTextField.y = 10; myTextField.width = 200; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n"); var index:int = myTextField.getLineIndexOfChar(100); myTextField.appendText("100th character is in line: " + (index + 1) + "\n"); index = myTextField.getLineIndexOfChar(500); myTextField.appendText("500th character is in line: " + (index + 1)); this.addChild(myTextField); } } }
getLineLength | () | metodo |
public function getLineLength(lineIndex:int):int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce il numero di caratteri presenti in una riga di testo specifica.
Parametri
lineIndex:int — Il numero della riga per cui è richiesta la lunghezza.
|
int — Il numero di caratteri presenti nella riga.
|
Genera
RangeError — Il numero di riga specificato non rientra nell'intervallo.
|
Esempio ( Come utilizzare questo esempio )
Come dimostrazione il campo di testo myTextField
che visualizza il testo che deve essere contato, viene impostato su INPUT
in modo che l'utente possa modificare le linee esistenti o aggiungervene di nuove. C'è una linea vuota creata utilizzando l'interruzione di linea (\n
) alla fine dell'ultima linea. Il campo di testo countLines
, nel quale viene visualizzato il risultato del conteggio della linea, è inserito al di sotto del campo di testo myTextField
e il testo in esso contenuto non è selezionabile. Quando l'utente fa clic su una linea all'interno del campo di testo myTextField
viene richiamato il metodo clickHandler()
.
All'interno del metodo clickHandler()
il metodo getLineIndexAtPoint()
restituisce l'indice della linea sulla quale l'utente ha fatto clic tramite le coordinate localX
e localY
del clic del mouse. La prima dichiarazione if
controlla se l'utente ha fatto clic su un carattere. In caso affermativo il metodo getLineLength()
che utilizza l'indice della linea, restituisce il numero di caratteri della linea. Notate che le linee vuote comprendono la seconda interruzione di linea (\n
) e il conteggio dei loro caratteri è uguale a 1, mentre la linea successiva all'ultima ha un conteggio di 0. Anche gli spazi vengono contati come un carattere. Gli utenti possono scrivere una nuova linea o modificarne una esistente e ottenere il conteggio dei caratteri facendo clic su di essa. Se si utilizza l'a capo automatico e la schermata viene ridimensionata, l'indice della linea potrebbe cambiare.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.events.Event; import flash.events.MouseEvent; public class TextField_getLineLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countLines:TextField = new TextField(); public function TextField_getLineLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 350; myTextField.height = 150; myTextField.background = true; myTextField.border = true; myTextField.type = TextFieldType.INPUT; myTextField.appendText("Click on the lines to count its number of characters:\n\n"); myTextField.appendText("This is a short line.\n"); myTextField.appendText("This is a longer line than the last line.\n\n"); myTextField.appendText("This one is even longer than the one before. It has two sentences.\n"); this.addChild(myTextField); countLines.border = true; countLines.x = 10; countLines.y = 180; countLines.height = 30; countLines.width = 200; countLines.background = true; countLines.selectable = false; this.addChild(countLines); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getLineIndexAtPoint(e.localX, e.localY); if (index != -1) { var lenght:int = myTextField.getLineLength(index); countLines.text = "Number of characters in the line is: " + lenght.toString(); } } } }
getLineMetrics | () | metodo |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce informazioni sulla metrica relative a una data riga di testo.
Parametri
lineIndex:int — Il numero della riga per cui sono richieste le informazioni sulla metrica.
|
flash.text:TextLineMetrics — Un oggetto TextLineMetrics.
|
Genera
RangeError — Il numero di riga specificato non rientra nell'intervallo.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
Il testo allegato è formato da due righe tratte da Song of Myself di Walt Whitman. Viene utilizzato un nuovo oggetto TextFormat (newFormat
) per impostare il formato della seconda linea. Il formato della prima linea è quello predefinito. Il metodo getLineMetrics()
restituisce un oggetto TextLineMetrics
per una determinata linea. L'indice di linea comincia da 0. Utilizzando gli oggetti metrics1
e metrics2
rispettivamente per le righe 1 e 2, vengono recuperati i valori relativi ad ascendente, discendente, altezza, e spessore della linea. I risultati vengono convertiti in stringhe, ma non arrotondati. Notate che questo valore è relativo alla linea e non a uno specifico carattere. Riflette l'intervallo di caratteri per una linea. Per esempio, se una linea ha dei caratteri con altezze diverse, il valore verrà determinato dal carattere con l'altezza maggiore. Questo significa anche che se viene modificato il formato di uno dei caratteri, anche alcuni valori metrici potrebbero cambiare.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextLineMetrics; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.TextFormat; public class TextField_getLineMetricsExample extends Sprite { public function TextField_getLineMetricsExample() { var myTextField:TextField = new TextField(); var newFormat:TextFormat = new TextFormat(); myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.wordWrap = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("A child said What is the grass? fetching it to me with full hands;\n"); myTextField.appendText("How could I answer the child? I do not know what it is any more than he.\n\n"); newFormat.size = 14; newFormat.font = "Arial"; newFormat.italic = true; myTextField.setTextFormat(newFormat, 67, 139); var metrics1:TextLineMetrics = myTextField.getLineMetrics(0); myTextField.appendText("Metrics ascent for the line 1 is: " + metrics1.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics1.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics1.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics1.width.toString() + "\n\n"); var metrics2:TextLineMetrics = myTextField.getLineMetrics(1); myTextField.appendText("Metrics ascent for the line 2 is: " + metrics2.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics2.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics2.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics2.width.toString() + "\n"); addChild(myTextField); } } }
getLineOffset | () | metodo |
public function getLineOffset(lineIndex:int):int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce l'indice di carattere del primo carattere nella riga specificata dal parametro lineIndex
.
Parametri
lineIndex:int — Gli indici a base zero della riga (ad esempio, la prima riga è 0, la seconda è 1, e così via).
|
int — Il valore dell'indice a base zero del primo carattere nella riga.
|
Genera
RangeError — Il numero di riga specificato non rientra nell'intervallo.
|
Esempio ( Come utilizzare questo esempio )
Il campo di testo myTextField
è impostato sull'a capo automatico. Il campo di testo countField
visualizzerà il primo carattere della linea 4. Quando l'utente fa clic sul campo di testo myTextField
viene richiamato il metodo clickHandler()
.
All'interno del metodo clickHandler()
, il metodo getLineOffset()
restituisce l'indice del primo carattere dell'indice della linea 3 corrispondente alla quarta linea del testo (l'indice della prima linea è 0). Per ottenere il carattere tramite l'indice del primo carattere viene utilizzato il metodo charAt()
. Il contenuto del campo di testo countField
viene aggiornato con questa informazione tramite la proprietà text
del campo di testo countField
. L'uso della proprietà countField.text
implica che a ogni clic il contenuto del campo di testo countField
verrà sovrascritto. Nel caso in cui l'utente ridimensioni il display, al contenuto verrà applicato l'a capo automatico e pertanto il primo carattere della linea 4 potrebbe essere diverso. Facendo nuovamente clic sul campo myTextField
, il contenuto del campo di testo countField
viene aggiornato con il nuovo primo carattere della quarta linea.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getLineOffsetExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getLineOffsetExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 150; myTextField.height = 300; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; countField.height = 20; countField.width = 200; countField.x = 10; countField.y = 320; countField.selectable = false; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var c:String; var index:int; index = myTextField.getLineOffset(3); c = myTextField.text.charAt(index); countField.text = "The first character of line 4 is: " + c; } } }
getLineText | () | metodo |
public function getLineText(lineIndex:int):String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce il testo della riga specificata dal parametro lineIndex
.
Parametri
lineIndex:int — Gli indici a base zero della riga (ad esempio, la prima riga è 0, la seconda è 1, e così via).
|
String — La stringa di testo contenuta nella riga specificata.
|
Genera
RangeError — Il numero di riga specificato non rientra nell'intervallo.
|
Esempio ( Come utilizzare questo esempio )
Il campo di testo poem
viene impostato automaticamente in modo da ridimensionarsi a seconda del testo e di effettuare l'allineamento a sinistra. La proprietà wordWrap
viene impostata su false
in modo che le linee della poesia non vadano a capo automaticamente, anche se, quando si usa la proprietà autoSize
, questo non dovrebbe costituire un problema. Il ciclo for
scorre le linee del sonetto utilizzando la proprietà numLines
del campo di testo. Il metodo getLineText()
restituisce il contenuto della linea come stringa. Notate che la proprietà numLines
restituisce il numero di linee a partire da 1, mentre nel caso del metodo getLineText()
la numerazione comincia da 0. Utilizzando l'espressione regolare (/love/i
), la dichiarazione if
ricerca la parola in lettere minuscole o maiuscole all'interno di ogni sottostringa. Se il pattern viene recuperato il metodo search
restituisce l'indice della sottostringa corrispondente; in caso contrario (se, quindi, non viene trovata alcuna corrispondenza) restituisce -1
. Il numero corrispondente alla linea nel quale è stata trovata l'espressione "love" ((i + 1)
) viene quindi situato nella stringa lineResult
. Il metodo string converte l'argomento numerico ((i + 1)
) in una stringa fintantoché esiste un altro argomento che sia una stringa (" "). I risultati della ricerca comprenderanno le linee in cui sono presenti le parole "loved" o "Love's". Se la stringa "Love was found in lines:" è stata aggiunta prima del ciclo for
anche la parola "Love" presente in questa linea verrà compresa.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.utils.Timer; import flash.events.TimerEvent; public class TextField_getLineTextExample extends Sprite { public function TextField_getLineTextExample() { var poem:TextField = new TextField(); var lineResult:String = ""; var pattern:RegExp = /love/i; poem.x = 10; poem.y = 10; poem.background = true; poem.wordWrap = false; poem.autoSize = TextFieldAutoSize.LEFT; poem.text = "Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved.\n\n"; for (var i:int = 0; i < poem.numLines; i++) { var s:String = poem.getLineText(i); if(s.search(pattern) != -1) { lineResult += (i + 1) + " "; } } poem.appendText("Love was found in lines: " + lineResult); this.addChild(poem); } } }
getParagraphLength | () | metodo |
public function getParagraphLength(charIndex:int):int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dato un indice di carattere, restituisce la lunghezza del paragrafo contenente il carattere dato. La lunghezza è relativa al primo carattere del paragrafo (secondo quanto restituito da getFirstCharInParagraph()
) e non all'indice di carattere passato.
Parametri
charIndex:int — Gli indici a base zero del carattere (ad esempio, il primo carattere è 0, il secondo è 1, e così via).
|
int — Restituisce il numero dei caratteri nel paragrafo.
|
Genera
RangeError — L'indice del carattere specificato non rientra nell'intervallo.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
Il campo di testo myTextField
visualizza i paragrafi selezionati dall'utente. Quando l'utente fa clic sul campo di testo, viene inviato l'evento MouseEvent.CLICK
e viene chiamato il metodo clickHandler()
. La lunghezza del paragrafo e il numero dei caratteri "s" appariranno nel campo di testo countField
situato al di sotto del campo di testo myTextField
.
All'interno del metodo clickHandler()
il metodo getCharIndexAtPoint()
ottiene l'indice del carattere tramite le coordinate localX
e localY
del clic del mouse. La prima dichiarazione if
controlla se l'utente ha fatto clic su un carattere. Il metodo getFirstCharInParagraph()
utilizza questo indice per restituire l'indice del primo carattere dello stesso paragrafo. La lunghezza del paragrafo restituita dal metodo getParagraphLength()
viene utilizzata con l'indice del primo carattere del paragrafo per determinare l'indice relativo alla fine del paragrafo. Un ciclo for
scorre il paragrafo alla ricerca dei caratteri "s".
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getParagraphLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getParagraphLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 280; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField() constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); countField.x = 10; countField.y = 300; countField.height = 50; countField.width = 250; countField.background = true; countField.selectable = false; this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(index != -1) { var beginParag:int = myTextField.getFirstCharInParagraph(index); var paragLength:int = myTextField.getParagraphLength(index); var endParag:int = beginParag + paragLength; var sCount:uint = 0; for (var i:int = beginParag; i <= endParag; i++) { if ((myTextField.text.charAt(i) == "s") || (myTextField.text.charAt(i) == "S")) { sCount++; } countField.text = "Paragraph length is: " + paragLength.toString() + "\n" + "Number of 's' characters in the paragraph: " + sCount.toString(); } } } } }
getTextFormat | () | metodo |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo compreso tra i parametri beginIndex
e endIndex
. Solo le proprietà comuni a tutto il testo specificato vengono impostate nell'oggetto TextFormat risultante. Qualunque proprietà mista (ovvero dotata di valori diversi in diversi punti del testo) ha un valore null
.
Se non vengono specificati i valori di questi parametri, questo metodo viene applicato a tutto il testo presente nel campo di testo.
Nella tabella seguente sono descritti tre possibili utilizzi:
Uso | Descrizione |
---|---|
my_textField.getTextFormat() | Restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo presente nel campo di testo. Solo le proprietà comuni a tutto il testo vengono impostate nell'oggetto TextFormat risultante. Qualunque proprietà mista (ovvero dotata di valori diversi in diversi punti del testo) ha un valore null . |
my_textField.getTextFormat(beginIndex:Number) | Restituisce un oggetto TextFormat che contiene una copia del formato di testo del carattere nella posizione beginIndex . |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo compreso tra beginIndex ed endIndex . Solo le proprietà comuni a tutto il testo nell'intervallo specificato vengono impostate nell'oggetto TextFormat risultante. Qualunque proprietà mista (ovvero dotata di valori diversi in diversi punti dell'intervallo) ha un valore null . |
Parametri
beginIndex:int (default = -1 ) — Opzionale; un numero intero che specifica la posizione iniziale di un intervallo di testo all'interno del campo di testo.
| |
endIndex:int (default = -1 ) — Opzionale; un numero intero che specifica la posizione del primo carattere successivo alla porzione di testo desiderata. Come indicato, se vengono specificati i valoribeginIndex e endIndex , viene letto tutto il testo compreso tra beginIndex e endIndex-1 .
|
flash.text:TextFormat — L'oggetto TextFormat che rappresenta le proprietà di formattazione del testo specificato.
|
Genera
RangeError — Il valore beginIndex o endIndex specificato non rientra nell'intervallo.
|
Elementi API correlati
Esempio
Come utilizzare questo esempio
Per capire come utilizzare il metodo getTextFormat(), fate riferimento all'esempio relativo al metodo getFirstCharInParagraph() o
setTextFormat()
.
isFontCompatible | () | metodo |
public static function isFontCompatible(fontName:String, fontStyle:String):Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Restituisce true se è disponibile un carattere incorporato con i valori fontName
e fontStyle
specificati, dove Font.fontType
è flash.text.FontType.EMBEDDED
. A partire da Flash Player 10, in un file SWF possono essere presenti due tipi di caratteri incorporati. I caratteri incorporati normali vengono utilizzati solo con oggetti TextField. I caratteri incorporati CFF vengono utilizzati solo con le classi flash.text.engine. I due tipi si distinguono in base alla proprietà fontType
della classe Font
restituita dalla funzione enumerateFonts()
.
TextField non può utilizzare un carattere di tipo EMBEDDED_CFF
. Se embedFonts
è impostato su true
e il solo carattere disponibile in fase di runtime con il nome e lo stile specificati è di tipo EMBEDDED_CFF
, Flash Player non esegue il rendering del testo, come se non fosse disponibile alcun carattere incorporato con il nome e lo stile specificati.
Se i caratteri EMBEDDED
e EMBEDDED_CFF
sono entrambi disponibili con lo stesso nome e lo stesso stile, viene selezionato il carattere EMBEDDED
e il rendering del testo viene eseguito con il carattere EMBEDDED
.
Parametri
fontName:String — Il nome del carattere incorporato da verificare.
| |
fontStyle:String — Specifica lo stile del carattere da verificare. Utilizzate flash.text.FontStyle
|
Boolean — true se è disponibile un carattere incorporato compatibile, altrimenti false .
|
Genera
ArgumentError — Il valore fontStyle specificato non è un membro di flash.text.FontStyle .
|
Elementi API correlati
replaceSelectedText | () | metodo |
public function replaceSelectedText(value:String):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sostituisce la selezione corrente con il contenuto del parametro value
. Il testo viene inserito nella posizione della selezione corrente, utilizzando il formato predefinito corrente per il carattere e il paragrafo. La stringa di testo non viene considerata come HTML.
È possibile utilizzare il metodo replaceSelectedText()
per inserire ed eliminare il testo senza interrompere la formattazione del carattere e del paragrafo per il resto del testo.
Nota: questo metodo non funziona se al campo di testo è applicato un foglio di stile.
Parametri
value:String — La stringa con cui sostituire il testo selezionato.
|
Genera
Error — Questo metodo non può essere utilizzato in un campo di testo con un foglio di stile.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
Vengono creati due diversi oggetti TextField e vengono aggiunti dei listener di evento per gli eventi MouseEvent.MOUSE_UP
. L'evento mouse up si verifica quando l'utente rilascia il mouse; questo succede solitamente dopo aver effettuato una selezione di testo. Notate che l'impostazione predefinita per un campo di testo prevede che il testo in esso contenuto possa essere selezionato.
Il metodo mouseHandler1()
prevede che quando un utente rilascia il mouse all'interno del campo di testo myTextField1
, il testo venga sostituito con una stringa vuota e quindi cancellato. Questa operazione può essere ripetuta finché tutto il testo non venga cancellato. Il metodo mouseHandler2()
prevede che quando un utente seleziona una parte del testo contenuto nel campo di testo myTextField2
, venga effettuato un controllo sulle proprietà selectionBeginIndex
e selectionEndIndex
per verificare che sia effettivamente stata una selezione. Nel caso in cui sia stato selezionato del testo, infatti le proprietà selectionBeginIndex
e selectionEndIndex
avranno valori diversi. Il testo selezionato viene quindi sostituito con la stringa "NEW TEXT". Questa operazione può essere ripetuta finché il testo originale del secondo campo di testo non venga sostituito con la stringa "NEW TEXT".
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_replaceSelectedTextExample extends Sprite { private var myTextField1:TextField = new TextField(); private var myTextField2:TextField = new TextField(); public function TextField_replaceSelectedTextExample() { myTextField1.x = 10; myTextField1.width = 300; myTextField1.height = 50; myTextField1.background = true; myTextField1.border = true; myTextField1.text = "Select the text you want to remove from the line."; myTextField2.x = 10; myTextField2.y = 60; myTextField2.width = 300; myTextField2.height = 50; myTextField2.background = true; myTextField2.border = true; myTextField2.text = "Select the text you want to replace with NEW TEXT."; myTextField1.addEventListener(MouseEvent.MOUSE_UP, mouseHandler1); myTextField2.addEventListener(MouseEvent.MOUSE_UP, mouseHandler2); this.addChild(myTextField1); this.addChild(myTextField2); } private function mouseHandler1(e:MouseEvent):void { myTextField1.replaceSelectedText(""); } private function mouseHandler2(e:MouseEvent):void { if(myTextField2.selectionBeginIndex != myTextField2.selectionEndIndex) { myTextField2.replaceSelectedText("NEW TEXT"); } } } }
replaceText | () | metodo |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sostituisce un intervallo di caratteri, specificato dai parametri beginIndex
e endIndex
, con il contenuto del parametro newText
. Come indicato, il testo compreso tra beginIndex
e endIndex-1
viene sostituito.
Nota: questo metodo non funziona se al campo di testo è applicato un foglio di stile.
Parametri
beginIndex:int — L'indice a base zero del punto iniziale dell'intervallo da sostituire.
| |
endIndex:int — Il valore dell'indice con base zero del primo carattere situato dopo la porzione di testo richiesta.
| |
newText:String — Il testo da utilizzare per la sostituzione dell'intervallo di caratteri specificato.
|
Genera
Error — Questo metodo non può essere utilizzato in un campo di testo con un foglio di stile.
|
Esempio ( Come utilizzare questo esempio )
replaceText()
per cancellare, sostituire e inserire del testo in un campo di testo.
Il campo di testo outputText
viene impostato automaticamente in modo da ridimensionarsi a seconda del testo e di effettuare l'allineamento a sinistra. Con la prima chiamata del metodo replaceText()
la prima linea ("This is the wrong heading") viene sostituita con il testo "THIS IS THE HEADING FOR EVERYONE". Con la seconda chiamata del metodo viene inserito il testo "CORRECT" tra "THE" e "HEADING". Con la terza chiamata del metodo viene cancellato il testo "FOR EVERYONE". Notate che a ogni chiamata del metodo appendText()
gli indici attuali di inizio e di fine del testo vengono modificati. In questo caso verrà visualizzato come soltanto il testo finale (dopo, cioè, che tutte le modifiche sono state apportate).
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_replaceTextExample extends Sprite { public function TextField_replaceTextExample() { var outputText:TextField = new TextField(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.appendText("This is the wrong heading"); outputText.appendText("\n\n"); outputText.appendText("This is the body of the text."); outputText.replaceText(0, 25, "THIS IS THE HEADING FOR EVERYONE"); outputText.replaceText(12, 12, "CORRECT "); outputText.replaceText(27, 40, ""); this.addChild(outputText); } } }
setSelection | () | metodo |
public function setSelection(beginIndex:int, endIndex:int):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Imposta come selezionato il testo designato dai valori di indice del primo e ultimo carattere, specificati dai parametri beginIndex
e endIndex
. Se i valori dei due parametri sono uguali, questo metodo imposta il punto di inserimento, come se si impostasse la proprietà caretIndex
.
Parametri
beginIndex:int — Il valore dell'indice a base zero del primo carattere nella selezione (ad esempio, il primo carattere è 0, il secondo è 1, e così via).
| |
endIndex:int — Il valore dell'indice a base zero dell'ultimo carattere nella selezione.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
Due listener di evento relativi al campo di testo myTextField
rispondono agli eventi clic del mouse e mouse up dell'utente. L'evento mouse up si verifica quando l'utente rilascia il mouse; questo succede solitamente dopo aver effettuato una selezione di testo. Notate che l'impostazione predefinita per un campo di testo prevede che il testo in esso contenuto possa essere selezionato. Quando viene fatto clic su una porzione di testo, viene chiamato il metodo clickHandler()
. Quando si seleziona una porzione di testo e il mouse viene rilasciato, invece, viene richiamato il metodo mouseUpHandler()
.
Sia nel metodo clickHandler()
che in quello mouseUpHandler()
, il metodo setSelection()
fa in modo che vengano selezionati solo i caratteri compresi tra le posizioni 54 e 70 (corrispondenti alla stringa "TEXT IN ALL CAPS").
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_setSelectionExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_setSelectionExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS is selected."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); myTextField.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } private function mouseUpHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } } }
setTextFormat | () | metodo |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Applica la formattazione indicata dal parametro format
al testo specificato nel campo di testo. Il valore di format
deve essere un oggetto TextFormat che specifica le modifiche di formattazione del testo richieste. Solo le proprietà di format
con valori diversi da null vengono applicate al campo di testo. Qualunque proprietà di format
impostata su null
non viene applicata. Per impostazione predefinita, tutte le proprietà di un oggetto TextFormat appena creato sono impostate su null
.
Nota: questo metodo non funziona se al campo di testo è applicato un foglio di stile.
Il metodo setTextFormat()
modifica la formattazione del testo applicata a gruppi di caratteri o all'intero testo presente in un campo di testo. Per applicare le proprietà di format a tutto il testo presente nel campo di testo, non indicate i valori relativi a beginIndex
e endIndex
. Per applicare le proprietà del formato a un intervallo di testo, specificate i valori relativi ai parametri beginIndex
e endIndex
. Potete utilizzare la proprietà length
per determinare i valori di indice.
In un oggetto TextFormat sono presenti due tipi di informazioni sulla formattazione, le informazioni a livello di carattere e quelle a livello di paragrafo. Ogni carattere presente in un campo di testo può avere delle impostazioni di formattazione proprie, quali il nome del carattere, la dimensione, il grassetto e il corsivo.
Per i paragrafi, il primo carattere del paragrafo viene esaminato alla ricerca delle impostazioni di formattazione dell'intero paragrafo. Margine sinistro, margine destro e rientro sono esempi di impostazioni della formattazione del paragrafo.
Qualunque testo inserito manualmente dall'utente, o sostituito dal metodo replaceSelectedText()
, riceve la formattazione predefinita del campo di testo per il nuovo testo e non la formattazione specificata nel punto di inserimento del testo. Per impostare la formattazione predefinita per il nuovo testo, potete usare defaultTextFormat
.
Parametri
format:flash.text:TextFormat — Un oggetto TextFormat che contiene le informazioni relative alla formattazione del carattere e del paragrafo.
| |||||||||
beginIndex:int (default = -1 ) — Opzionale; un numero intero che specifica il valore dell'indice con base zero del primo carattere dell'intervallo di testo richiesto.
| |||||||||
endIndex:int (default = -1 ) — Opzionale; un numero intero che specifica il primo carattere successivo alla porzione di testo desiderata. Come indicato, se vengono specificati i valoribeginIndex e endIndex , viene aggiornato tutto il testo compreso tra beginIndex e endIndex-1 .
Notate che qualunque testo inserito manualmente dall'utente, o sostituito dal metodo |
Genera
Error — Questo metodo non può essere utilizzato in un campo di testo con un foglio di stile.
| |
RangeError — Il valore beginIndex o endIndex specificato non rientra nell'intervallo.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
Per il campo di testo myTextField
viene aggiunto un listener di evento in risposta ai clic del mouse chiamando il metodo clickHandler()
. All'interno del metodo clickHandler()
, il metodo getTextFormat()
restituisce il formato attuale di un carattere (indice 55) compreso nell'intervallo di testo desiderato, il quale viene situato nell'oggetto TextFormat currentTextFormat
. La dichiarazione if
effettua un controllo sul formato di testo currentTextFormat
per verificare se il carattere nell'intervallo sta utilizzando un nuovo formato (la dimensione del carattere è impostata su 18 punti). In caso contrario il nuovo formato modificherà l'intervallo di testo compreso tra le posizioni 54 e 70 (corrispondente alla stringa "TEXT IN ALL CAPS") portando la dimensione del carattere a 18 punti, cambiando il colore in rosso e applicando gli effetti di sottolineatura e corsivo. Se, invece, il carattere nell'intervallo sta già utilizzando il nuovo formato, questo verrà riportato al formato predefinito (originale) del campo di testo.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.events.MouseEvent; public class TextField_setTextFormatExample extends Sprite { private var myTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_setTextFormatExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.selectable = false; myTextField.background = true; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS changes format."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); newFormat.color = 0xFF0000; newFormat.size = 18; newFormat.underline = true; newFormat.italic = true; this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { var currentTextFormat:TextFormat = myTextField.getTextFormat(55); if(currentTextFormat.size != 18) { myTextField.setTextFormat(newFormat, 54, 70); } else { myTextField.setTextFormat(myTextField.defaultTextFormat); } } } }
change | Evento |
flash.events.Event
proprietà Event.type =
flash.events.Event.CHANGE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inviato dopo la modifica del valore di un controllo, a differenza dell'evento textInput
che viene inviato prima della modifica del valore. A differenza della versione del modello di evento W3C DOM dell'evento change
, che invia l'evento solo dopo che il controllo non è più attivo, la versione ActionScript 3.0 dell'evento change
viene inviata ogni volta che il controllo viene modificato. Ad esempio, se un utente immette del testo in un campo di testo, dopo ogni comando della tastiera viene inviato un evento change
.
Event.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. |
Esempio ( Come utilizzare questo esempio )
Vengono creati due campi di testo: uno per l'input dell'utente e l'altro (headingTextField
) per la copia dell'input dell'utente. Viene creato anche un oggetto TextFormat e il formato di testo predefinito viene assegnato al campo di testo headingTextField
. Quando il contenuto del campo di testo subisce delle modifiche, viene chiamato il metodo changeHandler()
, che assegna il testo contenuto nel campo di testo inputTextField
al campo di testo headingTextField
(se il metodo era stato richiamato per l'evento TextEvent.TEXT_INPUT
invece che per l'evento Event.CHANGE
, il contenuto dell'input dell'utente viene copiato solo dopo che l'utente ha immesso altro testo).
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; import flash.text.TextFormatAlign; import flash.events.Event; import flash.events.TextEvent; public class TextField_Event_changeExample extends Sprite { private var inputTextField:TextField = new TextField(); private var headingTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_Event_changeExample() { headingTextField.x = 10; headingTextField.y = 10; headingTextField.height = 30; headingTextField.width = 400; headingTextField.background = true; headingTextField.backgroundColor = 0xF5F5DC; headingTextField.selectable = false; inputTextField.x = 10; inputTextField.y = 70; inputTextField.height = 20; inputTextField.width = 230; inputTextField.background = true; inputTextField.border = true; inputTextField.maxChars = 40; inputTextField.wordWrap = true; inputTextField.type = TextFieldType.INPUT; inputTextField.addEventListener(Event.CHANGE, changeHandler); newFormat.bold = true; newFormat.size = 18; newFormat.color = 0xFF0000; newFormat.align = TextFormatAlign.CENTER; headingTextField.defaultTextFormat = newFormat; this.addChild(inputTextField); this.addChild(headingTextField); } private function changeHandler(e:Event):void { headingTextField.text = inputTextField.text; } } }
link | Evento |
flash.events.TextEvent
proprietà TextEvent.type =
flash.events.TextEvent.LINK
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inviato quando un utente fa clic su un collegamento ipertestuale in un campo di testo abilitato per HTML, dove l'URL inizia con "event:". La parte restante dell'URL, dopo "event:", viene inserita nella proprietà di testo dell'evento LINK.
Nota: il comportamento predefinito, ovvero l'aggiunta di testo al campo di testo, si verifica solo quando Flash Player genera l'evento; in questo caso, quando un utente cerca di immettere del testo. Non è possibile immettere del testo in un campo di testo inviandogli degli eventi textInput
.
type
di un oggetto evento link
.
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 | Il campo di testo contenente il collegamento ipertestuale su cui si è fatto clic. 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. |
text | La parte restante dell'URL, dopo "event:", |
Esempio ( Come utilizzare questo esempio )
playMP3()
. Viene creato un oggetto TextField denominato list
che viene poi compilato con testo HTML. I testi "Track 1"
e "Track 2"
sono collegamenti all'interno del campo di testo. La funzione playMP3() viene chiamata nel momento in cui l'utente fa clic su uno dei due campi. Il nome del file MP3, che segue la stringa "event:" nell'attributo href
del tag HTML, viene passato al metodo linkHandler()
come proprietà text
dell'oggetto evento link
.
package { import flash.display.Sprite; import flash.errors.IOError; import flash.events.IOErrorEvent; import flash.events.TextEvent; import flash.media.Sound; import flash.media.SoundChannel; import flash.net.URLRequest; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_event_link extends Sprite { private var myMP3:Sound; public function TextField_event_link() { myMP3 = new Sound(); var list:TextField = new TextField(); list.autoSize = TextFieldAutoSize.LEFT; list.multiline = true; list.htmlText = "<a href=\"event:track1.mp3\">Track 1</a><br>"; list.htmlText += "<a href=\"event:track2.mp3\">Track 2</a><br>"; addEventListener(TextEvent.LINK, linkHandler); addChild(list); } private function playMP3(mp3:String):void { try { myMP3.load(new URLRequest(mp3)); myMP3.play(); } catch(err:Error) { trace(err.message); } myMP3.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); } private function linkHandler(linkEvent:TextEvent):void { playMP3(linkEvent.text); } private function errorHandler(errorEvent:IOErrorEvent):void { trace(errorEvent.text); } } }
scroll | Evento |
flash.events.Event
proprietà Event.type =
flash.events.Event.SCROLL
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inviato da un oggetto TextField dopo che l'utente ha eseguito lo scorrimento.
La costanteEvent.SCROLL
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. |
target | L'oggetto TextField che è stato fatto scorrere. La proprietà 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. |
Esempio ( Come utilizzare questo esempio )
mouseDown
e viene chiamato il gestore associato mouseDownScroll
. Il gestore mouseDownScroll()
causa lo scorrimento del campo. Viene quindi inviato l'evento scroll
e il gestore associato scrollHandler()
aggiorna il secondo campo di testo per visualizzare la posizione di scorrimento corrente.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextScrollExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); private var myText:String = "Hello world and welcome to the show. It's really nice to meet you. Take your coat off and stay a while. OK, show is over. Hope you had fun. You can go home now. Don't forget to tip your waiter. There are mints in the bowl by the door. Thank you. Please come again."; public function TextScrollExample() { myTextBox1.text = myText; myTextBox1.width = 200; myTextBox1.height = 50; myTextBox1.multiline = true; myTextBox1.wordWrap = true; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownScroll); myTextBox1.addEventListener(Event.SCROLL, scrollHandler); } public function mouseDownScroll(event:MouseEvent):void { myTextBox1.scrollV++; } public function scrollHandler(event:Event):void { myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; } } }
textInput | Evento |
flash.events.TextEvent
proprietà TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Flash Player invia l'evento textInput
quando un utente immette uno o più caratteri di testo. Questo evento può essere generato da vari metodi di immissione del testo, quali tastiere, IME, sistemi di riconoscimento vocale o del contenuto parlato, e persino dalle operazioni Incolla di testo normale privo di informazioni di formattazione e stile.
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. |
Esempio ( Come utilizzare questo esempio )
textInput
, viene chiamato il gestore textInputHandler()
e i caratteri vengono visualizzati nel secondo campo di testo. Quando incollate un blocco di testo nel campo di testo, il gestore di eventi copia l'intero blocco nell'altro campo.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextInputExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); public function TextInputExample() { myTextBox1.type = TextFieldType.INPUT; myTextBox1.width = 200; myTextBox1.height = 20; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(TextEvent.TEXT_INPUT,textInputHandler); } public function textInputHandler(event:TextEvent):void { myTextBox2.text=event.text; } } }
textInteractionModeChange | Evento |
flash.events.Event
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 11, Flash Lite 4 |
Flash Player invia l'evento textInteractionModeChange
quando un utente cambia la modalità di interazione di un campo di testo. in Android, ad esempio, è possibile passare dalla modalità NORMAL alla modalità SELECTION tramite le opzioni del menu contestuale.
TextFieldExample
per visualizzare un messaggio di testo. Questa operazione viene eseguita mediante la procedura seguente:
- Viene creata una proprietà
label
di tipo TextField. - La funzione di costruzione della classe chiama la funzione
configureLabel()
. - Il metodo
configureLabel()
crea innanzitutto un nuovo oggetto TextField e lo assegna alla proprietàlabel
, quindi imposta i relativi parametri nel modo seguente:- Campo di testo giustificato a sinistra.
- Riempimento di sfondo abilitato.
- Bordo abilitato.
- Il metodo
configureLabel()
crea la variabileformat
e la assegna a una nuova istanza TextFormat con i parametri impostati nel modo seguente:- Tipo di carattere = Verdana
- Colore del carattere = rosso uniforme
- Dimensioni del carattere = 10
- Sottolineatura = true
- La proprietà
defaultTextFormat
del campo di testolabel
viene impostata suformat
e l'istanzalabel
viene aggiunta all'elenco di visualizzazione, nel quale viene inizialmente visualizzato un campo di testo privo di testo sullo stage. - La funzione di costruzione imposta il testo del campo di testo
label
su"Hello world and welcome to the show."
mediante una chiamata al metodosetLabel()
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.TextFormat; public class TextFieldExample extends Sprite { private var label:TextField; private var labelText:String = "Hello world and welcome to the show."; public function TextFieldExample() { configureLabel(); setLabel(labelText); } public function setLabel(str:String):void { label.text = str; } private function configureLabel():void { label = new TextField(); label.autoSize = TextFieldAutoSize.LEFT; label.background = true; label.border = true; var format:TextFormat = new TextFormat(); format.font = "Verdana"; format.color = 0xFF0000; format.size = 10; format.underline = true; label.defaultTextFormat = format; addChild(label); } } }
Tue Jun 12 2018, 02:44 PM Z