ContextMenuItem  - AS3

Paket	flash.ui
Klass	public final class ContextMenuItem
Arv	ContextMenuItem NativeMenuItem EventDispatcher Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Klassen ContextMenuItem representerar ett alternativ på snabbmenyn. Alla ContextMenuItem-objekt har en ledtext som visas på snabbmenyn. Om du vill lägga till ett nytt alternativ på en snabbmeny lägger du till det i arrayen customItems i ett ContextMenu-objekt.

Med egenskaperna i ContextMenuItem-klassen kan du aktivera eller inaktivera vissa menyalternativ, och du kan göra alternativ synliga eller osynliga.

Du skriver en händelsehanterare för menuItemSelect-händelsen för att göra det möjligt att lägga till funktioner i menyalternativet när det markeras av användaren.

Anpassade menyalternativ visas högst upp på snabbmenyn, ovanför inbyggda alternativ. En avgränsare skiljer de anpassade menyalternativen från de inbyggda. I AIR finns det inga inbyggda objekt och följande begränsningar gäller inte innehåll i AIR-programmets sandlåda.

Begränsningar:

• Det går inte att lägga till mer än 15 anpassade alternativ i en snabbmeny.
• Varje ledtext måste innehålla minst ett synligt tecken.
• Styrtecken, radmatningar och andra tomrumstecken ignoreras.
• Ingen ledtext kan vara mer än 100 tecken långt.
• Ledtexter som är likadana som inbyggda menyalternativ eller andra anpassade alternativ ignoreras, oavsett om det andra alternativet är synligt eller inte. Menyledtexter jämförs med inbyggda ledtexter eller befintliga anpassade ledtexter utan hänsyn till skiftläge, interpunktion eller tomrum.
• Följande ledtexter är inte tillåtna, men orden får användas tillsammans med andra ord för att formulera en anpassad ledtext.

   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
   

• Inget av följande ord får visas i en anpassad ledtext på egen hand eller tillsammans med andra ord:

   Adobe
   Macromedia
   Flash Player
   Settings
   

Obs! När spelaren körs på ett system på annat språk än engelska, jämförs ledtextsträngarna med både den engelska listan och det egna språket.

Visa exemplen

Relaterade API-element

---

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