ITextExporter  - AS3

Po tym, jak w wyniku wywołania metody modułu eksportu dla właściwości throwOnError zostanie ustawiona wartość false, która jest wartością domyślną, ta właściwość będzie zawierać wektor komunikatów o błędach w postaci ciągów. Jeśli nie wystąpią błędy, ta właściwość zwróci wartość null. Ta właściwość jest zerowana przy każdym wywołaniu metody.

Właściwość throwOnError kontroluje sposób obsługi błędów przez moduł eksportu. W przypadku ustawienia wartości true błąd powoduje wygenerowanie wystąpienia klasy Error. W przypadku ustawienia wartości false, która jest wartością domyślną, błędy są gromadzone w wektorze ciągów i zostają zachowane we właściwości errors, a moduł eksportu nie generuje żadnych błędów.

Właściwość useClipboardAnnotations określa, czy moduł eksportu powinien obsługiwać dodatkowe informacje wymagane przez schowek. Gdy dane znajdują się w obiekcie TextFlow, akapity są zawsze kompletne i zawierają znak końca akapitu. Gdy pewna ilość tekstu jest wklejana ze schowka, są tworzone akapity, ale tekst może nie zawierać ostatniego znaku końca akapitu. W takim przypadku jeśli tekst ma zostać wklejony do schowka, akapit musi zostać oznaczony jako akapit częściowy, tak aby po wklejeniu został prawidłowo scalony z nowym tekstem. Jeśli przeznaczeniem zawartości jest schowek, właściwość useClipboardAnnotations ma wartość true.

Zawartość tekstową można eksportować z wystąpienia klasy TextFlow w formacie String, XML lub w dowolnym formacie zdefiniowanym przez użytkownika.

Dla parametru conversionType należy ustawić jedną z poniższych wartości lub format zdefiniowany przez użytkownika w przypadku modułów eksportu zdefiniowanych przez użytkownika.

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

Parametry

Powiązane elementy interfejsu API

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;
        }
    }
}