Pakket | flashx.textLayout.conversion |
Klasse | public class TextConverter |
Overerving | TextConverter Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
De indeling van de geconverteerde gegevens is niet vooraf gedefinieerd. Door de gebruiker geschreven converters kunnen elke gewenste indeling accepteren en retourneren. Veelvoorkomende indelingen zijn tekenreeksen, XML en ByteArray-instanties. Auteurs van converters moeten documenteren welke indelingen worden ondersteund.
Meer voorbeelden
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
numFormats : int [statisch] [alleen-lezen] Aantal indelingen. | TextConverter |
Methode | Gedefinieerd door | ||
---|---|---|---|
[statisch]
Registreer een nieuwe indeling voor importeren/exporteren. | TextConverter | ||
addFormatAt(index:int, format:String, importerClass:Class, exporterClass:Class = null, clipboardFormat:String = null):void [statisch]
Registreer een nieuwe indeling voor importeren/exporteren op de opgegeven locatie. | TextConverter | ||
[statisch]
Exporteert een TextFlow naar een opgegeven indeling. | TextConverter | ||
[statisch]
Maakt en retourneert een exportconverter die u vervolgens kunt gebruiken om gegevens uit een TextFlow te exporteren naar een brontekenreeks of een XML-object. | TextConverter | ||
[statisch] Retourneert de indelingsnaam voor de indeling op indexpositie. | TextConverter | ||
[statisch] Retourneert de FormatDescriptor voor de indeling op indexpositie. | TextConverter | ||
[statisch]
Maakt en retourneert een importconverter die u vervolgens kunt gebruiken voor het importeren van een brontekenreeks, een XML-object of door de gebruiker gedefinieerde gegevens naar een TextFlow. | TextConverter | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
importToFlow(source:Object, format:String, config:IConfiguration = null):flashx.textLayout.elements:TextFlow [statisch]
Maakt een TextFlow van de broninhoud in een opgegeven indeling. | TextConverter | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
[statisch]
Verwijder de opmaak. | TextConverter | ||
[statisch]
Verwijder de indeling op de indexlocatie. | TextConverter | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object |
Constante | Gedefinieerd door | ||
---|---|---|---|
PLAIN_TEXT_FORMAT : String = "plainTextFormat" [statisch]
Onbewerkte-tekstindeling. | TextConverter | ||
TEXT_FIELD_HTML_FORMAT : String = "textFieldHTMLFormat" [statisch]
HTML-indeling. | TextConverter | ||
TEXT_LAYOUT_FORMAT : String = "textLayoutFormat" [statisch]
TextLayout-indeling. | TextConverter |
numFormats | eigenschap |
addFormat | () | methode |
public static function addFormat(format:String, importerClass:Class, exporterClass:Class, clipboardFormat:String):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Registreer een nieuwe indeling voor importeren/exporteren. De nieuwe indeling wordt aan het einde toegevoegd, met de laagste prioriteit. Locatie kan significant zijn voor clients met meerdere mogelijkheden voor de te gebruiken indeling, bijvoorbeeld bij het importeren van het externe Klembord. De nieuwe indeling biedt mogelijk ondersteuning voor importeren en/of exporteren. Als de indeling al is toegevoegd, is deze op meerdere locaties aanwezig. De indeling die als eerste wordt gevonden, wordt gebruikt.
Parameters
format:String — De importconverterklasse voor registratie of null
| |
importerClass:Class — De exportconverterklasse voor registratie of null
| |
exporterClass:Class — De indelingstekensreeks die converterklassen tagt. Indelingen kunnen elke naam hebben, maar deze naam moet wel uniek zijn.
| |
clipboardFormat:String — De tekenreeks die als Klembord-indeling wordt gebruikt bij conversies naar/van het Klembord. Maak dit null als de indeling toegang tot het Klembord niet ondersteunt.
|
addFormatAt | () | methode |
public static function addFormatAt(index:int, format:String, importerClass:Class, exporterClass:Class = null, clipboardFormat:String = null):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Registreer een nieuwe indeling voor importeren/exporteren op de opgegeven locatie. Locatie kan significant zijn voor clients met meerdere mogelijkheden voor de te gebruiken indeling, bijvoorbeeld bij het importeren van het externe Klembord. Lagere getallen duiden op een hogere prioriteit. Deze converters worden eerst geprobeerd. De nieuwe indeling biedt mogelijk ondersteuning voor importeren en/of exporteren. Als de indeling al is toegevoegd, is deze op meerdere locaties aanwezig. De indeling die als eerste wordt gevonden, wordt gebruikt.
Parameters
index:int — De importconverterklasse voor registratie of null
| |
format:String — De exportconverterklasse voor registratie of null
| |
importerClass:Class — De indelingstekensreeks die converterklassen tagt
| |
exporterClass:Class (default = null ) — De tekenreeks die als Klembord-indeling wordt gebruikt bij conversies naar/van het Klembord. Maak dit null als de indeling toegang tot het Klembord niet ondersteunt.
| |
clipboardFormat:String (default = null )
|
export | () | methode |
public static function export(source:flashx.textLayout.elements:TextFlow, format:String, conversionType:String):Object
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Exporteert een TextFlow naar een opgegeven indeling.
Gebruik een van de statische constanten die worden verstrekt met deze klasse, een MIME-type of een door gebruikers gedefinieerde indeling voor door gebruikers gedefinieerde exporters om de parameter format
op te geven:
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
Geef het type voor de geëxporteerde gegevens in de parameter conversionType
op met een van de statische constanten verstrekt door de klasse ConversionType, of een door gebruikers gedefinieerd gegevenstype voor door gebruikers gedefinieerde exporters:
- ConversionType.STRING_TYPE
- ConversionType.XML_TYPE
Parameters
source:flashx.textLayout.elements:TextFlow — Broninhoud
| |
format:String — Indeling van uitgevoerde gegevens
| |
conversionType:String — Type van geëxporteerde gegevens
|
Object — Uit de TextFlow geëxporteerd object, of null bij fouten
|
Verwante API-elementen
getExporter | () | methode |
public static function getExporter(format:String):flashx.textLayout.conversion:ITextExporter
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Maakt en retourneert een exportconverter die u vervolgens kunt gebruiken om gegevens uit een TextFlow te exporteren naar een brontekenreeks of een XML-object. Gebruik deze functie als u veel afzonderlijke exportacties moet uitvoeren. Equivalent aan het oproepen van flashx.textLayout.conversion.TextConverter.export()
.
U kunt de parameter format
opgeven met een van de statische constanten die bij deze klasse horen:
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
Als de indeling meerdere keren is toegevoegd, wordt de eerste gevonden indeling gebruikt.
Parameters
format:String — Doelindeling voor de geëxporteerde gegevens
|
flashx.textLayout.conversion:ITextExporter — ITextExporter-tekstexporter die gegevens kan exporteren naar de opgegeven indeling
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Dit codefragment toont een manier waarop de methode getExporter
kan worden gebruikt voor het herhaaldelijk exporteren van opgemaakte tekst.
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 | () | methode |
getFormatDescriptorAt | () | methode |
public static function getFormatDescriptorAt(index:int):FormatDescriptor
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Retourneert de FormatDescriptor voor de indeling op indexpositie.
Parameters
index:int |
FormatDescriptor |
getImporter | () | methode |
public static function getImporter(format:String, config:IConfiguration = null):flashx.textLayout.conversion:ITextImporter
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Maakt en retourneert een importconverter die u vervolgens kunt gebruiken voor het importeren van een brontekenreeks, een XML-object of door de gebruiker gedefinieerde gegevens naar een TextFlow. Gebruik deze methode als u veel afzonderlijke importacties moet uitvoeren of als u fouten tijdens het importeren wilt verwerken. Equivalent aan het oproepen van flashx.textLayout.conversion.TextConverter.importToFlow()
.
Gebruik een van de statische constanten uit deze klasse om de parameter format
, een MIME-type of een door de gebruiker gedefinieerde indeling te definiëren.
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
Als de indeling meerdere keren is toegevoegd, wordt de eerste gevonden indeling gebruikt.
Parameters
format:String — Indeling van de broninhoud. Gebruik constanten uit flashx.textLayout.conversion.TextConverter.TEXT_LAYOUT_FORMAT, PLAIN_TEXT_FORMAT, TEXT_FIELD_HTML_FORMAT, enzovoort, een MIME-type of een door de gebruiker gedefinieerde indeling.
| |
config:IConfiguration (default = null ) — tijdens deze importactie te gebruiken configuratie. null betekent dat de huidige standaard wordt gebruikt. U kunt de configuratie ook instellen via de eigenschap ITextImporter.configuration .
|
flashx.textLayout.conversion:ITextImporter — ITextImporter-tekstimporter die de brongegevens kan importeren
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Dit codefragment toont een manier waarop de methode getImporter
kan worden gebruikt voor het herhaaldelijk exporteren van opgemaakte tekst. Fouten worden gewist aan het begin van elke aanroep naar 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 | () | methode |
public static function importToFlow(source:Object, format:String, config:IConfiguration = null):flashx.textLayout.elements:TextFlow
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Maakt een TextFlow van de broninhoud in een opgegeven indeling.
Gebruik een van de statische constanten die worden verstrekt met deze klasse, een MIME-type, om de parameter format
aan te geven of gebruik een door gebruikers gedefinieerde waarde voor door gebruikers geregistreerde importers:
- TextConverter.TEXT_FIELD_HTML_FORMAT
- TextConverter.PLAIN_TEXT_FORMAT
- TextConverter.TEXT_LAYOUT_FORMAT
Parameters
source:Object — Broninhoud
| |
format:String — Indeling van de broninhoud
| |
config:IConfiguration (default = null ) — Te gebruiken IConfiguration bij het maken van nieuwe TextFlows
|
flashx.textLayout.elements:TextFlow — TextFlow die is gemaakt van de bron, of null bij fouten.
|
Verwante API-elementen
removeFormat | () | methode |
public static function removeFormat(format:String):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Verwijder de opmaak. Als een indeling meerdere keren is toegevoegd, wordt alleen de eerste gevonden indeling verwijderd.
Parameters
format:String — De indelingstekenreeks voor converters die moet worden verwijderd
|
removeFormatAt | () | methode |
PLAIN_TEXT_FORMAT | Constante |
public static const PLAIN_TEXT_FORMAT:String = "plainTextFormat"
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Onbewerkte-tekstindeling. Te gebruiken voor het maken van een TextFlow op basis van een eenvoudige tekenreeks zonder opmaak of voor het maken van een eenvoudige tekenreeks zonder opmaak op basis van een TextFlow.
TEXT_FIELD_HTML_FORMAT | Constante |
public static const TEXT_FIELD_HTML_FORMAT:String = "textFieldHTMLFormat"
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
HTML-indeling. Te gebruiken voor het importeren uit of exporteren naar een TextFlow met de HTML-indeling. Text Layout Framework-HTML ondersteunt een subset van labels en kenmerken die worden ondersteund door de TextField-klasse in het flash.text
-pakket.
De volgende tabel geeft de HTML-labels en -kenmerken weer die worden ondersteund voor het importeren en exporteren (labels en kenmerken ondersteund door TextField, maar niet door Text Layout Framework worden specifiek omschreven als niet ondersteund):
Tag | Beschrijving |
---|---|
Tag voor anker |
De tag <a> maakt een hyperlink en ondersteunt de volgende kenmerken:
|
Tag voor vette tekst |
Met de tag <b> wordt tekst vet weergegeven. Er moet wel een vet lettertype beschikbaar zijn voor de weergave van de tekst.
|
Tag voor regeleinde |
De tag <br> maakt een regeleinde in de tekst.
|
Tag voor lettertype |
De tag <font> geeft een lettertype of lijst met lettertypen op voor weergave van de tekst. De tag font ondersteunt de volgende kenmerken:
|
Tag voor afbeelding |
Met de tag <img> kunt u externe afbeeldingsbestanden (JPEG, GIF, PNG), SWF-bestanden en filmclips in tekst insluiten.
De tag
Opmerking: in tegenstelling tot de TextField-klasse, worden de volgende kenmerken niet ondersteund: |
Tag voor cursieve tekst |
Met de tag <i> wordt de tekst tussen tags cursief weergegeven. Er moet wel een cursief lettertype beschikbaar zijn voor de weergave van de tekst.
|
Tag voor lijstitem | Opmerking: in tegenstelling tot de TextField-klasse, wordt de tag voor lijstitem niet ondersteund. |
Tag voor alinea |
De tag <p> voegt een nieuwe alinea in. De tag <p> ondersteunt de volgende kenmerken:
|
Tag voor bereik |
De tag <span> ondersteunt de volgende kenmerken:
|
Tag voor tekstopmaak |
Met de tag De tag
|
Tag voor onderstreping |
Met de tag <u> wordt de tekst tussen tags onderstreept weergegeven.
|
Wanneer een onbekende tag wordt geïmporteerd, stelt de textFieldHTMLFormat
-importer de typeName-eigenschap van één FlowElement in op die tagnaam of maakt het een DivElement of SubParagraphGroupElement waarvoor de typeName-eigenschap is ingesteld op de tagnaam.
De exporter textFieldHTMLFormat
exporteert typeName
als de XML-tag wanneer deze afwijkt van de standaard.
Verwante API-elementen
TEXT_LAYOUT_FORMAT | Constante |
public static const TEXT_LAYOUT_FORMAT:String = "textLayoutFormat"
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
TextLayout-indeling. Te gebruiken voor het importeren uit of exporteren naar een TextFlow met de TextLayout Markup-indeling. TextLayout-indeling zal de volgende fouten vaststellen:
- Onverwachte naamruimte
- Onbekend element
- Onbekend kenmerk
Dit voorbeeld illustreert een manier waarop de conversieklasse TextConverter
kan worden gebruikt. Tekst in een standaardopmaakindeling wordt geïmporteerd in een TextFlow
-object en vervolgens weergegeven. De tekst wordt vervolgens geëxporteerd naar XML-indeling.
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; } } }
Wed Jun 13 2018, 11:42 AM Z