| Package | flashx.textLayout.elements |
| Classe | public final class LinkElement |
| Héritage | LinkElement  SubParagraphGroupElementBase FlowGroupElement FlowElement Object |
| Implémente | IEventDispatcher |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Normalement, lorsque vous cliquez dessus, l’objet LinkElement appellera la méthode flash.net.navigateToURL(). Un schéma d’URI spécial event: est également pris en charge. Ce schéma générera un événement TextFlow que l’utilisateur peut écouter afin d’exécuter le code AS3. Un exemple est fourni ci-dessous.
Si vous spécifiez une cible, elle doit avoir l’une des valeurs suivantes :
| Valeur cible | description |
|---|---|
| _self | Remplace la page HTML actuelle. Si elle est dans un cadre ou un jeu de cadres, elle doit se charger dans ce cadre. S’il s’agit de la base du navigateur, il s’ouvre pour remplacer la page à partir de laquelle il provient. |
| _blank | Ouvre un nouveau nom de navigateur sans nom. |
| _parent | Remplace la page HTML dont il provient. |
| _top | Se charge dans le navigateur ouvert, en remplaçant tout ce qu’il contient, par exemple, un jeu de cadres. |
Propriété MXML par défautmxmlChildren
Eléments de l’API associés
LinkState
FlowElement.linkActiveFormat
FlowElement.linkHoverFormat
FlowElement.linkNormalFormat
TextFlow
FlowElement.linkActiveFormat
FlowElement.linkHoverFormat
FlowElement.linkNormalFormat
TextFlow
Propriétés publiques
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | alignmentBaseline : *
TextLayoutFormat : spécifie la ligne de base sur laquelle la ligne de base dominante s’aligne. | FlowElement | |
| backgroundAlpha : *
TextLayoutFormat : valeur alpha (transparence) pour l’arrière-plan (adopte la valeur par défaut si undefined pendant la cascade). | FlowElement | |
| backgroundColor : *
TextLayoutFormat : couleur d’arrière-plan du texte (adopte la valeur par défaut si undefined pendant la propagation en cascade). | FlowElement | |
| baselineShift : *
TextLayoutFormat : valeur de décalage de la ligne de base par rapport à la valeur dominantBaseline. | FlowElement | |
| blockProgression : *
TextLayoutFormat : spécifie la progression verticale ou horizontale du positionnement de la ligne. | FlowElement | |
| breakOpportunity : *
TextLayoutFormat : contrôle l’autorisation des sauts de ligne lors de la séparation de l’habillage du texte en plusieurs lignes. | FlowElement | |
| cffHinting : *
TextLayoutFormat : type de repère CFF utilisé pour ce texte. | FlowElement | |
| clearFloats : *
TextLayoutFormat : contrôle la manière dont le texte enveloppe un élément flottant. | FlowElement | |
| color : *
TextLayoutFormat : couleur du texte. | FlowElement | |
| columnCount : *
TextLayoutFormat : nombre de colonnes de texte (adopte la valeur par défaut si la valeur est undefined pendant la propagation en cascade). | FlowElement | |
| columnGap : *
TextLayoutFormat : spécifie la quantité d’espace de gouttière, en pixels, à laisser entre les colonnes (adopte la valeur par défaut si undefined pendant la propagation en cascade). | FlowElement | |
| columnWidth : *
TextLayoutFormat : largeur de colonne en pixels (adopte la valeur par défaut si undefined pendant la propagation en cascade). | FlowElement | |
| computedFormat : flashx.textLayout.formats:ITextLayoutFormat [lecture seule]
Renvoie les attributs de format de caractère calculés qui sont appliqués à cet élément. | FlowElement | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| coreStyles : Object [lecture seule] Renvoie l’objet coreStyles sur cet objet FlowElement. | FlowElement | |
| digitCase : *
TextLayoutFormat : le type de casse de chiffres utilisée pour ce texte. | FlowElement | |
| digitWidth : *
TextLayoutFormat : type de largeur de chiffres utilisée pour ce texte. | FlowElement | |
| direction : *
TextLayoutFormat : spécifie le niveau d’intégration bidirectionnelle par défaut du texte dans le bloc de texte. | FlowElement | |
| dominantBaseline : *
TextLayoutFormat : spécifie la ligne de base de l’élément s’alignant sur alignmentBaseline pour déterminer la position verticale de l’élément sur la ligne. | FlowElement | |
| firstBaselineOffset : *
TextLayoutFormat : spécifie la position de ligne de base de la première ligne du conteneur. | FlowElement | |
| fontFamily : *
TextLayoutFormat : nom de la police à utiliser, ou liste de noms de police séparés par une virgule. | FlowElement | |
| fontLookup : *
TextLayoutFormat : recherche de police à utiliser. | FlowElement | |
| fontSize : *
TextLayoutFormat : taille du texte en pixels. | FlowElement | |
| fontStyle : *
TextLayoutFormat : style du texte. | FlowElement | |
| fontWeight : *
TextLayoutFormat : épaisseur du texte. | FlowElement | |
| format : flashx.textLayout.formats:ITextLayoutFormat Propriétés TextLayoutFormat appliquées directement à cet élément. | FlowElement | |
| href : String
URI (Uniform Resource Identifier) associée à l’objet LinkElement. | LinkElement | ||
| id : String
Attribue un identifiant à l’élément. De fait, il est possible de définir le style de l’élément, vous pouvez donc référencer l’identifiant. | FlowElement | |
| justificationRule : *
TextLayoutFormat : règle utilisée pour justifier le texte dans un paragraphe. | FlowElement | |
| justificationStyle : *
TextLayoutFormat : style utilisé pour la justification du paragraphe. | FlowElement | |
| kerning : *
TextLayoutFormat : le crénage ajuste les pixels entre certaines paires de caractères pour améliorer la lisibilité. | FlowElement | |
| leadingModel : *
TextLayoutFormat : spécifie le modèle d’interlignage, qui est une combinaison de la base et de la direction de l’interlignage. | FlowElement | |
| ligatureLevel : *
TextLayoutFormat : contrôle laquelle des ligatures qui sont définies dans la police peut être utilisée dans le texte. | FlowElement | |
| lineBreak : *
TextLayoutFormat : contrôle le retour à la ligne dans le conteneur (adopte la valeur par défaut si undefined pendant cascade). | FlowElement | |
| lineHeight : *
TextLayoutFormat : contrôles d’interlignage pour le texte. | FlowElement | |
| lineThrough : *
TextLayoutFormat : si la valeur est true, applique le style de formatage barré, une ligne au milieu du texte. | FlowElement | |
| linkActiveFormat : *
TextLayoutFormat : définit les attributs de mise en forme utilisés pour les liens à l’état normal. | FlowElement | |
| linkHoverFormat : *
TextLayoutFormat : définit les attributs de mise en forme utilisés pour les liens à l’état pointé, c’est-à-dire lorsque l’utilisateur survole un lien avec la souris. | FlowElement | |
| linkNormalFormat : *
TextLayoutFormat : définit les attributs de mise en forme utilisés pour les liens à l’état normal. | FlowElement | |
| linkState : String [lecture seule]
L’état actuel du lien. | LinkElement | ||
| listAutoPadding : *
TextLayoutFormat : spécifie un retrait automatique pour le bord de début des listes, lorsque la valeur d’espacement de la liste de ce côté est auto. | FlowElement | |
| listMarkerFormat : *
TextLayoutFormat : définit les marqueurs de liste d’attributs de mise en forme. | FlowElement | |
| listStylePosition : *
TextLayoutFormat : les valeurs valides sont ListStylePosition.INSIDE, ListStylePosition.OUTSIDE et FormatValue.INHERIT. La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie. Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. | FlowElement | |
| listStyleType : *
TextLayoutFormat : les valeurs valides sont ListStyleType.UPPER_ALPHA, ListStyleType.LOWER_ALPHA, ListStyleType.UPPER_ROMAN, ListStyleType.LOWER_ROMAN, ListStyleType.NONE, ListStyleType.DISC, ListStyleType.CIRCLE, ListStyleType.SQUARE, ListStyleType.BOX, ListStyleType.CHECK, ListStyleType.DIAMOND, ListStyleType.HYPHEN, ListStyleType.ARABIC_INDIC, ListStyleType.BENGALI, ListStyleType.DECIMAL, ListStyleType.DECIMAL_LEADING_ZERO, ListStyleType.DEVANAGARI, ListStyleType.GUJARATI, ListStyleType.GURMUKHI, ListStyleType.KANNADA, ListStyleType.PERSIAN, ListStyleType.THAI, ListStyleType.URDU, ListStyleType.CJK_EARTHLY_BRANCH, ListStyleType.CJK_HEAVENLY_STEM, ListStyleType.HANGUL, ListStyleType.HANGUL_CONSTANT, ListStyleType.HIRAGANA, ListStyleType.HIRAGANA_IROHA, ListStyleType.KATAKANA, ListStyleType.KATAKANA_IROHA, ListStyleType.LOWER_ALPHA, ListStyleType.LOWER_GREEK, ListStyleType.LOWER_LATIN, ListStyleType.UPPER_ALPHA, ListStyleType.UPPER_GREEK, ListStyleType.UPPER_LATIN et FormatValue.INHERIT. La valeur par défaut est undefined, ce qui indique qu’elle n’est pas définie. Si lors de la propagation en cascade, la valeur est undefined, cette propriété héritera ses valeurs d’un ancêtre. | FlowElement | |
| locale : *
TextLayoutFormat : paramètres régionaux du texte. | FlowElement | |
| mxmlChildren : Array
Ajoute un tableau d’enfants à cet objet. | FlowGroupElement | |
| numChildren : int [lecture seule]
Renvoie le nombre d’enfants FlowElement que possède cet objet FlowGroupElement. | FlowGroupElement | |
| paddingBottom : *
TextLayoutFormat : encart inférieur en pixels. | FlowElement | |
| paddingLeft : *
TextLayoutFormat : encart à gauche en pixels. | FlowElement | |
| paddingRight : *
TextLayoutFormat : encart à droite en pixels. | FlowElement | |
| paddingTop : *
TextLayoutFormat : encart supérieur en pixels. | FlowElement | |
| paragraphEndIndent : *
TextLayoutFormat : nombre qui indique, en pixels, la valeur de retrait du bord de la fin du paragraphe. | FlowElement | |
| paragraphSpaceAfter : *
TextLayoutFormat : un nombre qui spécifie la quantité d’espace, en pixels, à laisser après le paragraphe. | FlowElement | |
| paragraphSpaceBefore : *
TextLayoutFormat : nombre qui spécifie la quantité d’espace, en pixels, à conserver avant le paragraphe. | FlowElement | |
| paragraphStartIndent : *
TextLayoutFormat : nombre qui indique, en pixels, la valeur de retrait du bord du début du paragraphe. | FlowElement | |
| parent : FlowGroupElement [lecture seule] Renvoie le parent de ce objet FlowElement. | FlowElement | |
| parentRelativeEnd : int [lecture seule] Renvoie la fin relative de cet objet FlowElement dans le parent. | FlowElement | |
| parentRelativeStart : int [lecture seule] Renvoie le début relatif de cet objet FlowElement dans le parent. | FlowElement | |
| renderingMode : *
TextLayoutFormat : mode de rendu utilisé pour ce texte. | FlowElement | |
| styleName : *
TextLayoutFormat : attribue une classe d’identification à l’élément, ce qui permet de définir le style de l’élément en référençant la propriété styleName. | FlowElement | |
| styles : Object [lecture seule] Renvoie les styles sur cet objet FlowElement. | FlowElement | |
| tabStops : *
TextLayoutFormat : spécifie les taquets de tabulation associés au paragraphe. | FlowElement | |
| target : String
La valeur cible associée à l’objet LinkElement. | LinkElement | ||
| textAlign : *
TextLayoutFormat : alignement des lignes du paragraphe par rapport au conteneur. | FlowElement | |
| textAlignLast : *
TextLayoutFormat : alignement de la dernière (ou unique) ligne dans le paragraphe par rapport au conteneur dans un texte justifié. | FlowElement | |
| textAlpha : *
TextLayoutFormat : valeur alpha (transparence) du texte. | FlowElement | |
| textDecoration : *
TextLayoutFormat : décoration du texte. | FlowElement | |
| textIndent : *
TextLayoutFormat : nombre qui indique la quantité, en pixels, pour mettre en retrait la première ligne du paragraphe. | FlowElement | |
| textJustify : *
TextLayoutFormat : spécifie des options de justification de texte. | FlowElement | |
| textLength : int [lecture seule]
Renvoie la longueur totale de texte administrée par cet objet FlowElement et ses enfants. | FlowElement | |
| textRotation : *
TextLayoutFormat : détermine le nombre de degrés de rotation de ce texte. | FlowElement | |
| tracking : Object [écriture seule]
Définit le suivi et est synonyme de la propriété trackingRight. | FlowElement | |
| trackingLeft : *
TextLayoutFormat : nombre de pixels (ou pourcentage de taille fontSize, comme 120 %) indiquant la quantité de l’approche (crénage manuel) à appliquer à gauche de chaque caractère. | FlowElement | |
| trackingRight : *
TextLayoutFormat : nombre de pixels (ou pourcentage de taille fontSize, comme 120 %) indiquant la quantité de l’approche (crénage manuel) à appliquer à droite de chaque caractère. | FlowElement | |
| typeName : String
Chaque objet FlowElement a une propriété typeName. | FlowElement | |
| typographicCase : *
TextLayoutFormat : le type de casse typographique utilisée pour ce texte. | FlowElement | |
| userStyles : Object Permet de lire les styles d’écriture de l’utilisateur sur un objet FlowElement. | FlowElement | |
| verticalAlign : *
TextLayoutFormat : alignement vertical ou justification (adopte la valeur par défaut si undefined pendant la propagation en cascade). | FlowElement | |
| whiteSpaceCollapse : *
TextLayoutFormat : réduit ou conserve les espaces lors de l’importation de texte dans un TextFlow. | FlowElement | |
| wordSpacing : *
TextLayoutFormat : spécifie les espacements optimal, minimal et maximal (comme multiplicateur de la largeur d’un espace normal) entres les mots à utiliser lors de la justification. | FlowElement | |
Méthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur : crée une nouvelle occurrence LinkElement. | LinkElement | ||
|
Ajoute un objet FlowElement objet. | FlowGroupElement | |
|
Ajoute un objet FlowElement enfant à la position d’index spécifiée. | FlowGroupElement | |
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | LinkElement | ||
| Supprime le style spécifié par le paramètre styleProp à partir de cet objet FlowElement. | FlowElement | |
|
Effectue une copie en profondeur de cette objet FlowElement, y compris tout enfant, copiant le contenu entre les deux emplacements de caractère et renvoyant la copie en tant qu’objet FlowElement. | FlowElement | |
Distribue un événement dans le flux d’événements. | LinkElement | ||
| Comparez ces styles utilisateur avec les styles utilisateur d’autres éléments. | FlowElement | |
|
En fonction d’une position de texte relative, recherchez l’index du premier objet FlowElement enfant qui contient la position relative. | FlowGroupElement | |
|
En fonction d’une position du texte relative, recherchez l’élément de nœud terminal qui contient la position. | FlowGroupElement | |
|
Renvoie l’emplacement de départ de l’élément dans l’enchaînement de texte avec un index absolu. | FlowElement | |
|
Renvoie le caractère à la position spécifiée, par rapport à cet objet FlowElement. | FlowElement | |
| Renvoie le code de caractère à la position spécifiée, par rapport à cet objet FlowElement. | FlowElement | |
|
Renvoie l’enfant de l’objet FlowElement à l’index spécifié. | FlowGroupElement | |
|
Recherche dans les enfants pour l’objet FLowElement et renvoie sa position d’index. | FlowGroupElement | |
|
Renvoie la valeur de début de cet élément par rapport à l’élément ancêtre. | FlowElement | |
|
Renvoie le premier objet FlowLeafElement descendant de ce groupe. | FlowGroupElement | |
|
Renvoie le dernier objet FlowLeafElement descendant de ce groupe. | FlowGroupElement | |
| Renvoie le prochain objet FlowElement frère dans la hiérarchie de l’enchaînement de texte. | FlowElement | |
|
Renvoie l’objet ParagraphElement associé à cet élément. | FlowElement | |
| Renvoie l’objet FlowElement frère précédent dans la hiérarchie de l’enchaînement de texte. | FlowElement | |
| Renvoie la valeur du style spécifié par le paramètre styleProp, qui spécifie le nom du style et peut être n’importe quel nom de style d’utilisateur. | FlowElement | |
| [override] | FlowGroupElement | |
|
Gravit la hiérarchie de l’enchaînement de texte pour renvoyer l’objet TextFlow racine pour l’élément. | FlowElement | |
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | LinkElement | ||
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
| Appelé pour des objets MXML une fois que l’objet d’implémentation a été créé et que toutes les propriétés de composants spécifiées sur la balise MXML ont été initialisées. | FlowElement | |
|
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 propriété spécifiée existe et est énumérable. | Object | |
|
Supprime l’objet FlowElement enfant spécifié du groupe. | FlowGroupElement | |
|
Supprime l’objet FlowElement enfant de la position d’index spécifiée. | FlowGroupElement | |
Supprime un écouteur de l’objet EventDispatcher. | LinkElement | ||
|
Remplace les éléments enfant dans le groupe avec les nouveaux éléments spécifiés. | FlowGroupElement | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
| Définit le style spécifié par le paramètre styleProp à la valeur spécifiée par le paramètre newValue. | FlowElement | |
|
Effectue une copie de cet objet FlowElement, copie le contenu entre deux positions de caractères spécifiées. | FlowElement | |
|
Divise cet objet à la position spécifiée par le paramètre childIndex. | FlowGroupElement | |
|
Divise cet objet FlowElement à la position spécifiée par le paramètre relativePosition, qui est une position relative dans le texte pour cet élément. | FlowElement | |
|
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 | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | LinkElement | ||
Evénements
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| Distribué lorsque le lien est activé. | LinkElement | |||
| Distribué lorsque l’utilisateur clique sur le bouton de la souris sur un lien. | LinkElement | |||
| Distribué lorsque la souris survole le lien. | LinkElement | |||
| Distribué lorsque le bouton de la souris est relâché au-dessus d’un lien. | LinkElement | |||
| Distribué lorsque la souris sort du lien. | LinkElement | |||
| Distribué lorsque la souris entre pour la première fois dans le lien. | LinkElement | |||
Détails de la propriété
href | propriété |
href:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
URI (Uniform Resource Identifier) associée à l’objet LinkElement. L’URI peut être tout URI pris en charge par la méthode flash.net.navigateToURL(). Cette propriété est mappée au paramètre request pour cette méthode. L’URI peut également être de la forme event:eventType. Lorsque vous cliquez dessus, l’objet TextFlow générera un événement du type eventType.
Implémentation
public function get href():String public function set href(value:String):voidEléments de l’API associés
linkState | propriété |
target | propriété |
target:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
La valeur cible associée à l’objet LinkElement. Les valeurs possibles sont « _self », « _blank », « _parent » et « _top ». Cette valeur est mappée au paramètre window de la méthode flash.net.navigateToURL().
Implémentation
public function get target():String public function set target(value:String):voidEléments de l’API associés
Détails du constructeur
LinkElement | () | Constructeur |
public function LinkElement()| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur : crée une nouvelle occurrence LinkElement.
Détails de la méthode
addEventListener | () | méthode |
public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. Vous pouvez enregistrer les écouteurs d’événement dans tous les nœuds de la liste d’affichage pour un type spécifique d’événement, de phase et de priorité.
Après l’enregistrement d’un écouteur d’événement, vous ne pouvez plus modifier sa priorité par d’autres appels de addEventListener(). Pour modifier la priorité d’un écouteur, vous devez d’abord appeler removeEventListener(). Vous pouvez ensuite réenregistrer l’écouteur avec le nouveau niveau de priorité.
Après l’enregistrement de l’écouteur, tous les futurs appels de addEventListener() avec une valeur type ou useCapture différente entraîneront la création d’un autre enregistrement d’écouteur. Si, par exemple, vous enregistrez un écouteur dans lequel la propriété useCapture est définie sur true, il écoute uniquement pendant la phase de capture. Si vous appelez addEventListener() à l’aide du même objet écouteur, mais en définissant useCapture sur false, vous obtenez deux écouteurs distincts : l’un qui écoute pendant la phase de capture et l’autre qui écoute pendant les phases cible et de propagation vers le haut.
Il est impossible d’enregistrer un écouteur d’événement uniquement pour la phase cible ou la phase de propagation vers le haut. Ces deux phases sont associées pendant l’enregistrement car la propagation vers le haut s’applique uniquement aux ancêtres du nœud cible.
Si vous n’avez plus besoin d’un écouteur d’événement, supprimez-le en appelant EventDispatcher.removeEventListener(), pour éviter tout problème de mémoire. Les objets associés à des écouteurs d’événement enregistrés ne sont pas automatiquement supprimés de la mémoire, car le nettoyeur de mémoire n’efface pas les objets auxquels il est toujours fait référence.
Lors de la copie d’une occurrence d’EventDispatcher, les écouteurs d’événement qui lui sont associés ne sont pas pris en compte (si le nouveau nœud nécessite un écouteur d’événement, vous devez associer celui-ci après la création du nœud). Toutefois, si vous déplacez une occurrence d’EventDispatcher, les écouteurs d’événement qui lui sont associés la suivent.
Si un écouteur d’événement est enregistré sur un nœud alors qu’un événement est en cours de traitement sur ce nœud, l’écouteur n’est pas déclenché pendant la phase actuelle, mais il peut l’être pendant une phase ultérieure du flux d’événements, telle que la phase de propagation vers le haut.
Si un écouteur d’événement est supprimé d’un nœud sur lequel un événement est en cours de traitement, il est cependant déclenché par les actions en cours. Une fois supprimé, l’écouteur d’événement n’est plus jamais appelé (à moins d’être réenregistré à des fins de traitement ultérieur).
Paramètres
type:String — Type d’événement.
| |
listener:Function — Fonction d’auditeur qui traite l’événement. Cette fonction doit accepter un objet Event comme paramètre unique et ne rien renvoyer, comme dans l’exemple ci-dessous :
| |
useCapture:Boolean (default = false)useCapture est définie sur true, l’écouteur traite l’événement uniquement pendant la phase de capture et non pendant les phases cible et de propagation. Si la propriété useCapture est définie sur false, l’écouteur traite l’événement uniquement pendant les phases cible et de propagation. Pour écouter l’événement dans les trois phases, appelez addEventListener() à deux reprises, une première fois avec la propriété useCapture définie sur true, puis une nouvelle fois avec useCapture définie sur false.
| |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false)Les fonctions de membres de niveau classe n’étant pas soumises au nettoyage, vous pouvez définir |
dispatchEvent | () | méthode |
public function dispatchEvent(evt:Event):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribue un événement dans le flux d’événements. La cible de l’événement est l’objet EventDispatcher sur lequel la méthode dispatchEvent() est appelée.
Paramètres
evt:Event — Objet d’événement distribué dans le flux d’événements.
|
Boolean — true, sauf si la méthode preventDefault() est appelée sur l’événement, auquel cas la valeur false est renvoyée.
|
hasEventListener | () | méthode |
public function hasEventListener(type:String):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. Vous pouvez ainsi déterminer précisément où un objet EventDispatcher a modifié la gestion d’un type d’événement dans la hiérarchie du flux d’événements. Pour savoir si un type d’événement spécifique déclenche réellement un écouteur d’événement, utilisez IEventDispatcher.willTrigger().
La différence entre les méthodes hasEventListener() et willTrigger() est la suivante : hasEventListener() examine uniquement l’objet auquel elle appartient, tandis que willTrigger() recherche dans la totalité du flux d’événements l’événement spécifié par le paramètre type.
Paramètres
type:String — Type d’événement.
|
Boolean — La valeur true est renvoyée si un écouteur du type spécifié est enregistré. La valeur false est renvoyée dans tous les autres cas.
|
removeEventListener | () | méthode |
public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Supprime un écouteur de l’objet EventDispatcher. Si aucun écouteur correspondant n’est enregistré auprès de l’objet EventDispatcher, l’appel de cette méthode n’a aucun effet.
Paramètres
type:String — Type d’événement.
| |
listener:Function — Objet écouteur à supprimer.
| |
useCapture:Boolean (default = false)removeEventListener() à deux reprises pour le supprimer : une première fois en définissant useCapture sur true, puis une seconde fois avec la propriété useCapture définie sur false.
|
willTrigger | () | méthode |
public function willTrigger(type:String):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. Cette méthode renvoie true si un écouteur d’événement est déclenché pendant toute phase du flux d’événements lorsqu’un événement du type spécifié est distribué à cet objet EventDispatcher ou à l’un de ses descendants.
La différence entre les méthodes hasEventListener() et willTrigger() est la suivante : hasEventListener() examine uniquement l’objet auquel elle appartient, tandis que willTrigger() recherche dans la totalité du flux d’événements l’événement spécifié par le paramètre type.
Paramètres
type:String — Type d’événement.
|
Boolean — Renvoie true si un écouteur du type spécifié est enregistré, false dans tous les autres cas.
|
Détails de l’événement
click | Evénement |
Type d’objet d’événement:
propriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEventpropriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.CLICK| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque le lien est activé. Les clients peuvent remplacer la façon dont le lien gère cet événement en le gérant eux-mêmes et en appelant par défaut preventDefault().
Définit la valeur de la propriététype d’un objet d’événement click.
mouseDown | Evénement |
Type d’objet d’événement:
propriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEventpropriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_DOWN| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque l’utilisateur clique sur le bouton de la souris sur un lien.
Définit la valeur de la propriététype d’un objet d’événement mouseDown.
mouseMove | Evénement |
Type d’objet d’événement:
propriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEventpropriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_MOVE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque la souris survole le lien.
Définit la valeur de la propriététype d’un objet d’événement mouseMove.
mouseUp | Evénement |
Type d’objet d’événement:
propriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEventpropriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_UP| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque le bouton de la souris est relâché au-dessus d’un lien.
Définit la valeur de la propriététype d’un objet d’événement mouseUp.
rollOut | Evénement |
Type d’objet d’événement:
propriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEventpropriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.ROLL_OUT| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque la souris sort du lien.
Définit la valeur de la propriététype d’un objet d’événement rollOut.
rollOver | Evénement |
Type d’objet d’événement:
propriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEventpropriété FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.ROLL_OVER| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque la souris entre pour la première fois dans le lien.
Définit la valeur de la propriététype d’un objet d’événement rollOver.
Exemples Comment utiliser cet exemple
LinkElementExample.as
Cet exemple ajoute un objet LinkElement à un paragraphe et remplace le format par défaut pour l’état suspendu, le texte du lien devient rouge.
package flashx.textLayout.elements.examples
{
import flash.display.Sprite;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.LinkElement;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
import flashx.textLayout.formats.TextLayoutFormat;
public class LinkElementExample extends Sprite
{
public function LinkElementExample()
{
var textFlow:TextFlow = new TextFlow();
var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
textLayoutFormat.fontSize = 18;
textFlow.hostFormat = textLayoutFormat;
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var link:LinkElement = new LinkElement();
var span2:SpanElement = new SpanElement();
var inf:Object = {color:0xFF0000};
p.linkHoverFormat = inf;
span1.text = "Text that includes a link to ";
link.href = "http://www.adobe.com";
var linkSpan:SpanElement = new SpanElement();
linkSpan.text = "Adobe's website";
link.addChild(linkSpan);
span2.text = ". Notice the custom formatting when the cursor hovers " +
"over the link.";
p.addChild(span1);
p.addChild(link);
p.addChild(span2);
textFlow.addChild(p);
textFlow.flowComposer.addController(new ContainerController(this,stage.stageWidth, stage.stageHeight));
textFlow.flowComposer.updateAllControllers();
}
}
}
LinkElementEventExample.as
Cet exemple utilise le modèle d’URI
event: pour générer un événement permettant d’exécuter du code ActionScript sur un simple clic.
package flashx.textLayout.elements.examples
{
import flash.display.Sprite;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.LinkElement;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
import flashx.textLayout.events.FlowElementMouseEvent;
import flashx.textLayout.formats.TextLayoutFormat;
public class LinkElementEventExample extends Sprite
{
public function LinkElementEventExample()
{
var textFlow:TextFlow = new TextFlow();
textFlow.fontFamily = "Arial, Helvetica, _sans";
textFlow.fontSize = 18;
textFlow.paddingLeft = textFlow.paddingRight = textFlow.paddingTop = 20;
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var link:LinkElement = new LinkElement();
var span2:SpanElement = new SpanElement();
span1.text = "Text that includes a link to ";
link.href = "event:changeTextFlowColor";
var linkSpan:SpanElement = new SpanElement();
linkSpan.text = "custom event code"
link.addChild(linkSpan);
span2.text = ". Clicking the link changes the default color of the TextFlow";
p.addChild(span1);
p.addChild(link);
p.addChild(span2);
textFlow.addChild(p);
textFlow.flowComposer.addController(new ContainerController(this,stage.stageWidth, stage.stageHeight));
textFlow.flowComposer.updateAllControllers();
textFlow.addEventListener("changeTextFlowColor",changeTextFlowColor)
}
private function changeTextFlowColor(e:FlowElementMouseEvent):void
{
var textFlow:TextFlow = e.flowElement.getTextFlow();
textFlow.color = textFlow.color == 0x00ff00 ? 0 : 0x00ff00;
textFlow.flowComposer.updateAllControllers();
}
}
}
Tue Jun 12 2018, 09:30 AM Z