Pacchetto | flashx.textLayout.conversion |
Classe | public class TextConverter |
Ereditarietà | TextConverter Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Il formato dei dati convertiti non è predefinito; i convertitori scritti dall'utente possono accettare liberamente e restituire qualunque formato. I formati comuni sono stringhe, XML e istanze ByteArray. Gli autori dei convertitori devono documentare i formati supportati.
Altri esempi
Importazione ed esportazione di testo con TLF
Proprietà | Definito da | ||
---|---|---|---|
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
numFormats : int [statico] [sola lettura] Numero di formati. | TextConverter |
Metodo | Definito da | ||
---|---|---|---|
[statico]
Registrate un nuovo formato per l'importazione/esportazione. | TextConverter | ||
addFormatAt(index:int, format:String, importerClass:Class, exporterClass:Class = null, clipboardFormat:String = null):void [statico]
Registrate un nuovo formato per l'importazione/esportazione, nella posizione specificata. | TextConverter | ||
[statico]
Esporta un oggetto TextFlow in un formato specificato. | TextConverter | ||
[statico]
Crea e restituisce un convertitore di esportazione, che potrete quindi utilizzare per l'esportazione da un oggetto TextFlow in una stringa di origine o in un oggetto XML. | TextConverter | ||
[statico] Restituisce il nome di formato per il formato corrispondente al numero di indice. | TextConverter | ||
[statico] Restituisce il FormatDescriptor per il formato corrispondente al numero di indice. | TextConverter | ||
[statico]
Crea e restituisce un convertitore di importazione, che potrete quindi utilizzare per l'importazione in un oggetto TextFlow da una stringa di origine, un oggetto XML o qualunque formato dati definito dall'utente. | TextConverter | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
importToFlow(source:Object, format:String, config:IConfiguration = null):flashx.textLayout.elements:TextFlow [statico]
Crea un oggetto TextFlow dal contenuto di origine in un formato specificato. | TextConverter | ||
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 | ||
[statico]
Rimuove il formato. | TextConverter | ||
[statico]
Rimuove il formato nella posizione di indice. | TextConverter | ||
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 |
Costante | Definito da | ||
---|---|---|---|
PLAIN_TEXT_FORMAT : String = "plainTextFormat" [statico]
Formato testo normale. | TextConverter | ||
TEXT_FIELD_HTML_FORMAT : String = "textFieldHTMLFormat" [statico]
Formato HTML. | TextConverter | ||
TEXT_LAYOUT_FORMAT : String = "textLayoutFormat" [statico]
Formato TextLayout. | TextConverter |
numFormats | proprietà |
addFormat | () | metodo |
public static function addFormat(format:String, importerClass:Class, exporterClass:Class, clipboardFormat:String):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Registrate un nuovo formato per l'importazione/esportazione. Il nuovo formato verrà aggiunto alla fine, con la priorità più bassa. La posizione può essere rilevante per i client che presentano più scelte per il formato da utilizzare, ad esempio per l'importazione dagli Appunti esterni. Il nuovo formato potrebbe supportare l'importazione e/o l'esportazione. Se il formato è già stato aggiunto, sarà presente in più posizioni. Verrà utilizzato il primo formato trovato.
Parametri
format:String — La classe del convertitore di importazione da registrare, oppure null.
| |
importerClass:Class — La classe del convertitore di esportazione da registrare, oppure null.
| |
exporterClass:Class — I tag della stringa di formato per le classi del convertitore. I formati possono avere qualsiasi nome, ma questo deve essere univoco.
| |
clipboardFormat:String — La stringa utilizzata come formato degli Appunti quando si esegue una conversione da o verso gli Appunti. Impostatela come null se il formato non supporta l'accesso agli Appunti.
|
addFormatAt | () | metodo |
public static function addFormatAt(index:int, format:String, importerClass:Class, exporterClass:Class = null, clipboardFormat:String = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Registrate un nuovo formato per l'importazione/esportazione, nella posizione specificata. La posizione può essere rilevante per i client che presentano più scelte per il formato da utilizzare, ad esempio per l'importazione dagli Appunti esterni. I numeri inferiori indicano una priorità maggiore; questi convertitori devono essere provati per primi. Il nuovo formato potrebbe supportare l'importazione e/o l'esportazione. Se il formato è già stato aggiunto, sarà presente in più posizioni. Verrà utilizzato il primo formato trovato.
Parametri
index:int — La classe del convertitore di importazione da registrare, oppure null.
| |
format:String — La classe del convertitore di esportazione da registrare, oppure null.
| |
importerClass:Class — I tag della stringa di formato per le classi del convertitore.
| |
exporterClass:Class (default = null ) — La stringa utilizzata come formato degli Appunti quando si esegue una conversione da o verso gli Appunti. Impostatela come null se il formato non supporta l'accesso agli Appunti.
| |
clipboardFormat:String (default = null )
|
export | () | metodo |
public static function export(source:flashx.textLayout.elements:TextFlow, format:String, conversionType:String):Object
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Esporta un oggetto TextFlow in un formato specificato.
Per specificare il parametro format
, utilizzate una delle quattro costanti statiche fornite con questa classe, un tipo MIME oppure un formato definito dall'utente per gli esportatori definiti dall'utente.
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
Specificate il tipo dei dati esportati nel parametro conversionType
con una delle costanti statiche fornite dalla classe ConversionType, oppure un tipo di dati definito dall'utente per gli esportatori definiti dall'utente:
- ConversionType.STRING_TYPE
- ConversionType.XML_TYPE
Parametri
source:flashx.textLayout.elements:TextFlow — Contenuto di origine
| |
format:String — Formato di output
| |
conversionType:String — Tipo di dati esportati
|
Object — Formato di oggetto esportato di TextFlow, oppure null per gli errori
|
Elementi API correlati
getExporter | () | metodo |
public static function getExporter(format:String):flashx.textLayout.conversion:ITextExporter
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Crea e restituisce un convertitore di esportazione, che potrete quindi utilizzare per l'esportazione da un oggetto TextFlow in una stringa di origine o in un oggetto XML. Utilizzate questa funzione se dovete eseguire molte esportazioni distinte. Equivale a una chiamata a flashx.textLayout.conversion.TextFilter.export()
.
Per specificare il parametro format
, utilizzate una delle costanti statiche fornite con questa classe:
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
Se il formato è stato aggiunto più volte, verrà utilizzato il primo formato trovato.
Parametri
format:String — Formato di destinazione per i dati esportati
|
flashx.textLayout.conversion:ITextExporter — L'esportatore di testo ITextExporter che consente l'esportazione nel formato specificato
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
Questo frammento di codice mostra un utilizzo possibile del metodo getExporter
per eseguire ripetutamente esportazioni di testo formattato.
package flashx.textLayout.conversion.examples { import flashx.textLayout.conversion.ConversionType; import flashx.textLayout.conversion.ITextExporter; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.elements.TextFlow; public class getExporter_example { // Serialize the TextFlow into a String public function export(textFlow:TextFlow):String { var exporter:ITextExporter = TextConverter.getExporter(TextConverter.TEXT_LAYOUT_FORMAT); return exporter.export(textFlow, ConversionType.STRING_TYPE) as String; } } }
getFormatAt | () | metodo |
getFormatDescriptorAt | () | metodo |
public static function getFormatDescriptorAt(index:int):FormatDescriptor
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Restituisce il FormatDescriptor per il formato corrispondente al numero di indice.
Parametri
index:int |
FormatDescriptor |
getImporter | () | metodo |
public static function getImporter(format:String, config:IConfiguration = null):flashx.textLayout.conversion:ITextImporter
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Crea e restituisce un convertitore di importazione, che potrete quindi utilizzare per l'importazione in un oggetto TextFlow da una stringa di origine, un oggetto XML o qualunque formato dati definito dall'utente. Utilizzate questo metodo se dovete eseguire molte importazioni distinte o se desiderate gestire gli errori durante l'importazione. Equivale a una chiamata a flashx.textLayout.conversion.TextConverter.importToFlow()
.
Per specificare il parametro format
, utilizzate una delle costanti statiche fornite con questa classe, un tipo MIME o un formato dati definito dall'utente.
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
Se il formato è stato aggiunto più volte, verrà utilizzato il primo formato trovato.
Parametri
format:String — Formato del contenuto di origine. Utilizzate le costanti di flashx.textLayout.conversion.TextConverter.TEXT_LAYOUT_FORMAT, PLAIN_TEXT_FORMAT, TEXT_FIELD_HTML_FORMAT ecc., un tipo MIME oppure un formato definito dall'utente.
| |
config:IConfiguration (default = null ) — configurazione da utilizzare durante questa importazione. null significa utilizzare i valori predefiniti correnti. Potete impostare la configurazione anche tramite la proprietà ITextImporter.configuration .
|
flashx.textLayout.conversion:ITextImporter — L'importatore di testo ITextImporter che consente l'importazione dei dati di origine
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
Questo frammento di codice mostra un utilizzo possibile del metodo getImporter
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 getImporter_example { 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; } } }
importToFlow | () | metodo |
public static function importToFlow(source:Object, format:String, config:IConfiguration = null):flashx.textLayout.elements:TextFlow
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Crea un oggetto TextFlow dal contenuto di origine in un formato specificato.
Per specificare il parametro format
, utilizzate una delle costanti statiche fornite con questa classe oppure un valore definito dall'utente per gli importatori registrati dall'utente:
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
Parametri
source:Object — Contenuto di origine
| |
format:String — Formato del contenuto di origine
| |
config:IConfiguration (default = null ) — Classe IConfiguration da utilizzare quando si creano nuovi oggetti TextFlow
|
flashx.textLayout.elements:TextFlow — TextFlow creato dall'origine, oppure null per gli errori.
|
Elementi API correlati
removeFormat | () | metodo |
public static function removeFormat(format:String):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Rimuove il formato. Se un formato è stato aggiunto più volte, verrà rimosso solo il primo formato trovato.
Parametri
format:String — La stringa di formato convertitore da rimuovere
|
removeFormatAt | () | metodo |
PLAIN_TEXT_FORMAT | Costante |
public static const PLAIN_TEXT_FORMAT:String = "plainTextFormat"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Formato testo normale. Utilizzate questo filtro per la creazione di un oggetto TextFlow da un semplice oggetto String non formattato o per la creazione di un semplice oggetto String non formattato da un oggetto TextFlow.
TEXT_FIELD_HTML_FORMAT | Costante |
public static const TEXT_FIELD_HTML_FORMAT:String = "textFieldHTMLFormat"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Formato HTML. Utilizzate questo filtro per l'importazione da, o l'esportazione in, un oggetto TextFlow utilizzando il formato HTML. L'HTML Text Layout Framework HTML supporta un sottoinsieme di tag e attributi supportati dalla classe TextField nel pacchetto flash.text
.
Nella seguente tabella sono elencati i tag e gli attributi HTML supportati per i processi di importazione ed esportazione (i tag e gli attributi supportati da TextField, ma non da Text Layout Framework sono espressamente indicati come non supportati):
Tag | Descrizione |
---|---|
Tag di ancoraggio |
Il tag <a> crea un collegamento ipertestuale e supporta i seguenti attributi:
|
Tag del grassetto |
Il tag <b> rende il testo in grassetto. Il tipo di carattere usato per visualizzare il testo deve essere disponibile in stile grassetto.
|
Tag per l'interruzione di riga |
Il tag <br> crea un'interruzione di riga nel testo.
|
Tag del carattere |
Il tag <font> specifica un tipo di carattere o un elenco di tipi di carattere per la visualizzazione del testo. Il tag del carattere supporta gli attributi seguenti:
|
Tag per le immagini |
Il tag <img> consente di incorporare file di immagine (JPEG, GIF, PNG), file SWF e clip filmato esterni all'interno del testo.
Il tag
Nota: a differenza della classe TextField, i seguenti attributi non sono supportati: |
Tag del corsivo |
Il tag <i> visualizza in corsivo il testo a cui viene applicato. Il tipo di carattere usato per visualizzare il testo deve essere disponibile in stile corsivo.
|
Tag per le voci di elenco | Nota: a differenza della classeTextField, il tag per le voci di elenco non è supportato. |
Tag del paragrafo |
Il tag <p> crea un nuovo paragrafo. Il tag <p> supporta i seguenti attributi:
|
Tag SPAN |
Il tag <span> supporta i seguenti attributi:
|
Tag TEXTFORMAT |
Il tag Il tag
|
Tag di sottolineatura |
Il tag <u> sottolinea il testo cui esso è applicato.
|
Quando un tag sconosciuto viene importato, l'importatore textFieldHTMLFormat
imposta una singola proprietà typeName del FlowElement su tale nome di tag oppure crea un DivElement o un SubParagraphGroupElement con la sua proprietà typeName impostata sul nome del tag.
L'esportatore textFieldHTMLFormat
esporta typeName
come tag XML quando è diverso dal valore predefinito.
Elementi API correlati
TEXT_LAYOUT_FORMAT | Costante |
public static const TEXT_LAYOUT_FORMAT:String = "textLayoutFormat"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Formato TextLayout. Utilizzate questo filtro per l'importazione da, o l'esportazione in, un oggetto TextFlow utilizzando il formato codice TextLayout. Il formato TextLayout rileva i seguenti errori:
- Spazio dei nomi imprevisto
- Elemento sconosciuto
- Attributo sconosciuto
In questo esempio è descritto un utilizzo possibile della classe di conversione TextConverter
. Il testo in un formato di codice standard viene importato nell'oggetto TextFlow
e quindi visualizzato. Il testo viene quindi esportato nel formato XML.
package flashx.textLayout.conversion.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.conversion.ConversionType; public class TextConverter_example extends Sprite { public function TextConverter_example() { var markup:String = "<TextFlow xmlns='http://ns.adobe.com/textLayout/2008'><p><span>Hello, World</span></p></TextFlow>"; var textFlow:TextFlow = TextConverter.importToFlow(markup, TextConverter.TEXT_LAYOUT_FORMAT); textFlow.flowComposer.addController(new ContainerController(this, 200, 50)); textFlow.flowComposer.updateAllControllers(); //export to XML var xmlOut:XML = TextConverter.export(textFlow,TextConverter.TEXT_LAYOUT_FORMAT, ConversionType.XML_TYPE) as XML; } } }
Tue Jun 12 2018, 02:44 PM Z