| 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):voidisMouseTargetInaccessible | 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):voidRelaterade 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):voidRelaterade 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
myContextMenudeklareras 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 arrayendefaultItemsmedpush()-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
myContextMenutill kontextmenyn för egenskapenredRectangleså 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
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper