SelectionManager  - AS3

Die Textposition am Ende der Auswahl als Offset ab Beginn des Textflusses.

Das absolute Ende ist entweder mit dem aktiven oder dem Ankerpunkt der Auswahl identisch, je nachdem, welcher im Textfluss an letzter Stelle steht.

Die Textposition am Anfang der Auswahl als Offset ab Beginn des Textflusses.

Der absolute Anfang ist entweder mit dem aktiven oder dem Ankerpunkt der Auswahl identisch, je nachdem, welcher im Textfluss an letzter Stelle steht.

Der aktive Punkt der Auswahl.

Der aktive Punkt ist das flüchtige Ende der Auswahl. Der aktive Punkt wird geändert, wenn die Auswahl modifiziert wird. Der aktive Punkt kann sich entweder am Anfang oder am Ende der Auswahl befinden.

Der Ankerpunkt der Auswahl.

Ein Ankerpunkt ist das stabile Ende der Auswahl. Wenn die Auswahl erweitert wird, ändert sich der Ankerpunkt nicht. Der Ankerpunkt kann sich entweder am Anfang oder am Ende der Auswahl befinden.

Das aktuelle SelectionFormat-Objekt.

Das aktuelle SelectionFormat-Objekt wird aus den SelectionFormat-Objekten gewählt, die den unfocusedSelectionFormat-, inactiveSelectionFormat- und focusedSelectionFormat-Eigenschaften basierend auf dem aktuellen Status der windowActive- und focused-Eigenschaften zugeordnet sind.

Verwandte API-Elemente

Der Bearbeitungsmodus.

Der Bearbeitungsmodus gibt an, ob der Textfluss Auswahl, Bearbeitung oder nur Lesen unterstützt. Ein Textfluss wird durch Zuweisen eines Auswahlmanagers auswählbar und durch Zuweisen eines Bearbeitungsmanagers bearbeitbar gemacht. Konstanten, die die Bearbeitungsmodi darstellen, werden in der EditingMode-Klasse definiert.

Verwandte API-Elemente

Gibt an, ob ein Container im Textfluss den Fokus hat.

Die focused-Eigenschaft ist true, wenn einer der Container im Textfluss den Hauptfokus hat.

Das SelectionFormat-Objekt, das zum Ziehen der Auswahl in einen fokussierten Container verwendet wird.

Verwandte API-Elemente

Das SelectionFormat-Objekt, das zum Ziehen der Auswahl verwendet wird, wenn sie sich nicht im aktiven Fenster befindet.

Verwandte API-Elemente

Das Format, das auf eingefügten Text angewendet wird. TBD: pointFormat needs to be extended to remember user styles and "undefine" of formats from calls to IEditManager.undefineFormat with leafFormat values on a point selection.

Das von diesem Auswahlmanager verwaltete TextFlow-Objekt.

Ein Auswahlmanager verwaltet einen einzelnen Textfluss. Ein Auswahlmanager kann auch einem Textfluss zugewiesen werden, indem die interactionManager-Eigenschaft des TextFlow-Objekts festgelegt wird.

Verwandte API-Elemente

Das SelectionFormat-Objekt, das zum Ziehen der Auswahl verwendet wird, wenn sie sich nicht im fokussierten Container, sondern im aktiven Fenster befindet.

Verwandte API-Elemente

Gibt an, ob das mit dem Textfluss verknüpfte Fenster aktiv ist.

Die windowActive-Eigenschaft ist true, wenn das mit dem Textfluss angezeigte Fenster das aktive Fenster ist.

Erstellt ein SelectionManager-Objekt.

Weisen Sie ein SelectionManager-Objekt der interactionManager-Eigenschaft eines Textflusses zu, um die Textauswahl zu aktivieren.

Verarbeitet ein Aktivierungsereignis.

Parameter

Verarbeitet ein Deaktivierungsereignis.

Parameter

Führen Sie eine SelectionManager-Operation aus - diese Operationen können den Fluss niemals ändern, der Client kann sie jedoch abbrechen.

Parameter

Verarbeitet ein Bearbeitungsereignis.

