Un objeto que tiene las propiedades siguientes de la clase ContextMenuBuiltInItems: forwardAndBack, loop, play, print, quality, rewind, save y zoom. La configuración de estas propiedades con el valor false quita los elementos de menú correspondientes del objeto ContextMenu especificado. Estas propiedades son enumerables y están configuradas con el valor true de manera predeterminada.

Véase también

Una matriz de objetos ContextMenuItem. Cada objeto de la matriz representa un elemento del menú contextual que ha definido. Utilice esta propiedad para añadir, quitar o modificar estos elementos de menú personalizados.

Para añadir nuevos elementos al menú, cree un objeto ContextMenuItem y luego añádalo a la matriz customItems (por ejemplo, utilizando Array.push()). Para más información sobre la creación de elementos de menú, consulte la entrada de la clase ContextMenuItem.

Véase también

Crea un objeto ContextMenu.

Véase también

Crea una copia del objeto ContextMenu especificado. La copia hereda todas las propiedades del objeto de menú original.

Oculta todos los elementos de menú incorporados (salvo Configuración) del objeto ContextMenu especificado. Si se está en ejecución la versión del depurador de Flash Player, se mostrará el elemento de menú Depuración, aunque éste estará atenuado para archivos SWF que no tengan activada la depuración remota.

Este método oculta sólo los elementos de menú que aparecen en el menú contextual estándar; no afecta a los elementos que aparecen en los menús de edición y de error.

Este método funciona configurando todos los miembros booleanos de my_cm.builtInItems como false. Puede seleccionar los elementos incorporados que deben estar visibles configurando su correspondiente miembro en my_cm.builtInItems como true.

Véase también

Se distribuye cuando el usuario genera por primera vez un menú contextual, pero antes de que se muestre su contenido. De este modo, el programa puede modificar la definición de los elementos del menú contextual antes de mostrarlo. El usuario genera el menú contextual al hacer clic con el botón derecho del dispositivo de señalización.

Este evento tiene las propiedades siguientes:

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(), que elimina todos los elementos incorporados en el menú contextual salvo Print.
3. Se llama al método addCustomMenuItems(), que coloca el elemento de menú de selección de menú Red to Black en la matriz defaultItems a través del método push() de la clase Array. Se añade un detector de eventos menuItemSelect al objeto ContextMenuItem y se llama al método asociado menuItemSelectHandler(). Este método imprime determinadas sentencias mediante trace() siempre que se accede al menú contextual y se selecciona Red to Black. Asimismo, se elimina el cuadrado de color rojo y se sustituye por uno de color negro.
4. Se añade un detector de eventos de tipo menuSelect, junto con el método asociado menuSelectHandler, que simplemente imprime tres sentencias a través de trace() siempre que se abre un elemento del menú contextual.
5. A continuación, addChildren() 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 del elemento sprite 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.events.ContextMenuEvent;
    import flash.display.Sprite;
    import flash.display.Shape;
    import flash.text.TextField;

    public class ContextMenuExample 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 ContextMenuExample() {
            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;
        }
    }
}