SelectionManager  - AS3

Textpositionen för slutet av markeringen, som en förskjutning från textflödets början.

Den absoluta slutpunkten är samma som antingen den aktiva markeringen eller ankarpunkten för markeringen, beroende på vad som kommer sist i textflödet.

Textpositionen för början av markeringen, som en förskjutning från textflödets början.

Den absoluta startpunkten är samma som antingen den aktiva markeringen eller ankarpunkten för markeringen, beroende på vad som kommer först i textflödet.

Markeringens aktiva punkt.

Den aktiva punkten är markeringens rörliga avslutning. Den aktiva punkten flyttas när markeringen ändras. Den aktiva punkten kan antingen ligga i början eller slutet av markeringen.

Markeringens ankarpunkt.

En ankarpunkt är den stabila änden av markeringen. Ankarpunkten ändras inte även om markeringen utvidgas. Ankarpunkten kan antingen ligga i början eller slutet av markeringen.

Det aktuella SelectionFormat-objektet.

Det aktuella SelectionFormat-objektet väljs från SelectionFormat-objekt tilldelade till unfocusedSelectionFormat, inactiveSelectionFormat och focusedSelectionFormat-egenskaperna utifrån aktuellt läge för windowActive och focused-egenskaperna.

Relaterade API-element

Redigeringsläget.

I redigeringsläget visas om textflödet går att markera, redigera eller om det är skrivskyddat. Det går att markera ett textflöde om en markeringshanterare tilldelas och det kan redigeras om en redigeringshanterare tilldelas. Konstanter som representerar redigeringslägen definieras i EditingMode-klassen.

Relaterade API-element

Anger om en behållare i textflödet har fokus.

Egenskapen focused är true om någon av behållarna i textflödet har tangentfokus.

Det SelectionFormat-objekt som används för att rita markeringen i en behållare med fokus.

Relaterade API-element

Det SelectionFormat-objekt som används för att rita markeringen när denna inte finns i det aktiva fönstret.

Relaterade API-element

Det format som kommer att användas på infogad text. TBD: pointFormat behöver utökas till att komma ihåg användarformat och ”avdefiniering” av format från anrop till IEditManager.undefineFormat med leafFormat-värden för en punktmarkering.

Det TextFlow-objekt som hanteras av denna markeringshanterare.

En markeringshanterare hanterar ett enda textflöde. Du kan också tilldela en markeringshanterare till ett textflöde genom att ange egenskapen interactionManager för TextFlow-objektet.

Relaterade API-element

Det SelectionFormat-objekt som används för att rita markeringen när denna inte finns i en behållare med fokus, utan i det aktiva fönstret.

Relaterade API-element

Anger om det fönster som är kopplat till textflödet är aktivt.

Egenskapen windowActive är true om fönstret som visar textflödet är det aktiva fönstret.

Skapar ett SelectionManager-objekt.

Tilldela ett SelectionManager-objekt till interactionManager-egenskapen för ett textflöde för att aktivera textmarkering.

Bearbetar en aktiveringshändelse.

Parametrar

Bearbetar en inaktiveringshändelse.

Parametrar

Utför en SelectionManager-åtgärd. Dessa kan aldrig ändra flödet, men klienter kan ändå avbryta dem.

Parametrar

Bearbetar en redigeringshändelse.

Redigeringshändelser skickas för kommandona cut, copy, paste och selectAll.

Parametrar

Bearbetar en focusChange-händelse.

Parametrar

Bearbetar en focusIn-händelse.

Parametrar

Bearbetar en focusOut-händelse.

Parametrar

Hämtar de attribut för teckenformat som är gemensamma för alla tecken i det angivna textintervallet eller den aktuella markeringen.

Formatattribut som inte har samma värde för alla tecken i det angivna elementintervallet eller markeringen ställs in på null i den returnerade TextLayoutFormat-instansen.

Parametrar

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

Hämtar de attribut för behållarformat som är gemensamma för alla behållare i det angivna textintervallet eller den aktuella markeringen.

Formatattribut som inte har samma värde för alla behållare i det angivna elementintervallet eller markeringen ställs in på null i den returnerade TextLayoutFormat-instansen.

Parametrar

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

Hämtar de attribut för styckeformat som är gemensamma för alla stycken i det angivna textintervallet eller den aktuella markeringen.

Formatattribut som inte har samma värde för alla stycken i det angivna elementintervallet eller markeringen ställs in på null i den returnerade TextLayoutFormat-instansen.

Parametrar

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

Hämtar SelectionState-objektet för den aktuella markeringen.

Relaterade API-element

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

Anger om det finns någon markering.

Returnerar true om det är antingen en områdesmarkering eller en punktmarkering. Det finns som standard ingen markering när markeringshanteraren ställs in första gången (start och slut är -1).

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

Bearbetar en imeStartComposition-händelse.

Parametrar

Anger om markeringen omfattar ett område med text.

Returnerar true om det finns en markering som sträcker sig utanför en enskild position.

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

Bearbetar en keyDown-händelse.

Parametrar

Bearbetar en keyFocusChange-händelse.

Parametrar

Bearbetar en keyUp-händelse.

Parametrar

Bearbetar en menuSelect-händelse.

Parametrar

Bearbetar en mouseDoubleClick-händelse.

Parametrar

Bearbetar en mouseDown-händelse.

Parametrar

Bearbetar en mouseMove-händelse.

Parametrar

Bearbetar en mouseOut-händelse.

Parametrar

Bearbetar en mouseOver-händelse.

Parametrar

Bearbetar en mouseUp-händelse.

Parametrar

Bearbetar en mouseWheel-händelse.

Parametrar

Uppdaterar markeringshanteraren när text infogas eller tas bort.

Åtgärder måste anropa notifyInsertOrDeletenär text i textflödet ändras. Markeringshanteraren används för att justera indexbaserade positionsindikatorer utifrån dessa. Om du skapar en ny Operation-klass som ändrar text i ett textflöde direkt (utan att andra åtgärder används) måste du i din åtgärd anropa den här funktionen för att markeringen ska vara aktuell.

Parametrar

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

Visar markeringsformerna igen.

Obs! Du behöver inte anropa den här metoden direkt. Den anropas automatiskt.

Relaterade API-element

Parametrar

Relaterade API-element

Ger fokus till den första behållaren i markeringen.

 textFlow.interactionManager.setFocus();

Ställ in musmarkören.

Parametrar

Anger SelectionState-objektet för den aktuella markeringen.

Parametrar

Relaterade API-element

Bearbetar en softKeyboardActivating-händelse.

Parametrar

Bearbetar en TextEvent-händelse.

Parametrar

I det här exemplet visas hur du använder SelectionManager-klassen.

Det skapar ett textflöde, och en avlyssnare för markeringsändringar, och uppdaterar sedan baserat på markeringsändringarna.

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