| Pakiet | flashx.textLayout.edit |
| Interfejs | public interface ISelectionManager extends IInteractionEventHandler |
| Implementory | SelectionManager |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Klasa SelectionManager śledzi zaznaczony zakres tekstu i obsługuje zdarzenia w ramach TextFlow.
Zaznaczony może być punkt lub zakres. Zaznaczony jest punkt wstawiania, który jest wskazany poprzez narysowanie kursora. Zaznaczenie zakresu obejmuje tekst między punktem kontrolnym a punktem aktywnym.
Powiązane elementy interfejsu API
flashx.textLayout.edit.TextScrap
flashx.textLayout.elements.TextFlow
| 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 | ||
| anchorPosition : int [tylko do odczytu]
Punkt kontrolny zaznaczenia. | ISelectionManager | ||
| currentSelectionFormat : SelectionFormat [tylko do odczytu]
Bieżący obiekt SelectionFormat. | ISelectionManager | ||
| 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 | ||
| 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 | ||
Ukryj dziedziczone metody publiczne
Pokaż dziedziczone metody publiczne| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
 |
Przetwarza zdarzenie activate. | IInteractionEventHandler | |
|
Przetwarza zdarzenie deactivate. | IInteractionEventHandler | |
|
Przetwarza zdarzenie edit. | IInteractionEventHandler | |
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 | |
Wskazuje, czy zaznaczenie pokrywa zakres tekstu. | ISelectionManager | ||
|
Przetwarza zdarzenie keyDown. | IInteractionEventHandler | |
|
Przetwarza zdarzenie keyFocusChange. | IInteractionEventHandler | |
|
Przetwarza zdarzenie keyUp. | IInteractionEventHandler | |
|
Przetwarza zdarzenie menuSelect. | IInteractionEventHandler | |
|
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 | |
Aktualizuje menedżera zaznaczenia w razie wstawienia lub usunięcia tekstu. | ISelectionManager | ||
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 | |
|
Przetwarza zdarzenie TextEvent. | IInteractionEventHandler | |
absoluteEnd | właściwość |
absoluteEnd:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Położenie tekstu będące końcem zaznaczenia, jako przesunięcie od początku przepływu tekstu.
Bezwzględny koniec jest taki sam, jak punkt aktywny albo punkt kontrolny zaznaczenia — wybierany jest ostatni punkt w przepływie tekstu.
Implementacja
public function get absoluteEnd():intabsoluteStart | właściwość |
absoluteStart:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Położenie tekstu będące początkiem zaznaczenia, jako przesunięcie od początku przepływu tekstu.
Bezwzględny początek jest taki sam, jak punkt aktywny albo punkt kontrolny zaznaczenia — wybierany jest pierwszy punkt w przepływie tekstu.
Implementacja
public function get absoluteStart():intactivePosition | właściwość |
activePosition:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Punkt aktywny zaznaczenia.
Punkt aktywny jest zmiennym końcem zaznaczenia. Punkt aktywny jest zmieniany w przypadku modyfikacji zaznaczenia. Punkt aktywny może znajdować się na początku lub na końcu zaznaczenia.
Implementacja
public function get activePosition():intanchorPosition | właściwość |
anchorPosition:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Punkt kontrolny zaznaczenia.
Punkt kontrolny jest stabilnym końcem zaznaczenia. W razie rozszerzenia zaznaczenia punkt kontrolny nie ulega zmianie. Punkt kontrolny może znajdować się na początku lub na końcu zaznaczenia.
Implementacja
public function get anchorPosition():intcurrentSelectionFormat | właściwość |
currentSelectionFormat:SelectionFormat [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Bieżący obiekt SelectionFormat.
Bieżący obiekt SelectionFormat jest wybierany z obiektów SelectionFormat przypisanych do właściwości unfocusedSelectionFormat, inactiveSelectionFormat i focusedSelectionFormat w zależności od bieżącego stanu właściwości windowActive i focused.
Implementacja
public function get currentSelectionFormat():SelectionFormateditingMode | właściwość |
editingMode:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Tryb edycji.
Tryb edycji wskazuje, czy przepływ tekstu obsługuje zaznaczenie, edycję, czy tylko czytanie. Przepływ tekstu można zaznaczyć poprzez przypisanie menedżera zaznaczenia oraz edytować poprzez przypisanie menedżera edycji. Stałe reprezentujące tryby edycji są zdefiniowane w klasie EditingMode.
Implementacja
public function get editingMode():StringPowiązane elementy interfejsu API
focused | właściwość |
focused:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wskazuje, czy kontener w przepływie tekstu zawiera punkt skupienia.
Właściwość focused ma wartość true, jeśli dowolny z kontenerów w przepływie tekstu zawiera punkt skupienia i reaguje na zdarzenia klawiatury.
Implementacja
public function get focused():BooleanfocusedSelectionFormat | właściwość |
focusedSelectionFormat:SelectionFormat| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Obiekt SelectionFormat służący do rysowania zaznaczenia w kontenerze objętym punktem skupienia.
Implementacja
public function get focusedSelectionFormat():SelectionFormat public function set focusedSelectionFormat(value:SelectionFormat):voidinactiveSelectionFormat | właściwość |
inactiveSelectionFormat:SelectionFormat| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Obiekt SelectionFormat służący do narysowania zaznaczenia, gdy nie znajduje się ono w aktywnym oknie.
Implementacja
public function get inactiveSelectionFormat():SelectionFormat public function set inactiveSelectionFormat(value:SelectionFormat):voidtextFlow | właściwość |
textFlow:flashx.textLayout.elements:TextFlow| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Obiekt TextFlow zarządzany przez menedżera zaznaczania.
Menedżer zaznaczania zarządza pojedynczym przepływem tekstu. Menedżera zaznaczania można również przypisać do przepływu tekstu poprzez ustawienie właściwości interactionManager obiektu TextFlow.
Implementacja
public function get textFlow():flashx.textLayout.elements:TextFlow public function set textFlow(value:flashx.textLayout.elements:TextFlow):voidPowiązane elementy interfejsu API
unfocusedSelectionFormat | właściwość |
unfocusedSelectionFormat:SelectionFormat| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Obiekt SelectionFormat służący do rysowania zaznaczenia, gdy nie znajduje się w kontenerze objętym punktem skupienia, ale znajduje się w aktywnym oknie.
Implementacja
public function get unfocusedSelectionFormat():SelectionFormat public function set unfocusedSelectionFormat(value:SelectionFormat):voidwindowActive | właściwość |
windowActive:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wskazuje, czy okno skojarzone z przepływem tekstu jest aktywne.
Właściwość windowActive ma wartość true, jeśli okno wyświetlane z przepływem tekstu jest oknem aktywnym.
Implementacja
public function get windowActive():BooleanflushPendingOperations | () | metoda |
public function flushPendingOperations():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wykonuje wszelkie oczekujące operacje FlowOperation.
Wykonywanie niektórych operacji edycji, takich jak wstawianie tekstu, jest opóźniane do czasu następnego zdarzenia enterFrame. Wywołanie metody flushPendingOperations() powoduje natychmiastowe wykonanie wszelkich opóźnionych operacji.
getCommonCharacterFormat | () | metoda |
public function getCommonCharacterFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Pobiera atrybuty formatu znaków, które są wspólne dla wszystkich znaków w określonym zakresie tekstu lub w bieżącym zaznaczeniu.
W przypadku atrybutów formatu, które nie mają tej samej wartości dla wszystkich znaków w określonym zakresie elementów lub zaznaczeniu, ustawiana jest wartość null w zwróconym wystąpieniu klasy TextLayoutFormat.
Parametry
range:flashx.textLayout.elements:TextRange (default = null) |
flashx.textLayout.formats:TextLayoutFormat — Wspólne ustawienia stylu znakowego
|
Przykład ( Sposób korzystania z tego przykładu )
var common:ITextLayoutFormat = textFlow.interactionManager.getCommonCharacterFormat();
getCommonContainerFormat | () | metoda |
public function getCommonContainerFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Pobiera atrybuty formatu kontenera, które są wspólne dla wszystkich kontenerów w określonym zakresie tekstu lub w bieżącym zaznaczeniu.
W przypadku atrybutów formatu, które nie mają tej samej wartości dla wszystkich kontenerów w określonym zakresie elementów lub zaznaczeniu, ustawiana jest wartość null w zwróconym wystąpieniu klasy TextLayoutFormat.
Parametry
range:flashx.textLayout.elements:TextRange (default = null) |
flashx.textLayout.formats:TextLayoutFormat — Wspólne ustawienia stylu kontenera
|
Przykład ( Sposób korzystania z tego przykładu )
var common:ITextLayoutFormat = textFlow.interactionManager.getCommonContainerFormat();
getCommonParagraphFormat | () | metoda |
public function getCommonParagraphFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Pobiera atrybuty formatu akapitu, które są wspólne dla wszystkich akapitów w określonym zakresie tekstu lub w bieżącym zaznaczeniu.
W przypadku atrybutów formatu, które nie mają tej samej wartości dla wszystkich akapitów w określonym zakresie elementów lub zaznaczeniu, ustawiana jest wartość null w zwróconym wystąpieniu klasy TextLayoutFormat.
Parametry
range:flashx.textLayout.elements:TextRange (default = null) |
flashx.textLayout.formats:TextLayoutFormat — Wspólne ustawienia stylu akapitu
|
Przykład ( Sposób korzystania z tego przykładu )
var common:ITextLayoutFormat = textFlow.interactionManager.getCommonParagraphFormat();
getSelectionState | () | metoda |
public function getSelectionState():SelectionState| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Pobiera obiekt SelectionState bieżącego zaznaczenia.
ZwracaSelectionState |
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
var selection:SelectionState = textFlow.interactionManager.getSelectionState();
hasSelection | () | metoda |
public function hasSelection():Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wskazuje, czy istnieje zaznaczenie.
Zwraca true, jeśli istnieje zaznaczenie zakresu lub punktu. Po skonfigurowaniu menedżera zaznaczenia domyślnie nie istnieje żadne zaznaczenie (początek i koniec mają wartość -1).
Boolean |
Przykład ( Sposób korzystania z tego przykładu )
var selection:SelectionState = textFlow.interactionManager.hasSelection();
isRangeSelection | () | metoda |
public function isRangeSelection():Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wskazuje, czy zaznaczenie pokrywa zakres tekstu.
Zwraca true, jeśli istnieje zaznaczenie większe niż pojedyncze położenie.
Boolean |
Przykład ( Sposób korzystania z tego przykładu )
var selection:SelectionState = textFlow.interactionManager.isRangeSelection();
notifyInsertOrDelete | () | metoda |
public function notifyInsertOrDelete(absolutePosition:int, length:int):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Aktualizuje menedżera zaznaczenia w razie wstawienia lub usunięcia tekstu.
W przypadku zmiany tekstu w przepływie tekstu operacje muszą wywoływać metodę notifyInsertOrDelete. Odpowiednio do tego menedżer zaznaczenia dostosowuje wskaźniki pozycji na podstawie indeksu. Jeśli zostanie utworzona nowa klasa Operation, która będzie zmieniała tekst bezpośrednio w przepływie tekstu (bez użycia innej operacji), wówczas operacja będzie musiała wywołać tę funkcję w celu aktualizacji zaznaczenia.
Parametry
absolutePosition:int — Punkt w tekście, gdzie została wprowadzona zmiana.
| |
length:int — Liczba dodatnia lub ujemna, która określa liczbę znaków wstawionych albo usuniętych.
|
Przykład ( Sposób korzystania z tego przykładu )
notifyInsertOrDelete().
Ta funkcja zastępuje zakres tekstu w obiekcie SpanElement w ramach pewnej hipotetycznej operacji.
import flashx.textLayout.elements.SpanElement;
function doReplace( span:SpanElement, newText:String, relativeStart:int, relativeEnd:int ):void
{
span.replaceText( relativeStart, relativeEnd, newText );
var parentFlow:TextFlow = span.getTextFlow();
var lengthDifference:int = newText.length - (relativeEnd - relativeStart);
parentFlow.interactionManager.notifyInsertOrDelete( span.getAbsoluteStart() + relativeStart, lengthDifference );
}
refreshSelection | () | metoda |
public function refreshSelection():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Ponownie wyświetla kształty zaznaczenia.
Uwaga: Nie ma potrzeby bezpośredniego wywoływania tej metody. Jest ona wywoływana automatycznie.
selectAll | () | metoda |
public function selectAll():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Zaznacza cały przepływ.
selectRange | () | metoda |
public function selectRange(anchorPosition:int, activePosition:int):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wybiera zakres tekstu.
Jeśli jako którykolwiek z parametrów zostanie przekazana liczba ujemna, wówczas wszelkie zaznaczenia zostaną usunięte.
Parametry
anchorPosition:int — Punkt kontrolny dla nowego zaznaczenia, jako bezwzględne położenie w obiekcie TextFlow
| |
activePosition:int — Aktywny koniec nowego zaznaczenia, jako bezwzględne położenie w obiekcie TextFlow
|
Przykład ( Sposób korzystania z tego przykładu )
var textFlow:TextFlow = TextConverter.importToFlow( "Let me not to the marriage of true minds", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.interactionManager = new SelectionManager(); textFlow.interactionManager.selectRange( 18, 26 ); // Selects the word 'marriage'
setFocus | () | metoda |
public function setFocus():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Ustawia punkt skupienia na pierwszym kontenerze w zaznaczeniu.
Przykład ( Sposób korzystania z tego przykładu )
textFlow.interactionManager.setFocus();
setSelectionState | () | metoda |
public function setSelectionState(state:SelectionState):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Ustawia obiekt SelectionState bieżącego zaznaczenia.
Parametry
state:SelectionState |
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z