Paketflash.events
Klassepublic class ContextMenuEvent
VererbungContextMenuEvent Inheritance Event Inheritance Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Flash® Player sendet ContextMenuEvent-Objekte, wenn ein Benutzer mit einem Kontextmenü interagiert oder ein Kontextmenü erzeugt. Benutzer erzeugen das Kontextmenü durch Klicken der sekundären Taste auf dem Zeigegerät (in der Regel eine Maus oder ein Trackball). Es gibt zwei Arten von ContextMenuEvent-Objekten:

Beispiele anzeigen

Siehe auch

ContextMenu-Klasse
ContextMenuItem-Klasse


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[read-only] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[read-only] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  contextMenuOwner : InteractiveObject
Das Anzeigelistenobjekt, dem das Menü zugeordnet ist.
ContextMenuEvent
 InheritedcurrentTarget : Object
[read-only] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[read-only] Die aktuelle Phase im Ereignisablauf.
Event
  mouseTarget : InteractiveObject
Das Anzeigelistenobjekt, auf das der Benutzer mit rechts geklickt hat, um das Kontextmenü anzuzeigen.
ContextMenuEvent
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
 Inheritedtarget : Object
[read-only] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[read-only] Der Typ des Ereignisses.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
ContextMenuEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, mouseTarget:InteractiveObject = null, contextMenuOwner:InteractiveObject = null)
Erstellt ein Ereignisobjekt, das bestimmte Informationen über Menüereignisse enthält.
ContextMenuEvent
  
Erstellt eine Kopie des ContextMenuEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
ContextMenuEvent
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion, mit der die toString()-Methode in Ihrer benutzerdefinierten Event-Klasse implementiert wird.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob "preventDefault()" im Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
  
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ContextMenuEvent-Objekts enthält.
ContextMenuEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
 InheritedACTIVATE : String = "activate"
[static] Definiert den Wert der Eigenschaft "type" eines activate-Ereignisobjekts.
Event
 InheritedADDED : String = "added"
[static] Definiert den Wert der Eigenschaft "type" eines added-Ereignisobjekts.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Definiert den Wert der Eigenschaft "type" eines addedToStage-Ereignisobjekts.
Event
 InheritedCANCEL : String = "cancel"
[static] Definiert den Wert der Eigenschaft type eines cancel-Ereignisobjekts.
Event
 InheritedCHANGE : String = "change"
[static] Definiert den Wert der Eigenschaft "type" eines change-Ereignisobjekts.
Event
 InheritedCLOSE : String = "close"
[static] Definiert den Wert der Eigenschaft "type" eines close-Ereignisobjekts.
Event
 InheritedCOMPLETE : String = "complete"
[static] Definiert den Wert der Eigenschaft "type" eines complete-Ereignisobjekts.
Event
 InheritedCONNECT : String = "connect"
[static] Definiert den Wert der Eigenschaft "type" eines connect-Ereignisobjekts.
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] Definiert den Wert der Eigenschaft "type" eines deactivate-Ereignisobjekts.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] Definiert den Wert der Eigenschaft "type" eines enterFrame-Ereignisobjekts.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] Definiert den Wert der Eigenschaft "type" eines fullScreen-Ereignisobjekts.
Event
 InheritedID3 : String = "id3"
[static] Definiert den Wert der Eigenschaft "type" eines id3-Ereignisobjekts.
Event
 InheritedINIT : String = "init"
[static] Definiert den Wert der Eigenschaft "type" eines init-Ereignisobjekts.
Event
  MENU_ITEM_SELECT : String = "menuItemSelect"
[static] Definiert den Wert der Eigenschaft "type" eines menuItemSelect-Ereignisobjekts.
ContextMenuEvent
  MENU_SELECT : String = "menuSelect"
[static] Definiert den Wert der Eigenschaft "type" eines menuSelect-Ereignisobjekts.
ContextMenuEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Definiert den Wert der Eigenschaft "type" eines mouseLeave-Ereignisobjekts.
Event
 InheritedOPEN : String = "open"
[static] Definiert den Wert der Eigenschaft "type" eines open-Ereignisobjekts.
Event
 InheritedREMOVED : String = "removed"
[static] Definiert den Wert der Eigenschaft type eines removed-Ereignisobjekts.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Definiert den Wert der Eigenschaft "type" eines removedFromStage-Ereignisobjekts.
Event
 InheritedRENDER : String = "render"
