Пакет	flash.ui
Класс	public final class ContextMenuItem
Наследование	ContextMenuItem EventDispatcher Object

Язык версии :

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9

Класс ContextMenuItem используется для создания пользовательских элементов меню, отображаемых в контекстном меню проигрывателя Flash Player. Каждый объект ContextMenuItem имеет подпись (текст), который отображается в контекстом меню. Чтобы добавить новый элемент в контекстное меню, его нужно добавить в массив customItems объекта ContextMenu.

С помощью свойств класса ContextMenuItem можно включать или выключать определенные элементы меню, а также делать их видимыми или невидимыми.

Нужно записать обработчик для события menuItemSelect, чтобы добавить функцию для элемента меню, когда он выбирается пользователем.

Пользовательские элементы меню показываются в начале контекстного меню, над встроенными элементами. Разделительная полоса отделяет пользовательские элементы меню от встроенных.

Ограничения

• В контекстное меню можно добавить не более 15 пользовательских элементов.
• Каждая подпись должна содержать хотя бы один видимый символ.
• Управляющие символы, символы новой строки и другие символы пробела игнорируются.
• Длина подписи не должна превышать 100 символов.
• Подписи, идентичные встроенным элементам меню или другим пользовательским элементам, игнорируются независимо от того, отображается совпадающий с ним элемент или нет. Подписи меню сравниваются с встроенными или существующими пользовательскими подписями без учета регистра, пунктуации и пробелов.
• Следующие подписи не разрешены, но для пользовательской подписи эти слова можно использовать в сочетании с другими (например, "Paste" (Вставить) — запрещено, а "Paste tastes great" (Пастила очень вкусная) — разрешено):

   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
   

• Ни одно из следующих слов не может использоваться в пользовательских подписях ни отдельно, ни в сочетании с другими словами:

   Adobe
   Macromedia
   Flash Player
   Settings
   

Примечание. Когда проигрыватель работает не в англоязычной системе, строки подписей сравниваются и с английским списком и с локализованными эквивалентами.

Посмотреть примеры

См. также

---

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;
        }
    }
}