ContextMenuItem (класс)

Доступность

Flash Player 7.

Описание

Вы можете использовать класс ContextMenuItem для создания дополнительных пользовательских элементов меню в контекстном меню флэш проигрывателя. Каждый объект ContextMenuItem включает в себя текстовой заголовок, который будет показан в контекстном меню и функцию обратного вызова (callback handler), функцию, которая будет вызвана, когда этот элемент меню будет выбран. Для того, чтобы добавить новый элемент меню в контекстное меню, вы должна добавить его в массив customItems объекта ContextMenu.

Вы можете сделать активными или неактивными определенные элементы меню, сделать их видимыми или невидимыми, изменить заголовок или функцию обратного вызова (callback handler), связанную с элементом меню.

Дополнительные пользовательские элементы меню появляются в верхней часте контекстного меню, над основными. Разделитель всегда отделяет пользовательские элементы меню от основных. Вы можете добавить не больше 15 дополнительных элементов к контекстному меню. Каждый элемент должен содержать как минимум одну видимую букву— служебные символы, перевод строки и другие пустые символы игнорируются. Пользовательский элемент меню не может содержать текст длиннее ста символов. Элементы меню, аналогичные основным или уже созданным пользовательским элементам меню, игнорируются, независимо от того, видимые они или нет. Элементы меню сравниваются без учета знаков препинания и пробелов.

В пользовательских элементах меню не должны использоваться следующие слова: Macromedia, Flash Player, or Settings.

Методы класса ContextMenuItem

Метод	Описание
`ContextMenuItem.copy()`	Возвращает копию объекта ContextMenuItem.

Свойства класса ContextMenuItem

Свойство	Описание
`ContextMenuItem.caption`	Устанавливает текст элемента меню.
`ContextMenuItem.enabled`	Устанавливает, активен ли элемент меню или нет.
`ContextMenuItem.separatorBefore`	Устанавливает, будет ли показан разделитель над элементом меню..
`ContextMenuItem.visible`	.Устанавливает, будет ли виден элемент меню.

Обработчики событий класса ContextMenuItem

Обработчик	Описание
`ContextMenuItem.onSelect`	Выполняется, когда элемент меню выбран.

Конструктор класса ContextMenuItem

Доступность

Flash Player 7.

Синтаксис

new ContextMenuItem(caption:String, 
                callbackFunction:Function, 
                [ separatorBefore:Boolean, 
                [ enabled:Boolean, 
                [ visible:Boolean] ] ] ) : ContextMenuItem

Параметры

caption Строка, которая задает текст, связанный с элементом меню.

callbackFunction Определенная вам функция, которая будет вызвана, когда будет выбран элемент меню .

separatorBefore Булево(Boolean) значение, которое определяет, будет ли создан разделитель над элементом меню в контекстном меню. Значение по умолчанию равно false. Это необязательный параметр.

enabled Булево значение, которое определяет, будет ли элемент меню активен или неактивен в контекстном меню. Значение по умолчанию равно true.Это необязательный параметр.

visible Булево значение, которое определяет, будет ли элемент меню видим или невидим. Значение по умолчанию равно true.Это необязательный параметр.

Возвращает

.Ссылку на объект ContextMenuItem.

Описание

Конструктор, создает новый объект ContextMenuItem, который должен быть добавлен в массив ContextMenu.customItems.

Пример

Этот пример добавляет элементы меню Start и Stop с разделителем между ними в объект ContextMenu, названный my_cm. Функция startHandler() вызывается, когда Start выбран в контекстном меню, stopHandler() вызывается, когда выбран Stop. Объект ContextMenu помещен в текущий таймлайн (Timeline).

var my_cm:ContextMenu = 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...");
}
this.menu = my_cm;

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление