Pacchetto | flashx.textLayout.edit |
Classe | public class EditManager |
Ereditarietà | EditManager SelectionManager Object |
Implementa | IEditManager |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Per consentire la modifica del flusso di testo, assegnare un oggetto EditManager alla proprietà interactionManager
dell'oggetto TextFlow. EditManager gestisce le modifiche al testo (ad esempio inserimenti, eliminazioni e modifiche del formato). Le modifiche sono reversibili se EditManager dispone di un oggetto UndoManager. EditManager attiva la ricomposizione e visualizza il flusso di testo, se necessario.
La classe EditManager supporta le seguenti scelte rapide da tastiera:
Tasti | Risultato |
---|---|
ctrl-z | annulla |
ctrl-y | ripeti |
ctrl-backspace | deletePreviousWord |
ctrl-canc | deleteNextWord |
alt+canc | deleteNextWord |
ctrl+alt-canc | deleteNextWord |
ctrl-maiusc-trattino | inserimento trattino facoltativo |
ctrl+backspace | deletePreviousWord |
alt+backspace | deletePreviousWord |
ctrl+alt-backspace | deletePreviousWord |
INS | commuta overWriteMode |
backspace | deletePreviousCharacter |
INVIO | Se textFlow.configuration.manageEnterKey è in un elenco, crea una nuova voce di elenco, altrimenti crea un nuovo paragrafo. |
shift-ENTER | Se textFlow.configuration.manageEnterKey crea un nuovo paragrafo |
TAB | Se textFlow.configuration.manageTabKey è in un elenco, crea un elenco nidificato, altrimenti inserisce un TAB o sovrascrive il carattere successivo con un TAB. |
shift-TAB | Se textFlow.configuration.manageTabKey è la prima voce di un elenco, sposta la voce fuori dell'elenco (la promuove). |
Nota: i tasti seguenti non funzionano in Windows: alt-backspace, alt-canc, ctrl+alt-backspace e ctrl+alt-canc. Questi tasti non generano alcun evento per il runtime.
Elementi API correlati
Proprietà | Definito da | ||
---|---|---|---|
absoluteEnd : int [sola lettura]
La posizione del testo alla fine della selezione, indicata come offset dall'inizio del flusso di testo. | SelectionManager | ||
absoluteStart : int [sola lettura]
La posizione del testo all'inizio della selezione, indicata come offset dall'inizio del flusso di testo. | SelectionManager | ||
activePosition : int [sola lettura]
Il punto attivo della selezione. | SelectionManager | ||
allowDelayedOperations : Boolean | EditManager | ||
anchorPosition : int [sola lettura]
Il punto di ancoraggio della selezione. | SelectionManager | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
currentSelectionFormat : SelectionFormat [sola lettura]
L'oggetto SelectionFormat corrente. | SelectionManager | ||
delayUpdates : Boolean | EditManager | ||
editingMode : String [sola lettura]
La modalità di modifica. | SelectionManager | ||
focused : Boolean [sola lettura]
Indica se un contenitore nel flusso di testo ha ricevuto lo stato attivo. | SelectionManager | ||
focusedSelectionFormat : SelectionFormat
L'oggetto SelectionFormat viene utilizzato per disegnare la selezione in un contenitore con lo stato attivo. | SelectionManager | ||
inactiveSelectionFormat : SelectionFormat
L'oggetto SelectionFormat viene utilizzato per disegnare la selezione quando non è nella finestra attiva. | SelectionManager | ||
overwriteMode : Boolean = false [statico]
Indica se la modalità di sovrascrittura è attivata o disattivata. | EditManager | ||
textFlow : flashx.textLayout.elements:TextFlow
L'oggetto TextFlow gestito da questo SelectionManager. | SelectionManager | ||
undoManager : IUndoManager [sola lettura]
L'oggetto IUndoManager assegnato a questo EditManager. | EditManager | ||
unfocusedSelectionFormat : SelectionFormat
L'oggetto SelectionFormat viene utilizzato per disegnare la selezione quando non è in un contenitore con lo stato attivo, ma nella finestra attiva. | SelectionManager | ||
windowActive : Boolean [sola lettura]
Indica se la finestra associata al flusso di testo è attiva. | SelectionManager |
Metodo | Definito da | ||
---|---|---|---|
EditManager(undoManager:IUndoManager = null)
Crea un oggetto EditManager. | EditManager | ||
Elabora un evento activate. | SelectionManager | ||
applyContainerFormat(containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Applica gli stili del contenitore a qualsiasi contenitore nella selezione. | EditManager | ||
applyFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Modifica i formati della selezione specificata (o corrente). | EditManager | ||
applyFormatToElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Applica gli stili all'elemento specificato. | EditManager | ||
applyLeafFormat(characterFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Modifica i formati applicati agli elementi foglia nella selezione specificata (o corrente). | EditManager | ||
applyLink(href:String, targetString:String = null, extendToLinkBoundary:Boolean = false, operationState:SelectionState = null):LinkElement
Trasforma una selezione in un collegamento o un collegamento in testo normale. | EditManager | ||
applyParagraphFormat(paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Applica gli stili del paragrafo a qualsiasi paragrafo nella selezione. | EditManager | ||
Trasforma il testo in una sequenza TCY o una sequenza TCY in testo non TCY. | EditManager | ||
Inizia un nuovo gruppo di operazioni. | EditManager | ||
changeElementID(newID:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Modifica l'ID di un elemento. | EditManager | ||
changeStyleName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void Obsoleto da 2.0: Da utilizzare applyFormatToElement
Modifica il valore styleName di un elemento o parte di un elemento. | EditManager | ||
changeTypeName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Modifica il valore typeName di un elemento o parte di un elemento. | EditManager | ||
clearFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Annulla la definizione dei formati della selezione specificata (o corrente). | EditManager | ||
clearFormatOnElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Annulla la definizione degli stili dell'elemento specificato. | EditManager | ||
createDiv(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):DivElement Crea un nuovo DivElement che contiene l'intero intervallo specificato in operationState in corrispondenza dell'elemento superiore comune più basso che contiene sia il punto iniziale che il punto finale dell'intervallo. | EditManager | ||
createList(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):ListElement Crea un nuovo ListElement che contiene l'intero intervallo specificato in operationState in corrispondenza dell'elemento superiore comune più basso che contiene sia il punto iniziale che il punto finale dell'intervallo. | EditManager | ||
createSubParagraphGroup(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):SubParagraphGroupElement Crea un nuovo SubParagraphGroupElement che contiene l'intero intervallo specificato in operationState in corrispondenza dell'elemento superiore comune più basso che contiene sia il punto iniziale che il punto finale dell'intervallo. | EditManager | ||
Elimina l'area selezionata e la restituisce in un oggetto TextScrap. | EditManager | ||
Elabora un evento deactivate. | SelectionManager | ||
Elimina un intervallo di testo oppure, se viene indicata la selezione di un punto, elimina il carattere successivo. | EditManager | ||
Elimina la parola successiva. | EditManager | ||
Elimina un intervallo di testo oppure, se viene indicata la selezione di un punto, elimina il carattere precedente. | EditManager | ||
Elimina la parola precedente. | EditManager | ||
Elimina un intervallo di testo. | EditManager | ||
[override]
Esegue un'operazione FlowOperation. | EditManager | ||
Elabora un evento edit. | SelectionManager | ||
Termina un gruppo di operazioni. | EditManager | ||
SelectionManager | |||
Elabora un evento focusChange. | SelectionManager | ||
Elabora un evento focusIn. | SelectionManager | ||
Elabora un evento focusOut. | SelectionManager | ||
getCommonCharacterFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Ottiene gli attributi del formato del carattere comuni a tutti i caratteri nell'intervallo specificato o nella selezione corrente. | SelectionManager | ||
getCommonContainerFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Ottiene gli attributi del formato del contenitore comuni a tutti i contenitori nell'intervallo specificato o nella selezione corrente. | SelectionManager | ||
getCommonParagraphFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Ottiene gli attributi del formato del paragrafo comuni a tutti i paragrafi nell'intervallo specificato o nella selezione corrente. | SelectionManager | ||
Ottiene l'oggetto SelectionState della selezione corrente. | SelectionManager | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Indica se è presente una selezione. | SelectionManager | ||
Elabora un evento imeStartComposition.
| SelectionManager | ||
insertInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):InlineGraphicElement
Inserisce un'immagine. | EditManager | ||
Inserisce il testo. | EditManager | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Indica se la selezione si riferisce a un intervallo di testo. | SelectionManager | ||
Elabora un evento keyDown. | SelectionManager | ||
Elabora un evento keyFocusChange. | SelectionManager | ||
Elabora un evento keyUp. | SelectionManager | ||
Elabora un evento menuSelect. | SelectionManager | ||
modifyInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):void
Modifica un elemento grafico agganciato esistente. | EditManager | ||
Elabora un evento mouseDoubleClick. | SelectionManager | ||
Elabora un evento mouseDown. | SelectionManager | ||
Elabora un evento mouseMove. | SelectionManager | ||
Elabora un evento mouseOut. | SelectionManager | ||
Elabora un evento mouseOver. | SelectionManager | ||
Elabora un evento mouseUp. | SelectionManager | ||
Elabora un evento mouseWheel. | SelectionManager | ||
moveChildren(source:FlowGroupElement, sourceIndex:int, numChildren:int, destination:FlowGroupElement, destinationIndex:int, selectionState:SelectionState = null):void Sposta un set di FlowElement da un FlowGroupElement a un altro. | EditManager | ||
Aggiorna SelectionManager quando il testo viene inserito o eliminato. | SelectionManager | ||
Sovrascrive il testo selezionato. | EditManager | ||
pasteTextScrap(scrapToPaste:flashx.textLayout.edit:TextScrap, operationState:SelectionState = null):void
Incolla l'oggetto TextScrap nell'area selezionata. | EditManager | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Esegue di nuovo la precedente operazione annullata. | EditManager | ||
Visualizza di nuovo le forme della selezione. | SelectionManager | ||
SelectionManager | |||
SelectionManager | |||
Attribuisce lo stato attivo al primo contenitore nella selezione. | SelectionManager | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Imposta l'oggetto SelectionState della selezione corrente. | SelectionManager | ||
Elabora un evento softKeyboardActivating.
| SelectionManager | ||
Divide l'elemento di destinazione nella posizione specificata, creando un nuovo elemento dopo quello corrente. | EditManager | ||
Divide il paragrafo nella posizione specificata, creando un nuovo paragrafo dopo quello corrente. | EditManager | ||
Elabora un evento TextEvent. | SelectionManager | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
Annulla l'operazione precedente. | EditManager | ||
EditManager | |||
Restituisce il valore di base dell'oggetto specificato. | Object |
allowDelayedOperations | proprietà |
delayUpdates | proprietà |
overwriteMode | proprietà |
public static var overwriteMode:Boolean = false
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Indica se la modalità di sovrascrittura è attivata o disattivata.
Se è true
, una sequenza di tasti sovrascrive il carattere che segue il cursore. Se è false
, una sequenza di tasti viene inserita nella posizione del cursore.
undoManager | proprietà |
undoManager:IUndoManager
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
L'oggetto IUndoManager assegnato a questo EditManager.
Per consentire l'annullamento (e la ripetizione) delle modifiche, passate un'istanza IUndoManager alla funzione di costruzione EditManager. UndoManager gestisce uno stack delle operazioni eseguite ed è in grado di annullare o ripetere singole operazioni.
Nota: se TextFlow viene modificato direttamente (non tramite chiamate a EditManager, ma direttamente tramite chiamate agli oggetti FlowElement gestiti), lo stack di annullamento viene cancellato da EditManager per impedire che tale stack non sia più sincronizzato con lo stato corrente.
Implementazione
public function get undoManager():IUndoManager
EditManager | () | Funzione di costruzione |
public function EditManager(undoManager:IUndoManager = null)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Crea un oggetto EditManager.
Assegnate un oggetto EditManager alla proprietà interactionManager
di un flusso di testo per consentire la modifica di tale flusso di testo.
Per abilitare il supporto per le modifiche di annullamento e ripetizione, passate un'istanza IUndoManager alla funzione di costruzione EditManager. Potete utilizzare la classe flashx.undo.UndoManager
o creare un'istanza IUndoManager personalizzata. Utilizzate un'istanza IUndoManager personalizzata per integrare le modifiche di Text Layout Framework con un UndoManager esistente che non sia un'istanza della classe UndoManager. Per creare un'istanza IUndoManager personalizzata, verificate che la classe che utilizzate per definire UndoManager implementi l'interfaccia UndoManager.
undoManager:IUndoManager (default = null ) — L'oggetto UndoManager per l'applicazione
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_constructor { // Create a new TextFlow that is editable and undoable. static public function createEditableTextFlow():TextFlow { var textFlow:TextFlow = new TextFlow(); textFlow.interactionManager = new EditManager( new UndoManager() ); return textFlow; } } }
applyContainerFormat | () | metodo |
public function applyContainerFormat(containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Applica gli stili del contenitore a qualsiasi contenitore nella selezione.
Tutte le proprietà dello stile nell'oggetto format che risultano null
vengono lasciate invariate.
Parametri
containerFormat:flashx.textLayout.formats:ITextLayoutFormat — Il formato da applicare ai contenitori nell'intervallo
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.formats.TextLayoutFormat; public class EditManager_applyContainerFormat { public function EditManager_applyContainerFormat( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var containerStyle:TextLayoutFormat = new TextLayoutFormat(); containerStyle.columnCount = 2; editManager.applyContainerFormat( containerStyle ); } } }
applyFormat | () | metodo |
public function applyFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Modifica i formati della selezione specificata (o corrente).
Esegue un'operazione non annullabile che applica i nuovi formati. Vengono applicati solo gli attributi di stile impostati per gli oggetti TextLayoutFormat. Gli attributi undefined negli oggetti format non vengono modificati.
Parametri
leafFormat:flashx.textLayout.formats:ITextLayoutFormat — Il formato da applicare agli elementi foglia, ad esempio le estensioni e gli elementi grafici in linea.
| |
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat — Il formato da applicare agli elementi del paragrafo.
| |
containerFormat:flashx.textLayout.formats:ITextLayoutFormat — Il formato da applicare ai contenitori.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.formats.TextAlign; import flashx.textLayout.formats.TextLayoutFormat; public class EditManager_applyFormat { public function EditManager_applyFormat( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var containerStyle:TextLayoutFormat = new TextLayoutFormat(); containerStyle.columnCount = 2; var paraStyle:TextLayoutFormat = new TextLayoutFormat(); paraStyle.textAlign = TextAlign.JUSTIFY; var charStyle:TextLayoutFormat = new TextLayoutFormat(); charStyle.color = 0xff0000; editManager.applyFormat( charStyle, paraStyle, containerStyle ); } } }
applyFormatToElement | () | metodo |
public function applyFormatToElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Applica gli stili all'elemento specificato.
Tutte le proprietà dello stile nell'oggetto format che risultano null
vengono lasciate invariate. Vengono applicati solo gli stili rilevanti per l'elemento specificato.
Parametri
targetElement:FlowElement — L'elemento a cui vengono applicati gli stili.
| |
format:flashx.textLayout.formats:ITextLayoutFormat — Il formato contenente gli stili da applicare.
| |
relativeStart:int (default = 0 ) — Un offset dall'inizio dell'elemento in corrispondenza del quale dividere l'elemento quando si assegna la nuova formattazione.
| |
relativeEnd:int (default = -1 ) — Un offset dall'inizio dell'elemento in corrispondenza del quale dividere l'elemento quando si applica la nuova formattazione.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
applyLeafFormat | () | metodo |
public function applyLeafFormat(characterFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Modifica i formati applicati agli elementi foglia nella selezione specificata (o corrente).
Esegue un'operazione non annullabile che applica il nuovo formato agli elementi foglia, ad esempio gli oggetti SpanElement e InlineGraphicElement. Vengono applicati solo gli attributi di stile impostati per gli oggetti TextLayoutFormat. Gli attributi undefined nell'oggetto format non vengono modificati.
Parametri
characterFormat:flashx.textLayout.formats:ITextLayoutFormat — Il formato da applicare.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.formats.TextLayoutFormat; public class EditManager_applyLeafFormat { public function EditManager_applyLeafFormat(selection:SelectionState) { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var charStyle:TextLayoutFormat = new TextLayoutFormat(); charStyle.color = 0xff0000; editManager.applyLeafFormat( charStyle ); } } }
applyLink | () | metodo |
public function applyLink(href:String, targetString:String = null, extendToLinkBoundary:Boolean = false, operationState:SelectionState = null):LinkElement
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10 - + 10.2, AIR 1.5 |
Trasforma una selezione in un collegamento o un collegamento in testo normale.
Esegue un'operazione non annullabile che crea o rimuove il collegamento.
Se viene specificato un parametro target
, deve essere uno dei valori seguenti:
- "_self"
- "_blank"
- "_parent"
- "_top"
Nei runtime residenti nel browser, un parametro target impostato su "_self" sostituisce la pagina html corrente. Pertanto, se il contenuto SWF in cui è presente il collegamento si trova in una pagina al'interno di un frame o set di frame, il contenuto collegato viene caricato all'interno di tale frame. Se la pagina si trova al livello superiore, viene aperto il contenuto collegato per sostituire la pagina originale. Un target impostato su "_blank" apre una nuova finestra del browser senza nome. Un target impostato su "_parent" sostituisce l'elemento principale della pagina html che include il contenuto SWF. Un target impostato su "_top" sostituisce la pagina di livello superiore nella finestra del browser corrente.
In altri runtime, ad esempio Adobe AIR, il collegamento viene aperto nel browser predefinito dell'utente e il parametro target
viene ignorato.
Il parametro extendToLinkBoundary
determina il modo in cui EditManager gestisce una selezione che si interseca con uno o più collegamenti esistenti. Se il parametro è true
, l'operazione viene applicata come un'unità alla selezione e all'intero testo dei collegamenti esistenti. In questo modo, viene creato un singolo collegamento che si estende dell'inizio del primo collegamento di intersezione alla fine dell'ultimo collegamento di intersezione. Al contrario, se in questo caso extendToLinkBoundary
fosse stato false
, i collegamenti esistenti parzialmente selezionati verrebbero divisi in due collegamenti.
Parametri
href:String — L'URI a cui fa riferimento il collegamento.
| |
targetString:String (default = null ) — La finestra del browser di destinazione del collegamento.
| |
extendToLinkBoundary:Boolean (default = false ) — Specifica se consolidare la selezione con qualsiasi collegamento sovrapposto esistente e quindi applica la modifica.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
LinkElement — Il LinkElement che è stato creato.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_applyLink { static public function makeLink( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; editManager.applyLink( "http://www.adobe.com" ); } static public function removeLink( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; editManager.applyLink( null, null, true ); } } }
applyParagraphFormat | () | metodo |
public function applyParagraphFormat(paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Applica gli stili del paragrafo a qualsiasi paragrafo nella selezione.
Tutte le proprietà dello stile nell'oggetto format che risultano null
vengono lasciate invariate.
Parametri
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat — Il formato da applicare ai paragrafi selezionati.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.formats.TextAlign; import flashx.textLayout.formats.TextLayoutFormat; public class EditManager_applyParagraphFormat { static public function justifyParagraph( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var paraStyle:TextLayoutFormat = new TextLayoutFormat(); paraStyle.textAlign = TextAlign.JUSTIFY; editManager.applyParagraphFormat( paraStyle ); } } }
applyTCY | () | metodo |
public function applyTCY(tcyOn:Boolean, operationState:SelectionState = null):flashx.textLayout.elements:TCYElement
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10 - + 10.2, AIR 1.5 |
Trasforma il testo in una sequenza TCY o una sequenza TCY in testo non TCY.
TCY, o tate-chu-yoko, determina la disposizione orizzontale del testo in una riga verticale e viene utilizzato per rendere più facilmente leggibili piccoli blocchi di testo non giapponese o i numeri, ad esempio le date, nel testo verticale.
Parametri
tcyOn:Boolean — Impostate su true per applicare il TCY a un intervallo di testo; false per rimuovere il TCY.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
flashx.textLayout.elements:TCYElement — Il TCYElement che è stato creato.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_applyTCY { static public function tcyOn( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; editManager.applyTCY( true ); } static public function tcyOff( selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; editManager.applyTCY( false ); } } }
beginCompositeOperation | () | metodo |
public function beginCompositeOperation():void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Inizia un nuovo gruppo di operazioni.
Tutte le operazioni eseguite dopo la chiamata a beginCompositeOperation()
, e prima della chiamata corrispondente a endCompositeOperation()
, vengono eseguite e raggruppate come un'unica operazione che può essere annullata come un'unità.
Un blocco beginCompositeOperation
/endCompositeOperation
può essere nidificato all'interno di un altro blocco beginCompositeOperation
/endCompositeOperation
.
Esempio ( Come utilizzare questo esempio )
beginCompositeOperation()
e endCompositeOperation()
non venissero utilizzate, ciascuna delle operazioni secondarie dovrebbe essere annullata separatamente anziché come gruppo di operazioni.
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_beginCompositeOperation { static public function insertGraphic( source:Object, width:Object, height:Object, float:String, selection:SelectionState ):void { var editManager:IEditManager = selection.textFlow.interactionManager as IEditManager; editManager.beginCompositeOperation(); editManager.deleteText( selection ); var changedSelection:SelectionState = new SelectionState( selection.textFlow, selection.anchorPosition, selection.anchorPosition ); editManager.splitParagraph( changedSelection ); changedSelection = new SelectionState( changedSelection.textFlow, changedSelection.anchorPosition + 1, changedSelection.anchorPosition + 1); editManager.insertInlineGraphic( source, width, height, float, changedSelection ); changedSelection = new SelectionState( changedSelection.textFlow, changedSelection.anchorPosition + 1, changedSelection.anchorPosition + 1); editManager.splitParagraph( changedSelection ); editManager.endCompositeOperation(); } } }
changeElementID | () | metodo |
public function changeElementID(newID:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Modifica l'ID di un elemento.
Se il parametro relativeStart
o relativeEnd
è impostato (su qualsiasi valore che non sia tra quelli predefiniti), l'elemento viene diviso. Le parti dell'elemento all'esterno dell'intervallo mantengono l'ID originale. L'importazione di entrambi i parametri relativeStart
e relativeEnd
crea elementi con ID duplicati.
Parametri
newID:String — Il nuovo valore dell'ID.
| |
targetElement:FlowElement — L'elemento da modificare.
| |
relativeStart:int (default = 0 ) — Un offset dall'inizio dell'elemento in corrispondenza del quale dividere l'elemento quando si assegna il nuovo ID.
| |
relativeEnd:int (default = -1 ) — Un offset dall'inizio dell'elemento in corrispondenza del quale dividere l'elemento quando si assegna il nuovo ID.
| |
operationState:SelectionState (default = null ) — Specifica la selezione da ripristinare quando si annulla questa operazione; se null , l'operazione salva la selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.ElementRange; import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_changeElementID { static public function changeParagraphID( id:String, selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var selectedRange:ElementRange = ElementRange.createElementRange( selection.textFlow, selection.absoluteStart, selection.absoluteEnd ); editManager.changeElementID( id, selectedRange.firstParagraph, 0, -1, selection ); } } }
changeStyleName | () | metodo |
public function changeStyleName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Modifica il valore styleName di un elemento o parte di un elemento.
Se il parametro relativeStart
o relativeEnd
è impostato (su qualsiasi valore che non sia tra quelli predefiniti), l'elemento viene diviso. Le parti dell'elemento all'esterno dell'intervallo mantengono lo stile originale.
Parametri
newName:String — Il nome del nuovo stile.
| |
targetElement:FlowElement — Specifica l'elemento da modificare.
| |
relativeStart:int (default = 0 ) — Un offset dall'inizio dell'elemento in corrispondenza del quale dividere l'elemento quando si assegna il nuovo stile.
| |
relativeEnd:int (default = -1 ) — Un offset dalla fine dell'elemento in corrispondenza del quale dividere l'elemento quando si assegna il nuovo stile.
| |
operationState:SelectionState (default = null ) — Specifica la selezione da ripristinare quando si annulla questa operazione; se null , l'operazione salva la selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.ElementRange; import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_changeStyleName { static public function changeParagraphStyle( styleName:String, selection:SelectionState ):void { var textFlow:TextFlow = selection.textFlow; var editManager:IEditManager = textFlow.interactionManager as IEditManager; var selectedRange:ElementRange = ElementRange.createElementRange( selection.textFlow, selection.absoluteStart, selection.absoluteEnd ); editManager.changeElementID( styleName, selectedRange.firstParagraph, 0, -1, selection ); } } }
changeTypeName | () | metodo |
public function changeTypeName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Modifica il valore typeName di un elemento o parte di un elemento.
Se il parametro relativeStart
o relativeEnd
è impostato (su qualsiasi valore che non sia tra quelli predefiniti), l'elemento viene diviso. Le parti dell'elemento all'esterno dell'intervallo mantengono lo stile originale.
Parametri
newName:String — Il nome del nuovo tipo.
| |
targetElement:FlowElement — Specifica l'elemento da modificare.
| |
relativeStart:int (default = 0 ) — Un offset dall'inizio dell'elemento in corrispondenza del quale dividere l'elemento quando si assegna il nuovo stile.
| |
relativeEnd:int (default = -1 ) — Un offset dalla fine dell'elemento in corrispondenza del quale dividere l'elemento quando si assegna il nuovo stile.
| |
operationState:SelectionState (default = null ) — Specifica la selezione da ripristinare quando si annulla questa operazione; se null , l'operazione salva la selezione corrente.
|
clearFormat | () | metodo |
public function clearFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Annulla la definizione dei formati della selezione specificata (o corrente).
Esegue un'operazione non annullabile che annulla la definizione dei formati specificati. Vengono applicati solo gli attributi di stile impostati per gli oggetti TextLayoutFormat. Gli attributi undefined negli oggetti format non vengono modificati.
Parametri
leafFormat:flashx.textLayout.formats:ITextLayoutFormat — Formato i cui valori impostati indicano le proprietà di cui annullare la definizione per gli oggetti LeafFlowElement nell'intervallo selezionato.
| |
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat — Formato i cui valori impostati indicano le proprietà di cui annullare la definizione per gli oggetti ParagraphElement nell'intervallo selezionato.
| |
containerFormat:flashx.textLayout.formats:ITextLayoutFormat — Formato i cui valori impostati indicano le proprietà di cui annullare la definizione per gli oggetti ContainerController nell'intervallo selezionato.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
clearFormatOnElement | () | metodo |
public function clearFormatOnElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Annulla la definizione degli stili dell'elemento specificato.
Tutte le proprietà dello stile nell'oggetto format che risultano undefined
vengono lasciate invariate. Tutti gli stili definiti nel formato specificato sono "undefined" nell'elemento specificato.
Parametri
targetElement:FlowElement — L'elemento a cui vengono applicati gli stili.
| |
format:flashx.textLayout.formats:ITextLayoutFormat — Il formato contenente gli stili di cui annullare la definizione.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
createDiv | () | metodo |
public function createDiv(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):DivElement
Crea un nuovo DivElement che contiene l'intero intervallo specificato in operationState in corrispondenza dell'elemento superiore comune più basso che contiene sia il punto iniziale che il punto finale dell'intervallo. Se i punti iniziale e finale sono uguali, viene creato un nuovo DivElement in quella posizione con un singolo paragrafo di livello inferiore.
Parametri
parent:FlowGroupElement (default = null ) — Specifica un elemento superiore per il nuovo DivElement. Se è null , il nuovo elemento superiore sarà il livello più basso che contiene SelectionState.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Gli attributi di formattazione da applicare al nuovo DivElement.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
DivElement — Il nuovo DivElement che è stato creato.
|
createList | () | metodo |
public function createList(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):ListElement
Crea un nuovo ListElement che contiene l'intero intervallo specificato in operationState in corrispondenza dell'elemento superiore comune più basso che contiene sia il punto iniziale che il punto finale dell'intervallo. Ogni paragrafo all'interno dell'intervallo diventa un ListItemElement nel nuovo ListElement. Se i punti iniziale e finale sono uguali, viene creato un nuovo ListElement in quella posizione con un singolo ListItemElement di livello inferiore.
Parametri
parent:FlowGroupElement (default = null ) — Specifica (facoltativamente) un elemento superiore per il nuovo ListElement. Se è null , il nuovo elemento superiore sarà il livello più basso che contiene SelectionState.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Gli attributi di formattazione da applicare al nuovo ListElement.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
ListElement — Il nuovo ListElement che è stato creato.
|
createSubParagraphGroup | () | metodo |
public function createSubParagraphGroup(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):SubParagraphGroupElement
Crea un nuovo SubParagraphGroupElement che contiene l'intero intervallo specificato in operationState in corrispondenza dell'elemento superiore comune più basso che contiene sia il punto iniziale che il punto finale dell'intervallo. Se i punti iniziale e finale sono uguali, non avviene nulla.
Parametri
parent:FlowGroupElement (default = null ) — Specifica un elemento superiore per il nuovo elemento SubParagraphGroupElement. Se è null , il nuovo elemento superiore sarà il livello più basso che contiene SelectionState.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Gli attributi di formattazione da applicare al nuovo SubParagraphGroupElement.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
SubParagraphGroupElement — Il nuovo SubParagraphGroupElement che è stato creato.
|
cutTextScrap | () | metodo |
public function cutTextScrap(operationState:SelectionState = null):flashx.textLayout.edit:TextScrap
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Elimina l'area selezionata e la restituisce in un oggetto TextScrap.
L'oggetto TextScrap risultante può essere inviato all'area appunti del sistema o utilizzato in una successiva operazione pasteTextOperation()
.
Parametri
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
flashx.textLayout.edit:TextScrap — L'oggetto TextScrap tagliato.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.edit.TextScrap; import flashx.undo.UndoManager; import flashx.textLayout.elements.TextFlow; public class EditManager_cutTextScrap { static public function cutTextScrap():TextScrap { var textFlow:TextFlow = TextConverter.importToFlow( "How do now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( new Sprite() )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 4, 7 ); var scrap:TextScrap = editManager.cutTextScrap(); //Displays: How now brown cow. return scrap; } } }
deleteNextCharacter | () | metodo |
public function deleteNextCharacter(operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Elimina un intervallo di testo oppure, se viene indicata la selezione di un punto, elimina il carattere successivo.
Parametri
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_deleteNextCharacter { static public function deleteNextCharacter():void { var textFlow:TextFlow = TextConverter.importToFlow( "How now brown crow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( new Sprite() )); var editManager:EditManager = new EditManager(); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 15, 15 ); editManager.deleteNextCharacter(); //displays: How now brown cow. } } }
deleteNextWord | () | metodo |
public function deleteNextWord(operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Elimina la parola successiva.
Se viene selezionato un intervallo, viene eliminata la prima parola di tale intervallo.
Parametri
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_deleteNextWord { static public function deleteNextWord():void { var textFlow:TextFlow = TextConverter.importToFlow( "How do now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( new Sprite() )); var editManager:EditManager = new EditManager(); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 3, 3 ); editManager.deleteNextWord(); //displays: How now brown cow. } } }
deletePreviousCharacter | () | metodo |
public function deletePreviousCharacter(operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Elimina un intervallo di testo oppure, se viene indicata la selezione di un punto, elimina il carattere precedente.
Parametri
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_deletePreviousCharacter { static public function deletePreviousCharacter():void { var textFlow:TextFlow = TextConverter.importToFlow( "How now brown crow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( new Sprite() )); var editManager:EditManager = new EditManager(); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 16, 16 ); editManager.deletePreviousCharacter(); //displays: How now brown cow. } } }
deletePreviousWord | () | metodo |
public function deletePreviousWord(operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Elimina la parola precedente.
Se viene selezionato un intervallo, viene eliminata la prima parola di tale intervallo.
Parametri
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
var textFlow:TextFlow = TextConverter.importToFlow( "How do now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer = new StandardFlowComposer(); textFlow.flowComposer.addController( new ContainerController( this )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.setSelection( 7, 7 ); editManager.deletePreviousWord(); //displays: How now brown cow.
deleteText | () | metodo |
public function deleteText(operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Elimina un intervallo di testo.
Parametri
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_deleteText { static public function deleteText():void { var textFlow:TextFlow = TextConverter.importToFlow( "How do now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( new Sprite() )); var editManager:EditManager = new EditManager(); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 4, 7 ); editManager.deleteText(); //displays: How now brown cow. } } }
doOperation | () | metodo |
override public function doOperation(operation:FlowOperation):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Esegue un'operazione FlowOperation.
Il metodo doOperation()
viene chiamato dalle funzioni IEditManager che aggiornano il flusso di testo. In genere, se non create operazioni personalizzate, non dovete chiamare questa funzione direttamente.
Questa funzione viene eseguita mediante la procedura seguente:
- Svuota tutte le operazioni in sospeso prima di eseguire questa operazione.
- Invia un evento flowOperationBegin annullabile. Se viene annullato, questo metodo viene restituito immediatamente.
- Esegue l'operazione. L'operazione restituisce
true
ofalse
.False
indica che non sono state apportate modifiche. - Inserisce l'operazione nello stack di annullamento.
- Cancella lo stack di ripetizione.
- Aggiorna la visualizzazione.
- Invia un evento flowOperationEnd annullabile.
Gestione delle eccezioni: se l'operazione genera un'eccezione, questa viene rilevata e l'errore associato all'evento flowOperationEnd. Se l'evento non è annullabile, l'errore viene generato di nuovo.
Parametri
operation:FlowOperation — Un oggetto FlowOperation
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.operations.InsertTextOperation; public class EditManager_doOperation { static public function doOperation(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager(); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); var selectionState:SelectionState = new SelectionState(textFlow, 4, 4); var insertOperation:InsertTextOperation = new InsertTextOperation( selectionState, "now " ); editManager.doOperation( insertOperation ); // displays: How now brown cow } } }
endCompositeOperation | () | metodo |
public function endCompositeOperation():void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Termina un gruppo di operazioni.
Tutte le operazioni eseguite dall'ultima chiamata a beginCompositeOperation()
vengono raggruppate come CompositeOperation, che viene quindi completato. Questo oggetto CompositeOperation viene aggiunto allo stack di annullamento oppure, se l'operazione composita viene nidificata all'interno di un'altra operazione composita, viene aggiunto all'operazione principale.
Esempio ( Come utilizzare questo esempio )
beginCompositeOperation()
e endCompositeOperation()
non venissero utilizzate, ciascuna delle operazioni secondarie dovrebbe essere annullata separatamente anziché come gruppo di operazioni.
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.elements.TextFlow; public class EditManager_beginCompositeOperation { static public function insertGraphic( source:Object, width:Object, height:Object, float:String, selection:SelectionState ):void { var editManager:IEditManager = selection.textFlow.interactionManager as IEditManager; editManager.beginCompositeOperation(); editManager.deleteText( selection ); var changedSelection:SelectionState = new SelectionState( selection.textFlow, selection.anchorPosition, selection.anchorPosition ); editManager.splitParagraph( changedSelection ); changedSelection = new SelectionState( changedSelection.textFlow, changedSelection.anchorPosition + 1, changedSelection.anchorPosition + 1); editManager.insertInlineGraphic( source, width, height, float, changedSelection ); changedSelection = new SelectionState( changedSelection.textFlow, changedSelection.anchorPosition + 1, changedSelection.anchorPosition + 1); editManager.splitParagraph( changedSelection ); editManager.endCompositeOperation(); } } }
insertInlineGraphic | () | metodo |
public function insertInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):InlineGraphicElement
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10 - + 10.2, AIR 1.5 |
Inserisce un'immagine.
L'origine dell'immagine può essere una stringa contenente un URI, un oggetto URLRequest, un oggetto Class che rappresenta una risorsa incorporata oppure un'istanza DisplayObject.
I valori di larghezza e altezza possono essere numeri, espressi in pixel, una percentuale o la stringa "auto", nel qual caso vengono utilizzate le dimensioni effettive dell'immagine.
Impostate float
su una delle costanti definite nella classe Float per specificare se l'immagine dovrà essere visualizzata a sinistra o a destra del testo o agganciata al testo.
Parametri
source:Object — Può essere una stringa che viene interpretata come un URI, un oggetto Class che viene interpretato come la classe di un Embed DisplayObject, un'istanza DisplayObject o un oggetto URLRequest.
| |
width:Object — La larghezza dell'immagine da inserire (numero, percentuale o "auto")
| |
height:Object — L'altezza dell'immagine da inserire (numero, percentuale o "auto")
| |
options:Object (default = null ) — Nessun elemento supportato.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
InlineGraphicElement |
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Shape; import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_insertInlineGraphic { static public function insertInlineGraphic(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 0, 0 ); editManager.insertInlineGraphic( createGraphic(), 6, 6, "none" ); } static private function createGraphic():Shape { var shape:Shape = new Shape(); shape.graphics.beginFill( 0x993366 ); shape.graphics.drawCircle( 5, 4, 6 ); return shape; } } }
insertText | () | metodo |
public function insertText(text:String, origOperationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Inserisce il testo.
Inserisce il testo in una posizione o in un intervallo nel testo. Se la posizione fornita nel parametro operationState
è un intervallo (o il parametro ènull
e la selezione corrente è un intervallo), il testo attualmente nell'intervallo viene sostituito dal testo inserito.
Parametri
text:String — La stringa da inserire.
| |
origOperationState:SelectionState (default = null ) — Specifica il testo nel flusso a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_insertText { static public function insertText(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 4, 4 ); editManager.insertText( "now " ); } } }
modifyInlineGraphic | () | metodo |
public function modifyInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Modifica un elemento grafico agganciato esistente.
Impostate le proprietà invariabili sui valori dell'elemento grafico originale. (La modifica di un oggetto grafico esistente risulta in genere più efficace rispetto all'eliminazione e alla creazione di un nuovo oggetto.)
Parametri
source:Object — Può essere una stringa che viene interpretata come un URI, un oggetto Class che viene interpretato come la classe di un Embed DisplayObject, un'istanza DisplayObject o un oggetto URLRequest.
| |
width:Object — La nuova larghezza dell'immagine (numero o percentuale).
| |
height:Object — La nuova altezza dell'immagine (numero o percentuale).
| |
options:Object (default = null ) — Nessun elemento supportato.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
width
e height
dell'elemento grafico in linea in modo da tirarlo e ottenere un'ellisse:
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flash.display.Shape; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_modifyInlineGraphic { static public function modifyInlineGraphic(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 0, 0 ); editManager.insertInlineGraphic( createGraphic(), 6, 6, "none" ); editManager.selectRange( 0, 1 ); editManager.modifyInlineGraphic( null, '12', '5', 'none' ); } static private function createGraphic():Shape { var shape:Shape = new Shape(); shape.graphics.beginFill( 0x993366 ); shape.graphics.drawCircle( 4, 4, 6 ); return shape; } } }
moveChildren | () | metodo |
public function moveChildren(source:FlowGroupElement, sourceIndex:int, numChildren:int, destination:FlowGroupElement, destinationIndex:int, selectionState:SelectionState = null):void
Sposta un set di FlowElement da un FlowGroupElement a un altro. Il destinationElement deve essere un tipo di elemento superiore valido per gli elementi inferiori da spostare, in caso contrario viene generata un'eccezione.
Parametri
source:FlowGroupElement — L'elemento superiore originale degli elementi da spostare.
| |
sourceIndex:int — L'indice inferiore all'interno dell'origine del primo elemento da spostare.
| |
numChildren:int — Il numero di elementi inferiori spostati.
| |
destination:FlowGroupElement — Il nuovo elemento superiore degli elementi dopo lo spostamento.
| |
destinationIndex:int — L'indice inferiore all'interno della destinazione dello spostamento degli elementi.
| |
selectionState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione e al quale ritorna la selezione in caso di annullamento. Se è null , l'operazione si applica alla selezione corrente. Se non vi è una selezione corrente, questo parametro deve essere diverso da null.
|
overwriteText | () | metodo |
public function overwriteText(text:String, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Sovrascrive il testo selezionato.
Nel caso di selezione di un punto, il primo carattere viene sovrascritto dal nuovo testo.
Parametri
text:String — La stringa da inserire.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_overwriteText { static public function overwriteText(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How zzz brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 4, 6 ); editManager.overwriteText( "now" ); //Displays: How now brown cow. } } }
pasteTextScrap | () | metodo |
public function pasteTextScrap(scrapToPaste:flashx.textLayout.edit:TextScrap, operationState:SelectionState = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Incolla l'oggetto TextScrap nell'area selezionata.
Se viene specificato un intervallo di testo, viene eliminato il testo nell'intervallo.
Parametri
scrapToPaste:flashx.textLayout.edit:TextScrap — L'oggetto TextScrap da incollare.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.edit.TextScrap; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_pasteTextScrap { static public function pasteText(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How brown cow now.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 13, 17 ); var scrap:TextScrap = editManager.cutTextScrap(); editManager.selectRange( 3, 3 ); editManager.pasteTextScrap( scrap ); //Displays: How now brown cow. } } }
redo | () | metodo |
public function redo():void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Esegue di nuovo la precedente operazione annullata.
Nota: se l'oggetto IUndoManager associato a questo IEditManager è associato anche a un altro oggetto IEditManager, è possibile che venga utilizzata l'operazione di ripetizione associata all'altro oggetto IEditManager. Ciò è possibile se l'oggetto FlowOperation di un altro IEditManager e in cima allo stack di ripetizione.
Questa funzione non esegue alcuna operazione se non si attiva l'annullamento.
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.edit.IEditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_redo { static public function redo( textFlow:TextFlow ):void { if( textFlow.interactionManager is IEditManager ) { IEditManager( textFlow.interactionManager ).redo(); } } } }
splitElement | () | metodo |
public function splitElement(target:FlowGroupElement, operationState:SelectionState = null):FlowGroupElement
Divide l'elemento di destinazione nella posizione specificata, creando un nuovo elemento dopo quello corrente. Se operationState è un intervallo, il testo all'interno dell'intervallo viene eliminato. Il nuovo elemento viene creato dopo la posizione di testo specificata da operationState. Tenete presente che la divisione di un SubParagraphGroupElement non ha effetto perché verrà ricreato automaticamente con gli elementi adiacenti.
Può essere utilizzato, ad esempio, quando si vuole dividere un elenco in due elenchi separati.
Parametri
target:FlowGroupElement — L'elemento da dividere.
| |
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
FlowGroupElement — Il nuovo paragrafo che è stato creato.
|
splitParagraph | () | metodo |
public function splitParagraph(operationState:SelectionState = null):ParagraphElement
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Divide il paragrafo nella posizione specificata, creando un nuovo paragrafo dopo quello corrente.
Se viene specificato un intervallo di testo, viene eliminato il testo nell'intervallo.
Parametri
operationState:SelectionState (default = null ) — Specifica il testo a cui si applica questa operazione; se null , l'operazione si applica alla selezione corrente.
|
ParagraphElement — Il nuovo paragrafo che è stato creato.
|
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.EditManager; import flashx.textLayout.edit.TextScrap; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_splitParagraph { static public function splitParagraph(sprite:Sprite):void { var textFlow:TextFlow = TextConverter.importToFlow( "How now brown cow.", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.flowComposer.addController( new ContainerController( sprite )); var editManager:EditManager = new EditManager( new UndoManager() ); textFlow.interactionManager = editManager; textFlow.flowComposer.updateAllControllers(); editManager.selectRange( 8, 8 ); editManager.splitParagraph(); //Displays: How now // brown cow. } } }
undo | () | metodo |
public function undo():void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Annulla l'operazione precedente.
Nota: se l'oggetto IUndoManager associato a questo IEditManager è associato anche a un altro oggetto IEditManager, è possibile che venga utilizzata l'operazione di annullamento associata all'altro oggetto IEditManager. Ciò è possibile se l'oggetto FlowOperation di un altro IEditManager è in cima allo stack di annullamento.
Questa funzione non esegue alcuna operazione se non si attiva l'annullamento.
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
package flashx.textLayout.edit.examples { import flashx.textLayout.edit.IEditManager; import flashx.textLayout.elements.TextFlow; public class EditManager_undo { static public function undo( textFlow:TextFlow ):void { if( textFlow.interactionManager is IEditManager ) { IEditManager( textFlow.interactionManager ).undo(); } } } }
updateAllControllers | () | metodo |
public function updateAllControllers():void
- Crea un TextFlow (
tf
) per contenere una riga di testo di esempio. - Memorizza il testo in uno SpanElement che a sua volta è memorizzato in un ParagraphElement.
- Crea un ContainerController per il testo e compone il testo per la visualizzazione.
- Crea le istanze degli oggetti del gestore TextFlow per utilizzarli successivamente in un listener di eventi.
- Crea un semplice pulsante di modifica che consente all'utente di rendere il testo modificabile.
- Crea il listener di eventi del pulsante che commuta tra gli stati "sola lettura" e "modificabile".
Il valore della proprietà interactionManager
del TextFlow determina se il testo di esempio è modificabile. Se la proprietà è null
, il testo di esempio è di sola lettura. Se alla proprietà è assegnata un'istanza EditManager, il testo di esempio è modificabile. Il metodo createEditButton() crea un'istanza TextField molto semplice che ha l'aspetto di un pulsante. Quando un utente fa clic sull'istanza TextField, la funzione del listener updateEditable()
commuta il valore della proprietà interactionManager
.
package flashx.textLayout.edit.examples { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flashx.textLayout.container.ContainerController; import flashx.textLayout.edit.EditManager; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.TextFlow; import flashx.undo.UndoManager; public class EditManager_example extends Sprite { private var tf:TextFlow; private var em:EditManager; private var um:UndoManager; private var editable:TextField; public function EditManager_example() { //define TextFlow tf = new TextFlow(); //define elements to contain text var p:ParagraphElement = new ParagraphElement(); var s:SpanElement = new SpanElement(); s.text ="This is sample text for the EditManager example."; //add these elements to the TextFlow p.addChild(s); tf.addChild(p); //compose TextFlow to display var tfController:ContainerController = new ContainerController(this,600,600); tfController.container.y = 10 tf.flowComposer.addController(tfController); tf.flowComposer.updateAllControllers(); //define TextFlow manager objects um = new UndoManager(); em = new EditManager(um); tf.interactionManager = null; createEditButton(); } private function createEditButton ():void { editable = new TextField(); editable.appendText("Click to make the sample text editable"); editable.x = 0; editable.y = 50; editable.width = 150; editable.autoSize = flash.text.TextFieldAutoSize.LEFT; editable.selectable = false; editable.background = true; editable.backgroundColor = 0xAAAAAA; addChild(editable); editable.addEventListener(MouseEvent.CLICK, updateEditable); } private function updateEditable(me:MouseEvent):void{ if (editable.text.indexOf("read only") >= 0) { editable.text = "Click to make the sample text editable"; tf.interactionManager = null; } else { editable.text = "Click to make the sample text read only"; tf.interactionManager = em; } } } }
Tue Jun 12 2018, 02:44 PM Z