Pakiet | flashx.textLayout.edit |
Interfejs | public interface IEditManager extends ISelectionManager , IInteractionEventHandler |
Implementory | EditManager |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Aby umożliwić edytowanie przepływu tekstu, należy przypisać instancję klasy IEditManager do właściwości interactionManager
obiektu TextFlow. Menedżer edycji obsługuje zmiany tekstu (np. wstawienia, usunięcia i zmiany formatu). Zmiany są odwracalne, jeśli menedżer edycji zawiera menedżera cofania. Menedżer edycji wywołuje zmianę określania układu oraz zmianę sposobu wyświetlania przepływu tekstu (w zależności od potrzeb).
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
absoluteEnd : int [tylko do odczytu]
Położenie tekstu będące końcem zaznaczenia, jako przesunięcie od początku przepływu tekstu. | ISelectionManager | ||
absoluteStart : int [tylko do odczytu]
Położenie tekstu będące początkiem zaznaczenia, jako przesunięcie od początku przepływu tekstu. | ISelectionManager | ||
activePosition : int [tylko do odczytu]
Punkt aktywny zaznaczenia. | ISelectionManager | ||
allowDelayedOperations : Boolean Określa, czy operacje można umieszczać w kolejce do wykonania później. | IEditManager | ||
anchorPosition : int [tylko do odczytu]
Punkt kontrolny zaznaczenia. | ISelectionManager | ||
currentSelectionFormat : SelectionFormat [tylko do odczytu]
Bieżący obiekt SelectionFormat. | ISelectionManager | ||
delayUpdates : Boolean
Domyślnie wywołania interfejsu IEditManager obsługują aktualizacje asynchronicznie. Żądana zmiana jest wprowadzana, a tekst jest ponownie komponowany i dodawany do listy wyświetlania w metodzie IEditManager. | IEditManager | ||
editingMode : String [tylko do odczytu]
Tryb edycji. | ISelectionManager | ||
focused : Boolean [tylko do odczytu]
Wskazuje, czy kontener w przepływie tekstu zawiera punkt skupienia. | ISelectionManager | ||
focusedSelectionFormat : SelectionFormat
Obiekt SelectionFormat służący do rysowania zaznaczenia w kontenerze objętym punktem skupienia. | ISelectionManager | ||
inactiveSelectionFormat : SelectionFormat
Obiekt SelectionFormat służący do narysowania zaznaczenia, gdy nie znajduje się ono w aktywnym oknie. | ISelectionManager | ||
textFlow : flashx.textLayout.elements:TextFlow
Obiekt TextFlow zarządzany przez menedżera zaznaczania. | ISelectionManager | ||
undoManager : IUndoManager [tylko do odczytu]
Obiekt UndoManager przypisany do danej instancji klasy EditManager (jeśli obiekt istnieje). | IEditManager | ||
unfocusedSelectionFormat : SelectionFormat
Obiekt SelectionFormat służący do rysowania zaznaczenia, gdy nie znajduje się w kontenerze objętym punktem skupienia, ale znajduje się w aktywnym oknie. | ISelectionManager | ||
windowActive : Boolean [tylko do odczytu]
Wskazuje, czy okno skojarzone z przepływem tekstu jest aktywne. | ISelectionManager |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Przetwarza zdarzenie activate. | IInteractionEventHandler | ||
applyContainerFormat(format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Stosuje style kontenera do dowolnych kontenerów w zaznaczeniu. | IEditManager | ||
applyFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Zmienia formaty wybranego (lub bieżącego) zaznaczenia. | IEditManager | ||
applyFormatToElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Stosuje style do wybranego elementu. | IEditManager | ||
applyLeafFormat(format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Zmienia format zastosowany do elementów-liści w określonym (lub bieżącym) zaznaczeniu. | IEditManager | ||
applyLink(href:String, target:String = null, extendToLinkBoundary:Boolean = false, operationState:SelectionState = null):LinkElement
Przekształca zaznaczenie w łącze lub łącze w normalny tekst. | IEditManager | ||
applyParagraphFormat(format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Stosuje style akapitu do dowolnych akapitów w zaznaczeniu. | IEditManager | ||
Przekształca tekst na bieg TCY lub bieg TCY na tekst inny niż TCY. | IEditManager | ||
Rozpoczyna nową grupę operacji. | IEditManager | ||
changeElementID(newID:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Zmienia identyfikator elementu. | IEditManager | ||
changeStyleName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void Przestarzałe od 2.0: Użyj applyFormatToElement
Zmienia wartość styleName elementu lub części elementu. | IEditManager | ||
changeTypeName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Zmienia właściwość typeName elementu lub części elementu. | IEditManager | ||
clearFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Usuwa definicje formatów określonego (lub bieżącego) zaznaczenia. | IEditManager | ||
clearFormatOnElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Usuwa definicje stylów zastosowane do wybranego elementu. | IEditManager | ||
createDiv(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):DivElement Tworzy nowy obiekt DivElement zawierający cały zakres określony we właściwości. Jest używany element macierzysty najniższego poziomu, który zawiera elementy początkowy i końcowy zakresu. | IEditManager | ||
createList(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):ListElement Tworzy nowy obiekt ListElement zawierający cały zakres określony we właściwości. Jest używany element macierzysty najniższego poziomu, który zawiera elementy początkowy i końcowy zakresu. | IEditManager | ||
createSubParagraphGroup(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):SubParagraphGroupElement Tworzy nowy obiekt SubParagraphGroupElement zawierający cały zakres określony we właściwości. Jest używany element macierzysty najniższego poziomu, który zawiera elementy początkowy i końcowy zakresu. | IEditManager | ||
Usuwa zaznaczony obszar i zwraca usunięty obszar w obiekcie TextScrap. | IEditManager | ||
Przetwarza zdarzenie deactivate. | IInteractionEventHandler | ||
Usuwa zakres tekstu lub — jeśli zaznaczony jest punkt — usuwa następny znak. | IEditManager | ||
Usuwa następny wyraz. | IEditManager | ||
Usuwa zakres tekstu lub — jeśli zaznaczony jest punkt — usuwa poprzedni znak. | IEditManager | ||
Usuwa poprzednie słowo. | IEditManager | ||
Usuwa zakres tekstu. | IEditManager | ||
Wykonuje operację FlowOperation. | IEditManager | ||
Przetwarza zdarzenie edit. | IInteractionEventHandler | ||
Kończy grupę operacji. | IEditManager | ||
Wykonuje wszelkie oczekujące operacje FlowOperation. | ISelectionManager | ||
Przetwarza zdarzenie focusChange. | IInteractionEventHandler | ||
Przetwarza zdarzenie focusIn. | IInteractionEventHandler | ||
Przetwarza zdarzenie focusOut. | IInteractionEventHandler | ||
getCommonCharacterFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Pobiera atrybuty formatu znaków, które są wspólne dla wszystkich znaków w określonym zakresie tekstu lub w bieżącym zaznaczeniu. | ISelectionManager | ||
getCommonContainerFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Pobiera atrybuty formatu kontenera, które są wspólne dla wszystkich kontenerów w określonym zakresie tekstu lub w bieżącym zaznaczeniu. | ISelectionManager | ||
getCommonParagraphFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Pobiera atrybuty formatu akapitu, które są wspólne dla wszystkich akapitów w określonym zakresie tekstu lub w bieżącym zaznaczeniu. | ISelectionManager | ||
Pobiera obiekt SelectionState bieżącego zaznaczenia. | ISelectionManager | ||
Wskazuje, czy istnieje zaznaczenie. | ISelectionManager | ||
Przetwarza zdarzenie imeStartComposition.
| IInteractionEventHandler | ||
insertInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):InlineGraphicElement
Wstawia obraz. | IEditManager | ||
Wstawia tekst. | IEditManager | ||
Wskazuje, czy zaznaczenie pokrywa zakres tekstu. | ISelectionManager | ||
Przetwarza zdarzenie keyDown. | IInteractionEventHandler | ||
Przetwarza zdarzenie keyFocusChange. | IInteractionEventHandler | ||
Przetwarza zdarzenie keyUp. | IInteractionEventHandler | ||
Przetwarza zdarzenie menuSelect. | IInteractionEventHandler | ||
modifyInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):void
Modyfikuje istniejący wstawiany obiekt graficzny. | IEditManager | ||
Przetwarza zdarzenie mouseDoubleClick. | IInteractionEventHandler | ||
Przetwarza zdarzenie mouseDown. | IInteractionEventHandler | ||
Przetwarza zdarzenie mouseMove. | IInteractionEventHandler | ||
Przetwarza zdarzenie mouseOut. | IInteractionEventHandler | ||
Przetwarza zdarzenie mouseOver. | IInteractionEventHandler | ||
Przetwarza zdarzenie mouseUp. | IInteractionEventHandler | ||
Przetwarza zdarzenie mouseWheel. | IInteractionEventHandler | ||
moveChildren(source:FlowGroupElement, sourceIndex:int, numChildren:int, destination:FlowGroupElement, destinationIndex:int, operationState:SelectionState = null):void Przenosi zestaw obiektów FlowElement z jednego obiektu FlowGroupElement do innego. | IEditManager | ||
Aktualizuje menedżera zaznaczenia w razie wstawienia lub usunięcia tekstu. | ISelectionManager | ||
Zastępuje zaznaczony tekst. | IEditManager | ||
pasteTextScrap(scrapToPaste:flashx.textLayout.edit:TextScrap, operationState:SelectionState = null):void
Wkleja obiekt TextScrap do wybranego obszaru. | IEditManager | ||
Ponownie wykonuje poprzednią cofniętą operację. | IEditManager | ||
Ponownie wyświetla kształty zaznaczenia. | ISelectionManager | ||
Zaznacza cały wiersz. | ISelectionManager | ||
Wybiera zakres tekstu. | ISelectionManager | ||
Ustawia punkt skupienia na pierwszym kontenerze w zaznaczeniu. | ISelectionManager | ||
Ustawia obiekt SelectionState bieżącego zaznaczenia. | ISelectionManager | ||
Przetwarza zdarzenie softKeyboardActivating.
| IInteractionEventHandler | ||
Dzieli element docelowy w określonym miejscu, tworząc nowy element po bieżącym elemencie. | IEditManager | ||
Dzieli akapit w bieżącym miejscu, tworząc nowy akapit po bieżącym akapicie. | IEditManager | ||
Przetwarza zdarzenie TextEvent. | IInteractionEventHandler | ||
Odwraca poprzednią operację. | IEditManager | ||
Aktualizuje zawartość wyświetlacza po modyfikacji przez operację. | IEditManager |
allowDelayedOperations | właściwość |
allowDelayedOperations:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10.2, AIR 2.0 |
Określa, czy operacje można umieszczać w kolejce do wykonania później.
Wykonanie niektórych operacji można opóźnić w celu zoptymalizowania wydajności. Przydatne może na przykład być połączenie wielu naciśnięć klawiszy w jedną operację wstawiania. Jeśli właściwość allowDelayedOperations
ma wartość true
, można umieszczać operacje w kolejce. W przypadku wartości false
wszystkie operacje są wykonywane natychmiast. Wartość domyślna to true
.
Implementacja
public function get allowDelayedOperations():Boolean
public function set allowDelayedOperations(value:Boolean):void
Powiązane elementy interfejsu API
delayUpdates | właściwość |
delayUpdates:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10.2, AIR 2.0 |
Domyślnie wywołania interfejsu IEditManager obsługują aktualizacje asynchronicznie. Żądana zmiana jest wprowadzana, a tekst jest ponownie komponowany i dodawany do listy wyświetlania w metodzie IEditManager. Aby ponowne rysowanie następowało z opóźnieniem, należy dla właściwości delayUpdates
ustawić wartość true
. W ten sposób interfejs IEditManager będzie aktualizował tylko model, a ponowne tworzenie kompozycji i ponowne rysowanie będzie następowało przy kolejnym zdarzeniu enter_frame
.
Implementacja
public function get delayUpdates():Boolean
public function set delayUpdates(value:Boolean):void
undoManager | właściwość |
undoManager:IUndoManager
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Obiekt UndoManager przypisany do danego wystąpienia klasy EditManager (jeśli obiekt istnieje).
Menedżer cofania obsługuje operacje cofania i ponawiania.
Implementacja
public function get undoManager():IUndoManager
applyContainerFormat | () | metoda |
public function applyContainerFormat(format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Stosuje style kontenera do dowolnych kontenerów w zaznaczeniu.
Wszelkie właściwości stylu w obiekcie formatu, które mają wartość null
, są pozostawiane bez zmian.
Parametry
format:flashx.textLayout.formats:ITextLayoutFormat — Format przeznaczony do zastosowania do kontenerów w zakresie.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function applyFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Zmienia formaty wybranego (lub bieżącego) zaznaczenia.
Wykonuje operację możliwą do wycofania, która stosuje nowe formaty. Stosowane są tylko atrybuty stylu ustawione dla obiektów TextLayoutFormat. Niezdefiniowane atrybuty w obiektach formatu nie są zmieniane.
Parametry
leafFormat:flashx.textLayout.formats:ITextLayoutFormat — Format do zastosowania do elementów-liści, takich jak zakresy i grafiki w tekście.
| |
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat — Format do zastosowania do elementów akapitu.
| |
containerFormat:flashx.textLayout.formats:ITextLayoutFormat — Format do zastosowania do kontenerów.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function applyFormatToElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Stosuje style do wybranego elementu.
Wszelkie właściwości stylu w obiekcie formatu, które mają wartość null
, są pozostawiane bez zmian. Stosowane są tylko style istotne dla określonego elementu.
Parametry
targetElement:FlowElement — Element, do którego stosowane są style.
| |
format:flashx.textLayout.formats:ITextLayoutFormat — Format zawierający style do zastosowania.
| |
relativeStart:int (default = 0 ) — Przesunięcie od początku elementu określające miejsce, w którym element ma zostać podzielony w przypadku przypisania nowego formatowania.
| |
relativeEnd:int (default = -1 ) — Przesunięcie od początku elementu określające miejsce, w którym element ma zostać podzielony w przypadku stosowania nowego formatowania.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function applyLeafFormat(format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Zmienia format zastosowany do elementów-liści w określonym (lub bieżącym) zaznaczeniu.
Wykonuje operację możliwą do wycofania, która stosuje nowy format do elementów liścia, takich jak obiekty SpanElement i InlineGraphicElement. Stosowane są tylko atrybuty stylu ustawione dla obiektów TextLayoutFormat. Zmieniane są niezdefiniowane atrybuty w obiektach formatu.
Parametry
format:flashx.textLayout.formats:ITextLayoutFormat — Format do zastosowania.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function applyLink(href:String, target:String = null, extendToLinkBoundary:Boolean = false, operationState:SelectionState = null):LinkElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Przekształca zaznaczenie w łącze lub łącze w normalny tekst.
Wykonuje operację możliwą do wycofania, która tworzy lub usuwa łącze.
Jeśli określony jest parametr target
, musi przyjmować jedną z następujących wartości:
- "_self"
- "_blank"
- "_parent"
- "_top"
W środowiskach wykonawczych obsługiwanych przez przeglądarkę cel "_self" zastępuje bieżącą stronę html. Dlatego jeśli treść SWF zawierająca łącze znajduje się na stronie w klatce lub zestawie klatek, wówczas treść, na którą wskazuje łącze, jest ładowana w ramach tej klatki. Jeśli strona znajduje się na najwyższym poziomie, wówczas treść, na którą wskazuje łącze, otwiera się w celu zastąpienia strony oryginalnej. Cel parametru "_blank" otwiera nowe okno przeglądarki bez nazwy. Cel parametru "_parent" zastępuje obiekt nadrzędny strony html zawierającej treść SWF. Cel elementu "_top" zastępuje stronę górnego poziomu w bieżącym oknie przeglądarki.
W innych środowiskach wykonawczych, takich jak Adobe AIR, łącze jest otwierane w domyślnej przeglądarce użytkownika, a parametr target
jest ignorowany.
Parametr extendToLinkBoundary
określa, w jaki sposób menedżer edycji traktuje zaznaczenie, które przecina się z jednym lub większą liczbą istniejących łączy. Jeśli parametr ma wartość true
, wówczas operacja jest stosowana całościowo do zaznaczania oraz do całego tekstu istniejących łączy. W ten sposób tworzone jest pojedyncze łącze, które rozciąga się od początku pierwszego łącza z przecięcia do końca ostatniego łącza z przecięcia. I na odwrót — jeśli·extendToLinkBoundary
ma w takiej sytuacji wartość false
, wówczas istniejące częściowo zaznaczone łącza zostaną podzielone na dwa.
Parametry
href:String — Identyfikator URI, do którego odwołuje się łącze.
| |
target:String (default = null ) — Okno przeglądarki docelowej łącza.
| |
extendToLinkBoundary:Boolean (default = false ) — Określa, czy wymagana jest konsolidacja zaznaczenia z dowolnymi nachodzącymi na siebie, istniejącymi łączami, a następnie zastosowanie zmiany.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
LinkElement — Utworzony obiekt LinkElement.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function applyParagraphFormat(format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Stosuje style akapitu do dowolnych akapitów w zaznaczeniu.
Wszelkie właściwości stylu w obiekcie formatu, które mają wartość null
, są pozostawiane bez zmian.
Parametry
format:flashx.textLayout.formats:ITextLayoutFormat — Format do zastosowania do wybranych akapitów.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function applyTCY(tcyOn:Boolean, operationState:SelectionState = null):flashx.textLayout.elements:TCYElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Przekształca tekst na bieg TCY lub bieg TCY na tekst inny niż TCY.
TCY (tate-chu-yoko) — tekst jest rysowany poziomo w ramach pionowego wiersza; to ustawienie zwiększa czytelność małych niejapońskich znaków tekstu i cyfr (np. dat) w wierszu pionowym.
Parametry
tcyOn:Boolean — Ustawianie wartości true powoduje zastosowanie przekształcenia TCY do zakresu tekstu, a określenie false powoduje usunięcie przekształcenia TCY.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
flashx.textLayout.elements:TCYElement — Utworzony obiekt TCYElement.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function beginCompositeOperation():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Rozpoczyna nową grupę operacji.
Wszystkie operacje wykonywane po wywołaniu metody beginCompositeOperation()
oraz przed wywołaniem uzgadniającym metody endCompositeOperation()
są wykonywane i grupowane jako jedna operacja, która może zostać wycofana jednorazowo.
Blok beginCompositeOperation
/endCompositeOperation
można osadzić w innym bloku beginCompositeOperation
/endCompositeOperation
.
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
beginCompositeOperation()
i endCompositeOperation()
, wówczas każda z podoperacji będzie musiała zostać wycofana oddzielnie, a nie grupowo.
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 | () | metoda |
public function changeElementID(newID:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Zmienia identyfikator elementu.
Jeśli ustawione są parametry relativeStart
lub relativeEnd
(na dowolne wartość inne niż domyślne), wówczas element podlega podziałowi. Części elementu poza tym zakresem zachowują oryginalny identyfikator. Ustawienie parametrów relativeStart
i relativeEnd
powoduje tworzenie elementów ze zduplikowanymi identyfikatorami.
Parametry
newID:String — Nowa wartość identyfikatora.
| |
targetElement:FlowElement — Element do zmodyfikowania.
| |
relativeStart:int (default = 0 ) — Przesunięcie od początku elementu określające miejsce, w którym wymagany jest podział elementu w przypadku przypisania nowego identyfikatora.
| |
relativeEnd:int (default = -1 ) — Przesunięcie od początku elementu określające miejsce, w którym wymagany jest podział elementu w przypadku przypisania nowego identyfikatora.
| |
operationState:SelectionState (default = null ) — Określa zaznaczenie do przywrócenia w przypadku cofnięcia danej operacji. W przypadku wartości null ta operacja zapisuje bieżące zaznaczenie.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function changeStyleName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Zmienia wartość styleName elementu lub części elementu.
Jeśli ustawione są parametry relativeStart
lub relativeEnd
(na dowolne wartość inne niż domyślne), wówczas element podlega podziałowi. Części elementu poza tym zakresem zachowują oryginalny styl.
Parametry
newName:String — Nazwa nowego stylu.
| |
targetElement:FlowElement — Określa element do zmiany.
| |
relativeStart:int (default = 0 ) — Przesunięcie od początku elementu określające miejsce, w którym wymagany jest podział elementu w przypadku przypisania nowego stylu.
| |
relativeEnd:int (default = -1 ) — Przesunięcie od końca elementu określające miejsce, w którym wymagany jest podział elementu w przypadku przypisania nowego stylu.
| |
operationState:SelectionState (default = null ) — Określa zaznaczenie do przywrócenia w przypadku cofnięcia danej operacji. W przypadku wartości null ta operacja zapisuje bieżące zaznaczenie.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function changeTypeName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Zmienia właściwość typeName elementu lub części elementu.
Jeśli ustawione są parametry relativeStart
lub relativeEnd
(na dowolne wartość inne niż domyślne), wówczas element podlega podziałowi. Części elementu poza tym zakresem zachowują oryginalny styl.
Parametry
newName:String — Nazwa nowego typu.
| |
targetElement:FlowElement — Określa element do zmiany.
| |
relativeStart:int (default = 0 ) — Przesunięcie od początku elementu określające miejsce, w którym element ma zostać podzielony w przypadku przypisania nowego stylu.
| |
relativeEnd:int (default = -1 ) — Przesunięcie od końca elementu określające miejsce, w którym element ma zostać podzielony w przypadku przypisania nowego stylu.
| |
operationState:SelectionState (default = null ) — Określa zaznaczenie do przywrócenia w przypadku cofnięcia danej operacji. W przypadku wartości null ta operacja zapisuje bieżące zaznaczenie.
|
clearFormat | () | metoda |
public function clearFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Usuwa definicje formatów określonego (lub bieżącego) zaznaczenia.
Wykonuje operację możliwą do wycofania, która usuwa definicję określonych formatów. Stosowane są tylko atrybuty stylu ustawione dla obiektów TextLayoutFormat. Niezdefiniowane atrybuty w obiektach formatu nie są zmieniane.
Parametry
leafFormat:flashx.textLayout.formats:ITextLayoutFormat — Format, którego ustawione wartości wskazują na właściwości, których definicje należy usunąć w obiektach LeafFlowElement w zaznaczonym zakresie.
| |
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat — Format, którego ustawione wartości wskazują na właściwości, których definicje należy usunąć w obiektach ParagraphElement w zaznaczonym zakresie.
| |
containerFormat:flashx.textLayout.formats:ITextLayoutFormat — Format, którego ustawione wartości wskazują na właściwości, których definicje należy usunąć w obiektach ContainerController w zaznaczonym zakresie.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
clearFormatOnElement | () | metoda |
public function clearFormatOnElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Usuwa definicje stylów zastosowane do wybranego elementu.
Wszelkie właściwości stylu w obiekcie formatu, które mają wartość undefined
, są pozostawiane bez zmian. Definicje wszystkich stylów zdefiniowanych w określonym formacie są usuwane z określonego elementu.
Parametry
targetElement:FlowElement — Element, do którego stosowane są style.
| |
format:flashx.textLayout.formats:ITextLayoutFormat — Format zawierający style, których definicje mają zostać usunięte.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
createDiv | () | metoda |
public function createDiv(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):DivElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Tworzy nowy obiekt DivElement zawierający cały zakres określony we właściwości. Jest używany element macierzysty najniższego poziomu, który zawiera elementy początkowy i końcowy zakresu. Jeśli punkt początkowy i końcowy to ten sam element, nowy obiekt DivElement jest tworzony w tym miejscu i zawiera jeden akapit potomny.
Parametry
parent:FlowGroupElement (default = null ) — Określa element macierzysty nowego obiektu DivElement. W przypadku wartości null nowy element macierzysty znajduje się na najniższym poziomie, jaki zawiera obiekt SelectionState.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Atrybuty formatowania do zastosowania do nowego obiektu DivElement.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
DivElement — Nowo utworzony obiekt DivElement.
|
createList | () | metoda |
public function createList(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):ListElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Tworzy nowy obiekt ListElement zawierający cały zakres określony we właściwości. Jest używany element macierzysty najniższego poziomu, który zawiera elementy początkowy i końcowy zakresu. Każdy akapit w zakresie staje się obiektem ListItemElement nowego obiektu ListElement. Jeśli punkt początkowy i końcowy to ten sam element, nowy obiekt ListElement jest tworzony w tym miejscu i zawiera jeden element potomny ListItemElement.
Parametry
parent:FlowGroupElement (default = null ) — Opcjonalnie określa element macierzysty nowego obiektu ListElement. W przypadku wartości null nowy element macierzysty znajduje się na najniższym poziomie, jaki zawiera obiekt SelectionState.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Atrybuty formatowania do zastosowania do nowego obiektu ListElement.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
ListElement — Nowo utworzony obiekt ListElement.
|
createSubParagraphGroup | () | metoda |
public function createSubParagraphGroup(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):SubParagraphGroupElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Tworzy nowy obiekt SubParagraphGroupElement zawierający cały zakres określony we właściwości. Jest używany element macierzysty najniższego poziomu, który zawiera elementy początkowy i końcowy zakresu. Jeśli punkt początkowy i końcowy to ten sam obiekt, nic się nie dzieje.
Parametry
parent:FlowGroupElement (default = null ) — Określa element macierzysty nowego obiektu SubParagraphGroupElement. W przypadku wartości null nowy element macierzysty znajduje się na najniższym poziomie, jaki zawiera obiekt SelectionState.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Atrybuty formatowania do zastosowania do nowego obiektu SubParagraphGroupElement.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
SubParagraphGroupElement — Nowo utworzony obiekt SubParagraphGroupElement.
|
cutTextScrap | () | metoda |
public function cutTextScrap(operationState:SelectionState = null):flashx.textLayout.edit:TextScrap
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Usuwa zaznaczony obszar i zwraca usunięty obszar w obiekcie TextScrap.
Wynikowy obiekt TextScrap może zostać przekazany do schowka systemu lub wykorzystany w kolejnej operacji pasteTextOperation()
.
Parametry
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
flashx.textLayout.edit:TextScrap — Obiekt TextScrap, który został wycięty.
|
Powiązane elementy interfejsu API
flashx.textLayout.edit.TextClipboard.setContents
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function deleteNextCharacter(operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Usuwa zakres tekstu lub — jeśli zaznaczony jest punkt — usuwa następny znak.
Parametry
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function deleteNextWord(operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Usuwa następne słowo.
Jeśli wybrany został zakres, usuwany jest pierwszy wyraz z tego zakresu.
Parametry
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function deletePreviousCharacter(operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Usuwa zakres tekstu lub — jeśli zaznaczony jest punkt — usuwa poprzedni znak.
Parametry
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function deletePreviousWord(operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Usuwa poprzedni wyraz.
Jeśli wybrany został zakres, usuwane jest pierwsze słowo z tego zakresu.
Parametry
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function deleteText(operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Usuwa zakres tekstu.
Parametry
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function doOperation(operation:FlowOperation):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wykonuje operację FlowOperation.
Metoda doOperation()
jest wywoływana przez funkcje IEditManager, które aktualizują przepływ tekstu. Zwykle wywoływanie tej funkcji nie jest wymagane, chyba że tworzone są własne operacje niestandardowe.
W ramach tej funkcji wywoływane są następujące kroki:
- Kasowanie wszelkich oczekujących operacji przed wykonaniem danej operacji.
- Wysłanie zdarzenia flowOperationBegin podlegającego anulowaniu. W przypadku anulowania następuje natychmiastowy powrót z metody.
- Wykonanie operacji. Operacja zwraca
true
lubfalse
.False
oznacza, że nie zostały wykonane żadne zmiany. - Przekazanie operacji na stos cofania.
- Opróżnienie stosu ponownego wykonywana.
- Aktualizacja wyświetlanego obrazu.
- Wysłanie zdarzenia flowOperationEnd podlegającego anulowaniu.
Obsługa wyjątków: jeśli operacja zwróci wyjątek, zostanie on przechwycony, a błąd zostanie dołączony do zdarzenia flowOperationEnd. Jeśli zdarzenie nie zostanie anulowane, błąd zostanie ponownie zgłoszony.
Parametry
operation:FlowOperation — obiekt FlowOperation
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function endCompositeOperation():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Kończy grupę operacji.
Wszystkie operacje wykonane od czasu ostatniego wywołania metody beginCompositeOperation()
są grupowane jako operacja CompositeOperation, która następnie jest kończona. Ten obiekt CompositeOperation jest dodawany do stosu cofania lub — jeśli operacja złożona jest zagnieżdżona w innej operacji złożonej — dodawana do operacji nadrzędnej.
Powiązane elementy interfejsu API
insertInlineGraphic | () | metoda |
public function insertInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):InlineGraphicElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wstawia obraz.
Źródłem obrazu może być ciąg znaków zawierający identyfikator URI, obiekt URLRequest, obiekt Class reprezentujący zasób osadzony lub instancja klasy DisplayObject.
Wartości szerokości i wysokości mogą być określone jako liczba pikseli, wartość procentowa lub ciąg znaków 'auto' — w tym przypadku wykorzystywane są rzeczywiste rozmiary obiektu graficznego.
Dla wartości float
należy ustawić jedną ze stałych zdefiniowanych w klasie Float w celu określenia, czy obraz powinien zostać wyświetlony po prawej, czy lewej stronie dowolnego tekstu, czy w jednej linii z tekstem.
Parametry
source:Object — Może to być obiekt String interpretowany jako identyfikator URI, obiekt Class interpretowany jako klasa obiektu Embed DisplayObject, wystąpienie klasy DisplayObject lub żądanie URLRequest.
| |
width:Object — Szerokość obrazu do wstawienia (liczba, wartość procentowa lub „auto”).
| |
height:Object — Wysokość obrazu do wstawienia (liczba, wartość procentowa lub „auto”).
| |
options:Object (default = null ) — Nieobsługiwane.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
InlineGraphicElement |
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function insertText(text:String, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wstawia tekst.
Wstawia tekst w określonym położeniu lub zakresie w tekście. Jeśli położenie określone w parametrze operationState
jest zakresem (lub parametr ma wartość null
, a bieżące zaznaczenie jest zakresem), wówczas tekst znajdujący się aktualnie w zakresie jest zastępowany przez tekst wstawiany.
Parametry
text:String — Ciąg znaków do wstawienia.
| |
operationState:SelectionState (default = null ) — Określa tekst w przepływie, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function modifyInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Modyfikuje istniejący wstawiany obiekt graficzny.
Ustawia niezmienne właściwości na wartości w oryginalnym obiekcie graficznym. (Zmodyfikowanie istniejącego obiektu graficznego jest zwykle bardziej wydajne niż usunięcie i ponowne utworzenie obiektu).
Parametry
source:Object — Może to być obiekt String interpretowany jako identyfikator URI, obiekt Class interpretowany jako klasa obiektu Embed DisplayObject, wystąpienie klasy DisplayObject lub żądanie URLRequest.
| |
width:Object — Nowa szerokość obrazu (liczba lub wartość procentowa).
| |
height:Object — Nowa wysokość obrazu (liczba lub wartość procentowa).
| |
options:Object (default = null ) — Nieobsługiwane.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
width
i height
wstawianej grafiki w celu jej rozciągnięcia do kształtu elipsy.
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 | () | metoda |
public function moveChildren(source:FlowGroupElement, sourceIndex:int, numChildren:int, destination:FlowGroupElement, destinationIndex:int, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Przenosi zestaw obiektów FlowElement z jednego obiektu FlowGroupElement do innego. Właściwość desinationElement musi wskazywać element macierzysty prawidłowego typu dla przenoszonych elementów potomnych, gdyż w przeciwnym razie zostanie wygenerowany wyjątek.
Parametry
source:FlowGroupElement — Oryginalny element macierzysty elementów do przeniesienia.
| |
sourceIndex:int — Indeks elementu potomnego w obiekcie źródłowym wskazujący pierwszy element do przeniesienia.
| |
numChildren:int — Liczba elementów potomnych do przeniesienia.
| |
destination:FlowGroupElement — Nowy element macierzysty elementów po przeniesieniu.
| |
destinationIndex:int — Indeks elementu potomnego w obiekcie docelowym wskazujący miejsce, do którego mają zostać przeniesione elementy.
| |
operationState:SelectionState (default = null ) — Określa tekst, do którego ma zastosowanie ta operacja (i do którego wróci zaznaczenie w przypadku cofnięcia operacji). W przypadku wartości null operacja ma zastosowanie do bieżącego zaznaczenia. Jeśli nie ma bieżącego zaznaczenia, ten parametr nie może mieć wartości null.
|
overwriteText | () | metoda |
public function overwriteText(text:String, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Zastępuje zaznaczony tekst.
Jeśli zaznaczony jest punkt, pierwszy znak jest zastępowany przez nowy tekst.
Parametry
text:String — Ciąg znaków do wstawienia.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function pasteTextScrap(scrapToPaste:flashx.textLayout.edit:TextScrap, operationState:SelectionState = null):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wkleja obiekt TextScrap do wybranego obszaru.
Jeśli określony jest zakres tekstu, wówczas usuwany jest tekst z tego zakresu.
Parametry
scrapToPaste:flashx.textLayout.edit:TextScrap — Obiekt TextScrap do wklejenia.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
Powiązane elementy interfejsu API
flashx.textLayout.edit.TextClipboard.getContents
flashx.textLayout.edit.TextScrap
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function redo():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Ponownie wykonuje poprzednią cofniętą operację.
Uwaga: Jeśli klasa IUndoManager skojarzona z klasą IEditManager jest również skojarzona z inną klasą IEditManager, wówczas możliwe jest, że operacja ponownego wykonania skojarzona z inną klasą IEditManager jest operacją, która została ponowiona. Może do tego dojść, jeśli operacja FlowOperation innej klasy IEditManager znajduje się na górze stosu ponawiania.
Ta funkcja nie wykonuje żadnej operacji, jeśli nie jest włączone wycofywanie.
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function splitElement(target:FlowGroupElement, operationState:SelectionState = null):FlowGroupElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Dzieli element docelowy w określonym miejscu, tworząc nowy element po bieżącym elemencie. Jeśli właściwość operationState określa zakres, następuje usunięcie tekstu w tym zakresie. Nowy element jest tworzony po pozycji tekstu określonej we właściwości operationState. Podzielenie obiektu SubParagraphGroupElement nie przyniesie żadnego skutku, ponieważ takie obiekty są automatycznie ponownie scalane z sąsiednimi elementami.
Ta operacja może na przykład być przydatna, gdy trzeba podzielić istniejącą listę na dwie listy.
Parametry
target:FlowGroupElement — Element do podzielenia.
| |
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
FlowGroupElement — Nowo utworzony akapit.
|
splitParagraph | () | metoda |
public function splitParagraph(operationState:SelectionState = null):ParagraphElement
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Dzieli akapit w bieżącym miejscu, tworząc nowy akapit po bieżącym akapicie.
Jeśli określony jest zakres tekstu, wówczas usuwany jest tekst z tego zakresu.
Parametry
operationState:SelectionState (default = null ) — Określa tekst, którego dotyczy ta operacja. W przypadku wartości null ta operacja ma zastosowanie do bieżącego zaznaczenia.
|
ParagraphElement — Nowo utworzony akapit.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function undo():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Odwraca poprzednią operację.
Uwaga: Jeśli klasa IUndoManager skojarzona z klasą IEditManager jest również skojarzona z inną klasą IEditManager, wówczas możliwe jest, że operacja wycofania skojarzona z inną klasą IEditManager jest operacją, która została wycofana. Może do tego dojść, jeśli operacja FlowOperation innej klasy IEditManager znajduje się na górze stosu cofania.
Ta funkcja nie wykonuje żadnej operacji, jeśli nie jest włączone cofanie.
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
public function updateAllControllers():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10.2, AIR 2.0 |
Aktualizuje zawartość wyświetlacza po modyfikacji przez operację. Zazwyczaj następuje to automatycznie, ale tę metodę należy wywołać, jeśli jest aktywna właściwość delayUpdates
, a zawartość wyświetlacza powinna zostać zaktualizowana przed następnym zdarzeniem enter_frame
.
Tue Jun 12 2018, 12:06 PM Z