Pacchetto | flash.text |
Classe | public class TextSnapshot |
Ereditarietà | TextSnapshot Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Non è necessario utilizzare una funzione di costruzione per creare un oggetto TextSnapshot, poiché viene restituito dalla proprietà flash.display.DisplayObjectContainer.textSnapshot
.
Elementi API correlati
Proprietà | Definito da | ||
---|---|---|---|
charCount : int [sola lettura]
Il numero di caratteri presenti in un oggetto TextSnapshot. | TextSnapshot | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object |
Metodo | Definito da | ||
---|---|---|---|
Cerca l'oggetto TextSnapshot specificato e restituisce la posizione della prima occorrenza di textToFind trovata in corrispondenza o dopo indiceIniziale. | TextSnapshot | ||
Restituisce un valore booleano che specifica se un oggetto TextSnapshot contiene il testo selezionato nell'intervallo specificato. | TextSnapshot | ||
Restituisce una stringa che contiene tutti i caratteri specificati dal metodo setSelected() corrispondente. | TextSnapshot | ||
Restituisce una stringa che contiene tutti i caratteri specificati dai parametri indiceIniziale e indiceFinale. | TextSnapshot | ||
Restituisce un array di oggetti che contiene informazioni su una sequenza di testo. | TextSnapshot | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Consente di determinare quale carattere all'interno di un oggetto TextSnapshot si trova sopra o vicino alle coordinate x e y specificate del clip filmato che contiene il testo nell'oggetto TextSnapshot. | TextSnapshot | ||
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 | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Specifica il colore da utilizzare per evidenziare i caratteri selezionati mediante il metodo setSelected(). | TextSnapshot | ||
Specifica un intervallo di caratteri da selezionare o deselezionare in un oggetto TextSnapshot. | TextSnapshot | ||
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 |
charCount | proprietà |
findText | () | metodo |
public function findText(beginIndex:int, textToFind:String, caseSensitive:Boolean):int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cerca l'oggetto TextSnapshot specificato e restituisce la posizione della prima occorrenza di textToFind
trovata in corrispondenza o dopo beginIndex
. Se textToFind
non viene trovato, il metodo restituisce -1
.
Parametri
beginIndex:int — Specifica il punto di partenza dal quale iniziare a cercare il testo specificato.
| |
textToFind:String — Specifica il testo da cercare. Se specificate un carattere letterale per la stringa, anziché una variabile di tipo String, racchiudere la stringa tra virgolette.
| |
caseSensitive:Boolean — Specifica se il testo deve rispettare le maiuscole/minuscole della stringa textToFind .
|
int — La posizione dell'indice a base zero della prima occorrenza del testo specificato, oppure -1.
|
Elementi API correlati
getSelected | () | metodo |
public function getSelected(beginIndex:int, endIndex:int):Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce un valore booleano che specifica se un oggetto TextSnapshot contiene il testo selezionato nell'intervallo specificato.
Per eseguire la ricerca in tutti i caratteri, passare il valore 0
per start
e charCount
(o qualunque numero molto elevato) per end
. Per cercare un singolo carattere, passate al parametro end
un valore maggiore del parametro start
.
Parametri
beginIndex:int — Indica la posizione del primo carattere da esaminare. I valori validi per beginIndex vanno da 0 a TextSnapshot.charCount - 1 . Se beginIndex è un valore negativo, viene utilizzato 0 .
| |
endIndex:int — Un valore che rappresenta la posizione di indice maggiore dell'ultimo carattere da esaminare. I valori validi per endIndex vanno da 0 a charCount . Il carattere indicizzato dal parametro endIndex non è compreso nella stringa estratta. Se si omette questo parametro, viene utilizzato charCount . Se questo valore è minore o uguale al valore di beginIndex , viene utilizzato beginIndex + 1 .
|
Boolean — Un valore booleano che indica se almeno un carattere nell'intervallo specificato è stato selezionato dal corrispondente metodo setSelected() (true ); false in caso contrario.
|
Elementi API correlati
getSelectedText | () | metodo |
public function getSelectedText(includeLineEndings:Boolean = false):String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9., Flash Lite 4 |
Restituisce una stringa che contiene tutti i caratteri specificati dal metodo setSelected()
corrispondente. Se non è specificato alcun carattere (dal metodo setSelected()
), viene restituita una stringa vuota.
Se si passa true
per includeLineEndings
, i caratteri newline vengono inseriti nella stringa, cosicché la stringa restituita può essere più lunga dell'intervallo di input. Se includeLineEndings
è false
oppure è stato omesso, il testo selezionato viene restituito senza che venga aggiunto alcun carattere.
Parametri
includeLineEndings:Boolean (default = false ) — Un valore booleano opzionale che specifica se i caratteri newline inseriti nella stringa restituita erano appropriati. Il valore predefinito è false .
|
String — Una stringa che contiene tutti i caratteri specificati dal comando setSelected() corrispondente.
|
Elementi API correlati
getText | () | metodo |
public function getText(beginIndex:int, endIndex:int, includeLineEndings:Boolean = false):String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9., Flash Lite 4 |
Restituisce una stringa che contiene tutti i caratteri specificati dai parametri beginIndex
e endIndex
. Se non è selezionato alcun carattere, viene restituita una stringa vuota.
Per restituire tutti i caratteri, passare il valore 0
per beginIndex
e charCount
(o qualunque numero molto elevato) per endIndex
. Per restituire un singolo carattere, passare il valore beginIndex + 1
per endIndex
.
Se si passa un valore true
per includeLineEndings
, i caratteri newline vengono inseriti nella stringa nei punti considerati appropriati. In tal caso, la stringa restituita può essere più lunga dell'intervallo di input. Se includeLineEndings
è false
oppure è stato omesso, il testo selezionato viene restituito senza che vanga aggiunto alcun carattere.
Parametri
beginIndex:int — Indica la posizione del primo carattere da includere nella stringa restituita. I valori validi per beginIndex vanno da 0 a charCount - 1 . Se beginIndex è un valore negativo, viene utilizzato 0 .
| |
endIndex:int — Un valore che rappresenta la posizione di indice maggiore dell'ultimo carattere da esaminare. I valori validi per endIndex vanno da 0 a charCount . Il carattere indicizzato dal parametro endIndex non è compreso nella stringa estratta. Se si omette questo parametro, viene utilizzato charCount . Se questo valore è minore o uguale al valore di beginIndex , viene utilizzato beginIndex + 1 .
| |
includeLineEndings:Boolean (default = false ) — Un valore booleano opzionale che specifica se i caratteri newline vengono inseriti (true ) o meno (false ) nella stringa restituita. Il valore predefinito è false .
|
String — Una stringa che contiene i caratteri nell'intervallo specificato oppure una stringa vuota se nell'intervallo specificato non viene trovato alcun carattere.
|
Elementi API correlati
getTextRunInfo | () | metodo |
public function getTextRunInfo(beginIndex:int, endIndex:int):Array
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce un array di oggetti che contiene informazioni su una sequenza di testo. Ogni oggetto corrisponde a un carattere dell'intervallo di caratteri specificato dai due parametri del metodo.
Nota: l'uso del metodo getTextRunInfo()
per un intervallo di testo esteso può restituire un oggetto di grandi dimensioni. Adobe consiglia di limitare l'intervallo di testo definito dai parametri beginIndex
e endIndex
.
Parametri
beginIndex:int — Il valore di indice del primo carattere di un intervallo di caratteri in un oggetto TextSnapshot.
| |
endIndex:int — Il valore di indice dell'ultimo carattere di un intervallo di caratteri in un oggetto TextSnapshot.
|
Array — Un array di oggetti in cui ogni oggetto contiene informazioni su un carattere specifico nell'intervallo di caratteri indicato dai parametri beginIndex e endIndex . Ogni oggetto contiene le undici proprietà seguenti:
|
Elementi API correlati
hitTestTextNearPos | () | metodo |
public function hitTestTextNearPos(x:Number, y:Number, maxDistance:Number = 0):Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9., Flash Lite 4 |
Consente di determinare quale carattere all'interno di un oggetto TextSnapshot si trova sopra o vicino alle coordinate x
, y
specificate del clip filmato che contiene il testo nell'oggetto TextSnapshot.
Se si omette o si passa il valore 0
per maxDistance
, la posizione specificata dalle coordinate x
e y
deve trovarsi all'interno del riquadro di delimitazione dell'oggetto TextSnapshot.
Questo metodo funziona correttamente solo con i caratteri che includono le informazioni sulla metrica dei caratteri; per impostazione predefinita, lo strumento di creazione Flash non include queste informazioni per i campi di testo statici. Questo metodo potrebbe quindi restituire -1
anziché un valore di indice. Per garantire che venga restituito un valore di indice, è possibile fare in modo che lo strumento di creazione Flash includa le informazioni sulle metriche di un carattere. A questo scopo, aggiungete un campo di testo dinamico che utilizza il carattere, selezionate Opzioni per i caratteri per il campo di testo dinamico aggiunto, quindi specificate che i profili di carattere devono essere incorporati per almeno un carattere. (Non ha importanza quali caratteri vengono specificati, né che si tratti dei caratteri utilizzati nei campi di testo statici in questione.)
Parametri
x:Number — Un numero che rappresenta la coordinata x del clip filmato contenente il testo.
| |
y:Number — Un numero che rappresenta la coordinata y del clip filmato contenente il testo.
| |
maxDistance:Number (default = 0 ) — Un numero opzionale che rappresenta la distanza massima da x , y nella quale è possibile cercare testo. La distanza viene misurata dal punto centrale di ciascun carattere. Il valore predefinito è 0 .
|
Number — Un numero che rappresenta il valore di indice del carattere che si trova più vicino alla coordinata x , y specificata. Restituisce -1 se non viene trovato alcun carattere o se il carattere non contiene le informazioni sulle metriche del carattere.
|
Elementi API correlati
setSelectColor | () | metodo |
public function setSelectColor(hexColor:uint = 0xFFFF00):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9., Flash Lite 4 |
Specifica il colore da utilizzare per evidenziare i caratteri selezionati mediante il metodo setSelected()
. Il colore è sempre opaco; non è possibile specificare un valore di trasparenza.
Questo metodo funziona correttamente solo con i caratteri che includono le informazioni sulla metrica dei caratteri; per impostazione predefinita, lo strumento di creazione Flash non include queste informazioni per i campi di testo statici. Questo metodo potrebbe quindi restituire -1
anziché un valore di indice. Per garantire che venga restituito un valore di indice, è possibile fare in modo che lo strumento di creazione Flash includa le informazioni sulle metriche di un carattere. A questo scopo, aggiungete un campo di testo dinamico che utilizza il carattere, selezionate Opzioni per i caratteri per il campo di testo dinamico aggiunto, quindi specificate che i profili di carattere devono essere incorporati per almeno un carattere. Non ha importanza quali caratteri vengono specificati, né che si tratti dei caratteri utilizzati nei campi di testo statici in questione.
Parametri
hexColor:uint (default = 0xFFFF00 ) — Il colore utilizzato per il bordo collocato intorno ai caratteri che sono stati selezionati mediante il comando setSelected() corrispondente, espresso in formato esadecimale (0x RRGGBB).
|
Elementi API correlati
setSelected | () | metodo |
public function setSelected(beginIndex:int, endIndex:int, select:Boolean):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9., Flash Lite 4 |
Specifica un intervallo di caratteri da selezionare o deselezionare in un oggetto TextSnapshot. Dietro ai caratteri selezionati viene disegnato un rettangolo colorato, che corrisponde al riquadro di delimitazione del carattere. Il colore del riquadro di delimitazione è definito da setSelectColor()
.
Per selezionare o deselezionare tutti i caratteri, passate il valore 0
per beginIndex
e charCount
(o qualunque numero molto elevato) per endIndex
. Per specificare un singolo carattere, passate il valore start + 1
per endIndex
.
Dal momento che i caratteri selezionati sono contrassegnati singolarmente, è possibile chiamare questo metodo più volte per selezionare più caratteri; in altre parole, l'uso di questo metodo non deseleziona gli altri caratteri eventualmente impostati dal metodo stesso.
Il rettangolo colorato che indica una selezione viene visualizzato solo con i caratteri che includono le informazioni sulla metrica dei caratteri; per impostazione predefinita, Flash non include queste informazioni per i campi di testo statici. In alcuni casi, questo comportamento indica che il testo selezionato non appare come selezionato sullo schermo. Per garantire che tutto il testo selezionato appaia selezionato, è possibile impostare lo strumento di creazione Flash in modo da imporre l'inclusione delle informazioni sulle metriche di un carattere. A questo scopo, aggiungete un campo di testo dinamico che utilizza il carattere, selezionate Opzioni per i caratteri per il campo di testo dinamico aggiunto, quindi specificate che i profili di carattere devono essere incorporati per almeno un carattere. Non ha importanza quali caratteri vengono specificati e nemmeno se si tratta dei caratteri utilizzati nei campi di testo statici in questione.
Parametri
beginIndex:int — Indica la posizione del primo carattere da selezionare. I valori validi per beginIndex vanno da 0 a charCount - 1 . Se beginIndex è un valore negativo, viene utilizzato 0 .
| |
endIndex:int — Un numero intero corrispondente al valore 1+ l'indice dell'ultimo carattere da esaminare. I valori validi per end vanno da 0 a charCount . Il carattere indicizzato dal parametro end non è compreso nella stringa estratta. Se si omette questo parametro, viene usato TextSnapshot.charCount . Se il valore di beginIndex è minore o uguale al valore di endIndex , viene utilizzato beginIndex + 1 .
| |
select:Boolean — Un valore booleano che specifica se il testo deve essere selezionato (true ) o deselezionato (false ).
|
Elementi API correlati
Tue Jun 12 2018, 02:44 PM Z