Package | flashx.textLayout.edit |
Classe | public class EditManager |
Héritage | EditManager SelectionManager Object |
Implémente | IEditManager |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Pour activer la modification de l’enchaînement de texte, affectez un objet EditManager à la propriété interactionManager
de l’objet TextFlow. Le gestionnaire de modification gère les modifications apportées au texte (telles que les insertions, suppressions et les modifications de format). Les modifications sont réversibles si le gestionnaire de modification possède un gestionnaire d’annulation. Le gestionnaire de modification déclenche la recomposition et l’affichage de l’enchaînement de texte, si nécessaire.
La classe EditManager prend en charge les raccourcis clavier suivants :
Touches | Résultat |
---|---|
ctrl-z | annuler |
ctrl-y | rétablir |
ctrl-retour arrière | deletePreviousWord |
ctrl-supprimer | deleteNextWord |
alt+supprimer | deleteNextWord |
ctrl+alt-supprimer | deleteNextWord |
ctrl-maj-tiret | insérer un tiret conditionnel |
ctrl +retour arrière | deletePreviousWord |
alt+retour arrière | deletePreviousWord |
ctrl+alt-retour arrière | deletePreviousWord |
INSERER | active/désactive overWriteMode |
retour arrière | deletePreviousCharacter |
ENTREE | Si textFlow.configuration.manageEnterKey dans une liste à laquelle il crée un nouvel élément de liste, dans le cas contraire crée un nouveau paragraphe |
Tout en maintenant la touche Maj enfoncée, ENTREZ | Si textFlow.configuration.manageEnterKey crée un nouveau paragraphe |
TABULATION | Si textFlow.configuration.manageTabKey, dans une liste à laquelle il crée liste imbriquée, dans le cas contraire insère une tabulation ou écrase caractère suivant avec une tabulation |
Maj+TAB | Si textFlow.configuration.manageTabKey, dans le premier élément d'une liste à laquelle il déplace l'élément hors de la liste (assure la promotion) |
Remarque : les touches suivantes ne sont pas compatibles avec Windows : alt-retour arrière, alt-supprimer, ctrl+alt-retour arrière et ctrl+alt-supprimer. Ces touches ne génèrent pas d’événement pour l’exécution.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
absoluteEnd : int [lecture seule]
La position du texte de la fin de la sélection, sous la forme d’un décalage à partir du début de l’enchaînement de texte. | SelectionManager | ||
absoluteStart : int [lecture seule]
La position du texte du début de la sélection, sous la forme d’un décalage à partir du début de l’enchaînement de texte. | SelectionManager | ||
activePosition : int [lecture seule]
Le point actif de la sélection. | SelectionManager | ||
allowDelayedOperations : Boolean | EditManager | ||
anchorPosition : int [lecture seule]
Le point d’ancrage de la sélection. | SelectionManager | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
currentSelectionFormat : SelectionFormat [lecture seule]
L’objet SelectionFormat en cours. | SelectionManager | ||
delayUpdates : Boolean | EditManager | ||
editingMode : String [lecture seule]
Le mode de modification. | SelectionManager | ||
focused : Boolean [lecture seule]
Indique si un conteneur dans l’enchaînement de texte a le focus. | SelectionManager | ||
focusedSelectionFormat : SelectionFormat
L’objet SelectionFormat utilisé pour tracer la sélection dans un conteneur concentré. | SelectionManager | ||
inactiveSelectionFormat : SelectionFormat
L’objet SelectionFormat utilisé pour tracer la sélection si elle n’est pas dans la fenêtre active. | SelectionManager | ||
overwriteMode : Boolean = false [statique]
Indique si le mode overwrite est activé ou désactivé. | EditManager | ||
textFlow : flashx.textLayout.elements:TextFlow
L’objet TextFlow géré par ce gestionnaire de sélection. | SelectionManager | ||
undoManager : IUndoManager [lecture seule]
L’interface IUndoManager affectée à ce gestionnaire de modification. | EditManager | ||
unfocusedSelectionFormat : SelectionFormat
L’objet SelectionFormat utilisé pour tracer la sélection si elle n’est pas dans un conteneur concentré mais dans la fenêtre active. | SelectionManager | ||
windowActive : Boolean [lecture seule]
Indique si la fenêtre associée à l’enchaînement de texte est active. | SelectionManager |
Méthode | Défini par | ||
---|---|---|---|
EditManager(undoManager:IUndoManager = null)
Crée un objet EditManager. | EditManager | ||
Traite un événement Activer. | SelectionManager | ||
applyContainerFormat(containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Applique les styles de conteneur aux conteneurs de la sélection. | EditManager | ||
applyFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Change les formats de la sélection spécifiée (ou en cours). | EditManager | ||
applyFormatToElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Applique les styles à l’élément spécifié. | EditManager | ||
applyLeafFormat(characterFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Modifie le format appliqué aux éléments de nœud terminal de la sélection spécifiée (ou en cours). | EditManager | ||
applyLink(href:String, targetString:String = null, extendToLinkBoundary:Boolean = false, operationState:SelectionState = null):LinkElement
Transforme une sélection en lien ou un lien en texte normal. | EditManager | ||
applyParagraphFormat(paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Les styles de paragraphe s’appliquent à tous les paragraphes de la sélection. | EditManager | ||
Transforme le texte en une séquence TCY ou une séquence TCY en texte non TCY. | EditManager | ||
Lance un nouveau groupe d’opérations. | EditManager | ||
changeElementID(newID:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Change l’ID d’un élément. | EditManager | ||
changeStyleName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void Déconseillé depuis 2.0: Veuillez utiliser applyFormatToElement
Modifie le nom du styleName d’un élément ou d’une partie de l’élément. | EditManager | ||
changeTypeName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Modifie la propriété typeName d’un élément ou d’une partie d’un élément. | EditManager | ||
clearFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Annule la définition des formats de la sélection spécifiée (ou en cours). | EditManager | ||
clearFormatOnElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Annule la définition des styles appliqués à l’élément spécifié. | EditManager | ||
createDiv(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):DivElement Crée un nouvel objet DivElement qui contient la plage complète spécifiée dans la propriété operationState au niveau de l’élément parent commun le plus bas qui contient à la fois les points de début et de fin de la plage. | EditManager | ||
createList(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):ListElement Crée un nouvel objet ListElement qui contient la plage complète spécifiée dans la propriété operationState au niveau de l’élément parent commun le plus bas qui contient à la fois les points de début et de fin de la plage. | EditManager | ||
createSubParagraphGroup(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):SubParagraphGroupElement Crée un nouvel objet SubParagraphGroupElement qui contient la plage complète spécifiée dans la propriété operationState au niveau de l’élément parent commun le plus bas qui contient à la fois les points de début et de fin de la plage. | EditManager | ||
Supprime la zone sélectionnée et renvoie la zone supprimée d’un objet TextScrap. | EditManager | ||
Traite un événement Désactiver. | SelectionManager | ||
Supprime une plage de texte ou, si une sélection de point est donnée, supprime le caractère suivant. | EditManager | ||
Supprime le mot suivant. | EditManager | ||
Supprime une plage de texte ou, si une sélection de point est donnée, supprime le caractère précédent. | EditManager | ||
Supprime le mot précédent. | EditManager | ||
Supprime une plage de texte. | EditManager | ||
[override]
Exécute une classe FlowOperation. | EditManager | ||
Traite un événement Modifier. | SelectionManager | ||
Termine un groupe d’opérations. | EditManager | ||
SelectionManager | |||
Traite un événement focusChange. | SelectionManager | ||
Traite un événement focusIn. | SelectionManager | ||
Traite un événement focusOut. | SelectionManager | ||
getCommonCharacterFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Récupère les attributs de format de caractère qui sont communs à tous les caractères de la plage de texte spécifiée ou de la sélection actuelle. | SelectionManager | ||
getCommonContainerFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Récupère les attributs de format de conteneur qui sont communs à tous les conteneurs de la plage de texte spécifiée ou de la sélection actuelle. | SelectionManager | ||
getCommonParagraphFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Récupère les attributs de format de paragraphe qui sont communs à tous les paragraphes de la plage de texte spécifiée ou de la sélection actuelle. | SelectionManager | ||
Récupère l’objet SelectionState de la sélection actuelle. | SelectionManager | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique s’il existe une sélection. | SelectionManager | ||
Traite un événement imeStartComposition
| SelectionManager | ||
insertInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):InlineGraphicElement
Insère une image. | EditManager | ||
Insère le texte. | EditManager | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Indique si la sélection couvre une plage de texte. | SelectionManager | ||
Traite un événement keyDown. | SelectionManager | ||
Traite un événement keyFocusChange. | SelectionManager | ||
Traite un événement keyUp. | SelectionManager | ||
Traite un événement menuSelect. | SelectionManager | ||
modifyInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):void
Modifie une image en ligne existante. | EditManager | ||
Traite un événement mouseDoubleClick. | SelectionManager | ||
Traite un événement mouseDown. | SelectionManager | ||
Traite un événement mouseMove. | SelectionManager | ||
Traite un événement mouseOut. | SelectionManager | ||
Traite un événement mouseOver. | SelectionManager | ||
Traite un événement mouseUp. | SelectionManager | ||
Traite un événement mouseWheel. | SelectionManager | ||
moveChildren(source:FlowGroupElement, sourceIndex:int, numChildren:int, destination:FlowGroupElement, destinationIndex:int, selectionState:SelectionState = null):void Déplacez un ensemble d’objets FlowElement d’un objet FlowGroupElement vers un autre. | EditManager | ||
Met à jour le gestionnaire de sélection lorsque du texte est inséré ou supprimé. | SelectionManager | ||
Remplace le texte sélectionné. | EditManager | ||
pasteTextScrap(scrapToPaste:flashx.textLayout.edit:TextScrap, operationState:SelectionState = null):void
Colle l’objet TextScrap dans la zone sélectionnée. | EditManager | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Effectue à nouveau l’opération annulée précédemment. | EditManager | ||
Affiche à nouveau les formes de sélection. | SelectionManager | ||
SelectionManager | |||
SelectionManager | |||
Donne le focus sur le premier conteneur de la sélection. | SelectionManager | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Définit l’objet SelectionState de la sélection actuelle. | SelectionManager | ||
Traite un événement softKeyboardActivating.
| SelectionManager | ||
Divise l’élément cible à l’emplacement spécifié, créant un nouvel élément après l’élément existant. | EditManager | ||
Divise le paragraphe à la position actuelle, créant un nouveau paragraphe après le paragraphe existant. | EditManager | ||
Traite un événement TextEvent. | SelectionManager | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Inverse la dernière opération. | EditManager | ||
EditManager | |||
Renvoie la valeur primitive de l’objet spécifié. | Object |
allowDelayedOperations | propriété |
delayUpdates | propriété |
overwriteMode | propriété |
public static var overwriteMode:Boolean = false
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indique si le mode overwrite est activé ou désactivé.
Si la valeur est true
, une séquence de touches remplace le caractère qui suit le curseur. Si la valeur est false
, une séquence de touches est insérée à l’emplacement du curseur.
undoManager | propriété |
undoManager:IUndoManager
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
L’interface IUndoManager affectée à ce gestionnaire de modification.
Pour activer les modifications à annuler et à rétablir, transmettez une occurrence IUndoManager au constructeur de l’objet EditManager. Le gestionnaire d’annulation conserve une pile d’opérations qui ont été exécutées, et peut annuler ou refaire une opération.
Remarque : si l’objet TextFlow est modifié directement (pas via les appels ver l’objet EditManager, mais directement via les appels vers les objets FlowElement), l’objet EditManager supprime la pile d’annulation pour empêcher la pile d’être désynchronisée de l’état actuel.
Implémentation
public function get undoManager():IUndoManager
EditManager | () | Constructeur |
public function EditManager(undoManager:IUndoManager = null)
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Crée un objet EditManager.
Affectez un objet EditManager à la propriété interactionManager
d’un enchaînement pour activer la modification de cet enchaînement.
Pour activer la prise en charge des modifications d’annulation et de rétablissement, transmettez une occurrence de IUndoManager au constructeur EditManager. Vous pouvez utiliser la classe flashx.undo.UndoManager
ou créer une occurrence de IUndoManager. Utilisez une occurrence de IUndoManager personnalisée pour intégrer les modifications de Text Layout Framework à un gestionnaire d’annulation existant qui n’est pas une occurrence de la classe UndoManager. Pour créer une occurrence de IUndoManager personnalisée, assurez-vous que la classe que vous utilisez pour définir le gestionnaire d’annulation implémente l’interface IUndoManager.
undoManager:IUndoManager (default = null ) — L’objet UndoManager pour l’application
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function applyContainerFormat(containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Applique les styles de conteneur aux conteneurs de la sélection.
Les propriétés de style dans l’objet de format qui sont null
demeurent inchangées.
Paramètres
containerFormat:flashx.textLayout.formats:ITextLayoutFormat — Format à appliquer aux conteneurs dans la plage
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function applyFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Change les formats de la sélection spécifiée (ou en cours).
Exécute une opération infaisable qui sera appliquée aux nouveaux formats. Seuls les attributs de style définis pour les objets TextLayoutFormat sont appliqués. Les attributs non définis dans les objets de format ne seront pas modifiés.
Paramètres
leafFormat:flashx.textLayout.formats:ITextLayoutFormat — Format à appliquer aux éléments de nœud terminal, tels que les plages et graphiques intégrés.
| |
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat — Format à appliquer à des éléments paragraphe.
| |
containerFormat:flashx.textLayout.formats:ITextLayoutFormat — Format à appliquer aux conteneurs.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function applyFormatToElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Applique les styles à l’élément spécifié.
Les propriétés de style dans l’objet de format qui sont null
demeurent inchangées. Seuls les styles exclusivement spécifiques à l’élément spécifié sont appliqués.
Paramètres
targetElement:FlowElement — Elément auquel les styles sont appliqués.
| |
format:flashx.textLayout.formats:ITextLayoutFormat — Format contenant les styles à appliquer.
| |
relativeStart:int (default = 0 ) — Décalage à partir du début de l’élément à utiliser pour diviser l’élément lors de l’affectation du nouveau formatage.
| |
relativeEnd:int (default = -1 ) — Décalage à partir du début de l’élément à utiliser pour diviser l’élément lors de l’application du nouveau formatage
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
applyLeafFormat | () | méthode |
public function applyLeafFormat(characterFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Modifie le format appliqué aux éléments de nœud terminal de la sélection spécifiée (ou en cours).
Exécute une opération infaisable qui appliquera le nouveau format aux éléments de nœud terminal, tels que les objets SpanElement et InlineGraphicElement. Seuls les attributs de style définis pour les objets TextLayoutFormat sont appliqués. Les attributs non définis dans les objets de format seront modifiés.
Paramètres
characterFormat:flashx.textLayout.formats:ITextLayoutFormat — Format à appliquer.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function applyLink(href:String, targetString:String = null, extendToLinkBoundary:Boolean = false, operationState:SelectionState = null):LinkElement
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10 - + 10.2, AIR 1.5 |
Transforme une sélection en lien ou un lien en texte normal.
Exécute une opération infaisable qui crée ou supprime le lien.
Si un paramètre target
est spécifié, il doit avoir l’une des valeurs suivantes :
- "_self"
- "_blank"
- "_parent"
- "_top"
Dans les moteurs d’exécution hébergés par navigateur, une cible de « _self » remplace la page html actuelle. Ainsi, si le contenu SWF contenant le lien figure dans une page d’un cadre ou d’un jeu de cadres, le contenu lié sera chargé dans ce cadre. Si la page est au niveau supérieur, le contenu lié s’ouvre pour remplacer la page d’origine. Une cible de « _blank » ouvre une nouvelle fenêtre de navigateur sans nom. Une cible de « _parent » remplace le parent de la page HTML contenant le contenu SWF. Une cible de « _top » remplace la page de plus haut niveau dans la fenêtre du navigateur ouverte.
Dans les autres moteurs d’exécution, tels que Adobe AIR, le lien est ouvert dans le navigateur par défaut de l’utilisateur et le paramètre target
est ignoré.
Le paramètre extendToLinkBoundary
détermine la façon dont le gestionnaire de modification traite une sélection qui croise un ou plusieurs liens existants. Si le paramètre est true
, l’opération est appliquée comme une unité à la sélection et à tout le texte des liens existants. Ainsi, un lien est créé qui s’étend du début du premier lien croisé à la fin du dernier lien croisé. En revanche, si le paramètre extendToLinkBoundary
est false
, dans ce cas, les liens sélectionnés partiellement existants seraient divisés en deux liens.
Paramètres
href:String — L’uri référencé par le lien.
| |
targetString:String (default = null ) — La fenêtre du navigateur cible du lien.
| |
extendToLinkBoundary:Boolean (default = false ) — Spécifie s’il faut consolider la sélection à l’aide de l’un des liens existants superposés avant d’appliquer la modification.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
LinkElement — LinkElement ayant été créé.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function applyParagraphFormat(paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Les styles de paragraphe s’appliquent à tous les paragraphes de la sélection.
Les propriétés de style dans l’objet de format qui sont null
demeurent inchangées.
Paramètres
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat — Format à appliquer aux paragraphes sélectionnés.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function applyTCY(tcyOn:Boolean, operationState:SelectionState = null):flashx.textLayout.elements:TCYElement
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10 - + 10.2, AIR 1.5 |
Transforme le texte en une séquence TCY ou une séquence TCY en texte non TCY.
TCY ou tate-chu-yoko provoque le traçage horizontal du texte au sein d’une ligne verticale, et est utilisée pour rendre des petits blocs de texte non japonais ou des chiffres, comme la date, plus lisibles dans un texte vertical.
Paramètres
tcyOn:Boolean — Sélectionnez true pour appliquer TCY à une plage de texte, false pour supprimer TCY.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
flashx.textLayout.elements:TCYElement — TCYElement ayant été créé.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function beginCompositeOperation():void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Lance un nouveau groupe d’opérations.
Toutes les opérations exécutées après l’appel vers l’opération beginCompositeOperation()
, et avant l’appel de correspondance vers l’opération endCompositeOperation()
doivent être exécutées et sont regroupées sous la forme d’une opération unique qui peut être annulée en tant qu’unité.
Un bloc beginCompositeOperation
/endCompositeOperation
peut être imbriqué dans un autre bloc beginCompositeOperation
/endCompositeOperation
.
Exemple ( Comment utiliser cet exemple )
beginCompositeOperation()
et endCompositeOperation()
ne sont pas utilisées, chacune des sous-opérations doit être annulée séparément, plutôt qu’en tant que groupe.
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 | () | méthode |
public function changeElementID(newID:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Change l’ID d’un élément.
Si les paramètres relativeStart
ou relativeEnd
sont définis (sur toute autre valeur que les valeurs par défaut), l’élément est divisé. Les parties de l’élément en dehors de cette plage conservent l’ID original. La définition des paramètres relativeStart
et relativeEnd
crée des éléments avec des ID en double.
Paramètres
newID:String — Nouvelle valeur d’ID.
| |
targetElement:FlowElement — Elément à modifier.
| |
relativeStart:int (default = 0 ) — Décalage à partir du début de l’élément à utiliser pour diviser l’élément lors de l’affectation du nouvel ID.
| |
relativeEnd:int (default = -1 ) — Décalage à partir du début de l’élément à utiliser pour diviser l’élément lors de l’affectation du nouvel ID.
| |
operationState:SelectionState (default = null ) — Spécifie la sélection à restaurer lors de l’annulation de cette opération ; si la valeur est null , l’opération enregistre la sélection en cours.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function changeStyleName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Modifie le nom du styleName d’un élément ou d’une partie de l’élément.
Si les paramètres relativeStart
ou relativeEnd
sont définis (sur toute autre valeur que les valeurs par défaut), l’élément est divisé. Les parties de l’élément en dehors de cette plage conserve le style original.
Paramètres
newName:String — Nom du nouveau style.
| |
targetElement:FlowElement — Spécifie l’élément à modifier.
| |
relativeStart:int (default = 0 ) — Décalage à partir du début de l’élément à utiliser pour diviser l’élément lors de l’affectation du nouveau style.
| |
relativeEnd:int (default = -1 ) — Décalage à partir de la fin de l’élément à utiliser pour diviser l’élément lors de l’affectation du nouveau style.
| |
operationState:SelectionState (default = null ) — Spécifie la sélection à restaurer lors de l’annulation de cette opération ; si la valeur est null , l’opération enregistre la sélection en cours.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function changeTypeName(newName:String, targetElement:FlowElement, relativeStart:int = 0, relativeEnd:int = -1, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Modifie la propriété typeName d’un élément ou d’une partie d’un élément.
Si les paramètres relativeStart
ou relativeEnd
sont définis (sur toute autre valeur que les valeurs par défaut), l’élément est divisé. Les parties de l’élément en dehors de cette plage conserve le style original.
Paramètres
newName:String — Nom du nouveau type.
| |
targetElement:FlowElement — Spécifie l’élément à modifier.
| |
relativeStart:int (default = 0 ) — Décalage à partir du début de l’élément à utiliser pour diviser l’élément lors de l’affectation du nouveau style.
| |
relativeEnd:int (default = -1 ) — Décalage à partir de la fin de l’élément à utiliser pour diviser l’élément lors de l’affectation du nouveau style.
| |
operationState:SelectionState (default = null ) — Spécifie la sélection à restaurer lors de l’annulation de cette opération ; si la valeur est null , l’opération enregistre la sélection en cours.
|
clearFormat | () | méthode |
public function clearFormat(leafFormat:flashx.textLayout.formats:ITextLayoutFormat, paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat, containerFormat:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Annule la définition des formats de la sélection spécifiée (ou en cours).
Exécute une opération annulable qui annule la définition des formats spécifiés. Seuls les attributs de style définis pour les objets TextLayoutFormat sont appliqués. Les attributs non définis dans les objets de format ne seront pas modifiés.
Paramètres
leafFormat:flashx.textLayout.formats:ITextLayoutFormat — Format dont les valeurs spécifiées indiquent les propriétés dont il faut annuler la définition sur les objets LeafFlowElement de la plage sélectionnée.
| |
paragraphFormat:flashx.textLayout.formats:ITextLayoutFormat — Format dont les valeurs spécifiées indiquent les propriétés dont il faut annuler la définition sur les objets ParagraphElement de la plage sélectionnée.
| |
containerFormat:flashx.textLayout.formats:ITextLayoutFormat — Format dont les valeurs spécifiées indiquent les propriétés dont il faut annuler la définition sur les objets ContainerController de la plage sélectionnée.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
clearFormatOnElement | () | méthode |
public function clearFormatOnElement(targetElement:FlowElement, format:flashx.textLayout.formats:ITextLayoutFormat, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Annule la définition des styles appliqués à l’élément spécifié.
Toutes les propriétés de style non définies
dans l’objet de format demeurent inchangées. Il est nécessaire d’annuler la définition des styles définis dans le format indiqué sur l’élément spécifié.
Paramètres
targetElement:FlowElement — Elément auquel les styles sont appliqués.
| |
format:flashx.textLayout.formats:ITextLayoutFormat — Format contenant les styles dont il faut annuler la définition.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
createDiv | () | méthode |
public function createDiv(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):DivElement
Crée un nouvel objet DivElement qui contient la plage complète spécifiée dans la propriété operationState au niveau de l’élément parent commun le plus bas qui contient à la fois les points de début et de fin de la plage. Si les points de début et de fin sont les mêmes, un nouvel objet DivElement est créé à cette position avec un seul paragraphe enfant.
Paramètres
parent:FlowGroupElement (default = null ) — Spécifie un élément parent pour le nouvel élément DivElement. Si la valeur null est définie, le nouveau parent sera le niveau le plus bas contenant l’objet SelectionState.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Attributs de formatage à appliquer au nouvel élément DivElement.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
DivElement — Le nouvel objet DivElement qui a été créé.
|
createList | () | méthode |
public function createList(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):ListElement
Crée un nouvel objet ListElement qui contient la plage complète spécifiée dans la propriété operationState au niveau de l’élément parent commun le plus bas qui contient à la fois les points de début et de fin de la plage. Chaque paragraphe au sein de la plage deviendra un objet ListItemElement dans le nouvel objet ListElement. Si les points de début et de fin sont les mêmes, un nouvel objet ListElement est créé à cette position avec un seul enfant ListItemElement.
Paramètres
parent:FlowGroupElement (default = null ) — Indique éventuellement un élément parent pour le nouveau ListElement. Si la valeur null est définie, le nouveau parent sera le niveau le plus bas contenant l’objet SelectionState.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Attributs de formatage à appliquer au nouvel élément ListElement.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
ListElement — Le nouvel objet ListElement qui a été créé.
|
createSubParagraphGroup | () | méthode |
public function createSubParagraphGroup(parent:FlowGroupElement = null, format:flashx.textLayout.formats:ITextLayoutFormat = null, operationState:SelectionState = null):SubParagraphGroupElement
Crée un nouvel objet SubParagraphGroupElement qui contient la plage complète spécifiée dans la propriété operationState au niveau de l’élément parent commun le plus bas qui contient à la fois les points de début et de fin de la plage. Si les points de début et de fin sont les mêmes, rien n’est effectué.
Paramètres
parent:FlowGroupElement (default = null ) — Indique un élément parent pour le nouvel élément SubParagraphGroupElement. Si la valeur null est définie, le nouveau parent sera le niveau le plus bas contenant l’objet SelectionState.
| |
format:flashx.textLayout.formats:ITextLayoutFormat (default = null ) — Attributs de formatage à appliquer au nouvel élément SubParagraphGroupElement.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
SubParagraphGroupElement — Le nouvel objet SubParagraphGroupElement qui a été créé.
|
cutTextScrap | () | méthode |
public function cutTextScrap(operationState:SelectionState = null):flashx.textLayout.edit:TextScrap
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Supprime la zone sélectionnée et renvoie la zone supprimée d’un objet TextScrap.
L’objet TextScrap résultant peut être publié sur le presse-papiers du système ou utilisé dans une nouvelle opération pasteTextOperation()
.
Paramètres
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
flashx.textLayout.edit:TextScrap — L’objet TextScrap qui a été coupé.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function deleteNextCharacter(operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Supprime une plage de texte ou, si une sélection de point est donnée, supprime le caractère suivant.
Paramètres
operationState:SelectionState (default = null ) — spécifie le texte auquel cette opération s’applique ; si la valeur est null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function deleteNextWord(operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Supprime le mot suivant.
Si une plage est sélectionnée, le premier mot de la plage est supprimé.
Paramètres
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function deletePreviousCharacter(operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Supprime une plage de texte ou, si une sélection de point est donnée, supprime le caractère précédent.
Paramètres
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function deletePreviousWord(operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Supprime le mot précédent.
Si une plage est sélectionnée, le premier mot de la plage est supprimé.
Paramètres
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function deleteText(operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Supprime une plage de texte.
Paramètres
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
override public function doOperation(operation:FlowOperation):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Exécute une classe FlowOperation.
La méthode doOperation()
est appelée par les fonctions IEditManager qui mettent à jour l’enchaînement de texte. En règle générale, il n’est pas nécessaire d’appeler cette fonction directement à moins de créer vos propres opérations personnalisées.
Cette fonction se poursuit dans les étapes suivantes :
- Purger toutes les opérations en cours avant d’effectuer cette opération.
- Envoyer un événement flowOperationBegin annulable. Si annulée, cette méthode est immédiatement renvoyée.
- Exécuter l’opération. L’opération renvoie
true
oufalse
.False
indique qu’aucune modification n’a été effectuée. - Pousser l’opération sur la pile annuler.
- Effacer la pile rétablir.
- Mettre à jour l’affichage.
- Envoie un événement flowOperationEnd annulable.
Gestion des exceptions : si l’opération renvoie une exception, elle est émise et l’erreur est associée à l’événement flowOperationEvent. Si l’événement n’est pas annulé l’erreur est rejetée.
Paramètres
operation:FlowOperation — un objet FlowOperation
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function endCompositeOperation():void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Termine un groupe d’opérations.
Toutes les opérations exécutées depuis le dernier appel vers l’opération beginCompositeOperation()
sont regroupées sous la forme d’une opération CompositeOperation qui est ensuite terminée. Cet objet CompositeOperation est ajouté à la pile annuler ou, si cette opération composite est imbriquée dans une autre opération composite, ajoutée à l’opération parent.
Exemple ( Comment utiliser cet exemple )
beginCompositeOperation()
et endCompositeOperation()
ne sont pas utilisées, chacune des sous-opérations doit être annulée séparément, plutôt qu’en tant que groupe.
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 | () | méthode |
public function insertInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):InlineGraphicElement
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10 - + 10.2, AIR 1.5 |
Insère une image.
La source de l’image peut être une chaîne contenant un objet URI, URLRequest, un objet de classe représentant un actif incorporé, ou une occurrence d’objet DisplayObject.
Les valeurs de largeur et de hauteur peuvent être le nombre de pixels, un pourcentage ou la chaîne « auto », auquel cas les dimensions réelles du graphique sont utilisées.
Définissez le float
vers l’une des constantes définies dans la classe float afin de spécifier si l’image doit être affichée à gauche ou à droite du texte ou en ligne avec le texte.
Paramètres
source:Object — Peut être un objet String interprété comme un uri, une Classe interprétée comme la classe d’un objet DisplayObject imbriqué, une occurrence de DisplayObject ou un objet URLRequest.
| |
width:Object — Largeur de l’image à insérer (nombre, pourcentage ou "auto").
| |
height:Object — Hauteur de l’image à insérer (nombre, pourcentage, ou "auto").
| |
options:Object (default = null ) — Aucune prise en charge.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
InlineGraphicElement |
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function insertText(text:String, origOperationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Insère le texte.
Insère le texte à une position ou une plage dans le texte. Si l’emplacement fourni dans le paramètre operationState
est une plage (ou que le paramètre est null
et que la sélection actuelle est une plage), le texte en cours d’affichage dans la plage est remplacé par le texte inséré.
Paramètres
text:String — Chaîne à insérer.
| |
origOperationState:SelectionState (default = null ) — spécifie le texte dans l’enchaînement auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function modifyInlineGraphic(source:Object, width:Object, height:Object, options:Object = null, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Modifie une image en ligne existante.
Définissez les propriétés inchangées aux valeurs de l’image d’origine (modifier un objet graphique existant est généralement plus efficace que le supprimer et le reconstituer).
Paramètres
source:Object — Peut être un objet String interprété comme un uri, une Classe interprétée comme la classe d’un objet DisplayObject imbriqué, une occurrence de DisplayObject ou un objet URLRequest.
| |
width:Object — Nouvelle largeur de l’image (nombre ou pourcentage).
| |
height:Object — Nouvelle hauteur de l’image (nombre ou pourcentage).
| |
options:Object (default = null ) — Aucune prise en charge.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
width
et height
de l’image en ligne à étirer dans une ellipse :
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 | () | méthode |
public function moveChildren(source:FlowGroupElement, sourceIndex:int, numChildren:int, destination:FlowGroupElement, destinationIndex:int, selectionState:SelectionState = null):void
Déplacez un ensemble d’objets FlowElement d’un objet FlowGroupElement vers un autre. L’élément de destination doit être un type de parent valide pour les enfants déplacés, ou une exception est levée.
Paramètres
source:FlowGroupElement — Parent original des éléments à déplacer.
| |
sourceIndex:int — Index enfant au sein de la source du premier élément à déplacer.
| |
numChildren:int — Nombre d’enfants déplacés.
| |
destination:FlowGroupElement — Nouveau parent des éléments après leur déplacement.
| |
destinationIndex:int — Index enfant au sein de la destination vers laquelle les éléments sont déplacés.
| |
selectionState:SelectionState (default = null ) — Spécifie le texte auquel s’applique cette opération et où la sélection retourne en cas d’annulation. Si la valeur null est définie, l’opération s’applique à la sélection actuelle. Si rien n’est sélectionné, ce paramètre ne doit pas être null.
|
overwriteText | () | méthode |
public function overwriteText(text:String, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Remplace le texte sélectionné.
Si la sélection est un point de sélection, le premier caractère est remplacé par le nouveau texte.
Paramètres
text:String — Chaîne à insérer.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function pasteTextScrap(scrapToPaste:flashx.textLayout.edit:TextScrap, operationState:SelectionState = null):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Colle l’objet TextScrap dans la zone sélectionnée.
Si une plage de texte est spécifiée le texte de la plage est supprimé.
Paramètres
scrapToPaste:flashx.textLayout.edit:TextScrap — Objet TextScrap à coller.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function redo():void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Effectue à nouveau l’opération annulée précédemment.
Remarque : si l’interface IUndoManager associé à cette interface IEditManager est également associée à une autre, il est possible que l’opération Rétablir associée à l’autre interface IEditManager sera celle rétablie. Cela peut se produire si la classe FlowOperation d’une autre interface IEditManager est au-dessus de la pile Rétablir.
Cette fonction n’a aucune incidence si Annuler n’est pas activé.
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function splitElement(target:FlowGroupElement, operationState:SelectionState = null):FlowGroupElement
Divise l’élément cible à l’emplacement spécifié, créant un nouvel élément après l’élément existant. Si operationState est une plage, le texte au sein de la plage est supprimé. Le nouvel élément est créé après la position du texte spécifiée par operationState. Notez que la division d’un objet SubParagraphGroupElement n’aura aucun effet, car ils seront automatiquement refusionnés avec les éléments adjacents.
Par exemple, vous pouvez utiliser ceci si vous possédez une liste et voulez la diviser en deux listes.
Paramètres
target:FlowGroupElement — Elément à diviser.
| |
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
FlowGroupElement — Le nouveau paragraphe qui a été créé.
|
splitParagraph | () | méthode |
public function splitParagraph(operationState:SelectionState = null):ParagraphElement
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Divise le paragraphe à la position actuelle, créant un nouveau paragraphe après le paragraphe existant.
Si une plage de texte est spécifiée le texte de la plage est supprimé.
Paramètres
operationState:SelectionState (default = null ) — Spécifie le texte auquel cette opération s’applique ; si null , l’opération s’applique à la sélection actuelle.
|
ParagraphElement — Le nouveau paragraphe qui a été créé.
|
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function undo():void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Inverse la dernière opération.
Remarque : si l’interface IUndoManager associée à cette interface IEditManager est également associée à une autre, il est possible que l’opération Annuler associée à l’autre interface IEditManager sera celle annulée. Cela peut se produire si la classe FlowOperation d’une autre interface IEditManager est au-dessus de la pile Annuler.
Cette fonction n’a aucune incidence si Annuler n’est pas activé.
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
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 | () | méthode |
public function updateAllControllers():void
- Créez un TextFlow (
tf
) pour contenir une ligne d’exemple de texte. - Stockez le texte dans un élément SpanElement lui-même stocké dans un élément ParagraphElement.
- Créez un ContainerController pour le texte et rédigez le texte à afficher.
- Instanciez les objets du gestionnaire TextFlow en vue d’une utilisation ultérieure par un écouteur d’événement.
- Créez un bouton de modification très simple permettant à l’utilisateur de rendre le texte modifiable.
- Créez l’écouteur d’événement du bouton qui bascule entre les états « lecture seule » et « modifiable ».
La valeur de la propriété interactionManager
de TextFlow détermine si l’exemple de texte est modifiable. Si la propriété est null
, l’exemple de texte est en lecture seule. Si la propriété est affectée à une occurrence EditManager, l’exemple de texte est modifiable. La méthode createEditButton() crée une occurrence TextField très simple analogue à un bouton. Lorsqu’un utilisateur clique sur une occurrence TextField, la fonction d’écouteur updateEditable()
fait basculer la valeur de la propriété 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, 09:30 AM Z