ContextMenuItem  - AS3

Paket	flash.ui
Sınıf	public final class ContextMenuItem
Miras Alma	ContextMenuItem NativeMenuItem EventDispatcher Object

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

ContextMenuItem sınıfı, bağlam menüsünde yer alan bir öğeyi temsil eder. Her ContextMenuItem öğesinde, bağlam menüsünde görüntülenen bir resim yazısı (metin) mevcuttur. Bir bağlam menüsüne yeni bir öğe eklemek için ContextMenu nesnesindeki customItems dizisine ekleyin.

ContextMenuItem sınıfının özelliklerini kullanarak belirli menü öğelerini etkinleştirebilir, devre dışı bırakabilir ve öğelerin görünür veya görünmez olmasını sağlayabilirsiniz.

Kullanıcı tarafından seçildiğinde bir menü öğesine işlev eklemek üzere menuItemSelect olayı için bir olay işleyici yazın.

Özel menü öğeleri, bağlam menüsünde diğer yerleşik öğelerin üzerinde görüntülenir. Bir ayırıcı çubuğu, özel menü öğelerini yerleşik öğelerden ayırır. AIR uygulamasında yerleşik öğe yoktur ve aşağıdaki kısıtlamalar AIR uygulama sanal alanındaki içerik için geçerli değildir.

Kısıtlamalar:

• Bir bağlam menüsüne 15'ten fazla özel öğe ekleyemezsiniz.
• Her resim yazısında en az bir adet görünür karakter olmalıdır.
• Kontrol karakterleri, satır başı karakterleri ve diğer beyaz karakterler yok sayılır.
• Hiçbir resim yazısının uzunluğu 100 karakterden fazla olamaz.
• Yerleşik bir öğeyle veya başka bir özel öğeyle aynı olan resim yazıları, eşleşen öğenin görünür olup olmadığına bakılmaksızın yok sayılır. Menü resim yazıları; büyük/küçük karakter kullanımına, noktalamaya veya beyaz boşluğa bakılmaksızın yerleşik resim yazılarıyla veya varolan özel resim yazılarıyla karşılaştırılır.
• Aşağıdaki resim yazılarına izin verilmez, ancak özel bir resim yazısı oluşturmak için sözcükler, başka sözcüklerle birlikte kullanılabilir (örneğin, "Pasta" sözcüğüne izin verilmese de "Hasta pasta yedi" kullanılabilir):

   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
   

• Aşağıdaki sözcüklerden hiçbiri, tek başlarına veya başka sözcüklerle birlikte özel bir resim yazısında bulunamaz:

   Adobe
   Macromedia
   Flash Player
   Settings
   

Not: Flash Player İngilizce olmayan bir sistemde çalıştırılıyorsa, resim yazısı dizeleri hem İngilizce listeyle hem de yerelleştirilmiş karşılıklarıyla karşılaştırılır.

Örnekleri görüntüle

İlgili API Öğeleri

---

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