SelectionManager  - AS3

La position du texte de la fin de la sélection, sous la forme d’un décalage à partir du début de l’enchaînement de texte.

La fin absolue est la même que le point actif ou le point d’ancrage de la sélection, en fonction de celui qui vient en dernier dans l’enchaînement de texte.

La position du texte du début de la sélection, sous la forme d’un décalage à partir du début de l’enchaînement de texte.

Le début absolu est le même que le point actif ou le point d’ancrage de la sélection, en fonction de celui qui vient en premier dans l’enchaînement de texte.

Le point actif de la sélection.

Le point actif est la fin instable de la sélection. Le point actif est modifié lorsque la sélection est modifiée. Le point actif peut être au début ou à la fin de la sélection.

Le point d’ancrage de la sélection.

Un point d’ancrage est la fin stable de la sélection. Lorsque la sélection est étendue, le point d’ancrage ne change pas. Le point actif peut être au début ou à la fin de la sélection.

L’objet SelectionFormat en cours.

L’objet SelectionFormat en cours est choisi parmi les objets SelectionFormat affectés aux propriétés unfocusedSelectionFormat, inactiveSelectionFormat et focusedSelectionFormat sur la base de l’état actuel des propriétés windowActive et focused.

Eléments de l’API associés

Le mode de modification.

Le mode de modification indique si l’enchaînement de texte prend en charge la sélection, la modification ou uniquement la lecture. Un enchaînement de texte est rendu sélectionnable par affectation d’un gestionnaire de sélection et modifiable par affectation d’un gestionnaire de modification. Les constantes représentant les modes de modification sont définies dans la classe EditingMode.

Eléments de l’API associés

Indique si un conteneur dans l’enchaînement de texte a le focus.

La propriété focused est truesi l’un des conteneurs dans l’enchaînement de texte a le focus principal.

L’objet SelectionFormat utilisé pour tracer la sélection dans un conteneur concentré.

Eléments de l’API associés

L’objet SelectionFormat utilisé pour tracer la sélection si elle n’est pas dans la fenêtre active.

Eléments de l’API associés

Format qui sera appliqué au texte inséré. A déterminer : pointFormat doit être étendu pour mémoriser les styles utilisateur et annuler la définition des formats à partir d’appels de IEditManager.undefineFormat avec des valeurs leafFormat sur une sélection de point.

L’objet TextFlow géré par ce gestionnaire de sélection.

Un gestionnaire de sélection gère un seul enchaînement de texte. Un gestionnaire de sélection peut également être affecté à un enchaînement de texte par la définition du gestionnaire interactionManager de la propriété de l’objet TextFlow.

Eléments de l’API associés

L’objet SelectionFormat utilisé pour tracer la sélection si elle n’est pas dans un conteneur concentré mais dans la fenêtre active.

Eléments de l’API associés

Indique si la fenêtre associée à l’enchaînement de texte est active.

La propriété windowActive est true si la fenêtre qui affiche le texte est la fenêtre active

Crée un objet SelectionManager.

Affectez un objet à la propriété interactionManager d’un enchaînement de texte pour activer la sélection de texte.

Traite un événement Activer.

Paramètres

Traite un événement Désactiver.

Paramètres

Effectue une opération de SelectionManager. Il est possible que ces méthodes ne modifient jamais l’enchaînement, mais les clients ont toujours la possibilité de les annuler.

Paramètres

Traite un événement Modifier.

Les événements de modification sont distribués pour les commandes couper, copier, coller et selectAll.

Paramètres

Traite un événement focusChange.

Paramètres

Traite un événement focusIn.

Paramètres

Traite un événement focusOut.

Paramètres

Récupère les attributs de format de caractère qui sont communs à tous les caractères de la plage de texte spécifiée ou de la sélection actuelle.

Les attributs de format qui n’ont pas la même valeur pour tous les caractères de la plage d’éléments spécifiée ou de la sélection sont définis sur null dans l’occurrence de TextLayoutFormat renvoyée.

Paramètres

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

Récupère les attributs de format de conteneur qui sont communs à tous les conteneurs de la plage de texte spécifiée ou de la sélection actuelle.

Les attributs de format qui n’ont pas la même valeur pour tous les conteneurs de la plage d’éléments spécifiée ou de la sélection sont définis sur null dans l’occurrence de TextLayoutFormat renvoyée.

Paramètres

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

Récupère les attributs de format de paragraphe qui sont communs à tous les paragraphes de la plage de texte spécifiée ou de la sélection actuelle.

Les attributs de format qui n’ont pas la même valeur pour tous les paragraphes de la plage d’éléments spécifiée ou de la sélection sont définis sur null dans l’occurrence de TextLayoutFormat renvoyée.

Paramètres

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

Récupère l’objet SelectionState de la sélection actuelle.

Eléments de l’API associés

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

Indique s’il existe une sélection.

Renvoie true s’il existe une sélection de plage ou un point de sélection. Par défaut, lorsqu’un gestionnaire de sélection est configuré pour la première fois, il n’existe pas de sélection (le début et la fin sont -1).

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

Traite un événement imeStartComposition

Paramètres

Indique si la sélection couvre une plage de texte.

Renvoie true s’il existe une sélection qui s’étend au-delà d’une position unique

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

Traite un événement keyDown.

Paramètres

Traite un événement keyFocusChange.

Paramètres

Traite un événement keyUp.

Paramètres

Traite un événement menuSelect.

Paramètres

Traite un événement mouseDoubleClick.

Paramètres

Traite un événement mouseDown.

Paramètres

Traite un événement mouseMove.

Paramètres

Traite un événement mouseOut.

Paramètres

Traite un événement mouseOver.

Paramètres

Traite un événement mouseUp.

Paramètres

Traite un événement mouseWheel.

Paramètres

Met à jour le gestionnaire de sélection lorsque du texte est inséré ou supprimé.

Les opérations doivent appeler notifyInsertOrDelete lors de la modification de texte dans l’enchaînement. Le gestionnaire de sélection ajuste les indicateurs de position basés sur l’index en conséquence. Si vous créez une nouvelle classe d’opération qui modifie le texte dans un enchaînement de texte directement (sans utiliser une autre opération) votre opération doit appeler cette fonction pour maintenir la sélection à jour.

Paramètres

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

Affiche à nouveau les formes de sélection.

Remarque : vous n’avez pas besoin d’appeler directement cette méthode. Elle est appelée automatiquement.

Eléments de l’API associés

Paramètres

Eléments de l’API associés

Donne le focus sur le premier conteneur de la sélection.

 textFlow.interactionManager.setFocus();

Définissez le curseur de la souris.

Paramètres

Définit l’objet SelectionState de la sélection actuelle.

Paramètres

Eléments de l’API associés

Traite un événement softKeyboardActivating.

Paramètres

Traite un événement TextEvent.

Paramètres

Cet exemple montre l’utilisation de la classe SelectionManager.

Il configure un objet TextFlow et un écouteur pour les modifications de sélection, puis effectue une mise à jour en fonction des modifications de sélection.

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