Paket | flashx.textLayout.edit |
Schnittstelle | public interface IEditManager extends ISelectionManager , IInteractionEventHandler |
Umsetzer | EditManager |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Um die Textflussbearbeitung zu aktivieren, weisen Sie eine IEditManager-Instanz 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.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
absoluteEnd : int [schreibgeschützt]
Die Textposition am Ende der Auswahl als Offset ab Beginn des Textflusses. | ISelectionManager | ||
absoluteStart : int [schreibgeschützt]
Die Textposition am Anfang der Auswahl als Offset ab Beginn des Textflusses. | ISelectionManager | ||
activePosition : int [schreibgeschützt]
Der aktive Punkt der Auswahl. | ISelectionManager | ||
allowDelayedOperations : Boolean Steuert, ob Vorgänge für die Ausführung zu einem späteren Zeitpunkt in die Warteschlange gestellt werden können. | IEditManager | ||
anchorPosition : int [schreibgeschützt]
Der Ankerpunkt der Auswahl. | ISelectionManager | ||
currentSelectionFormat : SelectionFormat [schreibgeschützt]
Das aktuelle SelectionFormat-Objekt. | ISelectionManager | ||
delayUpdates : Boolean
Standardmäßig werden bei IEditManager-Aufrufen Aktualisierungen synchron ausgeführt, sodass die angeforderte Änderung vorgenommen wird und der Text neu zusammengesetzt sowie der Anzeigeliste innerhalb der IEditManager-Methode hinzugefügt wird. | IEditManager | ||
editingMode : String [schreibgeschützt]
Der Bearbeitungsmodus. | ISelectionManager | ||
focused : Boolean [schreibgeschützt]
Gibt an, ob ein Container im Textfluss den Fokus hat. | ISelectionManager | ||
focusedSelectionFormat : SelectionFormat
Das SelectionFormat-Objekt, das zum Ziehen der Auswahl in einen fokussierten Container verwendet wird. | ISelectionManager | ||
inactiveSelectionFormat : SelectionFormat
Das SelectionFormat-Objekt, das zum Ziehen der Auswahl verwendet wird, wenn sie sich nicht im aktiven Fenster befindet. | ISelectionManager | ||
textFlow : flashx.textLayout.elements:TextFlow
Das von diesem Auswahlmanager verwaltete TextFlow-Objekt. | ISelectionManager | ||
undoManager : IUndoManager [schreibgeschützt]
Das UndoManager-Objekt, das dieser EditManager-Instanz zugewiesen ist, falls vorhanden. | IEditManager | ||
unfocusedSelectionFormat : SelectionFormat
Das SelectionFormat-Objekt, das zum Ziehen der Auswahl verwendet wird, wenn sie sich nicht im fokussierten Container, sondern im aktiven Fenster befindet. | ISelectionManager | ||
windowActive : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Textfluss verknüpfte Fenster aktiv ist. | ISelectionManager |
Methode | Definiert von | ||
---|---|---|---|
Verarbeitet ein Aktivierungsereignis. | IInteractionEventHandler | ||
applyContainerFormat(format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Wendet Containerstile auf alle Container in der Auswahl an. | IEditManager | ||
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. | IEditManager | ||
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. | IEditManager | ||
applyLeafFormat(format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Ändert das auf die Blattelemente in der angegebenen (oder aktuellen) Auswahl angewendete Format. | IEditManager | ||
applyLink(href:String, target:String = null, extendToLinkBoundary:Boolean = false, operationState:SelectionState = null):LinkElement
Wandelt eine Auswahl in eine Verknüpfung oder eine Verknüpfung in normalen Text um. | IEditManager | ||
applyParagraphFormat(format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Wendet Absatzstile auf alle Absätze in der Auswahl an. | IEditManager | ||
Wandelt Text in eine TCY-Ausführung oder eine TCY-Ausführung in Nicht-TCY-Text aus. | IEditManager | ||
Beginnt eine neue Gruppe von Vorgängen. | IEditManager | ||
changeElementID(newID:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Ändert die ID eine Elements. | IEditManager | ||
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. | IEditManager | ||
changeTypeName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Ändert den typeName eines Elements oder eines Elementteils. | IEditManager | ||
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. | IEditManager | ||
clearFormatOnElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Hebt die Definition von Stilen für das angegebene Element auf. | IEditManager | ||
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. | IEditManager | ||
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. | IEditManager | ||
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. | IEditManager | ||
Löscht den ausgewählten Bereich und gibt den gelöschten Bereich in einem TextScrap-Objekt zurück. | IEditManager | ||
Verarbeitet ein Deaktivierungsereignis. | IInteractionEventHandler | ||
Löscht einen Textbereich oder löscht bei gegebener Punktauswahl das nächste Zeichen. | IEditManager | ||
Löscht das nächste Wort. | IEditManager | ||
Löscht einen Textbereich oder löscht bei gegebener Punktauswahl das vorherige Zeichen. | IEditManager | ||
Löscht das vorherige Wort. | IEditManager | ||
Löscht einen Textbereich. | IEditManager | ||
Führt eine FlowOperation aus. | IEditManager | ||
Verarbeitet ein Bearbeitungsereignis. | IInteractionEventHandler | ||
Beendet eine Gruppe von Vorgängen. | IEditManager | ||
Führt ausstehende FlowOperations aus. | ISelectionManager | ||
Verarbeitet ein focusChange-Ereignis. | IInteractionEventHandler | ||
Verarbeitet ein focusIn-Ereignis. | IInteractionEventHandler | ||
Verarbeitet ein focusOut-Ereignis. | IInteractionEventHandler | ||
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. | ISelectionManager | ||
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. | ISelectionManager | ||
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. | ISelectionManager | ||
Ruft das SelectionState-Objekt der aktuellen Auswahl ab. | ISelectionManager | ||
Zeigt an, ob es eine Auswahl gibt. | ISelectionManager | ||
Verarbeitet ein imeStartComposition-Ereignis.
| IInteractionEventHandler | ||
insertInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):InlineGraphicElement
Fügt eine Grafik ein. | IEditManager | ||
Fügt Text ein. | IEditManager | ||
Gibt an, ob die Auswahl einen Textbereich abdeckt. | ISelectionManager | ||
Verarbeitet ein keyDown-Ereignis. | IInteractionEventHandler | ||
Verarbeitet ein keyFocusChange-Ereignis. | IInteractionEventHandler | ||
Verarbeitet ein keyUp-Ereignis. | IInteractionEventHandler | ||
Verarbeitet ein menuSelect-Ereignis. | IInteractionEventHandler | ||
modifyInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):void
Ändert eine vorhandene Inline-Grafik. | IEditManager | ||
Verarbeitet ein mouseDoubleClick-Ereignis. | IInteractionEventHandler | ||
Verarbeitet ein mouseDown-Ereignis. | IInteractionEventHandler | ||
Verarbeitet ein mouseMove-Ereignis. | IInteractionEventHandler | ||
Verarbeitet ein mouseOut-Ereignis. | IInteractionEventHandler | ||
Verarbeitet ein mouseOver-Ereignis. | IInteractionEventHandler | ||
Verarbeitet ein mouseUp-Ereignis. | IInteractionEventHandler | ||
Verarbeitet ein mouseWheel-Ereignis. | IInteractionEventHandler | ||
moveChildren(source:FlowGroupElement, sourceIndex:int, numChildren:int, destination:FlowGroupElement, destinationIndex:int, operationState:SelectionState = null):void Verschiebt eine Reihe von FlowElements von einem FlowGroupElement zum anderen. | IEditManager | ||
Aktualisiert den Auswahlmanager, wenn Text eingefügt oder gelöscht wird. | ISelectionManager | ||
Überschreibt den ausgewählten Text. | IEditManager | ||
pasteTextScrap(scrapToPaste:flashx.textLayout.edit:TextScrap, operationState:SelectionState = null):void
Fügt den TextScrap in den ausgewählten Bereich ein. | IEditManager | ||
Führt den vorher rückgängig gemachten Vorgang erneut durch. | IEditManager | ||
Zeigt die Auswahlformen erneut an. | ISelectionManager | ||
Wählt den gesamten Fluss aus.. | ISelectionManager | ||
Wählt einen Textbereich aus. | ISelectionManager | ||
Legt den Fokus auf den ersten Container in der Auswahl. | ISelectionManager | ||
Legt das SelectionState-Objekt der aktuellen Auswahl fest. | ISelectionManager | ||
Verarbeitet ein softKeyboardActivating-Ereignis.
| IInteractionEventHandler | ||
Teilt das Zielelement an der angegebenen Position und erstellt nach dem aktuellen Element ein neues Element. | IEditManager | ||
Teilt den Absatz an der aktuellen Position und erstellt nach dem aktuellen Absatz einen neuen Absatz. | IEditManager | ||
Verarbeitet ein TextEvent. | IInteractionEventHandler | ||
Kehrt den vorherigen Vorgang um. | IEditManager | ||
Aktualisiert die Anzeige, nachdem sie von einem Vorgang geändert wurde. | IEditManager |
allowDelayedOperations | Eigenschaft |
allowDelayedOperations:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.2, AIR 2.0 |
Steuert, ob Vorgänge für die Ausführung zu einem späteren Zeitpunkt in die Warteschlange gestellt werden können.
Zur Optimierung der Leistung werden manche Vorgänge möglicherweise mit Verzögerung ausgeführt. So kann es sich anbieten, mehrere Tastaturbefehle in einem einzigen Einfügevorgang zusammenzufassen. Wenn für allowDelayedOperations
der Wert true
angegeben wird, können Vorgänge in die Warteschlange gestellt werden. Bei dem Wert false
werden alle Vorgänge automatisch ausgeführt. Die Standardeinstellung ist true
.
Implementierung
public function get allowDelayedOperations():Boolean
public function set allowDelayedOperations(value:Boolean):void
Verwandte API-Elemente
delayUpdates | Eigenschaft |
delayUpdates:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.2, AIR 2.0 |
Standardmäßig werden bei IEditManager-Aufrufen Aktualisierungen synchron ausgeführt, sodass die angeforderte Änderung vorgenommen wird und der Text neu zusammengesetzt sowie der Anzeigeliste innerhalb der IEditManager-Methode hinzugefügt wird. Um das erneute Zeichnen zu verzögern, legen Sie für delayUpdates
den Wert true
fest. Dadurch aktualisiert IEditManager lediglich das Modell; Neuzusammenstellung und erneutes Zeichnen erfolgen beim nächsten enter_frame
-Ereignis.
Implementierung
public function get delayUpdates():Boolean
public function set delayUpdates(value:Boolean):void
undoManager | Eigenschaft |
undoManager:IUndoManager
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Das UndoManager-Objekt, das dieser EditManager-Instanz zugewiesen ist, falls vorhanden.
Ein Undo-Manager verarbeitet Vorgänge zum Rückgängigmachen oder Wiederholen.
Implementierung
public function get undoManager():IUndoManager
applyContainerFormat | () | Methode |
public function applyContainerFormat(format: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
format: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.
|
Beispiel ( Verwendung dieses Beispiels )
package flashx.textLayout.edit.examples { import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.FlowElement; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.formats.TextLayoutFormat; public class EditManager_applyFormatToElement { public function EditManager_applyFormatToElement( selection:SelectionState ):void { var textFlow:TextFlow = TextConverter.importToFlow("<TextFlow><div><p><span>Hello World</span></p></div><p>No indent</p></TextFlow>", TextConverter.TEXT_LAYOUT_FORMAT); var editManager:IEditManager = textFlow.interactionManager as IEditManager; var divElement:FlowElement = textFlow.getChildAt(0); var format:TextLayoutFormat = new TextLayoutFormat(); format.textIndent = 15; editManager.applyFormatToElement( divElement, format ); } } }
applyLeafFormat | () | Methode |
public function applyLeafFormat(format: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
format: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, target:String = null, extendToLinkBoundary:Boolean = false, operationState:SelectionState = null):LinkElement
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, 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.
| |
target: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.
|
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.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(format: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
format: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, 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.
|
Verwandte API-Elemente
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.
Verwandte API-Elemente
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
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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
flashx.textLayout.edit.TextClipboard.setContents
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 |
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.
Verwandte API-Elemente
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, 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, operationState: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.
| |
operationState: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.
|
Verwandte API-Elemente
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, operationState:SelectionState = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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.
| |
operationState: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
flashx.textLayout.edit.TextClipboard.getContents
flashx.textLayout.edit.TextScrap
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
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.2, AIR 2.0 |
Aktualisiert die Anzeige, nachdem sie von einem Vorgang geändert wurde. Dies erfolgt normalerweise automatisch. Rufen Sie diese Methode jedoch auf, wenn delayUpdates
aktiv ist und die Anzeige vor dem nächsten enter_frame
-Ereignis aktualisiert werden soll.
Tue Jun 12 2018, 10:04 AM Z