ITextImporter  - AS3

Właściwość configuration zawiera wystąpienie klasy IConfiguration, którego moduł importu wymaga podczas tworzenia nowych wystąpień klasy TextFlow. Dla tej właściwości jest początkowo ustawiona wartość null.

Powiązane elementy interfejsu API

Po tym, jak w wyniku wywołania metody eksportowania dla właściwości throwOnError zostanie ustawiona wartość false, która jest wartością domyślną, ta właściwość 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ł importu. 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ł importu nie generuje żadnych błędów.

Kontroluje, czy moduł importu powinien obsługiwać dodatkowe informacje wymagane przez schowek. Gdy dane pochodzą ze schowka, mogą one zawierać częściowe akapity, a także akapity pozbawione znaku końca akapitu lub znaku nowego wiersza. Jeśli flaga useClipboardAnnotations ma wartość true, moduł importu oznacza te akapity częściowe za pomocą atrybutu ConverterBase.MERGE_TO_NEXT_ON_PASTE. Powoduje to prawidłową obsługę scalania wklejanego akapitu (oraz wszelkich elementów list i div mogących zawierać akapit) do tekstu przez operację wklejania.

Powiązane elementy interfejsu API

Importuje tekst ze źródła zewnętrznego i konwertuje go na obiekt TextFlow.

Parametry

Ten urywek kodu przedstawia użycie metody ITextImporter w celu przeprowadzenia powtarzalnych operacji importu sformatowanego tekstu. Błędy są czyszczone na początku każdego wywołania metody 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;
        }
    }
}