RichEditableText  - AS3 Flex

Paket	spark.components
Klasse	public class RichEditableText
Vererbung	RichEditableText UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
Implementiert	IFocusManagerComponent, IIMESupport, ISystemCursorClient, IViewport, IEditableText

Adobe empfiehlt, diese Komponente nicht in einer Anwendung zu einzusetzen, die das mobileDevice-Profil verwendet.

Rich Text kann klickbare Hyperlinks bzw. Verknüpfungen und eingebundene Grafiken enthalten, die entweder eingebettet oder von URLs geladen werden.

RichEditableText hat zwar keine Bildlaufleisten, implementiert jedoch die IViewport-Schnittstelle zum Ausführen von programmgesteuerten Bildläufen, sodass die Steuerung durch einen Scroller möglich ist, der Bildlaufleisten bereitstellt. Außerdem werden vertikale Bildläufe mit dem Mausrad unterstützt.

Es bietet keine Benutzeroberfläche zum Ändern der Textformatierung. Es bietet jedoch APIs, mit denen Sie Text programmgesteuert formatieren können. Diese ermöglichen es beispielsweise, eine Fettdruck-Schaltfläche zu erstellen, durch die ausgewählter Text fett formatiert wird.

Diese Klasse wird in den Skins der Spark-Versionen von TextInput und TextArea verwendet. (TextInput bietet im Gegensatz zu TextArea nicht die Möglichkeit, Rich Text zu verarbeiten.) RichEditableText hat standardmäßig einen transparenten Hintergrund und unterstützt das Zeichnen von Rahmen nicht.

RichEditableText verwendet die Text Layout Framework (TLF)-Bibliothek, welche wiederum auf der neuen Flash Text Engine (FTE) in Flash Player 10 beruht. In Kombination ermöglichen diese Ebenen die Bearbeitung von Text mit hochwertigen internationalen Typografie- und Layoutfunktionen.

Die Spark-Architektur bietet drei grundlegende Textsteuerelemente: Label, RichText und RichEditableText. Label ist das schnellste und einfachste Steuerelement, da es nicht TLF, sondern FTE verwendet. Es hat eingeschränkte Funktionen: kein Rich Text, keine Bildläufe, keine Auswahl und keine Bearbeitung. Mit RichText können Sie Rich Text mit komplexem Layout anzeigen. Das Steuerelement ist dennoch nicht interaktiv. RichEditableText ist das umfangreichste Steuerelement und bietet die meisten Möglichkeiten von TLF. In der Regel sollten Sie das schnellste Textsteuerelement verwenden, das Ihre Anforderungen erfüllt.

RichEditableText ähnelt der UITextField-Klasse, die in MX-Komponenten zum Einsatz kommt. Bei dieser Klasse wurde weder FTE noch TLF verwendet. Vielmehr wurde die ältere TextField-Klasse erweitert.

Die wichtigsten Unterschiede zwischen UITextField und RichEditableText sind die folgenden:

• RichEditableText bietet bessere Typografie, bessere Unterstützung für Sprachen und besseres Textlayout.
• RichEditableText verfügt über ein objektorientiertes Modell von Rich Text, UITextField nicht.
• RichEditableText bietet bessere Unterstützung für das Anzeigen umfangreicher Texte.
• Bei RichEditableText müssen Schriftarten anders eingebettet werden als bei UITextField. Weitere Informationen zur Verwendung des embedAsCFF-Attributs beim Einbetten von Schriftarten finden Sie in der Dokumentation.

Bei RichEditableText kommt das objektorientierte TLF-Modell von Rich Text zum Einsatz. Hierbei werden Textlayoutelemente wie Unterteilungen, Absätze, Spannen, Hyperlinks und Bilder zur Laufzeit durch ActionScript-Objekte dargestellt, welche programmgesteuert verwendet und bearbeitet werden können. Das zentrale Objekt in TLF zur Darstellung von Rich Text ist ein TextFlow. Sie geben also Rich Text an, um ein RichEditableText-Steuerelement anzuzeigen, indem Sie die textFlow-Eigenschaft auf eine TextFlow-Instanz einstellen. In der Beschreibung der textFlow-Eigenschaft finden Sie weitere Informationen darüber, wie Sie diese erstellen, wie beispielsweise durch Importieren von TLF-Markup. Wenn Sie bei der Anzeige von Text auf die Darstellung unterschiedlicher Formatierungen verzichten können, verwenden Sie die text-Eigenschaft, um einen String mit unformatiertem Text festzulegen. Informationen zur Interaktion zwischen den text- und textFlow-Eigenschaften finden Sie in den jeweiligen Beschreibungen. Beispielsweise können Sie eine einstellen und die andere abrufen.

Beim Kompilieren können Sie in TLF-Markup-Tags das RichEditableText-Tag einfügen. Gehen Sie dazu wie im folgenden Beispiel vor:

      <s:RichEditableText>Hello <s:span fontWeight="bold">World!</s:span></s:RichEditableText>
      

Die Standardtextformatierung wird mithilfe von CSS-Stilen wie beispielsweise fontFamily und fontSize bestimmt. Formatierungsinformationen innerhalb des TextFlow-Objekts führen zum Überschreiben der Standardformatierung, die von den CSS-Stilen bereitgestellt wird.

