Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
flashx.textLayout.edit 

ISelectionManager  - AS3

Pacchettoflashx.textLayout.edit
Interfacciapublic interface ISelectionManager extends IInteractionEventHandler
Implementatori SelectionManager

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

L'interfaccia ISelectionManager definisce l'interfaccia per gestire la selezione del testo.

Un oggetto SelectionManager tiene traccia dell'intervallo di testo selezionato e gestisce gli eventi per un oggetto TextFlow.

Una selezione può essere la selezione di un punto o di un intervallo. La selezione di un punto è il punto di inserimento ed è indicata visivamente dal disegno di un cursore. La selezione di un intervallo include il testo tra un punto di ancoraggio e un punto attivo.

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
  absoluteEnd : int
[sola lettura] La posizione del testo alla fine della selezione, indicata come offset dall'inizio del flusso di testo.
ISelectionManager
  absoluteStart : int
[sola lettura] La posizione del testo all'inizio della selezione, indicata come offset dall'inizio del flusso di testo.
ISelectionManager
  activePosition : int
[sola lettura] Il punto attivo della selezione.
ISelectionManager
  anchorPosition : int
[sola lettura] Il punto di ancoraggio della selezione.
ISelectionManager
  currentSelectionFormat : SelectionFormat
[sola lettura] L'oggetto SelectionFormat corrente.
ISelectionManager
  editingMode : String
[sola lettura] La modalità di modifica.
ISelectionManager
  focused : Boolean
[sola lettura] Indica se un contenitore nel flusso di testo ha ricevuto lo stato attivo.
ISelectionManager
  focusedSelectionFormat : SelectionFormat
L'oggetto SelectionFormat viene utilizzato per disegnare la selezione in un contenitore con lo stato attivo.
ISelectionManager
  inactiveSelectionFormat : SelectionFormat
L'oggetto SelectionFormat viene utilizzato per disegnare la selezione quando non è nella finestra attiva.
ISelectionManager
  textFlow : flashx.textLayout.elements:TextFlow
L'oggetto TextFlow gestito da questo SelectionManager.
ISelectionManager
  unfocusedSelectionFormat : SelectionFormat
L'oggetto SelectionFormat viene utilizzato per disegnare la selezione quando non è in un contenitore con lo stato attivo, ma nella finestra attiva.
ISelectionManager
  windowActive : Boolean
[sola lettura] Indica se la finestra associata al flusso di testo è attiva.
ISelectionManager
Metodi pubblici
 MetodoDefinito da
 Inherited
Elabora un evento activate.
IInteractionEventHandler
 Inherited
Elabora un evento deactivate.
IInteractionEventHandler
 Inherited
Elabora un evento edit.
IInteractionEventHandler
  
Esegue qualsiasi oggetto FlowOperation in sospeso.
ISelectionManager
 Inherited
Elabora un evento focusChange.
IInteractionEventHandler
 Inherited
Elabora un evento focusIn.
IInteractionEventHandler
 Inherited
Elabora un evento focusOut.
IInteractionEventHandler
  
Ottiene gli attributi del formato del carattere comuni a tutti i caratteri nell'intervallo specificato o nella selezione corrente.
ISelectionManager
  
Ottiene gli attributi del formato del contenitore comuni a tutti i contenitori nell'intervallo specificato o nella selezione corrente.
ISelectionManager
  
Ottiene gli attributi del formato del paragrafo comuni a tutti i paragrafi nell'intervallo specificato o nella selezione corrente.
ISelectionManager
  
Ottiene l'oggetto SelectionState della selezione corrente.
ISelectionManager
  
Indica se è presente una selezione.
ISelectionManager
 Inherited
Elabora un evento imeStartComposition.
IInteractionEventHandler
  
Indica se la selezione si riferisce a un intervallo di testo.
ISelectionManager
 Inherited
Elabora un evento keyDown.
IInteractionEventHandler
 Inherited
Elabora un evento keyFocusChange.
IInteractionEventHandler
 Inherited
Elabora un evento keyUp.
IInteractionEventHandler
 Inherited
Elabora un evento menuSelect.
IInteractionEventHandler
 Inherited
Elabora un evento mouseDoubleClick.
IInteractionEventHandler
 Inherited
Elabora un evento mouseDown.
IInteractionEventHandler
 Inherited
Elabora un evento mouseMove.
IInteractionEventHandler
 Inherited
Elabora un evento mouseOut.
IInteractionEventHandler
 Inherited