Bearbeitungsereignisse werden für Befehle zum Ausschneiden, Kopieren, Einfügen sowie für selectAll-Befehle ausgelöst.

Parameter

Verarbeitet ein focusChange-Ereignis.

Parameter

Verarbeitet ein focusIn-Ereignis.

Parameter

Verarbeitet ein focusOut-Ereignis.

Parameter

Ruft die Zeichenformatattribute ab, die für alle Zeichen im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden.

Für Formatattribute, die nicht denselben Wert für alle Zeichen im angegebenen Elementbereich oder in der Auswahl haben, wird in der zurückgegebenen TextLayoutFormat-Instanz null festgelegt.

Parameter

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

Ruft die Containerformatattribute ab, die für alle Container im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden.

Für Formatattribute, die nicht denselben Wert für alle Container im angegebenen Elementbereich oder in der Auswahl haben, wird in der zurückgegebenen TextLayoutFormat-Instanz null festgelegt.

Parameter

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

Ruft die Absatzformatattribute ab, die für alle Absätze im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden.

Für Formatattribute, die nicht denselben Wert für alle Absätze im angegebenen Elementbereich oder in der Auswahl haben, wird in der zurückgegebenen TextLayoutFormat-Instanz null festgelegt.

Parameter

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

Ruft das SelectionState-Objekt der aktuellen Auswahl ab.

Verwandte API-Elemente

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

Zeigt an, ob es eine Auswahl gibt.

Gibt true zurück, wenn entweder eine Bereichsauswahl oder eine Punktauswahl vorhanden ist. Wenn standardmäßig zuerst ein Auswahlmanager eingerichtet wird, gibt es keine Auswahl (Anfang und Ende sind -1).

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

Verarbeitet ein imeStartComposition-Ereignis.

Parameter

Gibt an, ob die Auswahl einen Textbereich abdeckt.

Gibt true zurück, wenn eine Auswahl vorliegt, die nach einer einzelnen Position erweitert wird.

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

Verarbeitet ein keyDown-Ereignis.

Parameter

Verarbeitet ein keyFocusChange-Ereignis.

Parameter

Verarbeitet ein keyUp-Ereignis.

Parameter

Verarbeitet ein menuSelect-Ereignis.

Parameter

Verarbeitet ein mouseDoubleClick-Ereignis.

Parameter

Verarbeitet ein mouseDown-Ereignis.

Parameter

Verarbeitet ein mouseMove-Ereignis.

Parameter

Verarbeitet ein mouseOut-Ereignis.

Parameter

Verarbeitet ein mouseOver-Ereignis.

Parameter

Verarbeitet ein mouseUp-Ereignis.

Parameter

Verarbeitet ein mouseWheel-Ereignis.

Parameter

Aktualisiert den Auswahlmanager, wenn Text eingefügt oder gelöscht wird.

Vorgänge müssen notifyInsertOrDelete aufrufen, wenn der Text im Textfluss geändert wird. Der Auswahlmanager passt indexbasierte Positionsindikatoren dementsprechend an. Wenn Sie eine neue Operation-Klasse erstellen, die Text in einem Textfluss direkt ändert (ohne Verwendung eines anderen Vorgangs), muss Ihr Vorgang diese Funktion aufrufen, um die Auswahl auf dem aktuellen Stand zu halten.

Parameter

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

Zeigt die Auswahlformen erneut an.

Hinweis: Sie müssen diese Methode nicht direkt aufrufen. Sie wird automatisch aufgerufen.

Verwandte API-Elemente

Parameter

Verwandte API-Elemente

Legt den Fokus auf den ersten Container in der Auswahl.

 textFlow.interactionManager.setFocus();

Stellt den Mauscursor ein.

Parameter

Legt das SelectionState-Objekt der aktuellen Auswahl fest.

Parameter

Verwandte API-Elemente

Verarbeitet ein softKeyboardActivating-Ereignis.

Parameter

Verarbeitet ein TextEvent.

Parameter

Dieses Beispiel zeigt die Verwendung der SelectionManager-Klasse.

Es wird ein TextFlow eingerichtet sowie ein Listener für Auswahländerungen. Danach erfolgt die Aktualisierung entsprechend den Auswahländerungen.

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