ContextMenuItem 类

可用性

Flash Player 7。

说明

使用 ContextMenuItem 类可创建在 Flash Player 上下文菜单中显示的自定义菜单项。每个
ContextMenuItem 对象均具有在上下文菜单中显示的标题（文本）以及在选择菜单项时调用的回调处理函数（函数）。若要向上下文菜单添加新的上下文菜单项，请将其添加到
ContextMenu 对象的 customItems 数组。

您可以启用或禁用特定菜单项，显示或隐藏菜单项，或者更改与菜单项关联的标题或回调处理
函数。

自定义菜单项出现在上下文菜单的顶部，并位于所有内置菜单项之上。自定义菜单项与内置菜单项始终由分隔条隔开。向 Flash Player 上下文菜单添加的自定义菜单项不得超过 15 个。每个菜单项必须至少包含一个可见字符，控制字符、换行符和其它空白字符将被忽略。所有菜单项的长度不得超过 100 个字符。如果菜单项与任何内置菜单项或其它自定义菜单项相同，则无论匹配菜单项是否可见，均会忽略该菜单项。对菜单项进行比较时将忽略大小写、标点和空格。

自定义菜单项中不能出现以下字词：Macromedia、Flash Player、或 设置。

ContextMenuItem 类的方法概要

ContextMenuItem 类的属性概要

ContextMenuItem 类的事件处理函数概要

ContextMenuItem 类的构造函数

可用性

Flash Player 7。

用法

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

参数

caption 指定与菜单项关联的文本的字符串。

callbackFunction 您定义的函数，它在选择菜单项时被调用。

separatorBefore 布尔值，指示分隔条是否应该出现在上下文菜单中的特定菜单项之上。此参数是可选的；其默认值为 false。

enabled 布尔值，指示是启用还是禁用上下文菜单中的特定菜单项。此参数是可选的；其默认
值为 true。

visible 布尔值，指示菜单项是否可见。此参数是可选的；其默认值为 true。

返回

无。

说明

构造函数；创建可添加到 ContextMenu.customItems 数组的新 ContextMenuItem 对象。

示例

此示例将“开始”和“停止”菜单项（由分隔条隔开）添加到 ContextMenu 对象 my_cm。当从上下文菜单中选择“开始”时，将调用 startHandler() 函数；当选择“停止”时，将调用
stopHandler()。ContextMenu 对象会应用到根时间轴。

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;