Elabora un evento mouseOver.
IInteractionEventHandler
 Inherited
Elabora un evento mouseUp.
IInteractionEventHandler
 Inherited
Elabora un evento mouseWheel.
IInteractionEventHandler
  
notifyInsertOrDelete(absolutePosition:int, length:int):void
Aggiorna SelectionManager quando il testo viene inserito o eliminato.
ISelectionManager
  
Visualizza di nuovo le forme della selezione.
ISelectionManager
  
Seleziona l'intero flusso..
ISelectionManager
  
selectRange(anchorPosition:int, activePosition:int):void
Seleziona un intervallo di testo.
ISelectionManager
  
Attribuisce lo stato attivo al primo contenitore nella selezione.
ISelectionManager
  
Imposta l'oggetto SelectionState della selezione corrente.
ISelectionManager
 Inherited
Elabora un evento softKeyboardActivating.
IInteractionEventHandler
 Inherited
Elabora un evento TextEvent.
IInteractionEventHandler
Descrizione delle proprietà

absoluteEnd

proprietà
absoluteEnd:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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.



Implementazione
    public function get absoluteEnd():int

absoluteStart

proprietà 
absoluteStart:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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.



Implementazione
    public function get absoluteStart():int

activePosition

proprietà 
activePosition:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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.



Implementazione
    public function get activePosition():int

anchorPosition

proprietà 
anchorPosition:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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.



Implementazione
    public function get anchorPosition():int

currentSelectionFormat

proprietà 
currentSelectionFormat:SelectionFormat  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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.



Implementazione
    public function get currentSelectionFormat():SelectionFormat

editingMode

proprietà 
editingMode:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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.



Implementazione
    public function get editingMode():String

Elementi API correlati

flashx.textLayout.EditingMode

focused

proprietà 
focused:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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.



Implementazione
    public function get focused():Boolean

focusedSelectionFormat

proprietà 
focusedSelectionFormat:SelectionFormat

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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



Implementazione
    public function get focusedSelectionFormat():SelectionFormat
    public function set focusedSelectionFormat(value:SelectionFormat):void

inactiveSelectionFormat

proprietà 
inactiveSelectionFormat:SelectionFormat

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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



Implementazione
    public function get inactiveSelectionFormat():SelectionFormat
    public function set inactiveSelectionFormat(value:SelectionFormat):void

textFlow

proprietà 
textFlow:flashx.textLayout.elements:TextFlow

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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.



Implementazione
    public function get textFlow():flashx.textLayout.elements:TextFlow
    public function set textFlow(value:flashx.textLayout.elements:TextFlow):void

Elementi API correlati

unfocusedSelectionFormat

proprietà 
unfocusedSelectionFormat:SelectionFormat

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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



Implementazione
    public function get unfocusedSelectionFormat():SelectionFormat
    public function set unfocusedSelectionFormat(value:SelectionFormat):void

windowActive

proprietà 
windowActive:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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.



Implementazione
    public function get windowActive():Boolean
Descrizione dei metodi

flushPendingOperations

()metodo
public function flushPendingOperations():void

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Esegue qualsiasi oggetto FlowOperation in sospeso.

L'esecuzione di alcune operazioni di modifica, ad esempio un inserimento di testo, viene ritardata fino al successivo evento enterFrame. La chiamata a flushPendingOperations() causa l'esecuzione immediata di tutte le operazioni differite.

getCommonCharacterFormat

()metodo 
public function getCommonCharacterFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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

range:flashx.textLayout.elements:TextRange (default = null) — L'intervallo opzionale di testo per cui sono richiesti attributi comuni. Se null, viene utilizzata la selezione corrente.

Restituisce
flashx.textLayout.formats:TextLayoutFormat — Impostazioni dello stile di carattere comune

Esempio  ( Come utilizzare questo esempio )

L'esempio seguente mostra come ottenere un oggetto ITextLayoutFormat contenente le impostazioni di stile dei caratteri comuni a tutti gli elementi della selezione. (La variabile textFlow nell'esempio è un oggetto TextFlow.)
 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonCharacterFormat();

getCommonContainerFormat

()metodo 
public function getCommonContainerFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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

range:flashx.textLayout.elements:TextRange (default = null) — L'intervallo opzionale di testo per cui sono richiesti attributi comuni. Se null, viene utilizzata la selezione corrente.

Restituisce
flashx.textLayout.formats:TextLayoutFormat — Impostazioni dello stile di contenitore comune

Esempio  ( Come utilizzare questo esempio )

