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

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

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

Powiązane elementy interfejsu API

Format, jaki zostanie zastosowany do wstawianego tekstu. TBD: opis pointFormat należy uzupełnić o zapamiętywanie stylu użytkownika i usuwanie definicji formatów poprzez wywołanie IEditManager.undefineFormat z wartościami leafFormat ustawionymi na zaznaczenie punktowe.

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.

Powiązane elementy interfejsu API

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.

Tworzy obiekt SelectionManager.

Aby umożliwić zaznaczanie tekstu, należy przypisać obiekt SelectionManager do właściwości interactionManager przepływu tekstu.

Przetwarza zdarzenie activate.

Parametry

Przetwarza zdarzenie deactivate.

Parametry

Wykonuje operację obiektu SelectionManager — nawet jeśli nie modyfikuje ona przepływu, klienci mogą ją anulować.

Parametry

Przetwarza zdarzenie edit.

Zdarzenia edit są wywoływane dla poleceń cut, copy, paste i selectAll.

Parametry

Przetwarza zdarzenie focusChange.

Parametry

Przetwarza zdarzenie focusIn.

Parametry

Przetwarza zdarzenie focusOut.

Parametry

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

Przetwarza zdarzenie imeStartComposition.

Parametry

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

Przetwarza zdarzenie keyDown.

Parametry

Przetwarza zdarzenie keyFocusChange.

Parametry

Przetwarza zdarzenie keyUp.

Parametry

Przetwarza zdarzenie menuSelect.

Parametry

Przetwarza zdarzenie mouseDoubleClick.

Parametry

Przetwarza zdarzenie mouseDown.

Parametry

Przetwarza zdarzenie mouseMove.

Parametry

Przetwarza zdarzenie mouseOut.

Parametry

Przetwarza zdarzenie mouseOver.

Parametry

Przetwarza zdarzenie mouseUp.

Parametry

Przetwarza zdarzenie mouseWheel.

Parametry

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.

Powiązane elementy interfejsu API

Parametry

Powiązane elementy interfejsu API

Ustawia punkt skupienia na pierwszym kontenerze w zaznaczeniu.

 textFlow.interactionManager.setFocus();

Ustawia kursor myszy.

Parametry

Ustawia obiekt SelectionState bieżącego zaznaczenia.

Parametry

Powiązane elementy interfejsu API

Przetwarza zdarzenie softKeyboardActivating.

Parametry

Przetwarza zdarzenie TextEvent.

Parametry

Poniższy przykład ilustruje użycie klasy SelectionManager:

Ustawia obiekt TextFlow oraz detektor dla zmian w zaznaczeniu, a następnie dokonuje uaktualnienia na podstawie zmian w zaznaczeniu.

package flashx.textLayout.edit.examples {
    import flash.display.Sprite;
    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.edit.SelectionManager;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.ITextLayoutFormat;
    import flashx.textLayout.events.SelectionEvent;

    public class SelectionManager_example extends Sprite
    {
        private var textFlow:TextFlow;
        
        public function SelectionManager_example()
        {
            //define TextFlow, and make it read-select
            textFlow = TextConverter.importToFlow("This is sample text for the SelectionManager example.",
                TextConverter.PLAIN_TEXT_FORMAT);
            textFlow.interactionManager = new SelectionManager();
            
            //compose TextFlow to display
            textFlow.flowComposer.addController(new ContainerController(this,600,600));
            textFlow.flowComposer.updateAllControllers();
            
            //add event handlers to the TextFlow to detect when selection changes
            textFlow.addEventListener(SelectionEvent.SELECTION_CHANGE, selectionChanged);
        }

        private function selectionChanged(selectionEvent:SelectionEvent):void
        {
            var format:ITextLayoutFormat = textFlow.interactionManager.getCommonCharacterFormat();
            // do something here - perhaps update the application's UI based on the formatting
            // attributes applied in the current selected text range
        }
        
    }        
}