SelectionManager  - AS3

De tekstpositie van het einde van de selectie, uitgedrukt als een verschuiving van het begin van de tekstflow.

Het absolute einde is hetzelfde als óf het actieve punt óf het ankerpunt van de selectie, afhankelijk van welk punt zich het laatst in de tekstflow bevindt.

De tekstpositie van het begin van de selectie, uitgedrukt als een verschuiving van het begin van de tekstflow.

Het absolute begin is hetzelfde als óf het actieve punt óf het ankerpunt van de selectie, afhankelijk van welk punt zich het eerst in de tekstflow bevindt.

Het actieve punt van de selectie.

Het actieve punt is het veranderlijke punt van de selectie. Het actieve punt past zich aan als de selectie wordt gewijzigd. Het actieve punt kan zich aan begin of aan het eind van de selectie bevinden.

Het ankerpunt van de selectie.

Het ankerpunt is het stabiele punt van de selectie. Als de selectie wordt uitgebreid, verandert het ankerpunt niet. Het ankerpunt kan zich aan begin of aan het eind van de selectie bevinden.

Het huidige SelectionFormat-object.

Het huidige SelectionFormat-object wordt gekozen uit de SelectionFormat-objecten die zijn toegewezen aan de eigenschappen unfocusedSelectionFormat, inactiveSelectionFormat en focusedSelectionFormat, op basis van de huidige status van de eigenschappen windowActive en focused.

Verwante API-elementen

De bewerkingsmodus.

De bewerkingsmodus geeft aan of de tekstflow ondersteuning biedt voor selecteren, bewerken of alleen-lezen. Een tekstflow wordt selecteerbaar door het toewijzen van een selectiemanager en bewerkbaar door het toewijzen van een bewerkingsmanager. Constanten die de bewerkingsmodi representeren, worden gedefinieerd in de klasse EditingMode.

Verwante API-elementen

Geeft aan of de focus ligt op een container in de tekstflow.

De eigenschap focused is true als een van de containers in de tekstflow de belangrijkste focus heeft.

Het SelectionFormat-object waarmee de selectie wordt getekend in een container met focus.

Verwante API-elementen

Het SelectionFormat-object waarmee de selectie wordt getekend wanneer de selectie zich niet in het actieve venster bevindt.

Verwante API-elementen

De indeling die wordt toegepast op ingevoegde tekst. TBD: pointFormat moet worden uitgebreid om gebruikersstijlen en het ongedaan maken van de definitie van indelingen te herinneren van oproepen naar IEditManager.undefineFormat met leafFormat-waarden op een puntselectie.

Het TextFlow-object dat wordt beheerd door deze selectiemanager.

Een selectiemanager beheert één tekstflow. U kunt een selectiemanager ook aan een tekstflow toewijzen door de eigenschap interactionManager van het TextFlow-object in te stellen.

Verwante API-elementen

Het SelectionFormat-object waarmee de selectie wordt getekend wanneer de selectie zich niet in een container met focus bevindt, maar wel in het actieve venster.

Verwante API-elementen

Geeft aan of het venster dat is gekoppeld aan de tekstflow actief is.

De eigenschap windowActive is true als het venster dat de tekstflow weergeeft, het actieve venster is.

Maakt een SelectionManager-object.

Wijs een SelectionManager-object aan de eigenschap interactionManager van een tekstflow toe om tekstselectie toe te staan.

Verwerkt een activeringsgebeurtenis.

Parameters

Verwerkt een deactiveringsgebeurtenis.

Parameters

Voer een SelectionManager-bewerking uit - deze kunnen de flow niet aanpassen, maar clients kunnen ze nog steeds annuleren.

Parameters

Verwerkt een bewerkingsgebeurtenis.

Bewerkingsgebeurtenissen worden verzonden voor opdrachten voor knippen, kopiëren, plakken en alles selecteren.

Parameters

Verwerkt een focusChange-gebeurtenis.

Parameters

Verwerkt een focusIn-gebeurtenis.

