Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
flashx.textLayout.conversion 

ITextImporter  - AS3

Pacchettoflashx.textLayout.conversion
Interfacciapublic interface ITextImporter

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Interfaccia per l'importazione di contenuto in formato testo in un oggetto TextFlow da un'origine esterna. La classe TextConverter crea importatori con nessun argomento costruttore.

Vedere gli esempi

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
  configuration : IConfiguration
La proprietà configuration contiene l'istanza IConfiguration che occorre all'importatore quando crea le nuove istanze TextFlow.
ITextImporter
  errors : Vector.<String>
[sola lettura] Questa proprietà contiene un vettore di messaggi di errore come stringhe dopo una chiamata a un metodo importatore se la proprietà throwOnError è impostata su false, che è il valore predefinito.
ITextImporter
  throwOnError : Boolean
La proprietà throwOnError controlla il modo in cui l'importatore gestisce gli errori.
ITextImporter
  useClipboardAnnotations : Boolean
Controlla se l'importatore deve gestire o meno le informazioni aggiuntive necessarie per gli Appunti.
ITextImporter
Metodi pubblici
 MetodoDefinito da
  
Importa contenuto in formato testo da un'origine esterna e lo converte in un oggetto TextFlow.
ITextImporter
Descrizione delle proprietà

configuration

proprietà
configuration:IConfiguration

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10.2, AIR 2.0

La proprietà configuration contiene l'istanza IConfiguration che occorre all'importatore quando crea le nuove istanze TextFlow. Questa proprietà è inizialmente impostata su null.



Implementazione
    public function get configuration():IConfiguration
    public function set configuration(value:IConfiguration):void

Elementi API correlati

errors

proprietà 
errors:Vector.<String>  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Questa proprietà contiene un vettore di messaggi di errore come stringhe dopo una chiamata a un metodo importatore se la proprietà throwOnError è impostata su false, che è il valore predefinito. In assenza di errori, la proprietà restituisce null. La proprietà viene ripristinata a ogni chiamata del metodo.



Implementazione
    public function get errors():Vector.<String>

throwOnError

proprietà 
throwOnError:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

La proprietà throwOnError controlla il modo in cui l'importatore gestisce gli errori. Se è impostata su true, i metodi generano un'istanza Error per ogni errore. Se è impostata su false (valore predefinito), gli errori vengono raccolti in un vettore di stringhe e memorizzati nella proprietà errors, e l'importatore non genera errori.



Implementazione
    public function get throwOnError():Boolean
    public function set throwOnError(value:Boolean):void

useClipboardAnnotations

proprietà 
useClipboardAnnotations:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Controlla se l'importatore deve gestire o meno le informazioni aggiuntive necessarie per gli Appunti. I dati provenienti dagli Appunti potrebbero contenere paragrafi parziali, paragrafi in cui manca il carattere di terminazione o di nuova riga. Se useClipboardAnnotations è true, l'importatore contrassegna questi paragrafi parziali con l'attributo ConverterBase.MERGE_TO_NEXT_ON_PASTE. In questo modo l'operazione Incolla gestisce correttamente l'unione nel testo del paragrafo incollato (e di eventuali elementi list o div che includono il paragrafo).



Implementazione
    public function get useClipboardAnnotations():Boolean
    public function set useClipboardAnnotations(value:Boolean):void

Elementi API correlati

flashx.textLayout.conversion.ConverterBase.MERGE_TO_NEXT_ON_PASTE
Descrizione dei metodi

importToFlow

()metodo
public function importToFlow(source:Object):flashx.textLayout.elements:TextFlow

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Importa contenuto in formato testo da un'origine esterna e lo converte in un oggetto TextFlow.

Parametri

source:Object — I dati da convertire.

Restituisce
flashx.textLayout.elements:TextFlow — TextFlow creato dall'origine.
ITextImporterExample.as

Questo frammento di codice mostra un utilizzo possibile del metodo ITextImporter per eseguire ripetutamente importazioni di testo formattato. Come potete notare, gli errori vengono cancellati all'inizio di ogni chiamata a importToFlow.

package flashx.textLayout.conversion.examples
{
    import flashx.textLayout.conversion.ITextImporter;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.elements.TextFlow;
    
    public class ITextImporterExample 
    {
        // Create a new TextFlow based on the markup string
        static public function importAndCheckErrors():TextFlow
        {
            var markup:String = "<TextFlow xmlns='http://ns.adobe.com/textLayout/2008'><p><span>Hello, World</span></p></TextFlow>";
            var importer:ITextImporter = TextConverter.getImporter(TextConverter.TEXT_LAYOUT_FORMAT);
            importer.throwOnError = false;
            var textFlow:TextFlow = importer.importToFlow(markup);
            if (!textFlow)
            {
                var errors:Vector.<String> = importer.errors;
                //deal with import errors
            }
            return textFlow;
        }
    }
}




[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.