Pacchettoflash.events
Classepublic class ContextMenuEvent
EreditarietàContextMenuEvent Inheritance Event Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Flash® Player invia oggetti ContextMenuEvent quando un utente genera il menu di scelta rapida o interagisce con esso. Il menu di scelta rapida viene generato quando l'utente fa clic sul pulsante secondario del dispositivo di puntamento (in genere un mouse o una trackball). Esistono due tipi di oggetti ContextMenuEvent:

Vedere gli esempi

Vedere anche

Classe ContextMenu
Classe ContextMenuItem


Proprietà pubbliche
 ProprietàDefinito da
 Inheritedbubbles: Boolean
[sola lettura] Indica se un evento è un evento di bubbling.
Event
 Inheritedcancelable: Boolean
[sola lettura] Indica se il comportamento associato all'evento può essere impedito.
Event
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  contextMenuOwner: InteractiveObject
L'oggetto elenco di visualizzazione al quale il menu è associato.
ContextMenuEvent
 InheritedcurrentTarget: Object
[sola lettura] L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
Event
 InheritedeventPhase: uint
[sola lettura] La fase attuale del flusso di eventi.
Event
  mouseTarget: InteractiveObject
L'oggetto elenco di visualizzazione su cui l'utente ha fatto clic con il pulsante destro per visualizzare il menu di scelta rapida.
ContextMenuEvent
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
 Inheritedtarget: Object
[sola lettura] Il target dell'evento.
Event
 Inheritedtype: String
[sola lettura] Il tipo di evento.
Event
Metodi pubblici
 MetodoDefinito da
  
ContextMenuEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, mouseTarget:InteractiveObject = null, contextMenuOwner:InteractiveObject = null)
Crea un oggetto evento contenente informazioni specifiche sugli eventi di menu.
ContextMenuEvent
  
Crea una copia dell'oggetto ContextMenuEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.
ContextMenuEvent
 Inherited
formatToString(className:String, ... arguments):String
Una funzione di utilità per l'implementazione del metodo toString() nella classe Event personalizzata.
Event
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Verifica se sull'evento è stato chiamato il metodo preventDefault().
Event
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato.
Event
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi.
Event
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente.
Event
  
Restituisce una stringa che contiene tutte le proprietà dell'oggetto ContextMenuEvent.
ContextMenuEvent
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Costanti pubbliche
 CostanteDefinito da
 InheritedACTIVATE: String = "activate"
[statico] Definisce il valore della proprietà type di un oggetto evento activate.
Event
 InheritedADDED: String = "added"
[statico] Definisce il valore della proprietà type di un oggetto evento added.
Event
 InheritedADDED_TO_STAGE: String = "addedToStage"
[statico] Definisce il valore della proprietà type di un oggetto evento addedToStage.
Event
 InheritedCANCEL: String = "cancel"
[statico] Definisce il valore della proprietà type di un oggetto evento cancel.
Event
 InheritedCHANGE: String = "change"
[statico] Definisce il valore della proprietà type di un oggetto evento change.
Event
 InheritedCLOSE: String = "close"
[statico] Definisce il valore della proprietà type di un oggetto evento close.
Event
 InheritedCOMPLETE: String = "complete"
[statico] Definisce il valore della proprietà type di un oggetto evento complete.
Event
 InheritedCONNECT: String = "connect"
[statico] Definisce il valore della proprietà type di un oggetto evento connect.
Event
 InheritedDEACTIVATE: String = "deactivate"
[statico] Definisce il valore della proprietà type di un oggetto evento deactivate.
Event
 InheritedENTER_FRAME: String = "enterFrame"
[statico] Definisce il valore della proprietà type di un oggetto evento enterFrame.
Event
 InheritedFULLSCREEN: String = "fullScreen"
[statico] Definisce il valore della proprietà type di un oggetto evento fullScreen.
Event
 InheritedID3: String = "id3"
[statico] Definisce il valore della proprietà type di un oggetto evento id3.
Event
 InheritedINIT: String = "init"
