Paqueteflash.events
Clasepublic class ContextMenuEvent
HerenciaContextMenuEvent Inheritance Event Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Flash® Player distribuye objetos ContextMenuEvent cuando el usuario genera un menú contextual o interactúa con él. Los usuarios pueden generar el menú contextual al hacer clic en el botón secundario del dispositivo de señalización del usuario (normalmente, un ratón o una bola de seguimiento). Existen dos tipos de objetos ContextMenuEvent:

Ver los ejemplos

Véase también

ContextMenu
ContextMenuItem


Propiedades públicas
 PropiedadDefinido por
 Inheritedbubbles : Boolean
[read-only] Indica si un evento es un evento de propagación.
Event
 Inheritedcancelable : Boolean
[read-only] Indica si se puede evitar el comportamiento asociado al evento.
Event
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  contextMenuOwner : InteractiveObject
El objeto de la lista de visualización al que se asocia el menú.
ContextMenuEvent
 InheritedcurrentTarget : Object
[read-only] El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
Event
 InheritedeventPhase : uint
[read-only] La fase actual en el flujo del evento.
Event
  mouseTarget : InteractiveObject
El objeto de la lista de visualización en el que el usuario hace clic con el botón derecho para mostrar el menú contextual.
ContextMenuEvent
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
 Inheritedtarget : Object
[read-only] El destino del evento.
Event
 Inheritedtype : String
[read-only] El tipo de evento.
Event
Métodos públicos
 MétodoDefinido por
  
ContextMenuEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, mouseTarget:InteractiveObject = null, contextMenuOwner:InteractiveObject = null)
Crea un objeto de evento que contiene información específica sobre eventos de menú.
ContextMenuEvent
  
Crea una copia del objeto ContextMenuEvent y define el valor de cada propiedad para que coincida con el del objeto original.
ContextMenuEvent
 Inherited
formatToString(className:String, ... arguments):String
Una función de utilidad para implementar el método toString() en la clase Event personalizada.
Event
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Comprueba si se ha llamado a preventDefault() en el evento.
Event
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo.
Event
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento.
Event
 Inherited
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual.
Event
  
Devuelve una cadena con todas las propiedades del objeto ContextMenuEvent.
ContextMenuEvent
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Constantes públicas
 ConstanteDefinido por
 InheritedACTIVATE : String = "activate"
[static] Define el valor de la propiedad type para un objeto de evento activate.
Event
 InheritedADDED : String = "added"
[static] Define el valor de la propiedad type para un objeto de evento added.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Define el valor de la propiedad type para un objeto de evento addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[static] Define el valor de la propiedad type para un objeto de evento cancel.
Event
 InheritedCHANGE : String = "change"
[static] Define el valor de la propiedad type para un objeto de evento change.
Event
 InheritedCLOSE : String = "close"
[static] Define el valor de la propiedad type para un objeto de evento close.
Event
 InheritedCOMPLETE : String = "complete"
[static] Define el valor de la propiedad type para un objeto de evento complete.
Event
 InheritedCONNECT : String = "connect"
[static] Define el valor de la propiedad type para un objeto de evento connect.
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] Define el valor de la propiedad type para un objeto de evento deactivate.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] Define el valor de la propiedad type para un objeto de evento enterFrame.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] Define el valor de la propiedad type para un objeto de evento fullScreen.
Event
 InheritedID3 : String = "id3"
[static] Define el valor de la propiedad type para un objeto de evento id3.
Event
 InheritedINIT : String = "init"
[static] Define el valor de la propiedad type para un objeto de evento init.
Event
  MENU_ITEM_SELECT : String = "menuItemSelect"
[static] Define el valor de la propiedad type para un objeto de evento menuItemSelect.
ContextMenuEvent
  MENU_SELECT : String = "menuSelect"
[static] Define el valor de la propiedad type para un objeto de evento menuSelect.
ContextMenuEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Define el valor de la propiedad type para un objeto de evento mouseLeave.
Event
 InheritedOPEN : String = "open"
[static] Define el valor de la propiedad type para un objeto de evento open.
Event
 InheritedREMOVED : String = "removed"
[static] Define el valor de la propiedad type para un objeto de evento removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Define el valor de la propiedad type para un objeto de evento removedFromStage.
Event
 InheritedRENDER : String = "render"
[static] Define el valor de la propiedad type para un objeto de evento render.
Event
 InheritedRESIZE : String = "resize"
[static] Define el valor de la propiedad type para un objeto de evento resize.
Event
 InheritedSCROLL : String = "scroll"
[static] Define el valor de la propiedad type para un objeto de evento scroll.
Event
 InheritedSELECT : String = "select"
[static] Define el valor de la propiedad type para un objeto de evento select.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Define el valor de la propiedad type para un objeto de evento soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Define el valor de la propiedad type para un objeto de evento tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Define el valor de la propiedad type para un objeto de evento tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Define el valor de la propiedad type para un objeto de evento tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[static] Define el valor de la propiedad type para un objeto de evento unload.
Event
Información sobre propiedades
contextMenuOwnerpropiedad
contextMenuOwner:InteractiveObject  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

El objeto de la lista de visualización al que se asocia el menú. Podría ser el destino del ratón (mouseTarget) o uno de sus ascendientes de la lista de visualización.


