ContextMenuItem  - AS3

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

Язык версии:

ActionScript 3.0

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

AIR 1.0, Flash Player 9

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

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

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

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

Ограничения

• В контекстное меню можно добавить не более 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
   

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

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

Связанные элементы API

---

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