Questo oggetto permette di controllare i campi di testo Input Text inseriti nel filmato. Possiede metodi che ne gestiscono il fuoco e la selezione interna del testo. Questo oggetto non necessita di inizializzazione, dato che è possibile gestire un solo campo di testo alla volta per cui non permette di creare variabili oggetto tramite:
new Selection()
È necessario usare come variabile-oggetto, l'oggetto stesso:
Selection.getFocus();
Settare e conoscere il fuoco
I metodi per gestire queste due operazioni sono rispettivamente, getFocus e setFocus.
Associando il metodo getFocus ad una variabile (o utilizzando l'azione trace)
è possibile conoscere il nome del campo di testo con il fuoco attivo in quel
momento (se non è selezionato nessun campo, il metodo restituisce null).
Con setFocus invece, è possibile impostare il fuoco sul campo di testo indicato
nell'argomento del metodo (tra virgolette).
//Restituisce il campo di testo con fuoco attivo
trace (Selection.getFocus());
//Imposto il fuoco sul campo "nome"
Selection.setFocus("_level0.nome");
Conoscere la posizione del cursore e della selezione
Di un campo di testo, è possibile conoscere anche la posizione del cursore lampeggiante (posizione che varia da 0 a n, restituita dal metodo getCaretIndex) e l'inizio e la fine di una selezione (metodi getBeginIndex e .getEndIndex). Facciamo un esempio...
L'utente digita il proprio nome in un campo di testo nome. Ogni volta che viene digitato un carattere, il valore di getCaretIndex
aumenta di uno (spostandosi il cursore lampeggiante di un carattere). Quindi,
digitando "Carlo" si avrà:
- dopo la "C", 1
- dopo la "a", 2
- dopo la "r", 3
- dopo la "l", 4
- dopo la "o", 5
A questo punto, se l'utente seleziona una parte del testo "Carlo", i valori dei metodi getBeginIndex e .getEndIndex cambieranno in base alla selezione. Ponendo il caso che l'utente selezioni "arl", i valori di getBeginIndex e .getEndIndex restituiranno rispettivamente, 1 e 4, cioè l'inizio della selezione (tenete conto che i valori partono da 0 anziché 1!) e la sua fine.
I 3 metodi visti finora, restituiscono il valore -1 nel caso in cui non vi sia nessun campo di testo selezionato.
Impostare la selezione in un campo di testo
A questo punto è utile sapere che in un campo di testo è possibile anche selezionare un blocco di testo (oltre che, come già visto, conoscerne il valore).
Per fare ciò, si utilizza il metodo:
Selection.setSelection>(inizio, fine);
dove inizio indica l'inizio della selezione da attivare, mentre fine
ne indica la sua fine.
Scarica questo esempio 
