Paket | flashx.textLayout.edit |
Klasse | public class EditManager |
Vererbung | EditManager SelectionManager Object |
Implementiert | IEditManager |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Um die Bearbeitung des Textflusses zu aktivieren, weisen Sie ein EditManager-Objekt der interactionManager
-Eigenschaft des TextFlow-Objekts zu. Der Bearbeitungsmanager verarbeitet Änderungen am Text (beispielsweise Einfüge-, Löschvorgänge und Formatänderungen). Änderungen können rückgängig gemacht werden, wenn der Bearbeitungsmanager über einen Undo-Manager verfügt. Der Bearbeitungsmanager löst die Neuerstellung und Anzeige des Textflusses aus, falls erforderlich.
Die EditManager-Klasse unterstützt die folgenden Tastaturbefehle:
Tasten | Ergebnis |
---|---|
Strg+z | Rückgängig |
Strg+y | Wiederherstellen |
Strg+Rücktaste | Vorheriges Wort löschen |
Strg+Entf | Nächstes Wort löschen |
Alt+Löschen | Nächstes Wort löschen |
Strg+Alt+Entf | Nächstes Wort löschen |
Strg+Umschalt+Bindestrich | Bedingten Trennstrich einfügen |
Strg+Rücktaste | Vorheriges Wort löschen |
Alt+Rücktaste | Vorheriges Wort löschen |
Strg+Alt+Rücktaste | Vorheriges Wort löschen |
Einfg | Schaltet zum Modus „Überschreiben“ um |
Rücktaste | Vorheriges Zeichen löschen |
Eingabetaste | Für textFlow.configuration.manageEnterKey in einer Liste wird ein neuer Listeneintrag erstellt, andernfalls wird ein neuer Absatz erstellt |
Umschalt-ENTER | Bei textFlow.configuration.manageEnterKey wird ein neuer Absatz erstellt |
Tab | Bei textFlow.configuration.manageTabKey in einer Liste wird eine neue verschachtelte Liste erstellt, andernfalls wird ein Tabstopp eingefügt oder das nächste Zeichen wird durch einen Tabstopp überschrieben |
Umschalt-TAB | Bei textFlow.configuration.manageTabKey im ersten Eintrag einer Liste wird der Eintrag aus der Liste geschoben. |
Hinweis: Die folgenden Tasten funktionieren unter Windows nicht: Alt+Rücktaste, Alt+Entf, Strg+Alt+Rücktaste, und Strg+Alt+Entf. Diese Tasten generieren in der Laufzeitversion kein Ereignis.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
absoluteEnd : int [schreibgeschützt]
Die Textposition am Ende der Auswahl als Offset ab Beginn des Textflusses. | SelectionManager | ||
absoluteStart : int [schreibgeschützt]
Die Textposition am Anfang der Auswahl als Offset ab Beginn des Textflusses. | SelectionManager | ||
activePosition : int [schreibgeschützt]
Der aktive Punkt der Auswahl. | SelectionManager | ||
allowDelayedOperations : Boolean | EditManager | ||
anchorPosition : int [schreibgeschützt]
Der Ankerpunkt der Auswahl. | SelectionManager | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
currentSelectionFormat : SelectionFormat [schreibgeschützt]
Das aktuelle SelectionFormat-Objekt. | SelectionManager | ||
delayUpdates : Boolean | EditManager | ||
editingMode : String [schreibgeschützt]
Der Bearbeitungsmodus. | SelectionManager | ||
focused : Boolean [schreibgeschützt]
Gibt an, ob ein Container im Textfluss den Fokus hat. | SelectionManager | ||
focusedSelectionFormat : SelectionFormat
Das SelectionFormat-Objekt, das zum Ziehen der Auswahl in einen fokussierten Container verwendet wird. | SelectionManager | ||
inactiveSelectionFormat : SelectionFormat
Das SelectionFormat-Objekt, das zum Ziehen der Auswahl verwendet wird, wenn sie sich nicht im aktiven Fenster befindet. | SelectionManager | ||
overwriteMode : Boolean = false [statisch]
Gibt an, ob der Überschreibungsmodus aktiviert oder deaktiviert ist. | EditManager | ||
textFlow : flashx.textLayout.elements:TextFlow
Das von diesem Auswahlmanager verwaltete TextFlow-Objekt. | SelectionManager | ||
undoManager : IUndoManager [schreibgeschützt]
Der diesem Bearbeitungsmanager zugewiesene IUndoManager. | EditManager | ||
unfocusedSelectionFormat : SelectionFormat
Das SelectionFormat-Objekt, das zum Ziehen der Auswahl verwendet wird, wenn sie sich nicht im fokussierten Container, sondern im aktiven Fenster befindet. | SelectionManager | ||
windowActive : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Textfluss verknüpfte Fenster aktiv ist. | SelectionManager |
Methode | Definiert von | ||
---|---|---|---|
EditManager(undoManager:IUndoManager = null)
Erstellt ein EditManager-Objekt. | EditManager | ||
Verarbeitet ein Aktivierungsereignis. | SelectionManager | ||
applyContainerFormat(containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Wendet Containerstile auf alle Container in der Auswahl an. | EditManager | ||
applyFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Ändert die Formate der angegebenen (oder aktuellen) Auswahl. | EditManager | ||
applyFormatToElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Wendet Stile auf das angegebene Element an. | EditManager | ||
applyLeafFormat(characterFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Ändert das auf die Blattelemente in der angegebenen (oder aktuellen) Auswahl angewendete Format. | EditManager | ||
applyLink(href:String, targetString:String = null, extendToLinkBoundary:Boolean = false, operationState:SelectionState = null):LinkElement
Wandelt eine Auswahl in eine Verknüpfung oder eine Verknüpfung in normalen Text um. | EditManager | ||
applyParagraphFormat(paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Wendet Absatzstile auf alle Absätze in der Auswahl an. | EditManager | ||
Wandelt Text in eine TCY-Ausführung oder eine TCY-Ausführung in Nicht-TCY-Text aus. | EditManager | ||
Beginnt eine neue Gruppe von Vorgängen. | EditManager | ||
changeElementID(newID:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Ändert die ID eine Elements. | EditManager | ||
changeStyleName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void Veraltet seit 2.0: Verwenden Sie applyFormatToElement
Ändert den styleName eines Elements oder Teils eines Element. | EditManager | ||
changeTypeName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Ändert den typeName eines Elements oder eines Elementteils. | EditManager | ||
clearFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Hebt die Definition von Formaten der angegebenen (oder aktuellen) Auswahl auf. | EditManager | ||
clearFormatOnElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Hebt die Definition von Stilen für das angegebene Element auf. | EditManager | ||
createDiv(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):DivElement Erstellt ein neues DivElement, das den gesamten Bereich enthält, der im operationState am untersten gemeinsamen übergeordneten Element, das die Start- und Endpunkte des Bereichs enthält, festgelegt wurde. | EditManager | ||
createList(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):ListElement Erstellt ein neues ListElement, das den gesamten Bereich enthält, der im operationState am untersten gemeinsamen übergeordneten Element, das die Start- und Endpunkte des Bereichs enthält, festgelegt wurde. | EditManager | ||
createSubParagraphGroup(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):SubParagraphGroupElement Erstellt ein neues SubParagraphGroupElement, das den gesamten Bereich enthält, der im operationState am untersten gemeinsamen übergeordneten Element, das die Start- und Endpunkte des Bereichs enthält, festgelegt wurde. | EditManager | ||
Löscht den ausgewählten Bereich und gibt den gelöschten Bereich in einem TextScrap-Objekt zurück. | EditManager | ||
Verarbeitet ein Deaktivierungsereignis. | SelectionManager | ||
Löscht einen Textbereich oder löscht bei gegebener Punktauswahl das nächste Zeichen. | EditManager | ||
Löscht das nächste Wort. | EditManager | ||
Löscht einen Textbereich oder löscht bei gegebener Punktauswahl das vorherige Zeichen. | EditManager | ||
Löscht das vorherige Wort. | EditManager | ||
Löscht einen Textbereich. | EditManager | ||
[override]
Führt eine FlowOperation aus. | EditManager | ||
Verarbeitet ein Bearbeitungsereignis. | SelectionManager | ||
Beendet eine Gruppe von Vorgängen. | EditManager | ||
SelectionManager | |||
Verarbeitet ein focusChange-Ereignis. | SelectionManager | ||
Verarbeitet ein focusIn-Ereignis. | SelectionManager | ||
Verarbeitet ein focusOut-Ereignis. | SelectionManager | ||
getCommonCharacterFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Ruft die Zeichenformatattribute ab, die für alle Zeichen im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden. | SelectionManager | ||
getCommonContainerFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Ruft die Containerformatattribute ab, die für alle Container im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden. | SelectionManager | ||
getCommonParagraphFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Ruft die Absatzformatattribute ab, die für alle Absätze im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden. | SelectionManager | ||
Ruft das SelectionState-Objekt der aktuellen Auswahl ab. | SelectionManager | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Zeigt an, ob es eine Auswahl gibt. | SelectionManager | ||
Verarbeitet ein imeStartComposition-Ereignis.
| SelectionManager | ||
insertInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):InlineGraphicElement
Fügt eine Grafik ein. | EditManager | ||
Fügt Text ein. | EditManager | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die Auswahl einen Textbereich abdeckt. | SelectionManager | ||
Verarbeitet ein keyDown-Ereignis. | SelectionManager | ||
Verarbeitet ein keyFocusChange-Ereignis. | SelectionManager | ||
Verarbeitet ein keyUp-Ereignis. | SelectionManager | ||
Verarbeitet ein menuSelect-Ereignis. | SelectionManager | ||
modifyInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):void
Ändert eine vorhandene Inline-Grafik. | EditManager | ||
Verarbeitet ein mouseDoubleClick-Ereignis. | SelectionManager | ||
Verarbeitet ein mouseDown-Ereignis. | SelectionManager | ||
Verarbeitet ein mouseMove-Ereignis. | SelectionManager | ||
Verarbeitet ein mouseOut-Ereignis. | SelectionManager | ||
Verarbeitet ein mouseOver-Ereignis. | SelectionManager | ||
Verarbeitet ein mouseUp-Ereignis. | SelectionManager | ||
Verarbeitet ein mouseWheel-Ereignis. | SelectionManager | ||
moveChildren(source:FlowGroupElement, sourceIndex:int, numChildren:int, destination:FlowGroupElement, destinationIndex:int, selectionState:SelectionState = null):void Verschiebt eine Reihe von FlowElements von einem FlowGroupElement zum anderen. | EditManager | ||
Aktualisiert den Auswahlmanager, wenn Text eingefügt oder gelöscht wird. | SelectionManager | ||
Überschreibt den ausgewählten Text. | EditManager | ||
pasteTextScrap(scrapToPaste:flashx.textLayout.edit:TextScrap, operationState:SelectionState = null):void
Fügt den TextScrap in den ausgewählten Bereich ein. | EditManager | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Führt den vorher rückgängig gemachten Vorgang erneut durch. | EditManager | ||
Zeigt die Auswahlformen erneut an. | SelectionManager | ||
SelectionManager | |||
SelectionManager | |||
Legt den Fokus auf den ersten Container in der Auswahl. | SelectionManager | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Legt das SelectionState-Objekt der aktuellen Auswahl fest. | SelectionManager | ||
Verarbeitet ein softKeyboardActivating-Ereignis.
| SelectionManager | ||
Teilt das Zielelement an der angegebenen Position und erstellt nach dem aktuellen Element ein neues Element. | EditManager | ||
Teilt den Absatz an der aktuellen Position und erstellt nach dem aktuellen Absatz einen neuen Absatz. | EditManager | ||
Verarbeitet ein TextEvent. | SelectionManager | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Kehrt den vorherigen Vorgang um. | EditManager | ||
EditManager | |||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
allowDelayedOperations | Eigenschaft |
delayUpdates | Eigenschaft |
overwriteMode | Eigenschaft |
public static var overwriteMode:Boolean = false
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt an, ob der Überschreibungsmodus aktiviert oder deaktiviert ist.
Im Fall von true
wird durch einen Tastendruck das Zeichen nach dem Cursor überschrieben. Im Fall von false
wird ein Tastendruck an der Cursorposition eingefügt.
undoManager | Eigenschaft |
undoManager:IUndoManager
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der diesem Bearbeitungsmanager zugewiesene IUndoManager.
Damit Bearbeitungen rückgängig gemacht (und wiederholt) werden können, übergeben Sie eine IUndoManager-Instanz an den EditManager-Konstruktor. Der Undo-Manager verwaltet einen Stapel von Vorgängen, die ausgeführt wurden, und kann einzelne Vorgänge rückgängig machen oder wiederholen.
Hinweis: Wenn der TextFlow direkt geändert wird (nicht über Aufrufe von EditManager, sondern direkt über Aufrufe verwalteter FlowElement-Objekte), löscht der EditManager den Stapel zum Rückgängigmachen, um zu gewährleisten, dass der Stapel weiterhin mit dem aktuellen Status synchronisiert ist.
Implementierung
public function get undoManager():IUndoManager
EditManager | () | Konstruktor |
public function EditManager(undoManager:IUndoManager = null)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Erstellt ein EditManager-Objekt.
Weist ein EditManager-Objekt der interactionManager
-Eigenschaft eines Textflusses zu, um die Bearbeitung dieses Textflusses zu ermöglichen.
Um die Unterstützung zum Rückgängigmachen oder Wiederholen von Änderungen zu aktivieren, übergeben Sie eine IUndoManager-Instanz an den EditManager-Konstruktor. Sie können die flashx.undo.UndoManager
-Klasse verwenden oder eine benutzerdefinierte IUndoManager-Instanz erstellen. Verwenden Sie eine benutzerdefinierte IUndoManager-Instanz, um Text Layout Framework-Änderungen in einen vorhandenen Undo-Manager zu integrieren, der keine Instanz der UndoManager-Klasse ist. Um eine benutzerdefinierte IUndoManager-Instanz zu erstellen, vergewissern Sie sich, dass die Klasse, die Sie zur Definition des Undo-Managers verwenden, die IUndoManager-Schnittstelle implementiert.
undoManager:IUndoManager (default = null ) — Der UndoManager für die Anwendung
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_constructor { // Create a new TextFlow that is editable and undoable. static public function createEditableTextFlow():TextFlow { var textFlow:TextFlow = new TextFlow(); textFlow.interactionManager = new EditManager( new UndoManager() ); return textFlow; } } }
applyContainerFormat | () | Methode |
public function applyContainerFormat(containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wendet Containerstile auf alle Container in der Auswahl an.
Alle Stileigenschaften im Formatobjekt, die null
lauten, bleiben unverändert.
Parameter
containerFormat:flashx.textLayout.formats:ITextLayoutFormat — Das Format, das auf die Container im Bereich angewendet werden soll.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.formats.TextLayoutFormat; public class EditManager_applyContainerFormat { public function EditManager_applyContainerFormat( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var containerStyle:TextLayoutFormat = new TextLayoutFormat(); containerStyle.columnCount = 2; editManager.applyContainerFormat( containerStyle ); } } }
applyFormat | () | Methode |
public function applyFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ändert die Formate der angegebenen (oder aktuellen) Auswahl.
Führt einen Vorgang aus, der nicht rückgängig gemacht werden kann und die neuen Formate anwendet. Nur für die TextLayoutFormat-Objekte festgelegte Stilattribute werden angewendet. Nicht definierte Attribute in den Formatobjekten werden nicht geändert.
Parameter
leafFormat:flashx.textLayout.formats:ITextLayoutFormat — Das Format, das auf Blattelemente wie beispielsweise Bereiche und Inline-Grafiken angewendet werden soll.
| |
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat — Das Format, das auf Absatzelemente angewendet werden soll.
| |
containerFormat:flashx.textLayout.formats:ITextLayoutFormat — Das Format, das auf die Container angewendet werden soll.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.formats.TextAlign; import flashx.textLayout.formats.TextLayoutFormat; public class EditManager_applyFormat { public function EditManager_applyFormat( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var containerStyle:TextLayoutFormat = new TextLayoutFormat(); containerStyle.columnCount = 2; var paraStyle:TextLayoutFormat = new TextLayoutFormat(); paraStyle.textAlign = TextAlign.JUSTIFY; var charStyle:TextLayoutFormat = new TextLayoutFormat(); charStyle.color = 0xff0000; editManager.applyFormat( charStyle, paraStyle, containerStyle ); } } }
applyFormatToElement | () | Methode |
public function applyFormatToElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wendet Stile auf das angegebene Element an.
Alle Stileigenschaften im Formatobjekt, die null
lauten, bleiben unverändert. Nur Stile, die für das angegebene Element relevant sind, werden angewendet.
Parameter
targetElement:FlowElement — Das Element, auf das die Stile angewendet werden.
| |
format:flashx.textLayout.formats:ITextLayoutFormat — Das Format, das die Stile enthält, die angewendet werden sollen.
| |
relativeStart:int (default = 0 ) — Ein Offset ab dem Beginn des Elements, an dem das Element beim Zuweisen der neuen Formatierung geteilt werden soll.
| |
relativeEnd:int (default = -1 ) — Ein Offset ab dem Beginn des Elements, an dem das Element beim Anwenden der neuen Formatierung geteilt werden soll.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
applyLeafFormat | () | Methode |
public function applyLeafFormat(characterFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ändert das auf die Blattelemente in der angegebenen (oder aktuellen) Auswahl angewendete Format.
Führt einen nicht rückgängig zu machenden Vorgang aus, bei dem das neue Format auf Blattelemente wie beispielsweise SpanElement- und InlineGraphicElement-Objekte angewendet wird. Nur für die TextLayoutFormat-Objekte festgelegte Stilattribute werden angewendet. Nicht definierte Attribute im Formatobjekt werden geändert.
Parameter
characterFormat:flashx.textLayout.formats:ITextLayoutFormat — Das Format, das angewendet werden soll.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.formats.TextLayoutFormat; public class EditManager_applyLeafFormat { public function EditManager_applyLeafFormat(selection:SelectionState) { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var charStyle:TextLayoutFormat = new TextLayoutFormat(); charStyle.color = 0xff0000; editManager.applyLeafFormat( charStyle ); } } }
applyLink | () | Methode |
public function applyLink(href:String, targetString:String = null, extendToLinkBoundary:Boolean = false, operationState:SelectionState = null):LinkElement
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10 - + 10.2, AIR 1.5 |
Wandelt eine Auswahl in eine Verknüpfung oder eine Verknüpfung in normalen Text um.
Führt einen Vorgang aus, der nicht rückgängig gemacht werden kann und der die Verknüpfung erstellt oder entfernt.
Wenn ein target
-Parameter angegeben ist, muss es sich um einen der folgenden Werte handeln:
- "_self"
- "_blank"
- "_parent"
- "_top"
Bei Browser-gehosteten Laufzeitumgebungen wird die aktuelle HTML-Seite durch das Ziel „_self“ ersetzt. Wenn der SWF-Inhalt, der die Verknüpfung enthält, sich auf einer Seite innerhalb eines Frames oder Framesets befindet, wird der verknüpfte Inhalt innerhalb dieses Frames geladen. Wenn sich die Seite auf der obersten Ebene befindet, wird der verknüpfte Inhalt geöffnet, um die ursprüngliche Seite zu ersetzen. Das Ziel „_blank“ öffnet ein neues Browserfenster ohne Namen. Das Ziel „_parent“ ersetzt das übergeordnete Element der HTML-Seite, die den SWF-Inhalt enthält. Das Ziel „_top“ ersetzt die Seite auf oberster Ebene im aktuellen Browserfenster.
Bei anderen Laufzeitumgebungen wie beispielsweise Adobe AIR wird die Verknüpfung im Standardbrowser des Benutzers geöffnet und der target
-Parameter wird ignoriert.
Der extendToLinkBoundary
-Parameter bestimmt, wie der Bearbeitungsmanager eine Auswahl behandelt, die sich mit einer oder mehreren vorhandenen Verknüpfungen überschneidet. Wenn der Parameter true
ist, wird der Vorgang als Einheit auf die Auswahl und den gesamten Text der vorhandenen Verknüpfungen angewendet. Somit wird eine einzelne Verknüpfung erstellt, die vom Anfang der ersten überschnittenen Verknüpfung bis zum Ende der letzten überschnittenen Verknüpfung reicht. Wenn jedoch extendToLinkBoundary
in dieser Situation false
wäre, würden die vorhandenen, teilweise ausgewählte Verknüpfungen in zwei Verknüpfungen aufgeteilt.
Parameter
href:String — Der von der Verknüpfung referenzierte URI.
| |
targetString:String (default = null ) — Das Browserzielfenster der Verknüpfung.
| |
extendToLinkBoundary:Boolean (default = false ) — Gibt an, ob die Auswahl mit überlappenden vorhandenen Verknüpfungen konsolidiert werden soll und die Änderung anschließend angewendet werden soll.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
LinkElement — Das erstellte LinkElement.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_applyLink { static public function makeLink( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; editManager.applyLink( "http://www.adobe.com" ); } static public function removeLink( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; editManager.applyLink( null, null, true ); } } }
applyParagraphFormat | () | Methode |
public function applyParagraphFormat(paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wendet Absatzstile auf alle Absätze in der Auswahl an.
Alle Stileigenschaften im Formatobjekt, die null
lauten, bleiben unverändert.
Parameter
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat — Das Format, das auf die ausgewählten Absätze angewendet werden soll.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.formats.TextAlign; import flashx.textLayout.formats.TextLayoutFormat; public class EditManager_applyParagraphFormat { static public function justifyParagraph( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var paraStyle:TextLayoutFormat = new TextLayoutFormat(); paraStyle.textAlign = TextAlign.JUSTIFY; editManager.applyParagraphFormat( paraStyle ); } } }
applyTCY | () | Methode |
public function applyTCY(tcyOn:Boolean, operationState:SelectionState = null):flashx.textLayout.elements:TCYElement
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10 - + 10.2, AIR 1.5 |
Wandelt Text in eine TCY-Ausführung oder eine TCY-Ausführung in Nicht-TCY-Text aus.
TCY bzw. tate-chu-yoko hat zur Folge, dass Text horizontal innerhalb einer vertikalen Zeile gezeichnet wird, und wird verwendet, um kleine Blöcke von nicht-japanischem Text oder Zahlen (beispielsweise Datumsangaben) in vertikalem Text lesbarer zu machen.
Parameter
tcyOn:Boolean — Mit dem Wert true wird TCY auf einen Textbereich angewendet, mit dem Wert false wird TCY entfernt.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
flashx.textLayout.elements:TCYElement — Das erstellte TCYElement.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_applyTCY { static public function tcyOn( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; editManager.applyTCY( true ); } static public function tcyOff( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; editManager.applyTCY( false ); } } }
beginCompositeOperation | () | Methode |
public function beginCompositeOperation():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Beginnt eine neue Gruppe von Vorgängen.
Alle Vorgänge, die nach dem Aufruf von beginCompositeOperation()
und vor dem übereinstimmenden Aufruf von endCompositeOperation()
ausgeführt wurden, werden als einzelner Vorgang, der als eine Einheit rückgängig gemacht werden kann, ausgeführt und zusammengefasst.
Ein beginCompositeOperation
/endCompositeOperation
-Block kann in einem anderen beginCompositeOperation
/endCompositeOperation
-Block verschachtelt werden.
Beispiel ( Verwendung dieses Beispiels )
beginCompositeOperation()
- und die endCompositeOperation()
-Funktion nicht verwendet würden, müssten die untergeordneten Vorgänge einzeln und nicht als Gruppe rückgängig gemacht werden.
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_beginCompositeOperation { static public function insertGraphic( source:Object, width:Object, height:Object, float:String, selection:SelectionState ):void { var editManager:IEditManager = selection.textFlow.interactionManager as IEditManager; editManager.beginCompositeOperation(); editManager.deleteText( selection ); var changedSelection:SelectionState = new SelectionState( selection.textFlow, selection.anchorPosition, selection.anchorPosition ); editManager.splitParagraph( changedSelection ); changedSelection = new SelectionState( changedSelection.textFlow, changedSelection.anchorPosition + 1, changedSelection.anchorPosition + 1); editManager.insertInlineGraphic( source, width, height, float, changedSelection ); changedSelection = new SelectionState( changedSelection.textFlow, changedSelection.anchorPosition + 1, changedSelection.anchorPosition + 1); editManager.splitParagraph( changedSelection ); editManager.endCompositeOperation(); } } }
changeElementID | () | Methode |
public function changeElementID(newID:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ändert die ID eine Elements.
Wenn die relativeStart
- oder relativeEnd
-Parameter festgelegt sind (auf etwas anderes als Standardwerte), dann ist das Element geteilt. Die Teile des Elements außerhalb dieses Bereichs behalten die ursprüngliche ID bei. Durch Festlegen der Parameter relativeStart
und relativeEnd
werden Elemente mit doppelter ID erstellt.
Parameter
newID:String — Der neue ID-Wert.
| |
targetElement:FlowElement — Das Element, das geändert werden soll.
| |
relativeStart:int (default = 0 ) — Ein Offset ab dem Beginn eines Elements, an dem das Element beim Zuweisen der neuen ID geteilt werden soll.
| |
relativeEnd:int (default = -1 ) — Ein Offset ab dem Beginn eines Elements, an dem das Element beim Zuweisen der neuen ID geteilt werden soll.
| |
operationState:SelectionState (default = null ) — Gibt die Auswahl an, die wiederhergestellt werden soll, wenn der Vorgang rückgängig gemacht wird; bei null speichert der Vorgang die aktuelle Auswahl.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.ElementRange; import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_changeElementID { static public function changeParagraphID( id:String, selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var selectedRange:ElementRange = ElementRange.createElementRange( selection.textFlow, selection.absoluteStart, selection.absoluteEnd ); editManager.changeElementID( id, selectedRange.firstParagraph, 0, -1, selection ); } } }
changeStyleName | () | Methode |
public function changeStyleName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ändert den styleName eines Elements oder Teils eines Element.
Wenn die relativeStart
- oder relativeEnd
-Parameter festgelegt sind (auf etwas anderes als Standardwerte), dann ist das Element geteilt. Die Teile des Elements außerhalb dieses Bereichs behalten den ursprünglichen Stil bei.
Parameter
newName:String — Der Name des neuen Stils.
| |
targetElement:FlowElement — Legt das zu ändernde Element fest.
| |
relativeStart:int (default = 0 ) — Ein Offset ab dem Beginn des Elements, an dem das Element beim Zuweisen des neuen Stils geteilt werden soll.
| |
relativeEnd:int (default = -1 ) — Ein Offset ab dem Ende des Elements, an dem das Element beim Zuweisen des neuen Stils geteilt werden soll.
| |
operationState:SelectionState (default = null ) — Gibt die Auswahl an, die wiederhergestellt werden soll, wenn der Vorgang rückgängig gemacht wird; bei null speichert der Vorgang die aktuelle Auswahl.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.ElementRange; import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_changeStyleName { static public function changeParagraphStyle( styleName:String, selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var selectedRange:ElementRange = ElementRange.createElementRange( selection.textFlow, selection.absoluteStart, selection.absoluteEnd ); editManager.changeElementID( styleName, selectedRange.firstParagraph, 0, -1, selection ); } } }
changeTypeName | () | Methode |
public function changeTypeName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ändert den typeName eines Elements oder eines Elementteils.
Wenn die relativeStart
- oder relativeEnd
-Parameter festgelegt sind (auf etwas anderes als Standardwerte), dann ist das Element geteilt. Die Teile des Elements außerhalb dieses Bereichs behalten den ursprünglichen Stil bei.
Parameter
newName:String — Der Name des neuen Typs.
| |
targetElement:FlowElement — Legt das zu ändernde Element fest.
| |
relativeStart:int (default = 0 ) — Ein Offset ab dem Beginn des Elements, an dem das Element beim Zuweisen des neuen Stils geteilt werden soll.
| |
relativeEnd:int (default = -1 ) — Ein Offset ab dem Ende des Elements, an dem das Element beim Zuweisen des neuen Stils geteilt werden soll.
| |
operationState:SelectionState (default = null ) — Gibt die Auswahl an, die wiederhergestellt werden soll, wenn der Vorgang rückgängig gemacht wird; bei null speichert der Vorgang die aktuelle Auswahl.
|
clearFormat | () | Methode |
public function clearFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Hebt die Definition von Formaten der angegebenen (oder aktuellen) Auswahl auf.
Führt einen Vorgang aus, der nicht rückgängig gemacht werden kann und der die Definition der angegebene Formate aufhebt. Nur für die TextLayoutFormat-Objekte festgelegte Stilattribute werden angewendet. Nicht definierte Attribute in den Formatobjekten werden nicht geändert.
Parameter
leafFormat:flashx.textLayout.formats:ITextLayoutFormat — Das Format, dessen festgelegte Werte Eigenschaften angeben, um die Definition von LeafFlowElement-Objekten im ausgewählten Bereich aufzuheben.
| |
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat — Das Format, dessen festgelegte Werte Eigenschaften angeben, um die Definition von ParagraphElement-Objekten im ausgewählten Bereich aufzuheben.
| |
containerFormat:flashx.textLayout.formats:ITextLayoutFormat — Das Format, dessen festgelegte Werte Eigenschaften angeben, um die Definition von ContainerController-Objekten im ausgewählten Bereich aufzuheben.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
clearFormatOnElement | () | Methode |
public function clearFormatOnElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Hebt die Definition von Stilen für das angegebene Element auf.
Alle Stileigenschaften im Formatobjekt, die undefined
lauten, bleiben unverändert. Die Definition aller Stile, die im angegebenen Format definiert sind, wird für das angegebene Element aufgehoben.
Parameter
targetElement:FlowElement — Das Element, auf das die Stile angewendet werden.
| |
format:flashx.textLayout.formats:ITextLayoutFormat — Das Format, das die Stile enthält, deren Definition aufgehoben werden soll.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
createDiv | () | Methode |
public function createDiv(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):DivElement
Erstellt ein neues DivElement, das den gesamten Bereich enthält, der im operationState am untersten gemeinsamen übergeordneten Element, das die Start- und Endpunkte des Bereichs enthält, festgelegt wurde. Wenn der Anfangs- und der Endpunkt zusammenfallen, wird an dieser Position ein neues DivElement mit einem einzelnen untergeordneten Absatz erstellt.
Parameter
parent:FlowGroupElement (default = null ) — Legt ein übergeordnetes Element für das neue DivElement fest. Wenn der Wert null ist, liegt das übergeordnete Element auf der untersten Ebene, die den SelectionState enthält.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Auf das neue DivElement anzuwendende Formatierungsattribute.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
DivElement — Das neu erstellte DivElement.
|
createList | () | Methode |
public function createList(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):ListElement
Erstellt ein neues ListElement, das den gesamten Bereich enthält, der im operationState am untersten gemeinsamen übergeordneten Element, das die Start- und Endpunkte des Bereichs enthält, festgelegt wurde. Jeder Absatz innerhalb des Bereichs wird zu einem ListItemElement im neuen ListElement. Wenn der Anfangs- und der Endpunkt zusammenfallen, wird an dieser Position ein neues ListElement mit einem einzelnen untergeordneten ListItemElement erstellt.
Parameter
parent:FlowGroupElement (default = null ) — Legt wahlweise ein übergeordnetes Element für das neue ListElement fest. Wenn der Wert null ist, liegt das übergeordnete Element auf der untersten Ebene, die den SelectionState enthält.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Auf das neue ListElement anzuwendende Formatierungsattribute.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
ListElement — Das neu erstellte ListElement.
|
createSubParagraphGroup | () | Methode |
public function createSubParagraphGroup(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):SubParagraphGroupElement
Erstellt ein neues SubParagraphGroupElement, das den gesamten Bereich enthält, der im operationState am untersten gemeinsamen übergeordneten Element, das die Start- und Endpunkte des Bereichs enthält, festgelegt wurde. Wenn der Anfangs- und der Endpunkt zusammenfallen, geschieht nichts.
Parameter
parent:FlowGroupElement (default = null ) — Legt ein übergeordnetes Element für das neue SubParagraphGroupElement fest. Wenn der Wert null ist, liegt das übergeordnete Element auf der untersten Ebene, die den SelectionState enthält.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Auf das neue SubParagraphGroupElement anzuwendende Formatierungsattribute
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
SubParagraphGroupElement — Das neu erstellte SubParagraphGroupElement.
|
cutTextScrap | () | Methode |
public function cutTextScrap(operationState:SelectionState = null):flashx.textLayout.edit:TextScrap
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Löscht den ausgewählten Bereich und gibt den gelöschten Bereich in einem TextScrap-Objekt zurück.
Der resultierende TextScrap kann zur Zwischenablage des Systems gesendet werden oder wird in dem folgenden pasteTextOperation()
-Vorgang verwendet.
Parameter
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
flashx.textLayout.edit:TextScrap — Der TextScrap, der ausgeschnitten wurde.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.edit.TextScrap; import flashx.undo.UndoManager; import flashx.textLayout.elements.TextFlow; public class EditManager_cutTextScrap { static public function cutTextScrap():TextScrap { var textFlow:TextFlow = TextConverter.importToFlow( "How do now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( new Sprite() )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 4, 7 ); var scrap:TextScrap = editManager.cutTextScrap(); //Displays: How now brown cow. return scrap; } } }
deleteNextCharacter | () | Methode |
public function deleteNextCharacter(operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Löscht einen Textbereich oder löscht bei gegebener Punktauswahl das nächste Zeichen.
Parameter
operationState:SelectionState (default = null ) — gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_deleteNextCharacter { static public function deleteNextCharacter():void { var textFlow:TextFlow = TextConverter.importToFlow( "How now brown crow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( new Sprite() )); var editManager:EditManager = new EditManager(); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 15, 15 ); editManager.deleteNextCharacter(); //displays: How now brown cow. } } }
deleteNextWord | () | Methode |
public function deleteNextWord(operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Löscht das nächste Wort.
Wenn ein Bereich ausgewählt ist, wird das erste Wort des Bereichs gelöscht.
Parameter
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_deleteNextWord { static public function deleteNextWord():void { var textFlow:TextFlow = TextConverter.importToFlow( "How do now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( new Sprite() )); var editManager:EditManager = new EditManager(); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 3, 3 ); editManager.deleteNextWord(); //displays: How now brown cow. } } }
deletePreviousCharacter | () | Methode |
public function deletePreviousCharacter(operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Löscht einen Textbereich oder löscht bei gegebener Punktauswahl das vorherige Zeichen.
Parameter
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_deletePreviousCharacter { static public function deletePreviousCharacter():void { var textFlow:TextFlow = TextConverter.importToFlow( "How now brown crow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( new Sprite() )); var editManager:EditManager = new EditManager(); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 16, 16 ); editManager.deletePreviousCharacter(); //displays: How now brown cow. } } }
deletePreviousWord | () | Methode |
public function deletePreviousWord(operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Löscht das vorherige Wort.
Wenn ein Bereich ausgewählt ist, wird das erste Wort des Bereichs gelöscht.
Parameter
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
var textFlow:TextFlow = TextConverter.importToFlow( "How do now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer = new StandardFlowComposer(); textFlow.flowComposer.addController( new ContainerController( this )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.setSelection( 7, 7 ); editManager.deletePreviousWord(); //displays: How now brown cow.
deleteText | () | Methode |
public function deleteText(operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Löscht einen Textbereich.
Parameter
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_deleteText { static public function deleteText():void { var textFlow:TextFlow = TextConverter.importToFlow( "How do now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( new Sprite() )); var editManager:EditManager = new EditManager(); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 4, 7 ); editManager.deleteText(); //displays: How now brown cow. } } }
doOperation | () | Methode |
override public function doOperation(operation:FlowOperation):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Führt eine FlowOperation aus.
Die doOperation()
-Methode wird von IEditManager-Funktionen aufgerufen, die den Textfluss aktualisieren. Sie müssen diese Funktion normalerweise nicht direkt aufrufen, wenn Sie nicht Ihre eigenen benutzerdefinierten Vorgänge erstellen.
Diese Funktion wird mit den folgenden Schritten fortgesetzt:
- Geben Sie vor der Durchführung dieses Vorgangs ausstehende Vorgänge aus.
- Senden Sie ein flowOperationBegin-Ereignis, das abgebrochen werden kann. Falls abgebrochen, wird diese Methode sofort zurückgegeben.
- Führen Sie diesen Vorgang aus. Der Vorgang gibt
true
oderfalse
zurück.False
gibt an, dass keine Änderungen vorgenommen wurden. - Senden Sie den Vorgang auf den Stapel zum Rückgängigmachen.
- Löschen Sie den Stapel zum Wiederholen.
- Aktualisieren Sie die Anzeige.
- Senden Sie ein flowOperationEnd-Ereignis, das abgebrochen werden kann.
Verarbeitung von Ausnahmefehlern: Wenn der Vorgang einen Ausnahmefehler ausgibt, wird er erfasst und der Fehler wird an das flowOperationEnd-Ereignis angehängt. Wenn das Ereignis nicht abgebrochen wird, wird der Fehler erneut ausgegeben.
Parameter
operation:FlowOperation — ein FlowOperation-Objekt
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.operations.InsertTextOperation; public class EditManager_doOperation { static public function doOperation(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager(); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); var selectionState:SelectionState = new SelectionState(textFlow, 4, 4); var insertOperation:InsertTextOperation = new InsertTextOperation( selectionState, "now " ); editManager.doOperation( insertOperation ); // displays: How now brown cow } } }
endCompositeOperation | () | Methode |
public function endCompositeOperation():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Beendet eine Gruppe von Vorgängen.
Alle seit dem letzten Aufruf von beginCompositeOperation()
ausgeführten Vorgänge werden als CompositeOperation zusammengefasst, der anschließend beendet wird. Dieses CompositeOperation-Objekt wird dem Stapel zum Rückgängigmachen oder dem übergeordneten Vorgang hinzugefügt, wenn dieser zusammengesetzte Vorgang innerhalb eines anderen zusammengesetzten Vorgangs verschachtelt wird.
Beispiel ( Verwendung dieses Beispiels )
beginCompositeOperation()
- und die endCompositeOperation()
-Funktion nicht verwendet würden, müssten die untergeordneten Vorgänge einzeln und nicht als Gruppe rückgängig gemacht werden.
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_beginCompositeOperation { static public function insertGraphic( source:Object, width:Object, height:Object, float:String, selection:SelectionState ):void { var editManager:IEditManager = selection.textFlow.interactionManager as IEditManager; editManager.beginCompositeOperation(); editManager.deleteText( selection ); var changedSelection:SelectionState = new SelectionState( selection.textFlow, selection.anchorPosition, selection.anchorPosition ); editManager.splitParagraph( changedSelection ); changedSelection = new SelectionState( changedSelection.textFlow, changedSelection.anchorPosition + 1, changedSelection.anchorPosition + 1); editManager.insertInlineGraphic( source, width, height, float, changedSelection ); changedSelection = new SelectionState( changedSelection.textFlow, changedSelection.anchorPosition + 1, changedSelection.anchorPosition + 1); editManager.splitParagraph( changedSelection ); editManager.endCompositeOperation(); } } }
insertInlineGraphic | () | Methode |
public function insertInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):InlineGraphicElement
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10 - + 10.2, AIR 1.5 |
Fügt eine Grafik ein.
Die Quelle der Grafik kann ein String sein, der einen URI, ein URLRequest-Objekt, ein Class-Objekt, das ein eingebettetes Element darstellt, oder eine DisplayObject-Instanz enthält.
Bei den Werten für die Breite und Höhe kann es sich um die Anzahl der Pixel, einen Prozentwert oder den String 'auto' handeln. In diesem Fall wird die tatsächliche Abmessung der Grafik verwendet.
Legen Sie für float
eine der in der Float-Klasse definierten Konstanten fest, um anzugeben, ob die Grafik links oder rechts vom Text oder Inline mit dem Text angezeigt werden muss.
Parameter
source:Object — Kann ein als URI interpretierter String, ein als die Klasse eines Embed DisplayObject interpretiertes Class-Objekt, eine DisplayObject-Instanz oder ein URLRequest sein.
| |
width:Object — Die Breite des einzufügenden Bilds (Zahl, Prozentwert oder „auto“).
| |
height:Object — Die Höhe des einzufügenden Bilds (Zahl, Prozentwert oder „auto“).
| |
options:Object (default = null ) — Keine Unterstützung.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
InlineGraphicElement |
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Shape; import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_insertInlineGraphic { static public function insertInlineGraphic(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 0, 0 ); editManager.insertInlineGraphic( createGraphic(), 6, 6, "none" ); } static private function createGraphic():Shape { var shape:Shape = new Shape(); shape.graphics.beginFill( 0x993366 ); shape.graphics.drawCircle( 5, 4, 6 ); return shape; } } }
insertText | () | Methode |
public function insertText(text:String, origOperationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Fügt Text ein.
Fügt den Text an einer Position oder an einem Bereich im Text ein. Wenn es sich bei der im operationState
-Parameter bereitgestellten Position um einen Bereich handelt (oder der Parameter null
ist und die aktuelle Auswahl ein Bereich ist), wird der derzeit im Bereich befindliche Text durch den eingefügten Text ersetzt.
Parameter
text:String — Der einzufügende String.
| |
origOperationState:SelectionState (default = null ) — Gibt den Text im Textfluss an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_insertText { static public function insertText(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 4, 4 ); editManager.insertText( "now " ); } } }
modifyInlineGraphic | () | Methode |
public function modifyInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ändert eine vorhandene Inline-Grafik.
Legen Sie unveränderliche Eigenschaften für die Werte in der ursprünglichen Grafik fest. (Das Ändern eines vorhandenen Grafikobjekts ist im Allgemeinen effektiver als sein Löschen und Neuerstellen.)
Parameter
source:Object — Kann ein als URI interpretierter String, ein als die Klasse eines Embed DisplayObject interpretiertes Class-Objekt, eine DisplayObject-Instanz oder ein URLRequest sein.
| |
width:Object — Die neue Breite für die Grafik (Zahl oder Prozent).
| |
height:Object — Die neue Höhe für die Grafik (Zahl oder Prozent).
| |
options:Object (default = null ) — Keine Unterstützung.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
width
- und height
-Eigenschaft der Inline-Grafik geändert, um eine Dehnung zu einer Ellipse zu erzielen:
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flash.display.Shape; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_modifyInlineGraphic { static public function modifyInlineGraphic(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 0, 0 ); editManager.insertInlineGraphic( createGraphic(), 6, 6, "none" ); editManager.selectRange( 0, 1 ); editManager.modifyInlineGraphic( null, '12', '5', 'none' ); } static private function createGraphic():Shape { var shape:Shape = new Shape(); shape.graphics.beginFill( 0x993366 ); shape.graphics.drawCircle( 4, 4, 6 ); return shape; } } }
moveChildren | () | Methode |
public function moveChildren(source:FlowGroupElement, sourceIndex:int, numChildren:int, destination:FlowGroupElement, destinationIndex:int, selectionState:SelectionState = null):void
Verschiebt eine Reihe von FlowElements von einem FlowGroupElement zum anderen. Das desinationElement muss ein übergeordnetes Element mit einem zulässigen Typ für die zu verschiebenden untergeordneten Elemente sein. Andernfalls wird ein Ausnahmefehler ausgegeben.
Parameter
source:FlowGroupElement — Das ursprünglich übergeordnete Element der zu verschiebenden Elemente.
| |
sourceIndex:int — Die Indexposition des untergeordneten Elements innerhalb der Quelle des ersten zu verschiebenden Elements.
| |
numChildren:int — Die Anzahl der zu verschiebenden untergeordneten Elemente.
| |
destination:FlowGroupElement — Das neue übergeordnete Element der Elemente nach dem Verschieben.
| |
destinationIndex:int — Die Indexposition des untergeordneten Elements innerhalb des Ziels, an das Elemente verschoben werden.
| |
selectionState:SelectionState (default = null ) — Legt den Text fest, auf den dieser Vorgang angewendet wird und an den die Auswahl beim Rückgängigmachen zurückgegeben wird. Wenn der Wert null ist, wird der Vorgang auf die aktuelle Auswahl angewendet. Wenn keine aktuelle Auswahl vorhanden ist, muss dieser Parameter ungleich null sein.
|
overwriteText | () | Methode |
public function overwriteText(text:String, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Überschreibt den ausgewählten Text.
Wenn es sich bei der Auswahl um eine Punktauswahl handelt, wird das erste Zeichen durch den neuen Text überschrieben.
Parameter
text:String — Der einzufügende String.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_overwriteText { static public function overwriteText(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How zzz brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 4, 6 ); editManager.overwriteText( "now" ); //Displays: How now brown cow. } } }
pasteTextScrap | () | Methode |
public function pasteTextScrap(scrapToPaste:flashx.textLayout.edit:TextScrap, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Fügt den TextScrap in den ausgewählten Bereich ein.
Wenn ein Textbereich angegeben wird, wird der Text im Bereich gelöscht.
Parameter
scrapToPaste:flashx.textLayout.edit:TextScrap — Der TextScrap, der eingefügt werden soll.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.edit.TextScrap; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_pasteTextScrap { static public function pasteText(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How brown cow now.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 13, 17 ); var scrap:TextScrap = editManager.cutTextScrap(); editManager.selectRange( 3, 3 ); editManager.pasteTextScrap( scrap ); //Displays: How now brown cow. } } }
redo | () | Methode |
public function redo():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Führt den vorher rückgängig gemachten Vorgang erneut durch.
Hinweis: Wenn der mit diesem IEditManager verknüpfte IUndoManager auch mit einem anderen IEditManager verknüpft ist, ist es möglich, dass es sich bei dem mit dem anderen IEditManager verknüpften Wiederholungsvorgang um die wiederholte Aktion handelt. Dies kann passieren, wenn sich die FlowOperation eines anderen IEditManager am Beginn des Stapels zum Rückgängigmachen befindet.
Diese Funktion bewirkt nichts, wenn das Rückgängigmachen nicht aktiviert ist.
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.edit.IEditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_redo { static public function redo( textFlow:TextFlow ):void { if( textFlow.interactionManager is IEditManager ) { IEditManager( textFlow.interactionManager ).redo(); } } } }
splitElement | () | Methode |
public function splitElement(target:FlowGroupElement, operationState:SelectionState = null):FlowGroupElement
Teilt das Zielelement an der angegebenen Position und erstellt nach dem aktuellen Element ein neues Element. Wenn der operationState ein Bereich ist, wird der Text innerhalb des Bereichs gelöscht. Das neue Element wird nach der durch operationState angegebenen Textposition erstellt. Das Teilen eines SubParagraphGroupElement hat keine Wirkung, da diese Elemente automatisch wieder mit den benachbarten Elementen zusammengeführt werden.
Ein Beispiel für die Verwendungsmöglichkeiten dieser Funktion ist das Unterteilen einer Liste in zwei Listen.
Parameter
target:FlowGroupElement — Das zu teilende Element.
| |
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
FlowGroupElement — Der neu erstellte Absatz.
|
splitParagraph | () | Methode |
public function splitParagraph(operationState:SelectionState = null):ParagraphElement
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Teilt den Absatz an der aktuellen Position und erstellt nach dem aktuellen Absatz einen neuen Absatz.
Wenn ein Textbereich angegeben wird, wird der Text im Bereich gelöscht.
Parameter
operationState:SelectionState (default = null ) — Gibt den Text an, auf den dieser Vorgang angewendet wird; im Falle von null wird der Vorgang auf die aktuelle Auswahl angewendet.
|
ParagraphElement — Der neu erstellte Absatz.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.edit.TextScrap; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_splitParagraph { static public function splitParagraph(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 8, 8 ); editManager.splitParagraph(); //Displays: How now // brown cow. } } }
undo | () | Methode |
public function undo():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Kehrt den vorherigen Vorgang um.
Hinweis: Wenn der mit diesem IEditManager verknüpfte IUndoManager auch mit einem anderen IEditManager verknüpft ist, ist es möglich, dass es sich bei dem mit dem anderen IEditManager verknüpften Vorgang zum Rückgängigmachen um die rückgängig gemachte Aktion handelt. Dies kann passieren, wenn sich die FlowOperation eines anderen IEditManager am Beginn des Stapels zum Rückgängigmachen befindet.
Diese Funktion bewirkt nichts, wenn das Rückgängigmachen nicht aktiviert ist.
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_undo { static public function undo( textFlow:TextFlow ):void { if( textFlow.interactionManager is IEditManager ) { IEditManager( textFlow.interactionManager ).undo(); } } } }
updateAllControllers | () | Methode |
public function updateAllControllers():void
- Erstellen Sie einen TextFlow (
tf
) zur Aufnahme von einer Zeile Beispieltext. - Speichern Sie den Text in einem SpanElement, das wiederum in einem ParagraphElement gespeichert wird.
- Erstellen Sie einen ContainerController für den Text und führen Sie das Composing des anzuzeigenden Texts durch.
- Instanziieren Sie die TextFlow-Managerobjekte zur späteren Verwendung durch einen Ereignis-Listener.
- Erstellen Sie eine sehr einfache Schaltfläche (EditButton), mit welcher der Benutzer den Text bearbeitbar machen kann.
- Erstellen Sie den Ereignis-Listener der Schaltfläche, der zwischen dem schreibgeschützten und bearbeitbaren Status hin- und herschaltet.
Der Wert der interactionManager
-Eigenschaft des TextFlow bestimmt, ob der Beispieltext bearbeitet werden kann. Ist die Eigenschaft null
, ist der Beispieltext schreibgeschützt. Wurde der Eigenschaft eine EditManager-Instanz zugewiesen, kann der Beispieltext bearbeitet werden. Die createEditButton()-Methode erstellt eine sehr einfache schaltflächenähnliche TextField-Instanz. Wenn der Benutzer auf die TextField-Instanz klickt, ändert die updateEditable()
-Listener-Funktion den Wert der interactionManager
-Eigenschaft.
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flashx.textLayout.container.ContainerController; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_example extends Sprite { private var tf:TextFlow; private var em:EditManager; private var um:UndoManager; private var editable:TextField; public function EditManager_example() { //define TextFlow tf = new TextFlow(); //define elements to contain text var p:ParagraphElement = new ParagraphElement(); var s:SpanElement = new SpanElement(); s.text ="This is sample text for the EditManager example."; //add these elements to the TextFlow p.addChild(s); tf.addChild(p); //compose TextFlow to display var tfController:ContainerController = new ContainerController(this,600,600); tfController.container.y = 10 tf.flowComposer.addController(tfController); tf.flowComposer.updateAllControllers(); //define TextFlow manager objects um = new UndoManager(); em = new EditManager(um); tf.interactionManager = null; createEditButton(); } private function createEditButton ():void { editable = new TextField(); editable.appendText("Click to make the sample text editable"); editable.x = 0; editable.y = 50; editable.width = 150; editable.autoSize = flash.text.TextFieldAutoSize.LEFT; editable.selectable = false; editable.background = true; editable.backgroundColor = 0xAAAAAA; addChild(editable); editable.addEventListener(MouseEvent.CLICK, updateEditable); } private function updateEditable(me:MouseEvent):void{ if (editable.text.indexOf("read only") >= 0) { editable.text = "Click to make the sample text editable"; tf.interactionManager = null; } else { editable.text = "Click to make the sample text read only"; tf.interactionManager = em; } } } }
Tue Jun 12 2018, 10:04 AM Z