Sie können den Abstand zwischen den Zeilen mit dem lineHeight-Stil steuern. Den Abstand zwischen Absätzen steuern Sie mit den paragraphSpaceBefore- und paragraphSpaceAfter-Stilen. Mit den textAlign- und textAlignLast-Stilen richten Sie Text aus. Mit den paddingLeft-, paddingTop-, paddingRight- und paddingBottom-Stilen können Sie Text von den Kanten der Komponente aus einrücken.

Standardmäßig wird die Größe von RichEditableText automatisch angepasst: zu Beginn ist es sehr klein, wenn noch kein Text vorhanden ist, dann wird die Breite während der Eingabe bis auf maxWidth erhöht. Die Höhe wächst, wenn Sie die Eingabetaste drücken, um eine neue Zeile zu beginnen.

Mit den widthInChars- und heightInLines-Eigenschaften geben Sie die Breite und Höhe so an, dass eine Skalierung entsprechend der Schriftgröße erfolgt. Sie können auch die typicalText-Eigenschaft verwenden. Beachten Sie, dass beim Verwenden von typicalText die widthInChars und heightInLines ignoriert werden. Ferner können Sie eine explizite Breite oder Höhe in Pixeln angeben, eine prozentuale Breite oder Höhe angeben oder Beschränkungen wie left und right oder top und bottom festlegen.

Wenn Sie irgendeine Breite definieren (ausdrücklich oder prozentual oder mit maxWidth- oder left- und right-Beschränkungen), wird der Text am rechten Rand der Komponente umbrochen. Wenn mehr Text vorhanden ist als in den Anzeigebereich passt, kann ein vertikaler Bildlauf des Texts durchgeführt werden. Wenn Sie den lineBreak-Stil auf explicit setzen, beginnen neue Zeilen ausschließlich bei ausdrücklich definierten Zeilenumbrüchen, wie beispielsweise bei der Verwendung von CR (\r), LF (\n) oder CR+LF (\r\n) in text oder wenn Sie <p> und <br/> in TLF-Markup verwenden. In diesem Fall ist ein horizontaler Bildlauf möglich, wenn Textzeilen breiter sind als das Steuerelement.

Mit der maxChars-Eigenschaft beschränken Sie die Anzahl der Zeichen, die der Benutzer eingeben kann. Mit restrict legen Sie fest, welche Zeichen eingegeben werden dürfen.

Mit der multiline-Eigenschaft bestimmen Sie, welches Verhalten durch Drücken der Eingabetaste ausgelöst wird. Bei true wird durch Drücken der Eingabetaste ein neuer Absatz begonnen. Bei false wird ein FlexEvent.ENTER-Ereignis ausgelöst.

Um das Bearbeiten von Text zu unterbinden, setzen Sie die editable-Eigenschaft auf false. Wenn Sie festlegen möchten, dass der Text nicht markiert werden kann, setzen Sie die selectable-Eigenschaft auf false.

Da RichEditableText TLF verwendet, können Sie Texte anzeigen, die sowohl von links nach rechts (z. B. Französisch) als auch von rechts nach links (z. B. Arabisch) verlaufen. Auch die Anzeige von bidirektionalem Text wird unterstützt – das heißt, Sie können einen Satz auf Französisch in einem arabischen Text anzeigen. Läuft der Text vorwiegend von rechts nach links, stellen Sie den direction-Stil auf rtl ein. Der textAlign-Stil ist standardmäßig "start", sodass der Text linksbündig ist, wenn direction ltr ist, und rechtsbündig, wenn direction rtl ist. Setzen Sie textAlign auf end, um die umgekehrte Ausrichtung zu verwenden.

Infolge der Verwendung von TLF unterstützt RichEditableText eine unbegrenzte Anzahl von Schritten, die während einer Bearbeitungssitzung rückgängig gemacht und wiederhergestellt werden können. Eine Bearbeitungssitzung beginnt, wenn die Komponente den Tastaturfokus erhält, und endet, wenn sie den Fokus verliert.

RichEditableText nutzt die TextContainerManager-Klasse von TLF, um Textanzeige, Bildläufe, Auswahl, Bearbeitung und Kontextmenü zu verarbeiten.

Erstellen Sie einen Elementrenderer, um diese Komponente in einer listenbasierten Komponente wie beispielsweise einer Liste oder einem DataGrid zu verwenden. Weitere Informationen zum Erstellen eines Elementrenderers finden Sie unter Benutzerdefinierte Spark-Elementrenderer.

MXML-Syntax anzeigen

MXML-Syntax ausblenden

      <s:RichEditableText
        Properties
        clipAndEnableScrolling="false|true"
        contentHeight="Calculated default"
        contentWidth="Calculated default"
        displayAsPassword="false"
        editable="true"
        heightInLines="NaN"
        horizontalScrollPosition="0"
        imeMode="null"
        maxChars="0"
        multiline="true"
        restrict="null"
        selectable="true"
        selectionActivePosition="-1"
        selectionAnchorPosition="-1"
        selectionHighlighting="TextSelectionHighlighting.WHEN_FOCUSED"
        text=""
        textFlow="TextFlow"
        typicalText=null
        verticalScrollPosition="0"
        widthInChars="NaN"
      
        Events
        change="No default"
        changing="No default"
        enter="No default"
        selectionChange="No default"
      />
      

Standard-MXML-Eigenschaftcontent

Beispiele anzeigen

Verwandte API-Elemente