[static] Definiert den Wert der Eigenschaft "type" eines render-Ereignisobjekts.
Event
 InheritedRESIZE : String = "resize"
[static] Definiert den Wert der Eigenschaft type eines resize-Ereignisobjekts.
Event
 InheritedSCROLL : String = "scroll"
[static] Definiert den Wert der Eigenschaft type eines scroll-Ereignisobjekts.
Event
 InheritedSELECT : String = "select"
[static] Definiert den Wert der Eigenschaft type eines select-Ereignisobjekts.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Definiert den Wert der Eigenschaft "type" eines soundComplete-Ereignisobjekts.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Definiert den Wert der Eigenschaft "type" eines tabChildrenChange-Ereignisobjekts.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Definiert den Wert der Eigenschaft type eines tabEnabledChange-Ereignisobjekts.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Definiert den Wert der Eigenschaft "type" eines tabIndexChange-Ereignisobjekts.
Event
 InheritedUNLOAD : String = "unload"
[static] Definiert den Wert der Eigenschaft "type" eines unload-Ereignisobjekts.
Event
Eigenschaftsdetail
contextMenuOwnerEigenschaft
contextMenuOwner:InteractiveObject  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.


Implementierung
    public function get contextMenuOwner():InteractiveObject
    public function set contextMenuOwner(value:InteractiveObject):void
mouseTargetEigenschaft 
mouseTarget:InteractiveObject  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 einen seiner Nachfolger in der Anzeigeliste.


Implementierung
    public function get mouseTarget():InteractiveObject
    public function set mouseTarget(value:InteractiveObject):void
Konstruktordetail
ContextMenuEvent()Konstruktor
public function ContextMenuEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, mouseTarget:InteractiveObject = null, contextMenuOwner:InteractiveObject = null)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Parameter
type:String — Der Ereignistyp. Folgende Werte sind möglich:
  • ContextMenuEvent.MENU_ITEM_SELECT
  • ContextMenuEvent.MENU_SELECT
 
bubbles:Boolean (default = false) — Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen.
 
cancelable:Boolean (default = false) — Legt fest, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen.
 
mouseTarget:InteractiveObject (default = null) — Das Anzeigelistenobjekt, auf das der Benutzer mit rechts geklickt hat, um das Kontextmenü anzuzeigen. Hierbei kann es sich um contextMenuOwner oder um einen seiner Nachfolger in der Anzeigeliste handeln.
 
contextMenuOwner:InteractiveObject (default = null) — Das Anzeigelistenobjekt, dem das Menü zugeordnet ist. Hierbei kann es sich um mouseTarget oder um einen seinerer Vorgänger in der Anzeigeliste handeln.

Siehe auch

Methodendetail
clone()Methode
public override function clone():Event

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Rückgabewerte
Event — Ein neues ContextMenuEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.
toString()Methode 
public override function toString():String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 ]

Rückgabewerte
String — Eine Zeichenfolge, die alle Eigenschaften des ContextMenuEvent-Objekts enthält.
Konstantendetail
MENU_ITEM_SELECTKonstante
public static const MENU_ITEM_SELECT:String = "menuItemSelect"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Definiert den Wert der Eigenschaft type eines menuItemSelect-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
contextMenuOwnerDas Anzeigelistenobjekt, dem das Menü zugeordnet ist.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
mouseTargetDas Anzeigelistenobjekt, auf das der Benutzer mit rechts geklickt hat, um das Kontextmenü anzuzeigen.
targetDas ausgewählte ContextMenuItem-Objekt. Das Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

Siehe auch

MENU_SELECTKonstante 
public static const MENU_SELECT:String = "menuSelect"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Definiert den Wert der Eigenschaft type eines menuSelect-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
contextMenuOwnerDas Anzeigelistenobjekt, dem das Menü zugeordnet ist.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
mouseTargetDas Anzeigelistenobjekt, auf das der Benutzer mit rechts geklickt hat, um das Kontextmenü anzuzeigen.
targetDas ContextMenu-Objekt, das angezeigt werden soll. Das Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

Siehe auch

Beispiele Verwendung von Beispielen
ContextMenuEventExample.as

Im folgenden Beispiel wird die Klasse ContextMenuEventExample zur Entfernung des Standard-Kontextmenüs von der Bühne und zum Hinzufügen eines neuen Menüpunkts, mit dem die Farbe eines Quadrats auf der Bühne geändert wird, verwendet. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  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 lautet 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;
        }
    }
}




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/events/ContextMenuEvent.html