SelectionManager  - AS3

La posizione del testo alla fine della selezione, indicata come offset dall'inizio del flusso di testo.

La fine assoluta è la stessa del punto attivo o del punto di ancoraggio della selezione, a seconda di quale dei due è ultimo nel flusso di testo.

La posizione del testo all'inizio della selezione, indicata come offset dall'inizio del flusso di testo.

L'inizio assoluto è lo stesso del punto attivo o del punto di ancoraggio della selezione, a seconda di quale dei due è primo nel flusso di testo.

Il punto attivo della selezione.

Il punto attivo è l'estremità volatile della selezione. Il punto attivo viene modificato quando si modifica la selezione. Il punto attivo può trovarsi all'inizio o alla fine della selezione.

Il punto di ancoraggio della selezione.

Un punto di ancoraggio è l'estremità stabile della selezione. Quando la selezione viene estesa, il punto di ancoraggio non viene modificato. Il punto di ancoraggio può trovarsi all'inizio o alla fine della selezione.

L'oggetto SelectionFormat corrente.

L'oggetto SelectionFormat corrente viene scelto tra gli oggetti SelectionFormat assegnati alle proprietà unfocusedSelectionFormat, inactiveSelectionFormat e focusedSelectionFormat in base allo stato corrente delle proprietà windowActive e focused.

Elementi API correlati

La modalità di modifica.

La modalità di modifica indica se il flusso di testo supporta la selezione, la modifica o solo la lettura. Un flusso di testo diventa selezionabile mediante l'assegnazione di SelectionManager e modificabile mediante l'assegnazione di EditManager. Le costanti che rappresentano le modalità di modifica sono definite nella classe EditingMode.

Elementi API correlati

Indica se un contenitore nel flusso di testo ha ricevuto lo stato attivo.

La proprietà focused è true se uno qualsiasi dei contenitori nel flusso di testo ha ricevuto lo stato attivo.

L'oggetto SelectionFormat viene utilizzato per disegnare la selezione in un contenitore con lo stato attivo.

Elementi API correlati

L'oggetto SelectionFormat viene utilizzato per disegnare la selezione quando non è nella finestra attiva.

Elementi API correlati

Il formato che verrà applicato al testo inserito. TBD: è necessario estendere pointFormat per ricordare stili utente e "undefine" dei formati dalle chiamate a IEditManager.undefineFormat con valori leafFormat nella selezione di un punto.

L'oggetto TextFlow gestito da questo SelectionManager.

Un oggetto SelectionManager gestisce un singolo flusso di testo. Potete inoltre assegnare un oggetto SelectionManager a un flusso di testo impostando la proprietà interactionManager dell'oggetto TextFlow.

Elementi API correlati

L'oggetto SelectionFormat viene utilizzato per disegnare la selezione quando non è in un contenitore con lo stato attivo, ma nella finestra attiva.

Elementi API correlati

Indica se la finestra associata al flusso di testo è attiva.

La proprietà windowActive è true se la finestra in cui è visualizzato il flusso di testo è la finestra attiva.

Crea un oggetto SelectionManager.

Assegnate un oggetto SelectionManager alla proprietà interactionManager di un flusso di testo per consentire la selezione del testo.

Elabora un evento activate.

Parametri

Elabora un evento deactivate.

Parametri

Esegue un'operazione SelectionManager; il flusso potrebbe non essere mai modificato, ma i client saranno in grado di annullarlo.

Parametri

Elabora un evento edit.

Gli eventi edit vengono inviati per i comandi Taglia, Copia, Incolla e Seleziona tutto.

Parametri

Elabora un evento focusChange.

Parametri

Elabora un evento focusIn.

Parametri

Elabora un evento focusOut.

Parametri

Ottiene gli attributi del formato del carattere comuni a tutti i caratteri nell'intervallo specificato o nella selezione corrente.

Gli attributi del formato che non hanno lo stesso valore per tutti i caratteri nella selezione o nell'intervallo di elementi specificato sono impostati su null nell'istanza TextLayoutFormat restituita.

Parametri

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

Ottiene gli attributi del formato del contenitore comuni a tutti i contenitori nell'intervallo specificato o nella selezione corrente.

Gli attributi del formato che non hanno lo stesso valore per tutti i contenitori nella selezione o nell'intervallo di elementi specificato sono impostati su null nell'istanza TextLayoutFormat restituita.

Parametri

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

Ottiene gli attributi del formato del paragrafo comuni a tutti i paragrafi nell'intervallo specificato o nella selezione corrente.

Gli attributi del formato che non hanno lo stesso valore per tutti i paragrafi nella selezione o nell'intervallo di elementi specificato sono impostati su null nell'istanza TextLayoutFormat restituita.

Parametri

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

Ottiene l'oggetto SelectionState della selezione corrente.

Elementi API correlati

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

Indica se è presente una selezione.

Restituisce true se è presente una selezione dell'intervallo o una selezione del punto. Per impostazione predefinita, quando si imposta per la prima volta un oggetto SelectionManager, non è presente alcuna selezione (l'inizio e la fine corrispondono a -1).

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

Elabora un evento imeStartComposition.

Parametri

Indica se la selezione si riferisce a un intervallo di testo.

Restituisce true se è presente una selezione che si estende oltre una singola posizione.

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

Elabora un evento keyDown.

Parametri

Elabora un evento keyFocusChange.

Parametri

Elabora un evento keyUp.

Parametri

Elabora un evento menuSelect.

Parametri

Elabora un evento mouseDoubleClick.

Parametri

Elabora un evento mouseDown.

Parametri

Elabora un evento mouseMove.

Parametri

Elabora un evento mouseOut.

Parametri

Elabora un evento mouseOver.

Parametri

Elabora un evento mouseUp.

Parametri

Elabora un evento mouseWheel.

Parametri

Aggiorna SelectionManager quando il testo viene inserito o eliminato.

Le operazioni devono chiamare notifyInsertOrDelete quando viene modificato il testo nel flusso di testo. SelectionManager modifica di conseguenza gli indicatori di posizione basati sull'indice. Se create una nuova classe Operation che modifica direttamente il testo in un flusso di testo (senza utilizzare un'altra operazione), l'operazione deve chiamare questa funzione per mantenere aggiornata la selezione.

Parametri

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

Visualizza di nuovo le forme della selezione.

Nota: non dovete chiamare direttamente questo metodo. Viene chiamato automaticamente.

Elementi API correlati

Parametri

Elementi API correlati

Attribuisce lo stato attivo al primo contenitore nella selezione.

 textFlow.interactionManager.setFocus();

Imposta il cursore del mouse.

Parametri

Imposta l'oggetto SelectionState della selezione corrente.

Parametri

Elementi API correlati

Elabora un evento softKeyboardActivating.

Parametri

Elabora un evento TextEvent.

Parametri

In questo esempio viene illustrato l'utilizzo della classe SelectionManager.

Viene impostato un TextFlow, poi un listener per le modifiche della selezione, quindi viene effettuato l'aggiornamento in base alla modifiche della selezione.

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