ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flashx.textLayout.conversion 

ITextExporter  - AS3

Paketflashx.textLayout.conversion
Schnittstellepublic interface ITextExporter

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Schnittstelle zum Exportieren von Textinhalten aus einer TextFlow-Instanz in ein angegebenes Format, z. B. String, XML oder benutzerdefiniertes Format. Exportprogramme unterstützen das Abrufen und Festlegen von Eigenschaften, um den Export von Daten zu steuern. Diese Eigenschaften sind als öffentliche Eigenschaften implementiert, der direkte Zugriff sollte jedoch vermieden werden, da das Risiko besteht, dass ein Benutzer die Konverterklasse in der TextConverter-Registrierung ersetzt, was das Fehlschlagen eines Downcast zur Folge hätte.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  errors : Vector.<String>
[schreibgeschützt] Diese Eigenschaft enthält einen Vektor von Fehlermeldungen in Form von Strings nach dem Aufruf einer Exportprogrammmethode, wenn für die throwOnError-Eigenschaft der Wert „false“ (Standardwert) festgelegt wurde.
ITextExporter
  throwOnError : Boolean
Die throwOnError-Eigenschaft steuert, wie das Exportprogramm Fehler verarbeitet.
ITextExporter
  useClipboardAnnotations : Boolean
Die useClipboardAnnotations-Eigenschaft steuert, ob das Importprogramm die für die Zwischenablage erforderlichen zusätzlichen Informationen bearbeiten soll.
ITextExporter
Öffentliche Methoden
 MethodeDefiniert von
  
Exportiert Textinhalt aus einer TextFlow-Instanz in einen String, eine XML oder ein benutzerdefiniertes Format.
ITextExporter
Eigenschaftendetails

errors

Eigenschaft
errors:Vector.<String>  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.2, AIR 2.0

Diese Eigenschaft enthält einen Vektor von Fehlermeldungen in Form von Strings nach dem Aufruf einer Exportprogrammmethode, wenn für die throwOnError-Eigenschaft der Wert false (Standardwert) festgelegt wurde. Wenn keine Fehler aufgetreten sind, gibt die Eigenschaft null zurück. Die Eigenschaft wird jedes Mal, wenn die Methode aufgerufen wird, zurückgesetzt.



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

throwOnError

Eigenschaft 
throwOnError:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.2, AIR 2.0

Die throwOnError-Eigenschaft steuert, wie das Exportprogramm Fehler verarbeitet. Wenn true festgelegt ist, gibt die Methode eine Error-Instanz für Fehler aus. Wenn false (der Standardwert) angegeben wird, werden die Fehler in einem Vektor von Strings gesammelt und in der errors-Eigenschaft gespeichert und das Exportprogramm gibt keine Fehler aus.



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

useClipboardAnnotations

Eigenschaft 
useClipboardAnnotations:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die useClipboardAnnotations-Eigenschaft steuert, ob das Importprogramm die für die Zwischenablage erforderlichen zusätzlichen Informationen bearbeiten soll. Bei Daten, die in einem TextFlow enthalten sind, sind Absätze immer vollständig und enthalten ein Abschlusszeichen. Wenn Text in die Zwischenablage eingefügt wird, wird er in Absätze gegliedert; das Abschlusszeichen am Ende kann jedoch fehlen. Wenn der Absatz in die Zwischenablage eingefügt werden soll, muss er in solchen Fällen als unvollständig markiert werden, damit er beim späteren Einfügen in anderen Text richtig mit diesem zusammengeführt wird. Für Inhalte, die für die Zwischenablage vorgesehen sind, hat useClipboardAnnotations den Wert „true“.



Implementierung
    public function get useClipboardAnnotations():Boolean
    public function set useClipboardAnnotations(value:Boolean):void
Methodendetails

export

()Methode
public function export(source:flashx.textLayout.elements:TextFlow, conversionType:String):Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Exportiert Textinhalt aus einer TextFlow-Instanz in einen String, eine XML oder ein benutzerdefiniertes Format.

Legen Sie für den conversionType-Parameter entweder einen der folgenden Werte fest oder wählen Sie ein benutzerdefiniertes Format in benutzerdefinierten Exportprogrammen.

  • flashx.textLayout.conversion.ConversionType.STRING_TYPE;
  • flashx.textLayout.conversion.ConversionType.XML_TYPE.

Parameter

source:flashx.textLayout.elements:TextFlow — TextFlow, der exportiert werden soll
 
conversionType:String — Gibt einen String (STRING_TYPE), eine XML (XML_TYPE) oder ein benutzerdefiniertes Format zurück.

Rückgabewerte
Object — Object - Der exportierte Inhalt

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Dieses Codefragment zeigt die Verwendung der export-Methode, um wiederholte Exporte formatierten Texts durchzuführen.

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 ITextExporterExample 
    {
        // Serialize the TextFlow into a String
        static public function export(textFlow:TextFlow):String
        {
            var exporter:ITextExporter = TextConverter.getExporter(TextConverter.TEXT_LAYOUT_FORMAT);
            return exporter.export(textFlow, ConversionType.STRING_TYPE) as String;
        }
    }
}




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.