Clase ContextMenuItem

Disponibilidad

Flash Player 7.

Descripción

La clase ContextMenuItem se utiliza para crear elementos de menú personalizados y visualizarlos en el menú contextual de Flash Player. Cada objeto ContextMenuItem tiene un título (texto) que se visualiza en el menú contextual y un controlador callback (una función) que se invoca al seleccionar el elemento de menú. Para añadir un nuevo elemento de menú contextual a un menú contextual, debe añadirlo a la matriz customItems de un objeto ContextMenu.

Puede activar o desactivar elementos de menú específicos, establecer que los elementos sean visibles o no o cambiar un título o un controlador callback asociado a un elemento de menú.

Los elementos de menú personalizados aparecen en la parte superior del menú contextual, por encima de los elementos incorporados. Los elementos de menú personalizados siempre están separados de los elementos incorporados por una barra de división. En el menú contextual de Flash Player no pueden añadirse más de 15 elementos personalizados. Cada elemento debe contener como mínimo un carácter visible (los caracteres de control, las líneas nuevas y otros caracteres de espacio en blanco se pasan por alto). La longitud máxima de un elemento es de 100 caracteres. Los elementos que sean idénticos a algún elemento de menú incorporado o a otro elemento de menú personalizado, se pasarán por alto, independientemente de si el elemento coincidente está visible. Los elementos de menú se comparan sin tener en cuenta las mayúsculas y minúsculas, la puntuación ni los espacios en blanco.

Un elemento personalizado no puede contener ninguna de las palabras siguientes: Macromedia, Flash Player o Configuración.

Resumen de métodos para la clase ContextMenuItem

Resumen de propiedades para la clase ContextMenuItem

Resumen de controladores de eventos para la clase ContextMenuItem

Constructor para la clase ContextMenuItem

Disponibilidad

Flash Player 7.

Sintaxis

new ContextMenuItem(caption, callbackFunction, [ separatorBefore, [ enabled, [ visible ] ] ] )

Parámetros

caption Cadena que especifica el texto asociado a un elemento de menú.

callbackFunction Una función que haya definido, y a la que se llama cuando se selecciona el elemento de menú.

separatorBefore Valor booleano que indica si debe aparecer una barra de división por encima del elemento de menú en el menú contextual. Este parámetro es opcional; su valor predeterminado es false.

enabled Valor booleano que indica si el elemento de menú está activado o desactivado en el menú contextual. Este parámetro es opcional; su valor predeterminado es true.

visible Valor booleano que indica si el elemento de menú está visible o no. Este parámetro es opcional; su valor predeterminado es true.

Valor devuelto

Ninguno.

Descripción

Constructor; crea un nuevo objeto ContextMenuItem que puede añadirse a la matriz ContextMenu.customItems.

Ejemplo

En este ejemplo se añaden los elementos de menú Iniciar y Detener, separados por una barra, al objeto ContextMenu denominado my_cm. Al seleccionar Iniciar en el menú contextual se llama a la función startHandler(); al seleccionar Detener, se llama a la función stopHandler(). El objeto ContextMenu se aplica a la línea de tiempo raíz.

my_cm = new ContextMenu();
my_cm.customItems.push(new ContextMenuItem("Start", startHandler));
my_cm.customItems.push(new ContextMenuItem("Stop", stopHandler, true));
function stopHandler(obj, item) {
  trace("Stopping...");
}
function startHandler(obj, item) {
  trace("Starting...");
}
_root.menu = my_cm;