Paket | flash.events |
Klass | public class ContextMenuEvent |
Arv | ContextMenuEvent Event Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
-
ContextMenuEvent.MENU_ITEM_SELECT
-
ContextMenuEvent.MENU_SELECT
Relaterade API-element
Egenskap | Definieras med | ||
---|---|---|---|
bubbles : Boolean [skrivskyddad]
indikerar om händelsen är en bubblande händelse. | Event | ||
cancelable : Boolean [skrivskyddad]
Indikerar om beteendet som är kopplat till händelsen kan förhindras. | Event | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
contextMenuOwner : InteractiveObject
Visningslisteobjektet som menyn är kopplad till. | ContextMenuEvent | ||
currentTarget : Object [skrivskyddad]
Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. | Event | ||
eventPhase : uint [skrivskyddad]
Den nuvarande fasen i händelseflödet. | Event | ||
isMouseTargetInaccessible : Boolean
Anger om egenskapen mouseTarget sattes till null av säkerhetsskäl. | ContextMenuEvent | ||
mouseTarget : InteractiveObject
Visningslisteobjektet som användaren högerklickade på för att visa snabbmenyn. | ContextMenuEvent | ||
target : Object [skrivskyddad]
Händelsens mål. | Event | ||
type : String [skrivskyddad]
Händelsens typ. | Event |
Metod | Definieras med | ||
---|---|---|---|
ContextMenuEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, mouseTarget:InteractiveObject = null, contextMenuOwner:InteractiveObject = null)
Skapar ett nytt Event-objekt som innehåller specifik information om menyhändelser. | ContextMenuEvent | ||
[åsidosätt]
Skapar en kopia av ContextMenuEvent-objektet och ställer in värdet för alla egenskaper så att de matchar originalets egenskaper. | ContextMenuEvent | ||
Ett verktyg som används för att implementera metoden toString() i de anpassade klasserna ActionScript 3.0. | Event | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Kontrollerar om preventDefault()-metoden har anropats för händelsen. | Event | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Avbryter en händelses standardbeteende om det beteendet kan avbrytas. | Event | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Förhindrar behandling av händelsehanterare i den aktuella noden och alla noder som följer den aktuella noden i händelseflödet. | Event | ||
Förhindrar behandling av händelsehanterare i noder som följer den aktuella noden i händelseflödet. | Event | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
[åsidosätt]
Returnerar en sträng som innehåller alla egenskaper i ContextMenuEvent-objektet. | ContextMenuEvent | ||
Returnerar det angivna objektets primitiva värde. | Object |
Konstant | Definieras med | ||
---|---|---|---|
MENU_ITEM_SELECT : String = "menuItemSelect" [statisk]
Definierar värdet för menuItemSelect-händelseobjektets type-egenskap. | ContextMenuEvent | ||
MENU_SELECT : String = "menuSelect" [statisk]
Definierar värdet för menuSelect-händelseobjektets type-egenskap. | ContextMenuEvent |
contextMenuOwner | egenskap |
contextMenuOwner:InteractiveObject
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Visningslisteobjektet som menyn är kopplad till. Det här kan vara musmålet (mouseTarget
) eller en av dess underordnade i visningslistan.
Implementering
public function get contextMenuOwner():InteractiveObject
public function set contextMenuOwner(value:InteractiveObject):void
isMouseTargetInaccessible | egenskap |
isMouseTargetInaccessible:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 10 |
Anger om egenskapen mouseTarget
sattes till null
av säkerhetsskäl. Om det nominella värdet för menuTarget
är en referens till ett DisplayObject
i en annan säkerhetssandlåda, är menuTarget
satt till null
om det inte finns behörighet i båda riktningar över den här sandlådegränsen. Behörighet etableras genom att anropa Security.allowDomain()
från en SWF-fil, eller genom att tillhandahålla en principfil för en server för en bildfil och ställa in flaggan LoaderContext.checkPolicyFile
under inläsning av bilden.
Implementering
public function get isMouseTargetInaccessible():Boolean
public function set isMouseTargetInaccessible(value:Boolean):void
Relaterade API-element
mouseTarget | egenskap |
mouseTarget:InteractiveObject
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Visningslisteobjektet som användaren högerklickade på för att visa snabbmenyn. Det här kan vara det visningslisteobjekt som menyn är kopplad till (contextMenuOwner
) eller en av dess underordnade i visningslistan.
Värdet för den här egenskapen kan vara null
under två förhållanden: Om det inte finns något musmål, om du till exempel för musen över något från bakgrunden, eller om det finns ett musmål, men det finns i en säkerhetssandlåda som du inte har åtkomst till. Använd egenskapen isMouseTargetInaccessible()
för att avgöra vilken av dessa orsaker det är som gäller.
Implementering
public function get mouseTarget():InteractiveObject
public function set mouseTarget(value:InteractiveObject):void
Relaterade API-element
ContextMenuEvent | () | Konstruktor |
public function ContextMenuEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, mouseTarget:InteractiveObject = null, contextMenuOwner:InteractiveObject = null)
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Skapar ett nytt Event-objekt som innehåller specifik information om menyhändelser. Event-objekt skickas som parametrar till händelseavlyssnare.
Parametrartype:String — Händelsens typ. Möjliga värden är:
| |
bubbles:Boolean (default = false ) — Bestämmer om Event-objektet deltar i bubblingssteget av händelseflödet. Händelseavlyssnare kan hämta informationen genom den ärvda egenskapen bubbles .
| |
cancelable:Boolean (default = false ) — Avgör om Event-objektet kan avbrytas. Händelseavlyssnare kan hämta informationen genom den ärvda egenskapen cancelable .
| |
mouseTarget:InteractiveObject (default = null ) — Visningslisteobjektet som användaren högerklickade på för att visa snabbmenyn. Det här kan vara contextMenuOwner eller en av dess underordnade i visningslistan.
| |
contextMenuOwner:InteractiveObject (default = null ) — Visningslisteobjektet som menyn är kopplad till. Det här kan vara mouseTarget eller en av dess underordnade i visningslistan.
|
Relaterade API-element
clone | () | metod |
override public function clone():Event
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Skapar en kopia av ContextMenuEvent-objektet och ställer in värdet för alla egenskaper så att de matchar originalets egenskaper.
ReturnerarEvent — Ett nytt ContextMenuEvent-objekt med egenskapsvärden som matchar originalet.
|
toString | () | metod |
override public function toString():String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Returnerar en sträng som innehåller alla egenskaper i ContextMenuEvent-objektet. Strängen är i följande format:
[ContextMenuEvent type=värde bubbles=värde cancelable=värde ... contextMenuOwner=värde]
String — En sträng som innehåller alla ContextMenuEvent-objektets egenskaper.
|
MENU_ITEM_SELECT | Konstant |
public static const MENU_ITEM_SELECT:String = "menuItemSelect"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Definierar värdet för ett menuItemSelect
-händelseobjekts type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
contextMenuOwner | Visningslisteobjektet som menyn är kopplad till. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
mouseTarget | Visningslisteobjektet som användaren högerklickade på för att visa snabbmenyn. |
target | Det ContextMenuItem-objekt som har valts. Målet är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
Relaterade API-element
MENU_SELECT | Konstant |
public static const MENU_SELECT:String = "menuSelect"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Definierar värdet för ett menuSelect
-händelseobjekts type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
contextMenuOwner | Visningslisteobjektet som menyn är kopplad till. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
mouseTarget | Visningslisteobjektet som användaren högerklickade på för att visa snabbmenyn. |
target | Det ContextMenu-objekt som kommer att visas. Målet är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
Relaterade API-element
ContextMenuEventExample
för att ta bort standardkontextmenyposter från scenen och lägga till en ny menypost som ändrar färg på en fyrkant på scenen. I exemplen utförs följande uppgifter:
- Egenskapen
myContextMenu
deklareras och tilldelas sedan till ett nytt ContextMenu-objekt och egenskapenredRectangle
(av typen Sprite) deklareras. - Metoden
removeDefaultItems()
anropas. Med den här metoden tas alla inbyggda kontextmenyposter bort utom Print. - Metoden
addCustomMenuItems()
anropas. Med den här metoden sätts enReverse Colors
-menypost i arrayendefaultItems
medpush()
-metoden för Array. EnmenuItemSelect
-händelseavlyssnare läggs till ContextMenuItem-objektet och den kopplade metoden anropasmenuItemSelectHandler()
. Den här metoden skriver ut någratrace()
-satser när användaren väljer Reverse Colors från kontextmenyn. Dessutom blir den röda fyrkanten svart, och den svarta texten blir röd. - Tillbaka i konstruktorn läggs en
menuSelect
-händelseavlyssnare till, tillsammans med den kopplade metodenmenuSelectHandler()
, som enkelt skriver ut tretrace()
-satser varje gång användaren väljer en post i kontextmenyn. - Konstruktorn anropar
addChildren()
som ritar en röd fyrkant och lägger till den i visningslistan, som i sin tur omedelbart visar fyrkanten. - Till sist tilldelas
myContextMenu
till kontextmenyn för egenskapenredRectangle
så att den anpassade kontextmenyn bara visas när muspekaren är över fyrkanten.
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; } } }
Tue Jun 12 2018, 01:40 PM Z