L'esempio seguente mostra come ottenere un oggetto ITextLayoutFormat contenente le impostazioni di stile del contenitore comuni a tutti gli elementi della selezione. (La variabile textFlow nell'esempio è un oggetto TextFlow.)
 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonContainerFormat();

getCommonParagraphFormat

()metodo 
public function getCommonParagraphFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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

range:flashx.textLayout.elements:TextRange (default = null) — L'intervallo opzionale di testo per cui sono richiesti attributi comuni. Se null, viene utilizzata la selezione corrente.

Restituisce
flashx.textLayout.formats:TextLayoutFormat — Impostazioni dello stile di paragrafo comune

Esempio  ( Come utilizzare questo esempio )

L'esempio seguente mostra come ottenere un oggetto ITextLayoutFormat contenente le impostazioni di stile del paragrafo comuni a tutti gli elementi della selezione. (La variabile textFlow nell'esempio è un oggetto TextFlow.)
 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonParagraphFormat();

getSelectionState

()metodo 
public function getSelectionState():SelectionState

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Ottiene l'oggetto SelectionState della selezione corrente.

Restituisce
SelectionState

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )

L'esempio seguente ottiene un oggetto SelectionState per la selezione corrente in un flusso di testo. (La variabile textFlow nell'esempio è un oggetto TextFlow.)
 var selection:SelectionState = textFlow.interactionManager.getSelectionState();

hasSelection

()metodo 
public function hasSelection():Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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).

Restituisce
Boolean

Esempio  ( Come utilizzare questo esempio )

L'esempio seguente mostra come determinare se un flusso di testo contiene una selezione. (La variabile textFlow nell'esempio è un oggetto TextFlow.)
 var selection:SelectionState = textFlow.interactionManager.hasSelection();

isRangeSelection

()metodo 
public function isRangeSelection():Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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

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

Restituisce
Boolean

Esempio  ( Come utilizzare questo esempio )

L'esempio seguente mostra come determinare se la selezione corrente in un flusso di testo si estende oltre un intervallo di testo. (La variabile textFlow nell'esempio è un oggetto TextFlow.)
 var selection:SelectionState = textFlow.interactionManager.isRangeSelection();

notifyInsertOrDelete

()metodo 
public function notifyInsertOrDelete(absolutePosition:int, length:int):void

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

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

absolutePosition:int — Il punto nel testo in cui è stata apportata la modifica.
 
length:int — Un numero positivo o negativo che indica la quantità di caratteri inseriti o eliminati.


Esempio  ( Come utilizzare questo esempio )

L'esempio seguente mostra come una funzione in una classe Operation personalizzata chiamerebbe il metodo notifyInsertOrDelete().

Questa funzione sostituisce un intervallo di testo in uno SpanElement nell'ambito di un'operazione ipotetica.

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

refreshSelection

()metodo 
public function refreshSelection():void

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Visualizza di nuovo le forme della selezione.

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

selectAll

()metodo 
public function selectAll():void

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Seleziona l'intero flusso.

selectRange

()metodo 
public function selectRange(anchorPosition:int, activePosition:int):void

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Seleziona un intervallo di testo.

Se passate un numero negativo come uno dei parametri, viene rimossa qualsiasi selezione.

Parametri

anchorPosition:int — Il punto di ancoraggio della nuova selezione, indicata come posizione assoluta in TextFlow
 
activePosition:int — L'estremità attiva della nuova selezione, indicata come posizione assoluta in TextFlow


Esempio  ( Come utilizzare questo esempio )

Il seguente esempio crea un flusso di testo ed effettua una selezione:
 var textFlow:TextFlow = TextConverter.importToFlow( "Let me not to the marriage of true minds", TextConverter.PLAIN_TEXT_FORMAT );
 textFlow.interactionManager = new SelectionManager();
 
 textFlow.interactionManager.selectRange( 18, 26 ); // Selects the word 'marriage'

setFocus

()metodo 
public function setFocus():void

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Attribuisce lo stato attivo al primo contenitore nella selezione.


Esempio  ( Come utilizzare questo esempio )

L'esempio seguente imposta l'attivazione sul primo contenitore nella selezione corrente di un flusso di testo. (La variabile textFlow nell'esempio è un oggetto TextFlow.)
 textFlow.interactionManager.setFocus();

setSelectionState

()metodo 
public function setSelectionState(state:SelectionState):void

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Imposta l'oggetto SelectionState della selezione corrente.

Parametri

state:SelectionState

Elementi API correlati





[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.