Implementación
    public function get contextMenuOwner():InteractiveObject
    public function set contextMenuOwner(value:InteractiveObject):void
mouseTargetpropiedad 
mouseTarget:InteractiveObject  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

El objeto de la lista de visualización en el que el usuario hace clic con el botón derecho para mostrar el menú contextual. Podría ser el objeto de la lista de visualización al que se asocia el menú (contextMenuOwner) o uno de sus descendientes de la lista de visualización.


Implementación
    public function get mouseTarget():InteractiveObject
    public function set mouseTarget(value:InteractiveObject):void
Información sobre constructores
ContextMenuEvent()constructor
public function ContextMenuEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, mouseTarget:InteractiveObject = null, contextMenuOwner:InteractiveObject = null)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea un objeto de evento que contiene información específica sobre eventos de menú. Los objetos de evento se transfieren como parámetros a los detectores de eventos.

Parámetros
type:String — El tipo de evento. Los valores posibles son:
  • ContextMenuEvent.MENU_ITEM_SELECT
  • ContextMenuEvent.MENU_SELECT
 
bubbles:Boolean (default = false) — Determina si el objeto de evento participa en la fase de propagación del flujo del evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad bubbles heredada.
 
cancelable:Boolean (default = false) — Determina si se puede cancelar el objeto Event. Los detectores de eventos pueden acceder a esta información a través de la propiedad cancelable heredada.
 
mouseTarget:InteractiveObject (default = null) — El objeto de la lista de visualización en el que el usuario hace clic con el botón derecho para mostrar el menú contextual. Podría ser contextMenuOwner o uno de sus descendientes de la lista de visualización.
 
contextMenuOwner:InteractiveObject (default = null) — El objeto de la lista de visualización al que se asocia el menú. Podría ser mouseTarget o uno de sus ascendientes de la lista de visualización.

Véase también

Información sobre métodos
clone()método
public override function clone():Event

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea una copia del objeto ContextMenuEvent y define el valor de cada propiedad para que coincida con el del objeto original.

Valor devuelto
Event — Un nuevo objeto ContextMenuEvent con valores de propiedades que coinciden con los del objeto original.
toString()método 
public override function toString():String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Devuelve una cadena con todas las propiedades del objeto ContextMenuEvent. La cadena tiene el siguiente formato:

[tipo ContextMenuEvent= valor bubbles= valor cancelable= valor... contextMenuOwner= valor]

Valor devuelto
String — Una cadena que contiene todas las propiedades del objeto ContextMenuEvent.
Información sobre constantes
MENU_ITEM_SELECTConstante
public static const MENU_ITEM_SELECT:String = "menuItemSelect"

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Define el valor de la propiedad type de un objeto de evento menuItemSelect.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
contextMenuOwnerEl objeto de la lista de visualización al que se asocia el menú.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
mouseTargetEl objeto de la lista de visualización en el que el usuario hace clic con el botón derecho para mostrar el menú contextual.
targetEl objeto ContextMenuItem seleccionado. El destino no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente.

Véase también

MENU_SELECTConstante 
public static const MENU_SELECT:String = "menuSelect"

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Define el valor de la propiedad type de un objeto de evento menuSelect.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
contextMenuOwnerEl objeto de la lista de visualización al que se asocia el menú.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
mouseTargetEl objeto de la lista de visualización en el que el usuario hace clic con el botón derecho para mostrar el menú contextual.
targetEl objeto ContextMenu que se va a mostrar. El destino no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente.

Véase también

Ejemplos Cómo utilizar los ejemplos
ContextMenuEventExample.as

En el ejemplo siguiente, se utiliza la clase ContextMenuEventExample para eliminar del escenario los elementos de menú contextual predeterminados y añadir un elemento nuevo que cambia el color de un cuadrado en el escenario. El ejemplo realiza las siguientes tareas:
  1. Se declara una propiedad myContextMenu y, a continuación, se asigna a un objeto ContextMenu nuevo y se declara una propiedad redRectangle de tipo Sprite.
  2. Se llama al método removeDefaultItems(). Este método elimina todos los elementos incorporados en el menú contextual excepto Print.
  3. Se llama al método addCustomMenuItems(). Este método coloca un elemento de menú Reverse Colors en la matriz defaultItems utilizando el método push() de Array. Se añade un detector de eventos menuItemSelect al objeto ContextMenuItem y se llama al método asociado menuItemSelectHandler(). Este método imprime algunas sentencias trace() cuando el usuario selecciona Reverse Colors en el menú contextual. Además, el cuadrado rojo pasa a ser negro y el texto negro se muestra en rojo.
  4. De nuevo en el constructor, se añade un detector de eventos menuSelect, junto con el método asociado menuSelectHandler(), que simplemente imprime tres sentencias trace() siempre que se selecciona un elemento del menú contextual.
  5. El constructor llama a addChildren(), que dibuja un cuadrado de color rojo y lo añade a la lista de visualización, donde aparece inmediatamente.
  6. Por último, myContextMenu se asigna al menú contextual de la propiedad redRectangle, de modo que el menú contextual personalizado sólo aparezca cuando el puntero del ratón se encuentre sobre el cuadrado.
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;
        }
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/events/ContextMenuEvent.html