ContextMenuItem  - AS3

Paquete	flash.ui
Clase	public final class ContextMenuItem
Herencia	ContextMenuItem NativeMenuItem EventDispatcher Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9

La clase ContextMenuItem representa un elemento del menú contextual. Cada objeto ContextMenuItem tiene un texto que aparece en el menú contextual. Para añadir un nuevo elemento a un menú contextual, debe añadirse al conjunto customItems de un objeto ContextMenu.

Con las propiedades de la clase ContextMenuItem se pueden activar o desactivar elementos de menú específicos, así como hacerlos visibles o invisibles.

Escriba un controlador de eventos para el evento menuItemSelect a fin de añadir funcionalidad al elemento de menú cuando lo seleccione el usuario.

Los elementos de menú personalizados aparecen en la parte superior del menú contextual, por encima de los elementos de menú incorporados. Una barra separadora divide los elementos de menú incorporados y los personalizados. En AIR, no hay elementos incorporados y las siguientes restricciones no se aplican al contenido del entorno limitado de seguridad de la aplicación de AIR.

Restricciones:

• Puede añadir un máximo de 15 elementos personalizados a un menú contextual.
• Cada texto debe contener, al menos, un carácter visible.
• No se tienen en cuenta los caracteres de control, las nuevas líneas y otros caracteres de espacio en blanco.
• Ningún texto puede exceder los 100 caracteres de longitud.
• No se tienen en cuenta los textos que coincidan exactamente con algún elemento de menú incorporado o con otros elementos personalizados, sea visible o no el elemento coincidente. Los textos del menú se comparan con los textos incorporados o con los personalizados ya existentes, independientemente del uso de mayúsculas, puntuación o espacios en blanco.
• No están permitidos los textos siguientes, pero las palabras se pueden utilizar en combinación con otras palabras para crear un texto personalizado (por ejemplo, aunque no está permitido utilizar "Pegar", sí se puede emplear la frase "Pegar no está bien"):

   Save
   Zoom In
   Zoom Out
   100%
   Show All
   Quality
   Play
   Loop
   Rewind
   Forward
   Back
   Movie not loaded
   About
   Print
   Show Redraw Regions
   Debugger
   Undo
   Cut
   Copy
   Paste
   Delete
   Select All
   Open
   Open in new window
   Copy link
   

• Ninguna de las palabras siguientes puede aparecer en un texto personalizado, ni solas ni combinadas con otras palabras:

   Adobe
   Macromedia
   Flash Player
   Settings
   

Nota: si el reproductor se ejecuta en un sistema no inglés, las cadenas de los textos se comparan tanto con la lista inglesa como con las equivalencias traducidas.

Ver los ejemplos

Elementos de API relacionados

---

package {
    import flash.ui.ContextMenu;
    import flash.ui.ContextMenuItem;
    import flash.ui.ContextMenuBuiltInItems;
    import flash.display.Sprite;
    import flash.text.TextField;

    public class ContextMenuItemExample extends Sprite {
        private var myContextMenu:ContextMenu;

        public function ContextMenuItemExample() {
            myContextMenu = new ContextMenu();
            removeDefaultItems();
            addCustomMenuItems();
            this.contextMenu = myContextMenu;
            addChild(createLabel());
        }

        private function removeDefaultItems():void {
            myContextMenu.hideBuiltInItems();

            var defaultItems:ContextMenuBuiltInItems = myContextMenu.builtInItems;
            defaultItems.print = true;
        }

        private function addCustomMenuItems():void {
            var item:ContextMenuItem = new ContextMenuItem("Hello World");
            myContextMenu.customItems.push(item);
        }
        
        private function createLabel():TextField {
            var txtField:TextField = new TextField();
            txtField.text = "Right Click Here";
            return txtField;
        }
    }
}