ContextMenuEvent  - AS3

Das Anzeigelistenobjekt, dem das Menü zugeordnet ist. Hierbei kann es sich um ein Mausziel (mouseTarget) oder um einen seiner Vorgänger in der Anzeigeliste handeln.

Gibt an, ob die mouseTarget-Eigenschaft aus Sicherheitsgründen auf null gesetzt wurde. Ist der Nominalwert von menuTarget ein Verweis auf ein DisplayObject in einer anderen Sicherheitssandbox, wird menuTarget auf null gesetzt, es sei denn, die Berechtigung gilt über die Sandboxgrenzen hinweg für beide Richtungen. Die Berechtigung wird durch das Aufrufen von Security.allowDomain() aus einer SWF-Datei hergestellt, oder indem vom Server der Bilddatei eine Richtliniendatei bereitgestellt und das LoaderContext.checkPolicyFile-Flag beim Laden des Bilds gesetzt wird.

Verwandte API-Elemente

Das Anzeigelistenobjekt, auf das der Benutzer mit rechts geklickt hat, um das Kontextmenü anzuzeigen. Hierbei kann es sich um das Anzeigelistenobjekt handeln, mit dem das Menü verknüpft ist (contextMenuOwner), oder um eines seiner untergeordneten Elemente in der Anzeigeliste.

Der Wert dieser Eigenschaft kann in zwei Fällen null sein: Wenn kein Mausziel vorhanden ist (beispielsweise, wenn Sie die Maus über den Hintergrund bewegen) oder wenn eines vorhanden ist, dieses aber eine Sicherheitssandbox ist, auf die Sie keinen Zugriff haben. Verwenden Sie die isMouseTargetInaccessible()-Eigenschaft, um festzustellen, welcher dieser Gründe zutrifft.

Verwandte API-Elemente

Erstellt ein Ereignisobjekt, das bestimmte Informationen über Menüereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.

Verwandte API-Elemente

Erstellt eine Kopie des ContextMenuEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.

Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ContextMenuEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[ContextMenuEvent type= value bubbles= value cancelable= value ... contextMenuOwner= value ]

Definiert den Wert der Eigenschaft type eines menuItemSelect-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der Eigenschaft type eines menuSelect-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

1. Die Eigenschaft myContextMenu wird deklariert, und anschließend wird ein neues ContextMenu-Objekt mit der Eigenschaft redRectangle (vom Typ "Sprite") deklariert.
2. Die Methode removeDefaultItems() wird aufgerufen. Bei dieser Methode werden alle integrierten Kontextmenüelemente mit Ausnahme der Option zum Drucken entfernt.
3. Die Methode addCustomMenuItems() wird aufgerufen. Bei dieser Methode wird das defaultItems-Array um eine Option ReverseColours zur Farbumkehr erweitert. Hierfür wird die push()-Methode "Array" eingesetzt. Ein menuItemSelect-Ereignis-Listener wird dem ContextMenuItem-Objekt hinzugefügt. Die verknüpfte Methode ist menuItemSelectHandler(). Bei dieser Methode werden einige trace()-Anweisungen gedruckt, wenn der Benutzer die Option zur Farbumkehr im Kontextmenü wählt. Außerdem wird das rote Quadrat schwarz und der schwarze Text rot.
4. Im Konstruktor wird ein menuSelect-Ereignis-Listener zusammen mit der verknüpften Methode menuSelectHandler() hinzugefügt. Hiermit werden drei trace()-Anweisungen gedruckt, wenn ein Element im Kontextmenü ausgewählt wird.
5. Der Konstruktor ruft die Methode addChildren() auf, mit der ein rotes Quadrat gezeichnet und der Anzeigeliste hinzugefügt wird. Das Quadrat wird sofort angezeigt.
6. Zum Schluss wird myContextMenu dem Kontextmenü der Eigenschaft redRectangle zugewiesen, sodass das benutzerdefinierte Kontextmenü nur angezeigt wird, wenn sich der Mauszeiger über dem Quadrat befindet.

package {
    import flash.ui.ContextMenu;
    import flash.ui.ContextMenuItem;
    import flash.ui.ContextMenuBuiltInItems;
    import flash.events.ContextMenuEvent;
    import flash.display.Sprite;
    import flash.display.Shape;
    import flash.text.TextField;

    public class ContextMenuEventExample extends Sprite {
        private var myContextMenu:ContextMenu;
        private var menuLabel:String = "Reverse Colors";
        private var textLabel:String = "Right Click";
        private var redRectangle:Sprite;
        private var label:TextField;
        private var size:uint = 100;
        private var black:uint = 0x000000;
        private var red:uint = 0xFF0000;

        public function ContextMenuEventExample() {
            myContextMenu = new ContextMenu();
            removeDefaultItems();
            addCustomMenuItems();
            myContextMenu.addEventListener(ContextMenuEvent.MENU_SELECT, menuSelectHandler);

            addChildren();
            redRectangle.contextMenu = myContextMenu;
        }

        private function addChildren():void {
            redRectangle = new Sprite();
            redRectangle.graphics.beginFill(red);
            redRectangle.graphics.drawRect(0, 0, size, size);
            addChild(redRectangle);
            redRectangle.x = size;
            redRectangle.y = size;
            label = createLabel();
            redRectangle.addChild(label);
        }

        private function removeDefaultItems():void {
            myContextMenu.hideBuiltInItems();
            var defaultItems:ContextMenuBuiltInItems = myContextMenu.builtInItems;
            defaultItems.print = true;
        }

        private function addCustomMenuItems():void {
            var item:ContextMenuItem = new ContextMenuItem(menuLabel);
            myContextMenu.customItems.push(item);
            item.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, menuItemSelectHandler);
        }

        private function menuSelectHandler(event:ContextMenuEvent):void {
            trace("menuSelectHandler: " + event);
        }

        private function menuItemSelectHandler(event:ContextMenuEvent):void {
            trace("menuItemSelectHandler: " + event);
            var textColor:uint = (label.textColor == black) ? red : black;
            var bgColor:uint = (label.textColor == black) ? black : red;
            redRectangle.graphics.clear();
            redRectangle.graphics.beginFill(bgColor);
            redRectangle.graphics.drawRect(0, 0, size, size);
            label.textColor = textColor;
        }

        private function createLabel():TextField {
            var txtField:TextField = new TextField();
            txtField.text = textLabel;
            return txtField;
        }
    }
}