| Pacchetto | flash.text |
| Classe | public final class StageText |
| Ereditarietà | StageText  EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Questa classe consente alle applicazioni mobili di raccogliere l'input dell'utente utilizzando i controlli di immissione testo nativi dei dispositivi mobili. I controlli di input dei dispositivi mobili spesso hanno interfacce utente elaborate e comportamenti di supporto che non esistono in ambiente desktop. Ad esempio, molti dispositivi mobili supportano funzioni di input del testo quali le seguenti:
- compilazione automatica
- correzione automatica
- selezione di testo tramite tocco
- tastiere virtuali personalizzabili
Il sistema operativo sottostante (o una libreria di componenti inclusa nel sistema operativo) disegna i campi di immissione del testo nativi. Tali campi assicurano un'esperienza che risulta familiare a tutti coloro che hanno usato altre applicazioni sullo stesso dispositivo. Tuttavia, poiché il sistema operativo disegna i campi di immissione del testo al posto del lettore, non è possibile utilizzare caratteri incorporati.
Supporto profili AIR: questa funzione è supportata nelle piattaforme iOS e Android. StageText usa i campi di immissione testo nativi sui dispositivi mobili Android e iOS. Sulle altre piattaforme, StageText utilizza il campo di testo (TextField) del runtime Flash.
Se si usano gli input nativi, gli oggetti StageText non sono oggetti di visualizzazione e non possono essere aggiunti all'elenco di visualizzazione di Flash. Per visualizzare un oggetto StageText è invece necessario associarlo direttamente a uno stage utilizzando la proprietà stage. L'istanza StageText associata a uno stage viene visualizzata sopra gli oggetti di visualizzazione di Flash, se presenti. Per controllare le dimensioni e la posizione dell'area di rendering, utilizzate la proprietà viewPort. Non è possibile controllare l'ordine di profondità di oggetti StageText differenti. La sovrapposizione di due istanze è sconsigliata.
Quando un oggetto StageText è l'elemento attivo, ha la prima opportunità di gestire l'input della tastiera. Lo stage al quale l'oggetto StageText è associato non invia eventi di input da tastiera.
Poiché la classe StageText incorpora un controllo nativo differente su ogni piattaforma, le sue funzionalità sono supportate in modo diverso da ciascuna piattaforma e, dove sono supportate, possono comportarsi in modo differente. Quando tentate di usare una particolare funzione su una particolare piattaforma, è meglio testarne prima il comportamento. Solo su piattaforme desktop dove i controlli nativi non vengono utilizzati, StageText si comporta in modo simile al testo del runtime Flash.
StageText su Apple TV è attivato per impostazione predefinita. Per gestire l'attivazione tra oggetti diversi nell'applicazione, prendere nota dei punti seguenti:
- Per ignorare l'attivazione predefinita da StageText, oppure per assegnare l'attivazione a un altro oggetto di visualizzazione, utilizzare stage.focus
- Per assegnare l'attivazione a StageText, utilizzare stageText.assignFocus ()
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| autoCapitalize : String
Controlla il modo in cui un dispositivo applica automaticamente le maiuscole all'input dell'utente. | StageText | ||
| autoCorrect : Boolean
Indica se un dispositivo corregge automaticamente gli errori di ortografia e punteggiatura nell'input dell'utente. | StageText | ||
| clearButtonMode : String [sola scrittura]
La modalità clearButton per l'oggetto StageText corrente. | StageText | ||
| color : uint
Specifica il colore del testo. | StageText | ||
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| displayAsPassword : Boolean
Indica se il campo di testo è un campo di immissione password. | StageText | ||
| editable : Boolean
Indica se l'utente può modificare il campo di testo. | StageText | ||
| fontFamily : String
Indica il nome della famiglia di caratteri corrente. | StageText | ||
| fontPosture : String
Specifica la postura del carattere, utilizzando le costanti definite nella classe FontPosture. | StageText | ||
| fontSize : int
La dimensione in pixel della famiglia di caratteri corrente. | StageText | ||
| fontWeight : String
Specifica lo spessore del carattere, utilizzando le costanti definite nella classe FontWeight. | StageText | ||
| locale : String
Indica l'impostazione internazionale (lingua) del testo. | StageText | ||
| maxChars : int
Indica il numero massimo di caratteri che l'utente può immettere in un campo di testo. | StageText | ||
| multiline : Boolean [sola lettura]
Indica se l'oggetto StageText può visualizzare più di una riga di testo. | StageText | ||
| restrict : String
Limita il set di caratteri che l'utente può immettere in un campo di testo. | StageText | ||
| returnKeyLabel : String
Indica l'etichetta del tasto Invio per i dispositivi che dispongono di una tastiera software. | StageText | ||
| selectionActiveIndex : int [sola lettura]
Il valore dell'indice a base zero dell'ultimo carattere nella selezione corrente. | StageText | ||
| selectionAnchorIndex : int [sola lettura]
Il valore dell'indice a base zero del primo carattere nella selezione corrente. | StageText | ||
| softKeyboardType : String
Controlla l'aspetto della tastiera software. | StageText | ||
| stage : Stage
Lo stage sul quale viene visualizzato questo oggetto StageText. | StageText | ||
| text : String
Il testo corrente nel campo di testo. | StageText | ||
| textAlign : String
Indica l'allineamento del paragrafo. | StageText | ||
| viewPort : Rectangle
L'area dello stage in cui viene visualizzato questo oggetto StageText. | StageText | ||
| visible : Boolean
Indica se l'oggetto StageText è visibile o meno. | StageText | ||
| Metodo | Definito da | ||
|---|---|---|---|
Crea un oggetto StageText. | StageText | ||
| 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 | |
Assegna lo stato di attivazione all'oggetto StageText. | StageText | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
Rimuove l'oggetto StageText. | StageText | ||
Disegna il riquadro di visualizzazione di StageText su una bitmap. | StageText | ||
|
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 | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
Seleziona il testo specificato dai valori di indice del primo e dell'ultimo carattere. | StageText | ||
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
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 dopo che il contenuto del testo è stato modificato. | StageText | |||
| Inviato dopo aver impostato stage su un valore diverso da null e aver specificato un valore per viewPort. | StageText | |||
| [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 sta modificando il testo e il controllo è l'elemento attivo della tastiera. | StageText | |||
| Inviato quando l'utente non sta più modificando il testo e il controllo non è più l'elemento attivo della tastiera. | StageText | |||
| Inviato quando l'utente preme un tasto. | StageText | |||
| Inviato quando l'utente rilascia un tasto. | StageText | |||
| Inviato dopo l'attivazione della tastiera software, a seguito dell'acquisizione dello stato di attivazione dell'oggetto StageText. | StageText | |||
| Inviato prima dell'attivazione della tastiera software, a seguito dell'acquisizione dello stato di attivazione dell'oggetto StageText. | StageText | |||
| Inviato dopo la disattivazione della tastiera software, a seguito della perdita dello stato di attivazione dell'oggetto StageText. | StageText | |||
autoCapitalize | proprietà |
autoCapitalize:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Controlla il modo in cui un dispositivo applica automaticamente le maiuscole all'input dell'utente. I valori validi sono definiti come costanti nella classe AutoCapitalize:
- "none"
- "word"
- "sentence"
- "all"
Questa proprietà è solo un suggerimento per la piattaforma sottostante, poiché non tutti i dispositivi e sistemi operativi supportano questa funzionalità.
Nota: se si abilita autoCapitalize mentre il testo è in corso di modifica o è attivo, il comportamento aggiornato non viene applicato fino a quando l’attivazione non viene rilasciata e ripristinata.
Il valore predefinito è AutoCapitalize.NONE.
Implementazione
public function get autoCapitalize():String public function set autoCapitalize(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di AutoCapitalize
|
Elementi API correlati
autoCorrect | proprietà |
autoCorrect:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Indica se un dispositivo corregge automaticamente gli errori di ortografia e punteggiatura nell'input dell'utente.
Questa proprietà è solo un suggerimento per la piattaforma sottostante, poiché non tutti i dispositivi e sistemi operativi supportano questa funzionalità.
Nota: se si abilita autoCorrect mentre il testo è in corso di modifica o è attivo, il comportamento aggiornato non viene applicato fino a quando l’attivazione non viene rilasciata e ripristinata.
Il valore predefinito è false.
Implementazione
public function get autoCorrect():Boolean public function set autoCorrect(value:Boolean):void clearButtonMode | proprietà |
clearButtonMode:String [sola scrittura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 23 |
La modalità clearButton per l'oggetto StageText corrente. A questa proprietà sono associate quattro modalità:
-
Per mostrare clearButton durante la modifica:
StageTextClearButtonMode.WHILE_EDITING -
Per non mostrare mai clearButton:
StageTextClearButtonMode.NEVER -
Per mostrare sempre clearButton:
StageTextClearButtonMode.ALWAYS -
Per mostrare sempre clearButton, eccetto in modalità di modifica:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode è impostata come StageTextClearButtonMode.WHILE_EDITING.
Nota: questa proprietà è supportata solo su iOS.
Implementazione
public function set clearButtonMode(value:String):void color | proprietà |
color:uint| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Specifica il colore del testo. Potete specificare il colore del testo sotto forma di numero con tre componenti RGB a 8 bit. Il primo componente rappresenta il rosso, il secondo il verde e il terzo il blu. Ad esempio, 0xFF0000 specifica il rosso, 0x00FF00 specifica il verde e 0x0000FF specifica il blu. Il colore predefinito del testo è il nero (0x000000).
Il valore predefinito è 0x000000.
Implementazione
public function get color():uint public function set color(value:uint):void displayAsPassword | proprietà |
displayAsPassword:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Indica se il campo di testo è un campo di immissione password. Se è true, il campo di testo nasconde i caratteri digitati utilizzando un carattere sostitutivo (ad esempio un asterisco)
Nota: se si abilita displayAsPassword mentre il testo è in corso di modifica o è attivo, il comportamento aggiornato non viene applicato fino a quando l’attivazione non viene rilasciata e ripristinata.
Importante: in iOS, un oggetto StageText multiriga non visualizza caratteri sostitutivi anche se il valore di questa proprietà è true.
Il valore predefinito è false.
Implementazione
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):void editable | proprietà |
fontFamily | proprietà |
fontFamily:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Indica il nome della famiglia di caratteri corrente. Il valore null corrisponde al carattere predefinito del sistema. Per enumerare i caratteri disponibili, utilizzate flash.text.Font.enumerateFonts(). Se la famiglia di caratteri è sconosciuta, viene utilizzata quella predefinito.
Il valore predefinito è null.
Implementazione
public function get fontFamily():String public function set fontFamily(value:String):void fontPosture | proprietà |
fontPosture:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Specifica la postura del carattere, utilizzando le costanti definite nella classe FontPosture.
Il valore predefinito è FontPosture.NORMAL.
Implementazione
public function get fontPosture():String public function set fontPosture(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di FontPosture
|
Elementi API correlati
fontSize | proprietà |
fontWeight | proprietà |
fontWeight:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Specifica lo spessore del carattere, utilizzando le costanti definite nella classe FontWeight.
Il valore predefinito è FontWeight.NORMAL.
Implementazione
public function get fontWeight():String public function set fontWeight(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di FontWeight
|
Elementi API correlati
locale | proprietà |
locale:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Indica l'impostazione internazionale (lingua) del testo. StageText utilizza gli identificatori di impostazione internazionale standard. "en", "en_US" ed "en-US", ad esempio, si riferiscono all'inglese; "ja" al giapponese. Per un elenco dei codici delle impostazioni internazionali, visitate il sito Web iso639-2 code list.
Il valore predefinito è en.
Implementazione
public function get locale():String public function set locale(value:String):void maxChars | proprietà |
maxChars:int| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Indica il numero massimo di caratteri che l'utente può immettere in un campo di testo. Uno script può inserire più caratteri di quelli consentiti da maxChars. Se maxChars è zero, un utente può immettere un numero illimitato d caratteri nel campo di testo.
Il valore predefinito è 0.
Implementazione
public function get maxChars():int public function set maxChars(value:int):void multiline | proprietà |
multiline:Boolean [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Indica se l'oggetto StageText può visualizzare più di una riga di testo. Sola lettura. Questo valore corrisponde a quello della proprietà Multiriga dell'oggetto StageTextInitOptions utilizzato durante la costruzione.
Implementazione
public function get multiline():BooleanElementi API correlati
restrict | proprietà |
restrict:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Limita il set di caratteri che l'utente può immettere in un campo di testo. Il sistema analizza la stringa restrict da sinistra a destra.
Il valore di restrict specifica le seguenti regole di limitazione dell'immissione di testo:
- Se il valore è
null, l'utente può inserire qualunque carattere. - Se il valore è una stringa vuota, l'utente non può inserire nessun carattere.
- Se è una stringa di caratteri, l'utente può inserire solo i caratteri inclusi nella stringa.
- Se il valore include un accento circonflesso (^), l'utente non può inserire nessuno dei caratteri che seguono tale simbolo.
- Il valore può specificare un intervallo di caratteri di input ammessi se contiene un trattino (-).
- Il valore può utilizzare la sequenza di escape
\uper costruire una stringarestrict.
Caratteri speciali:
Utilizzate una barra rovesciata (\) per specificare un accento circonflesso (^) o un trattino (-) da interpretare come semplici caratteri. Le sequenze con barra rovesciata accettate come valide sono \-, \^ e \\. La barra rovesciata deve essere un carattere effettivo nella stringa. Quando specificate una barra rovesciata in ActionScript, usate una barra rovesciata doppia.
Esempi di impostazioni della proprietà restrict:
L'esempio seguente permette a un utente di inserire solo i caratteri trattino (-) e accento circonflesso (^):
my_txt.restrict = "\\-\\^";
L'esempio seguente permette a un utente di inserire solo i maiuscoli, gli spazi e i numeri:
my_txt.restrict = "A-Z 0-9";
L'esempio seguente esclude solo le lettere minuscole:
my_txt.restrict = "^a-z";
L'esempio seguente permette a un utente di inserire solo le lettere maiuscole, ma esclude la lettera Q maiuscola:
my_txt.restrict = "A-Z^Q";
L'esempio seguente permette a un utente di inserire solo i caratteri da ASCII 32 (spazio) a ASCII 126 (tilde):
my_txt.restrict = "\u0020-\u007E";
Nota: le restrizioni valgono solo per il testo immesso dall'utente; uno script può inserire qualsiasi carattere nel campo di testo.
Il valore predefinito è null.
Implementazione
public function get restrict():String public function set restrict(value:String):void returnKeyLabel | proprietà |
returnKeyLabel:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Indica l'etichetta del tasto Invio per i dispositivi che dispongono di una tastiera software. I valori disponibili sono costanti definite nella classe ReturnKeyLabel.
- "default"
- "done"
- "go"
- "next"
- "search"
Questa proprietà è solo un suggerimento per la piattaforma sottostante, poiché non tutti i dispositivi e sistemi operativi supportano questi valori. Questa proprietà non ha effetto sui dispositivi che non dispongono di una tastiera software.
Il valore predefinito è ReturnKeyLabel.DEFAULT.
Implementazione
public function get returnKeyLabel():String public function set returnKeyLabel(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di ReturnKeyLabel
|
Elementi API correlati
selectionActiveIndex | proprietà |
selectionActiveIndex:int [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
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.)
Se non è selezionato alcun testo, questo metodo restituisce il punto di inserimento. Se l’istanza StageText non è attiva, questo metodo restituisce -1.
In iOS, questa proprietà non è supportata per gli oggetti StageText non multiriga e restituisce -1.
Implementazione
public function get selectionActiveIndex():intElementi API correlati
selectionAnchorIndex | proprietà |
selectionAnchorIndex:int [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
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.)
Se non è selezionato alcun testo, questo metodo restituisce il punto di inserimento. Se l’istanza StageText non è attiva, questo metodo restituisce -1.
In iOS, questa proprietà non è supportata per gli oggetti StageText non multiriga e restituisce -1.
Implementazione
public function get selectionAnchorIndex():intElementi API correlati
softKeyboardType | proprietà |
softKeyboardType:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Controlla l'aspetto della tastiera software.
I dispositivi con tastiere software consentono di personalizzare i pulsanti della tastiera per farli corrispondere al tipo di input previsto. Ad esempio, se è previsto un input numerico, un dispositivo può utilizzare SoftKeyboardType.NUMBER per visualizzare solo i numeri sulla tastiera software. I valori validi sono definiti come costanti nella classe SoftKeyboardType:
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "telefono"
- "decimalpad"
Questi valori sono suggerimenti e hanno lo scopo di "aiutare" un dispositivo a visualizzare la tastiera più appropriata per l'operazione corrente.
Il valore predefinito è SoftKeyboardType.DEFAULT.
Implementazione
public function get softKeyboardType():String public function set softKeyboardType(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di SoftKeyboardType
|
Elementi API correlati
stage | proprietà |
stage:Stage| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Lo stage sul quale viene visualizzato questo oggetto StageText.
Impostate stage su null per nascondere questo oggetto StageText.
Il valore predefinito è null.
Implementazione
public function get stage():Stage public function set stage(value:Stage):void text | proprietà |
text:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Il testo corrente nel campo di testo. Il carattere di ritorno a capo ('\r', ASCII 13) separa le righe di testo. Il testo contenuto in questa proprietà non è formattato (non contiene tag di formattazione).
Il valore predefinito è null.
Implementazione
public function get text():String public function set text(value:String):void textAlign | proprietà |
textAlign:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Indica l'allineamento del paragrafo. I valori validi sono definiti come costanti nella classe TextFormatAlign:
- "left"
- "center"
- "right"
- "justify"
- "start"
- "end"
Non tutte le piattaforme supportano ogni valore textAlign. Per i valori textAlign non supportati, le piattaforme usano il valore predefinito (TextFormatAlign.START).
Il valore predefinito è TextFormatAlign.START.
Implementazione
public function get textAlign():String public function set textAlign(value:String):voidGenera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di TextFormatAlign
|
Elementi API correlati
viewPort | proprietà |
viewPort:Rectangle| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
L'area dello stage in cui viene visualizzato questo oggetto StageText. Il valore predefinito è zero.
Implementazione
public function get viewPort():Rectangle public function set viewPort(value:Rectangle):voidGenera
RangeError — Il valore Rectangle non è valido.
|
visible | proprietà |
StageText | () | Funzione di costruzione |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Crea un oggetto StageText.
L'oggetto StageText è invisibile finché rimane associato a uno stage e finché viewPort è impostato correttamente.
initOptions:flash.text:StageTextInitOptions (default = null) |
assignFocus | () | metodo |
public function assignFocus():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Assegna lo stato di attivazione all'oggetto StageText. Per gli oggetti non modificabili, assignFocus() non ha alcun effetto.
dispose | () | metodo |
public function dispose():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Rimuove l'oggetto StageText.
La chiamata di dispose() è opzionale. Se non mantenete un riferimento a questa istanza StageText, essa è idonea per il processo di garbage collection. La chiamata di dispose() può anticipare il processo di garbage collection oppure farlo avvenire in un momento più opportuno.
drawViewPortToBitmapData | () | metodo |
public function drawViewPortToBitmapData(bitmap:BitmapData):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3.0 |
Disegna il riquadro di visualizzazione di StageText su una bitmap.
Per visualizzare il contenuto sopra l'oggetto StageText, acquisite la bitmap e impostate lo stage su null.
La bitmap ha in genere la stessa larghezza e altezza del riquadro di visualizzazione. A partire da AIR 15.0, quando il lettore è impostato per visualizzazioni HiDPI, la larghezza e altezza della bitmap possono essere un numero di volte contentsScaleFactor la larghezza e altezza del riquadro di visualizzazione. Ad esempio, su un display Retina Mac, contentsScaleFactor è 2, poiché la risoluzione in pixel dello stage è doppia, e di conseguenza la bitmap può essere due volte la dimensione del riquadro di visualizzazione.
Se chiamate questo metodo prima dell'evento Event.COMPLETE, il metodo potrebbe disegnare il riquadro di visualizzazione in maniera non corretta.
Parametri
bitmap:BitmapData — L'oggetto BitmapData su cui disegnare la parte visibile del riquadro di visualizzazione di StageText.
|
Genera
ArgumentError — L'altezza e la larghezza della bitmap sono diverse rispetto a quelle del riquadro di visualizzazione.
| |
Error — La bitmap è null.
|
selectRange | () | metodo |
public function selectRange(anchorIndex:int, activeIndex:int):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Seleziona il testo specificato dai valori di indice del primo e dell'ultimo carattere. Il primo e l'ultimo carattere della selezione vengono specificati nei parametri anchorIndex e activeIndex. Se i due valori di parametro sono uguali, questo metodo imposta il punto di inserimento.
In iOS, per gli oggetti StageText non multiriga, questa funzione non è supportata e restituisce sempre -1. Se si chiama questo metodo selezionando la stringa di testo completa, la selezione è visibile. Tuttavia, se si chiama questo metodo selezionando un sottoinsieme della stringa di testo, la selezione non è visibile.
Per alcuni dispositivi o sistemi operativi, la selezione è visibile solo quando l'oggetto StageText è l'elemento attivo.
Parametri
anchorIndex:int — Il valore di indice a base zero del primo carattere della selezione (il valore di indice del primo carattere è 0).
| |
activeIndex:int — Il valore dell'indice a base zero dell'ultimo carattere nella selezione.
|
Elementi API correlati
change | Evento |
flash.events.Eventproprietà Event.type =
flash.events.Event.CHANGE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Inviato dopo che il contenuto del testo è stato modificato. Questo evento può esser inviato a ogni modifica oppure solo al completamento di una serie di modifiche.
La costanteEvent.CHANGE definisce il valore della proprietà type di un oggetto evento change.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | true |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto il cui valore è stato modificato. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento. |
complete | Evento |
flash.events.Eventproprietà Event.type =
flash.events.Event.COMPLETE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Inviato dopo aver impostato stage su un valore diverso da null e aver specificato un valore per viewPort. Indica che l'implementazione ha completato il layout dell'oggetto StageText ed è quindi ora possibile chiamare il metodo drawViewPortToBitmapData. A seconda della piattaforma, questo evento potrebbe essere inviato in modo sincrono o asincrono con l'impostazione stage, viewPort o con entrambe.
Event.COMPLETE definisce il valore della proprietà type di un oggetto evento complete.
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 di rete che ha completato il caricamento. |
focusIn | Evento |
flash.events.FocusEventproprietà FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Inviato quando l'utente sta modificando il testo e il controllo è l'elemento attivo della tastiera.
Definisce il valore della proprietàtype di un oggetto evento focusIn.
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. |
keyCode | 0; valido solo per gli eventi keyFocusChange. |
relatedObject | L'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione. |
shiftKey | false; valido solo per gli eventi keyFocusChange. |
target | L'istanza InteractiveObject che è appena stata attivata. 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.
|
direction | La direzione dalla quale l'attivazione è stata assegnata. Questa proprietà segnala il valore del parametro direction del metodo assignFocus() dello stage. Se l'attivazione viene modificata mediante altri metodi, il valore sarà sempre FocusDirection.NONE. Valido solo per gli eventi focusIn. Per tutti gli altri eventi di attivazione, il valore sarà FocusDirection.NONE. |
focusOut | Evento |
flash.events.FocusEventproprietà FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Inviato quando l'utente non sta più modificando il testo e il controllo non è più l'elemento attivo della tastiera.
Definisce il valore della proprietàtype di un oggetto evento focusOut.
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. |
keyCode | 0; valido solo per gli eventi keyFocusChange. |
relatedObject | L'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione. |
shiftKey | false; valido solo per gli eventi keyFocusChange. |
target | L'istanza InteractiveObject che è appena stata disattivata. 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.
|
keyDown | Evento |
flash.events.KeyboardEventproprietà KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Inviato quando l'utente preme un tasto.
Le mappature tra tasti e caratteri specifici variano a seconda del dispositivo e del sistema operativo. Questo tipo di evento viene generato dopo una tale mappatura ma prima dell'elaborazione di un IME (input method editor). Gli IME sono utili per immettere i caratteri non supportati dalla tastiera QWERTY standard (ad esempio gli ideogrammi cinesi).
Questo evento si verifica prima dell'evento keyUp.
Non viene inviato per tutti i tasti. I tasti che determinano l'invio dell'evento variano a seconda della piattaforma.
In AIR, l'annullamento di questo evento impedisce l'immissione del carattere in un campo di testo.
La costanteKeyboardEvent.KEY_DOWN definisce il valore della proprietà type di un oggetto evento keyDown.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | true |
cancelable | true in AIR, false in Flash Player; in AIR, l'annullamento di questo evento impedisce l'immissione del carattere in un campo di testo. |
charCode | Il valore del codice di carattere del tasto premuto o rilasciato. |
commandKey | true in Mac se il tasto Comando è attivo. Altrimenti false |
controlKey | true in Windows e Linux se il tasto Ctrl è attivo. true in Mac se il tasto Ctrl è attivo. Altrimenti false |
ctrlKey | true in Windows e Linux se il tasto Ctrl è attivo. true in Mac se il tasto Ctrl o il tasto Comando è attivo. Altrimenti false. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
keyCode | Il valore del codice tasto del tasto premuto o rilasciato. |
keyLocation | La posizione del tasto sulla tastiera. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
target | L'istanza InteractiveObject attivata. 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. |
keyUp | Evento |
flash.events.KeyboardEventproprietà KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Inviato quando l'utente rilascia un tasto.
Le mappature tra tasti e caratteri specifici variano a seconda del dispositivo e del sistema operativo. Questo tipo di evento viene generato dopo una tale mappatura ma prima dell'elaborazione di un IME (input method editor). Gli IME vengono utilizzati per immettere i caratteri non supportati dalla tastiera QWERTY standard (ad esempio gli ideogrammi cinesi).
Questo evento si verifica dopo un evento keyDown.
Non viene inviato per tutti i tasti. I tasti che determinano l'invio dell'evento variano a seconda della piattaforma.
La costanteKeyboardEvent.KEY_UP definisce il valore della proprietà type di un oggetto evento keyUp.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | true |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
charCode | Contiene il valore del codice di carattere del tasto premuto o rilasciato. |
commandKey | true in Mac se il tasto Comando è attivo. Altrimenti false |
controlKey | true in Windows e Linux se il tasto Ctrl è attivo. true in Mac se il tasto Ctrl è attivo. Altrimenti false |
ctrlKey | true in Windows se il tasto Ctrl è attivo. true in Mac se il tasto Ctrl o il tasto Comando è attivo. Altrimenti false. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
keyCode | Il valore del codice tasto del tasto premuto o rilasciato. |
keyLocation | La posizione del tasto sulla tastiera. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
target | L'istanza InteractiveObject attivata. 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. |
softKeyboardActivate | Evento |
flash.events.SoftKeyboardEventproprietà SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Inviato dopo l'attivazione della tastiera software, a seguito dell'acquisizione dello stato di attivazione dell'oggetto StageText.
La costanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE definisce il valore della proprietà type dell'oggetto SoftKeyboardEvent quando viene visualizzata una tastiera software. Per questo evento, cancellable = false.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
relatedObjectVal | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
triggerTypeVal | Indica se l'evento keyboard è stato inviato da un'applicazione o un utente. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
softKeyboardActivating | Evento |
flash.events.SoftKeyboardEventproprietà SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Inviato prima dell'attivazione della tastiera software, a seguito dell'acquisizione dello stato di attivazione dell'oggetto StageText.
La costanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING definisce il valore della proprietà type dell'oggetto SoftKeyboardEvent immediatamente prima della visualizzazione di una tastiera software. Per questo evento, cancellable = true.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | true a meno che l'evento non venga inviato da un oggetto StageText. Per gli oggetti StageText, l'evento non è annullabile. |
relatedObjectVal | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
triggerTypeVal | Indica se l'evento keyboard è stato inviato da un'applicazione o un utente. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
softKeyboardDeactivate | Evento |
flash.events.SoftKeyboardEventproprietà SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Inviato dopo la disattivazione della tastiera software, a seguito della perdita dello stato di attivazione dell'oggetto StageText.
La costanteSoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE definisce il valore della proprietà type dell'oggetto SoftKeyboardEvent quando una tastiera software viene chiusa o nascosta. Per questo evento, cancellable = false.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
relatedObjectVal | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
triggerTypeVal | Indica se l'evento keyboard è stato inviato da un'applicazione o un utente. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
Tue Jun 12 2018, 02:44 PM Z