ISelectionManager  - AS3

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.

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.

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.

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.

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.

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.

Powiązane elementy interfejsu API

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.

Obiekt SelectionFormat służący do rysowania zaznaczenia w kontenerze objętym punktem skupienia.

Obiekt SelectionFormat służący do narysowania zaznaczenia, gdy nie znajduje się ono w aktywnym oknie.

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.

Powiązane elementy interfejsu API

Obiekt SelectionFormat służący do rysowania zaznaczenia, gdy nie znajduje się w kontenerze objętym punktem skupienia, ale znajduje się w aktywnym oknie.

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.

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.

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

 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonCharacterFormat();

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

 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonContainerFormat();

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

 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonParagraphFormat();

Pobiera obiekt SelectionState bieżącego zaznaczenia.

Powiązane elementy interfejsu API

 var selection:SelectionState = textFlow.interactionManager.getSelectionState();

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).

 var selection:SelectionState = textFlow.interactionManager.hasSelection();

Wskazuje, czy zaznaczenie pokrywa zakres tekstu.

Zwraca true, jeśli istnieje zaznaczenie większe niż pojedyncze położenie.

 var selection:SelectionState = textFlow.interactionManager.isRangeSelection();

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

 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 );
}

Ponownie wyświetla kształty zaznaczenia.

Uwaga: Nie ma potrzeby bezpośredniego wywoływania tej metody. Jest ona wywoływana automatycznie.

Zaznacza cały przepływ.

Wybiera zakres tekstu.

Jeśli jako którykolwiek z parametrów zostanie przekazana liczba ujemna, wówczas wszelkie zaznaczenia zostaną usunięte.

Parametry

 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'

Ustawia punkt skupienia na pierwszym kontenerze w zaznaczeniu.

 textFlow.interactionManager.setFocus();

Ustawia obiekt SelectionState bieżącego zaznaczenia.

Parametry

Powiązane elementy interfejsu API