[statico] Definisce il valore della proprietà type di un oggetto evento init.
Event
  MENU_ITEM_SELECT: String = "menuItemSelect"
[statico] Definisce il valore della proprietà type di un oggetto evento menuItemSelect.
ContextMenuEvent
  MENU_SELECT: String = "menuSelect"
[statico] Definisce il valore della proprietà type di un oggetto evento menuSelect.
ContextMenuEvent
 InheritedMOUSE_LEAVE: String = "mouseLeave"
[statico] Definisce il valore della proprietà type di un oggetto evento mouseLeave.
Event
 InheritedOPEN: String = "open"
[statico] Definisce il valore della proprietà type di un oggetto evento open.
Event
 InheritedREMOVED: String = "removed"
[statico] Definisce il valore della proprietà type di un oggetto evento removed.
Event
 InheritedREMOVED_FROM_STAGE: String = "removedFromStage"
[statico] Definisce il valore della proprietà type di un oggetto evento removedFromStage.
Event
 InheritedRENDER: String = "render"
[statico] Definisce il valore della proprietà type di un oggetto evento render.
Event
 InheritedRESIZE: String = "resize"
[statico] Definisce il valore della proprietà type di un oggetto evento resize.
Event
 InheritedSCROLL: String = "scroll"
[statico] Definisce il valore della proprietà type di un oggetto evento scroll.
Event
 InheritedSELECT: String = "select"
[statico] Definisce il valore della proprietà type di un oggetto evento select.
Event
 InheritedSOUND_COMPLETE: String = "soundComplete"
[statico] Definisce il valore della proprietà type di un oggetto evento soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE: String = "tabChildrenChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE: String = "tabEnabledChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE: String = "tabIndexChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabIndexChange.
Event
 InheritedUNLOAD: String = "unload"
[statico] Definisce il valore della proprietà type di un oggetto evento unload.
Event
Descrizione delle proprietà
contextMenuOwnerproprietà
contextMenuOwner:InteractiveObject  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

L'oggetto elenco di visualizzazione al quale il menu è associato. Può trattarsi del target del mouse (mouseTarget) o di uno dei suoi antenati nell'elenco di visualizzazione.


Implementazione
    public function get contextMenuOwner():InteractiveObject
    public function set contextMenuOwner(value:InteractiveObject):void
mouseTargetproprietà 
mouseTarget:InteractiveObject  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

L'oggetto elenco di visualizzazione su cui l'utente ha fatto clic con il pulsante destro per visualizzare il menu di scelta rapida. Può trattarsi dell'oggetto dell'elenco di visualizzazione a cui è associato il menu (contextMenuOwner) o di uno dei suoi discendenti all'interno dell'elenco.


Implementazione
    public function get mouseTarget():InteractiveObject
    public function set mouseTarget(value:InteractiveObject):void
Descrizione della funzione di costruzione
ContextMenuEvent()Funzione di costruzione
public function ContextMenuEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, mouseTarget:InteractiveObject = null, contextMenuOwner:InteractiveObject = null)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea un oggetto evento contenente informazioni specifiche sugli eventi di menu. Gli oggetti evento vengono passati ai listener di eventi come parametri.

Parametri
type:String — Il tipo di evento. I valori possibili sono:
  • ContextMenuEvent.MENU_ITEM_SELECT
  • ContextMenuEvent.MENU_SELECT
 
bubbles:Boolean (default = false) — Determina se l'oggetto Event partecipa alla fase di bubbling del flusso di eventi. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata bubbles.
 
cancelable:Boolean (default = false) — Determina se l'oggetto Event può essere annullato. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata cancelable.
 
mouseTarget:InteractiveObject (default = null) — L'oggetto elenco di visualizzazione su cui l'utente ha fatto clic con il pulsante destro per visualizzare il menu di scelta rapida. Può trattarsi di contextMenuOwner o di uno dei suoi discendenti nell'elenco di visualizzazione.
 