Parameters

Verwerkt een focusOut-gebeurtenis.

Parameters

Haalt de tekenopmaakkenmerken op die algemeen gelden voor alle tekens in het opgegeven tekstbereik of de huidige selectie.

Opmaakkenmerken die niet dezelfde waarde hebben voor alle tekens in het opgegeven elementbereik of de opgegeven elementselectie, worden ingesteld op null in de geretourneerde TextLayoutFormat-instantie.

Parameters

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

Haalt de containeropmaakkenmerken op die algemeen gelden voor alle containers in het opgegeven tekstbereik of de huidige selectie.

Opmaakkenmerken die niet dezelfde waarde hebben voor alle containers in het opgegeven elementbereik of de opgegeven elementselectie, worden ingesteld op null in de geretourneerde TextLayoutFormat-instantie.

Parameters

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

Haalt de alineaopmaakkenmerken op die algemeen gelden voor alle alinea's in het opgegeven tekstbereik of de huidige selectie.

Opmaakkenmerken die niet dezelfde waarde hebben voor alle alinea's in het opgegeven elementbereik of de opgegeven elementselectie, worden ingesteld op null in de geretourneerde TextLayoutFormat-instantie.

Parameters

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

Haalt het SelectionState-object op voor de huidige selectie.

Verwante API-elementen

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

Geeft aan of er een selectie is.

Retourneert true als er een bereikselectie of een puntselectie is. Wanneer een selectiemanager voor het eerst wordt ingesteld, is er standaard geen selectie (het begin en het eind zijn -1).

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

Verwerkt een imeStartComposition-gebeurtenis.

Parameters

Geeft aan of de selectie een tekstbereik beslaat.

Retourneert true als er een selectie is die groter is dan één positie.

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

Verwerkt een keyDown-gebeurtenis.

Parameters

Verwerkt een keyFocusChange-gebeurtenis.

Parameters

Verwerkt een keyUp-gebeurtenis.

Parameters

Verwerkt een menuSelect-gebeurtenis.

Parameters

Verwerkt een mouseDoubleClick-gebeurtenis.

Parameters

Verwerkt een mouseDown-gebeurtenis.

Parameters

Verwerkt een mouseMove-gebeurtenis.

Parameters

Verwerkt een mouseOut-gebeurtenis.

Parameters

Verwerkt een mouseOver-gebeurtenis.

Parameters

Verwerkt een mouseUp-gebeurtenis.

Parameters

Verwerkt een mouseWheel-gebeurtenis.

Parameters

Werkt de selectiemanager bij wanneer tekst wordt ingevoegd of verwijderd.

Bewerkingen moeten notifyInsertOrDelete aanroepen bij het wijzigen van de tekst in de tekstflow. De selectiemanager past op indexen gebaseerde positie-indicatoren overeenkomstig aan. Als u een nieuwe bewerkingsklasse maakt waarmee tekst in een tekstflow rechtstreeks wordt gewijzigd (zonder hiervoor een andere bewerking te gebruiken), moet uw bewerking deze functie aanroepen om de selectie up-to-date te houden.

Parameters

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

Geeft de selectievormen opnieuw weer.

Opmerking: u hoeft deze methode niet rechtstreeks aan te roepen. Dit wordt automatisch gedaan.

Verwante API-elementen

Parameters

Verwante API-elementen

Geeft de focus aan de eerste container in de selectie.

 textFlow.interactionManager.setFocus();

Stel de muisaanwijzer in.

Parameters

Stelt het SelectionState-object in voor de huidige selectie.

Parameters

Verwante API-elementen

Verwerkt een softKeyboardActivating-gebeurtenis

Parameters

Verwerkt een TextEvent.

Parameters

Dit voorbeeld illustreert het gebruik van de klasse SelectionManager.

Hiermee wordt een TextFlow, een listener voor selectiewijzigingen en vervolgens updates gebaseerd op de selectiewijzigingen geïnstalleerd.

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