| Package | flash.events |
| Classe | public class ContextMenuEvent |
| Héritage | ContextMenuEvent Event Object |
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
ContextMenuEvent.MENU_ITEM_SELECTContextMenuEvent.MENU_SELECTVoir aussi
| Propriété | Défini par | ||
|---|---|---|---|
![]() | bubbles : Boolean
[lecture-seule]
Indique si un événement peut se propager vers le haut (bubbling).
| Event | |
![]() | cancelable : Boolean
[lecture-seule]
Indique si le comportement associé à l’événement peut être annulé.
| Event | |
![]() | constructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
| Object | |
| contextMenuOwner : InteractiveObject
Objet de la liste d'affichage auquel le menu est associé.
| ContextMenuEvent | ||
![]() | currentTarget : Object
[lecture-seule]
L’objet qui traite activement l’objet Event avec un écouteur d’événements.
| Event | |
![]() | eventPhase : uint
[lecture-seule]
Phase actuelle du flux d’événements.
| Event | |
| mouseTarget : InteractiveObject
Objet de la liste d’affichage sur lequel l'utilisateur a cliqué du bouton droit de la souris pour afficher le menu contextuel.
| ContextMenuEvent | ||
![]() | prototype : Object
[static]
Référence à l’objet prototype d’un objet de classe ou fonction.
| Object | |
![]() | target : Object
[lecture-seule]
Cible de l’événement.
| Event | |
![]() | type : String
[lecture-seule]
Type d’événement.
| Event | |
| Méthode | Défini par | ||
|---|---|---|---|
|
ContextMenuEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, mouseTarget:InteractiveObject = null, contextMenuOwner:InteractiveObject = null)
Crée un objet Event contenant des informations spécifiques sur les événements de menu.
| ContextMenuEvent | ||
|
Crée une copie de l’objet ContextMenuEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.
| ContextMenuEvent | ||
![]() |
Fonction d’un utilitaire permettant d'implémenter la méthode toString() dans votre classe Event personnalisée.
| Event | |
![]() |
Indique si la propriété spécifiée d'un objet est définie.
| Object | |
![]() |
Vérifie si preventDefault() a été appelée pour l’événement.
| Event | |
![]() |
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 | |
![]() |
Annule le comportement par défaut d’un événement si cette opération est possible.
| Event | |
![]() |
Indique si la propriété spécifiée existe et est énumérable.
| Object | |
![]() |
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
| Object | |
![]() |
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d'événements.
| Event | |
![]() |
Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements.
| Event | |
|
Renvoie une chaîne répertoriant toutes les propriétés de l'objet ContextMenuEvent.
| ContextMenuEvent | ||
![]() |
Renvoie la valeur primitive de l'objet spécifié.
| Object | |
| Constante | Défini par | ||
|---|---|---|---|
![]() | ACTIVATE : String = "activate" [static]
Définit la valeur de la propriété type d'un objet événement activate.
| Event | |
![]() | ADDED : String = "added" [static]
Définit la valeur de la propriété type d'un objet événement added.
| Event | |
![]() | ADDED_TO_STAGE : String = "addedToStage" [static]
Définit la valeur de la propriété type d'un objet événement addedToStage.
| Event | |
![]() | CANCEL : String = "cancel" [static]
Définit la valeur de la propriété type d'un objet événement cancel.
| Event | |
![]() | CHANGE : String = "change" [static]
Définit la valeur de la propriété type d'un objet événement change.
| Event | |
![]() | CLOSE : String = "close" [static]
Définit la valeur de la propriété type d'un objet événement close.
| Event | |
![]() | COMPLETE : String = "complete" [static]
Définit la valeur de la propriété type d'un objet événement complete.
| Event | |
![]() | CONNECT : String = "connect" [static]
Définit la valeur de la propriété type d'un objet événement connect.
| Event | |
![]() | DEACTIVATE : String = "deactivate" [static]
Définit la valeur de la propriété type d'un objet événement deactivate.
| Event | |
![]() | ENTER_FRAME : String = "enterFrame" [static]
Définit la valeur de la propriété type d'un objet événement enterFrame.
| Event | |
![]() | FULLSCREEN : String = "fullScreen" [static]
Définit la valeur de la propriété type d'un objet événement fullScreen.
| Event | |
![]() | ID3 : String = "id3" [static]
Définit la valeur de la propriété type d'un objet événement id3.
| Event | |
![]() | INIT : String = "init" [static]
Définit la valeur de la propriété type d'un objet événement init.
| Event | |
| MENU_ITEM_SELECT : String = "menuItemSelect" [static]
Définit la valeur de la propriété type d'un objet événement menuItemSelect.
| ContextMenuEvent | ||
| MENU_SELECT : String = "menuSelect" [static]
Définit la valeur de la propriété type d'un objet événement menuSelect.
| ContextMenuEvent | ||
![]() | MOUSE_LEAVE : String = "mouseLeave" [static]
Définit la valeur de la propriété type d'un objet événement mouseLeave.
| Event | |
![]() | OPEN : String = "open" [static]
Définit la valeur de la propriété type d'un objet événement open.
| Event | |
![]() | REMOVED : String = "removed" [static]
Définit la valeur de la propriété type d'un objet événement removed.
| Event | |
![]() | REMOVED_FROM_STAGE : String = "removedFromStage" [static]
Définit la valeur de la propriété type d'un objet événement removedFromStage.
| Event | |
![]() | RENDER : String = "render" [static]
Définit la valeur de la propriété type d'un objet événement render.
| Event | |
![]() | RESIZE : String = "resize" [static]
Définit la valeur de la propriété type d'un objet événement resize.
| Event | |
![]() | SCROLL : String = "scroll" [static]
Définit la valeur de la propriété type d'un objet événement scroll.
| Event | |
![]() | SELECT : String = "select" [static]
Définit la valeur de la propriété type d'un objet événement select.
| Event | |
![]() | SOUND_COMPLETE : String = "soundComplete" [static]
Définit la valeur de la propriété type d'un objet événement soundComplete.
| Event | |
![]() | TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [static]
Définit la valeur de la propriété type d'un objet événement tabChildrenChange.
| Event | |
![]() | TAB_ENABLED_CHANGE : String = "tabEnabledChange" [static]
Définit la valeur de la propriété type d'un objet événement tabEnabledChange.
| Event | |
![]() | TAB_INDEX_CHANGE : String = "tabIndexChange" [static]
Définit la valeur de la propriété type d'un objet événement tabIndexChange.
| Event | |
![]() | UNLOAD : String = "unload" [static]
Définit la valeur de la propriété type d'un objet événement unload.
| Event | |
| contextMenuOwner | propriété |
contextMenuOwner:InteractiveObject [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Objet de la liste d'affichage auquel le menu est associé. Il peut s’agir de la cible de la souris (mouseTarget) ou de l’un de ses ancêtres dans la liste d’affichage.
public function get contextMenuOwner():InteractiveObject
public function set contextMenuOwner(value:InteractiveObject):void
| mouseTarget | propriété |
mouseTarget:InteractiveObject [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Objet de la liste d’affichage sur lequel l'utilisateur a cliqué du bouton droit de la souris pour afficher le menu contextuel. Il peut s'agir de l’objet de la liste d'affichage auquel le menu est associé (contextMenuOwner) ou de l’un de ses descendants dans la liste d’affichage.
public function get mouseTarget():InteractiveObject
public function set mouseTarget(value:InteractiveObject):void
| ContextMenuEvent | () | Constructeur |
public function ContextMenuEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, mouseTarget:InteractiveObject = null, contextMenuOwner:InteractiveObject = null)
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Crée un objet Event contenant des informations spécifiques sur les événements de menu. Les objets Event sont transmis en tant que paramètres aux écouteurs d’événements.
Paramètrestype:String — Type de l’événement. Les valeurs possibles sont les suivantes :
|
|
bubbles:Boolean (default = false) — Détermine si l’objet Event prend part à la phase de propagation vers le haut (bubbling) du flux d’événements. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété bubbles héritée.
|
|
cancelable:Boolean (default = false) — Détermine si l’objet Event peut être annulé. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété cancelable héritée.
|
|
mouseTarget:InteractiveObject (default = null) — Objet de la liste d’affichage sur lequel l'utilisateur a cliqué du bouton droit de la souris pour afficher le menu contextuel. Il peut s’agir de l'objet contextMenuOwner ou de l’un de ses descendants dans la liste d’affichage.
|
|
contextMenuOwner:InteractiveObject (default = null) — Objet de la liste d'affichage auquel le menu est associé. Il peut s’agir de l'objet mouseTarget ou de l’un de ses ancêtres dans la liste d’affichage.
|
Voir aussi
| clone | () | méthode |
public override function clone():Event
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Crée une copie de l’objet ContextMenuEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.
Valeur renvoyéeEvent — Nouvel objet ContextMenuEvent dont les propriétés ont la même valeur que celles de l’objet d'origine.
|
| toString | () | méthode |
public override function toString():String
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Renvoie une chaîne répertoriant toutes les propriétés de l'objet ContextMenuEvent. La chaîne est écrite au format suivant :
[ContextMenuEvent type=valeur bubbles=valeur cancelable=valeur ... contextMenuOwner=valeur]
String — Chaîne répertoriant toutes les propriétés de l'objet ContextMenuEvent.
|
| MENU_ITEM_SELECT | Constante |
public static const MENU_ITEM_SELECT:String = "menuItemSelect"
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Définit la valeur de la propriété type d'un objet événement menuItemSelect.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
contextMenuOwner | Objet de la liste d'affichage auquel le menu est associé. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
mouseTarget | Objet de la liste d’affichage sur lequel l'utilisateur a cliqué du bouton droit de la souris pour afficher le menu contextuel. |
target | Objet ContextMenuItem qui a été sélectionné. La cible ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d'événements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement. |
Voir aussi
| MENU_SELECT | Constante |
public static const MENU_SELECT:String = "menuSelect"
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Définit la valeur de la propriété type d'un objet événement menuSelect.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
contextMenuOwner | Objet de la liste d'affichage auquel le menu est associé. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
mouseTarget | Objet de la liste d’affichage sur lequel l'utilisateur a cliqué du bouton droit de la souris pour afficher le menu contextuel. |
target | Objet ContextMenu sur le point d’être affiché. La cible ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d'événements. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d'affichage qui traite actuellement l'événement. |
Voir aussi
ContextMenuEventExample pour supprimer les éléments de menu contextuel par défaut de la scène et ajouter un nouvel élément de menu qui change la couleur d'un carré sur la scène. L'exemple exécute les tâches suivantes :
myContextMenu est déclarée, puis affectée à un nouvel objet ContextMenu et la propriété redRectangle (de type Sprite) est déclarée.removeDefaultItems() est appelée. Cette méthode supprime tous les éléments de menu intégrés à l'exception de Print.addCustomMenuItems() est appelée. Cette méthode place un élément de menu Reverse Colors dans le tableau defaultItems à l'aide de la méthode push() de Array. Un écouteur d'événements menuItemSelect est ajouté à l'objet ContextMenuItem et la méthode associée est appelée menuItemSelectHandler(). Cette méthode imprime certaines instructions trace() chaque fois que l'initiateur sélectionne Reverse Colors dans le menu contextuel. Le carré rouge devient noir et le texte noir devient rouge.menuSelect est ajouté, de même que la méthode associée menuSelectHandler(), qui imprime simplement trois instructions trace() chaque fois qu'un élément du menu contextuel est sélectionné.addChildren(), qui dessine un carré rouge et l'ajoute dans la liste d'affichage, cette dernière l'affichant immédiatement.myContextMenu est affectée ou menu contextuel de la propriété redRectangle, de sorte que le menu contextuel personnalisé ne s'affiche que lorsque le pointeur de la souris survole le carré.
package {
import flash.ui.ContextMenu;
import flash.ui.ContextMenuItem;
import flash.ui.ContextMenuBuiltInItems;
import flash.events.ContextMenuEvent;
import flash.display.Sprite;
import flash.display.Shape;
import flash.text.TextField;
public class ContextMenuEventExample extends Sprite {
private var myContextMenu:ContextMenu;
private var menuLabel:String = "Reverse Colors";
private var textLabel:String = "Right Click";
private var redRectangle:Sprite;
private var label:TextField;
private var size:uint = 100;
private var black:uint = 0x000000;
private var red:uint = 0xFF0000;
public function ContextMenuEventExample() {
myContextMenu = new ContextMenu();
removeDefaultItems();
addCustomMenuItems();
myContextMenu.addEventListener(ContextMenuEvent.MENU_SELECT, menuSelectHandler);
addChildren();
redRectangle.contextMenu = myContextMenu;
}
private function addChildren():void {
redRectangle = new Sprite();
redRectangle.graphics.beginFill(red);
redRectangle.graphics.drawRect(0, 0, size, size);
addChild(redRectangle);
redRectangle.x = size;
redRectangle.y = size;
label = createLabel();
redRectangle.addChild(label);
}
private function removeDefaultItems():void {
myContextMenu.hideBuiltInItems();
var defaultItems:ContextMenuBuiltInItems = myContextMenu.builtInItems;
defaultItems.print = true;
}
private function addCustomMenuItems():void {
var item:ContextMenuItem = new ContextMenuItem(menuLabel);
myContextMenu.customItems.push(item);
item.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, menuItemSelectHandler);
}
private function menuSelectHandler(event:ContextMenuEvent):void {
trace("menuSelectHandler: " + event);
}
private function menuItemSelectHandler(event:ContextMenuEvent):void {
trace("menuItemSelectHandler: " + event);
var textColor:uint = (label.textColor == black) ? red : black;
var bgColor:uint = (label.textColor == black) ? black : red;
redRectangle.graphics.clear();
redRectangle.graphics.beginFill(bgColor);
redRectangle.graphics.drawRect(0, 0, size, size);
label.textColor = textColor;
}
private function createLabel():TextField {
var txtField:TextField = new TextField();
txtField.text = textLabel;
return txtField;
}
}
}
M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire
Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/events/ContextMenuEvent.html