contextMenuOwner:InteractiveObject (default = null) — L'oggetto elenco di visualizzazione al quale il menu è associato. Può trattarsi di mouseTarget o di uno dei suoi antenati nell'elenco di visualizzazione.

Vedere anche

Descrizione dei metodi
clone()metodo
public override function clone():Event

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea una copia dell'oggetto ContextMenuEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.

Restituisce
Event — Un nuovo oggetto ContextMenuEvent con proprietà dai valori identici a quelli dell'originale.
toString()metodo 
public override function toString():String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Restituisce una stringa che contiene tutte le proprietà dell'oggetto ContextMenuEvent. La stringa ha il seguente formato:

[ContextMenuEvent type= value bubbles= value cancelable= value ... contextMenuOwner= value]

Restituisce
String — Una stringa che contiene tutte le proprietà dell'oggetto ContextMenuEvent.
Descrizione delle costanti
MENU_ITEM_SELECTCostante
public static const MENU_ITEM_SELECT:String = "menuItemSelect"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento menuItemSelect.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
contextMenuOwnerL'oggetto elenco di visualizzazione al quale il menu è associato.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
mouseTargetL'oggetto elenco di visualizzazione su cui l'utente ha fatto clic con il pulsante destro per visualizzare il menu di scelta rapida.
targetL'oggetto ContextMenuItem selezionato. Il target non è sempre l'oggetto contenuto nell'elenco di visualizzazione, che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

MENU_SELECTCostante 
public static const MENU_SELECT:String = "menuSelect"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento menuSelect.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
contextMenuOwnerL'oggetto elenco di visualizzazione al quale il menu è associato.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
mouseTargetL'oggetto elenco di visualizzazione su cui l'utente ha fatto clic con il pulsante destro per visualizzare il menu di scelta rapida.
targetL'oggetto ContextMenu che sta per essere visualizzato. Il target non è sempre l'oggetto contenuto nell'elenco di visualizzazione, che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

Esempi Come utilizzare gli esempi
ContextMenuEventExample.as

Nell'esempio seguente viene utilizzata la classe ContextMenuEventExample per rimuovere dallo stage le voci di menu di scelta rapida predefinite e aggiungere una nuova voce di menu che cambia il colore di un quadrato sullo stage. L'esempio esegue le operazioni seguenti:
  1. Viene dichiarata la proprietà myContextMenu e quindi viene assegnata a un nuovo oggetto ContextMenu. Viene quindi dichiarata la proprietà redRectangle (di tipo Sprite)
  2. Viene chiamato il metodo removeDefaultItems(), che rimuove tutte le voci incorporate del menu di scelta rapida ad eccezione di Print.
  3. Viene chiamato il metodo addCustomMenuItems(). Questo metodo colloca una voce di menu Reverse Colors (per l'inversione dei colori) nell'array defaultItems utilizzando il metodo push() di Array. Viene aggiunto un listener di eventi menuItemSelect all'oggetto ContextMenuItem e viene chiamato il metodo associato menuItemSelectHandler(). Questo metodo stampa alcune istruzioni trace() ogni volta che l'utente seleziona la voce Reverse Colors dal menu di scelta rapida. Inoltre, il quadrato rosso diventa nero e il testo nero diventa rosso.
  4. Nella funzione di costruzione viene aggiunto un listener di eventi menuSelect, unitamente al metodo associato menuSelectHandler(), che stampa semplicemente tre istruzioni trace() ogni volta che viene selezionata una voce dal menu di scelta rapida.
  5. La funzione di costruzione chiama addChildren(), che disegna un quadrato rosso e lo aggiunge all'elenco di visualizzazione nel quale viene visualizzato immediatamente.
  6. Viene infine assegnato myContextMenu al menu di scelta rapida della proprietà redRectangle, in modo che il menu di scelta rapida venga visualizzato solo quando il puntatore del mouse si trova sopra il quadrato.
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;
        }
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/events/ContextMenuEvent.html