InteractiveObject  - AS3

Den aktuella hjälpmedelsimplementeringen (AccessibilityImplementation) för den här InteractiveObject-instansen.

Relaterade API-element

Anger vilken snabbmeny som är associerad med det här objektet.

För innehåll som körs i Flash Player är denna egenskap ett ContextMenu-objekt. I AIR-körning täcker ContextMenu-klassen in NativeMenu-klassen. Flash Player stöder dock bara ContextMenu-klassen, inte NativeMenu-klassen.

Obs!: En urklippsmeny inkluderas alltid på snabbmenyn för TextField-objekt. Urklippsmenyn innehåller kommandona Klipp ut, Kopiera, Klistra in, Rensa och Markera alla. Du kan inte ta bort de här kommandona från snabbmenyn för TextField-objekt. För TextField-objekt genereras inga clear-, copy-, cut-, paste- eller selectAll-händelser när de här kommandona (eller motsvarande kortkommandon) väljs.

var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
 
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
 
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
 
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
    spr.graphics.clear();
    spr.graphics.beginFill(0xFF0000);
    spr.graphics.drawRect(0, 0, 120, 90);
    spr.graphics.endFill();
}

Anger om det här objektet tar emot doubleClick-händelser. Standardvärdet är false, vilket innebär att en InteractiveObject-instans inte tar emot doubleClick-händelser som standard. Om doubleClickEnabled-egenskapen står på true tar instansen emot doubleClick-händelser inom sina gränser. Egenskapen mouseEnabled för InteractiveObject-instansen måste också anges som true för att objektet ska ta emot doubleClick-händelser.

Ingen händelse skickas när denna egenskap sätts. Du måste använda addEventListener()-metoden för att lägga till en händelseavlyssnare för doubleClick-händelsen.

Relaterade API-element

Anger om det här objektet visar en fokusram. Den kan ta ett av tre värden: true, false eller null. Värdena true och false fungerar som förväntat och anger om fokusrektangeln visas eller inte. Ett värde på null anger att detta objekt lyder stageFocusRect-egenskapen i Stage.

Anger om det här objektet tar emot musmeddelanden eller annan indata från användaren. Standardvärdet är true, vilket innebär att varje InteractiveObject-instans som förekommer på visningslistan tar emot mushändelser eller andra indatahändelser från användaren som standard. Om mouseEnabled är inställt på false, tar instansen inte emot några mushändelser (eller andra indatahändelser från användaren, t.ex. tangentbordshändelser). Eventuella underordnade till denna instans i visningslistan påverkas inte. För att ändra mouseEnabled-beteendet för samtliga underordnade till ett objekt i visningslistan använder man flash.display.DisplayObjectContainer.mouseChildren.

Ingen händelse skickas när denna egenskap sätts. Du måste använda addEventListener()-metoden för att skapa interaktiv funktionalitet.

Relaterade API-element

Anger om ett virtuellt tangentbord (t.ex. ett skärmtangentbord) ska visas när den här InteractiveObject-instansen är i fokus.

Standardvärdet är false och fokusering på en InteractiveObject-instans visar inte ett skärmtangentbord. Om egenskapen needsSoftKeyboard är inställd på true visas ett skärmtangentbord vid körning när InteractiveObject-instansen är redo att ta emot indata från användaren. En InteractiveObject-instans är klar att acceptera indata från användaren efter ett programanrop för att ställa in scenens focus-egenskap eller en användarinteraktion, som exempelvis en "knackning." Om klientsystemet har ett reguljärt tangentbord tillgängligt eller om det inte har stöd för virtuella tangentbord, kommer skärmtangentbordet inte att visas.

Instansen InteractiveObject skickar softKeyboardActivating-, softKeyboardActivate- och softKeyboardDeactivate-händelser när skärmtangentbordet visas eller döljs.

Obs! Den här egenskapen stöds inte i AIR-program på iOS.

Relaterade API-element

Kontrollerar utseendet på skärmtangentbordet.

Enheter med skärmtangentbord kan anpassa tangentbordets knappar så att de motsvarar den typ av inmatning som förväntas. Om till exempel numeriska värden förväntas kan SoftKeyboardType.NUMBER användas på en enhet för att endast visa siffror på skärmtangentbordet. Giltiga värden definieras som konstanter i klassen SoftKeyboardType:

• "default"
• "punctuation"
• "url"
• "number"
• "contact"
• "email"
• "phone"
• "decimalpad"

Dessa värden är avsedda som tips som gör att en enhet visar det bästa tangentbordet för den aktuella tillämpningen.

Standardvärdet är SoftKeyboardType.DEFAULT.

Relaterade API-element

Definierar det område som ska behållas på skärmen när skärmtangentbordet visas (ej tillgängligt på iOS).

Om egenskapen needsSoftKeyboard för detta InteractiveObject är true, justerar körningen visningen efter behov för att hålla objektet i sikte medan användaren skriver. I vanliga fall använder körningen objektsgränserna som fås från metoden DisplayObject.getBounds(). Du kan ange ett annat område med hjälp av egenskapen softKeyboardInputAreaOfInterest.

Ange softKeyboardInputAreaOfInterest i scenkoordinaterna.

Obs! I Android är softKeyboardInputAreaOfInterest inte godkänt för liggande orientering.

Obs! softKeyboardInputAreaOfInterest stöds inte på iOS.

Relaterade API-element

Anger om det här objektet inkluderas i tabbordningen. Om detta värde är inkluderat i tabbordningen är värdet true, i annat fall är det false. Som standard är värdet false utom i följande fall:

• För ett SimpleButton-objekt är värdet true.
• För ett TextField-objekt med typ = "input" är värdet true.
• För ett Sprite-objekt eller MovieClip-objekt med buttonMode = true är värdet true.

Anger tabbordningen för objekt i en SWF-fil. tabIndex-egenskapen är -1 som standard, vilket innebär att inget tabbindexvärde läggs upp för objektet.

Om ett objekt som visas i SWF-filen innehåller en tabIndex-egenskap inaktiveras automatisk tabbordning. I stället beräknas tabbordningen från tabIndex-egenskaperna för objekten i SWF-filen. Den anpassade tabbordningen omfattar bara objekt som har tabIndex-egenskaper.

Egenskapen tabIndex måste vara ett positivt heltal. Objekten ordnas efter deras tabIndex-egenskaper i stigande ordning. Ett objekt med ett tabIndex-värde på 1 föregår ett objekt med ett tabIndex-värde på 2. Använd inte samma tabIndex-värde för flera objekt.

Den anpassade tabbordning som tabIndex-egenskapen definierar är flat. Det innebär att de hierarkiska förhållandena mellan objekt i SWF-filen inte har någon betydelse. Alla objekt i SWF-filen med tabIndex-egenskaper placeras i tabbordningen, som bestäms av ordningen för tabIndex-värden.

Obs! Om du vill ställa in tabbordningen för TLFTextField-instanser, ska du byta underordnat visningsobjekt för TLFTextField till ett InteractiveObject och sedan ställa in egenskapen tabIndex. Till exempel:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Anrop till konstruktorn new InteractiveObject() ger ett ArgumentError-undantag. Du kan emellertid anropa konstruktorer för följande underklasser till InteractiveObject:

• new SimpleButton()
• new TextField()
• new Loader()
• new Sprite()
• new MovieClip()

Visar ett virtuellt tangentbord.

När metoden anropas fokuseras InteractiveObject-instansen och skärmtangentbordet visas om det skulle behövas. Även needsSoftKeyboard måste vara true. Tangentbordet visas inte om ett reguljärt tangentbord finns tillgängligt eller om klientsystemet inte har stöd för virtuella trangentbord.

Obs! Den här metoden stöds inte i AIR-program på iOS.

Relaterade API-element

Skickas när användaren väljer ”Ta bort” på textinnehållsmenyn. Denna händelse skickas till det objekt som är i fokus för tillfället. Om objektet som för närvarande har fokus är ett TextField-objekt gör standardbeteendet för denna händelse att allt markerat innehåll i textfältet tas bort.

Den här händelsen har följande egenskaper:

Obs! TextField-objekt skickar inte clear-, copy-, cut-, paste- eller selectAll-händelser. TextField-objekt inkluderar alltid kommandona Klipp ut, Kopiera, Klistra in, Rensa och Markera allt på snabbmenyn. Du kan inte ta bort de här kommandona från snabbmenyn för TextField-objekt. För TextField-objekt genereras inga clear-, copy-, cut-, paste- eller selectAll-händelser när de här kommandona (eller motsvarande kortkommandon) väljs. Andra klasser som utökar InteractiveObject-klassen, bland annat komponenter som byggts med Flash Text Engine (FTE), skickar dock de här händelserna som svar på användaråtgärder som kortkommandon och snabbmenyer.

Skickas när en användare trycker ner och släpper upp huvudknappen på sitt pekdon över samma InteractiveObject. För att en klickhändelse ska ske måste den alltid följa denna händelsesekvens i rätt ordningsföljd: mouseDown-händelse följd av mouseUp. Målobjektet måste vara detsamma för bägge dessa händelser annars äger klickhändelsen inte rum. Valfritt antal andra mushändelser kan äga rum när som helst mellan mouseDown- eller mouseUp-händelsen – klickhändelsen äger ändå rum.

Den här händelsen har följande egenskaper:

Skickas när en användargest utlöser den snabbmeny som är kopplad till detta interaktiva objekt i ett AIR-program.

Den här händelsen har följande egenskaper:

Relaterade API-element

Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Kopiera eller väljer ”Kopiera” på snabbmenyn. Denna händelse skickas till det objekt som är i fokus för tillfället. Om objektet som för närvarande har fokus är ett TextField-objekt gör standardbeteendet för denna händelse att allt markerat innehåll i textfältet kopieras till urklipp.

Den här händelsen har följande egenskaper:

Obs! TextField-objekt skickar inte clear-, copy-, cut-, paste- eller selectAll-händelser. TextField-objekt inkluderar alltid kommandona Klipp ut, Kopiera, Klistra in, Rensa och Markera allt på snabbmenyn. Du kan inte ta bort de här kommandona från snabbmenyn för TextField-objekt. För TextField-objekt genereras inga clear-, copy-, cut-, paste- eller selectAll-händelser när de här kommandona (eller motsvarande kortkommandon) väljs. Andra klasser som utökar InteractiveObject-klassen, bland annat komponenter som byggts med Flash Text Engine (FTE), skickar dock de här händelserna som svar på användaråtgärder som kortkommandon och snabbmenyer.

Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Klipp ut eller väljer Klipp ut på snabbmenyn. Denna händelse skickas till det objekt som är i fokus för tillfället. Om objektet som för närvarande har fokus är ett TextField-objekt gör standardbeteendet för denna händelse att allt markerat innehåll i textfältet klipps ut till urklipp.

Den här händelsen har följande egenskaper:

Obs! TextField-objekt skickar inte clear-, copy-, cut-, paste- eller selectAll-händelser. TextField-objekt inkluderar alltid kommandona Klipp ut, Kopiera, Klistra in, Rensa och Markera allt på snabbmenyn. Du kan inte ta bort de här kommandona från snabbmenyn för TextField-objekt. För TextField-objekt genereras inga clear-, copy-, cut-, paste- eller selectAll-händelser när de här kommandona (eller motsvarande kortkommandon) väljs. Andra klasser som utökar InteractiveObject-klassen, bland annat komponenter som byggts med Flash Text Engine (FTE), skickar dock de här händelserna som svar på användaråtgärder som kortkommandon och snabbmenyer.

Skickas när en användare trycker ner och släpper upp huvudknappen på ett pekdon två gånger i snabb följd över samma InteractiveObject när detta objekts doubleClickEnabled-flagga är satt till true. För att en doubleClick-händelse ska äga rum måste den omedelbart följa följande händelsesekvens: mouseDown, mouseUp, click, mouseDown, mouseUp. Samtliga dessa händelser måste dela samma mål som doubleClick-händelsen. Den andra klickningen, som representeras av de andra mouseDown- ochmouseUp-händelserna, måste inträffa inom en bestämd tidsperiod efter click-händelsen. Denna periods tillåtna längd varierar beroende på operativsystemet och kan många gånger konfigureras av användaren. Om målet utgörs av ett valbart textfält markerar ordet under markören som standardbeteendet. Om det InteractiveObject som utgör målet inte sin doubleClickEnabled-flagga satt till true får den två click-händelser.

doubleClickEnabled-egenskapen sätts som standard till false.

Ett TextField-objekts textmarkeringsbeteende vid dubbelklickning har inget samband med doubleClick-händelsen. Använd TextField.doubleClickEnabled för att kontrollera TextField-valen.

Den här händelsen har följande egenskaper:

Relaterade API-element

Skickas när ett visningsobjekt fokuserats. Den här situationen uppträder när en användare markerar objektet med ett pekdon eller med tangentbordsnavigering. Mottagaren av sådan fokusering kallas för denna händelses målobjekt och motsvarande InteractiveObject-instans från denna senaste fokusering till följd av denna ändring kallas för det relaterade objektet. En referens till det relaterade objektet läggs in i det mottagande objektets relatedObject-egenskap. shiftKey-egenskapen används inte. Denna händelse följer på sändningen av det föregående objektets focusOut-händelse.

Den här händelsen har följande egenskaper:

Skickas när ett visningsobjekt tappar fokusering. Det här uppträder när en användare markerar ett annat objekt med ett pekdon eller med tangentbordsnavigering. Det objekt som tappar fokuseringen kallas för händelsens målobjekt och det den motsvarande InteractiveObject-instansen, som tar emot fokuseringen, kallas för det relaterade objektet. En referens till det relaterade objektet läggs in i målobjektets relatedObject-egenskap. shiftKey-egenskapen används inte. Den här händelsen föregår sändningen av focusIn-händelsen av det relaterade objektet.

Den här händelsen har följande egenskaper:

Skickas när användaren skapar en kontaktpunkt längs pekytans kant med en InteractiveObject-instans (såsom att trycka längs kanten av pekytan på Siri Remote för Apple-TV). Vissa enheter kan också tolka denna kontakt som en kombination av flera pekhändelser.

Närmare bestämt, om användaren rör ett finger över ett InteractiveObject och sedan tar bort fingret kan InteractiveObject-instansen skicka en touchBegin-händelse och en touchEnd-händelse (bland andra), såväl som gestureDirectionalTap-händelsen, eller så skickas alla om den aktuella miljön har stöd för det. Välj hur du vill hantera användarinteraktionen. Använd klassen flash.ui.Multitouch för att hantera beröringshändelser (aktivera händelsehantering för beröringsgester, händelsehantering för enkel beröringspunkt eller inaktivera beröringshändelser så att endast mushändelser skickas). Om du väljer att hantera touchBegin-händelsen körs samma händelsehanterare på en beröringsaktiverad enhet. Om du väljer att hantera gestureDirectionalTap-händelsen kan du utforma en egen händelsehanterare som svarar på specifika behov i den beröringskänsliga miljön och ger användarna en bättre upplevelse. Du kan också hantera båda händelserna separat om du vill skicka olika svar på gesthändelser och beröringshändelser. Men klassen flash.ui.Multitouch avgör om pek- eller gesthändelsen kommer att utlösas.

Lägg märke till att egenskaperna localX och localY är inställda på den primära kontaktpunkten vid hantering av egenskaperna för händelseobjektet (för Apple TV är den i mitten av skärmen). Egenskaperna offsetX och offsetY motsvarar gestens riktning.

Obs! Detta API har bara stöd för riktningstryck med ett finger.

Det skickade TransformGestureEvent-objektet har följande egenskaper:

Relaterade API-element

Skickas när användaren trycker på två kontaktpunkter över samma InteractiveObject-instans på en beröringsaktiverad enhet (som att trycka med två fingrar och sedan släppa dem över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). Vissa enheter kan även tolka detta som en doubleClick-händelse.

I synnerhet om användaren placerar två fingrar över ett InteractiveObject kan InteractiveObject-instansen skicka en doubleClick-händelse eller en gestureTwoFingerTap-händelse eller både och om miljön tillåter det. Välj hur du vill hantera användarinteraktionen. Använd klassen flash.ui.Multitouch för att hantera beröringshändelser (aktivera händelsehantering för beröringsgester, händelsehantering för enkel beröringspunkt eller inaktivera beröringshändelser så att endast mushändelser skickas). Om du väljer att hantera doubleClick-händelsen körs samma händelsehanterare på en beröringsaktiverad enhet och en musaktiverad enhet. Om du väljer att hantera gestureTwoFingerTap-händelsen kan du utforma en egen händelsehanterare som svarar på specifika behov i den beröringskänsliga miljön och ger användarna en bättre upplevelse. Du kan också hantera båda händelserna separat om du vill skicka olika svar på beröringshändelser och mushändelser.

Obs! Avsnittet om klassen Multitouch innehåller information om miljökompatibilitet.

Relaterade API-element

Skickas när användaren flyttar en kontaktpunkt över InteractiveObject-instansen på en beröringsaktiverad enhet (som att flytta ett finger från vänster till höger över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). Vissa enheter kan även tolka detta som en mouseOver-händelse eller en touchOver-händelse.

I synnerhet om användaren flyttar ett finger över ett InteractiveObject kan InteractiveObject-instansen skicka en mouseOver-händelse, en touchOver-händelse eller en gesturePan-händelse eller så skickas alla händelser om miljön tillåter det. Välj hur du vill hantera användarinteraktionen. Använd klassen flash.ui.Multitouch för att hantera beröringshändelser (aktivera händelsehantering för beröringsgester, händelsehantering för enkel beröringspunkt eller inaktivera beröringshändelser så att endast mushändelser skickas). Om du väljer att hantera mouseOver-händelsen körs samma händelsehanterare på en beröringsaktiverad enhet och en musaktiverad enhet. Om du väljer att hantera gesturePan-händelsen kan du utforma en egen händelsehanterare som svarar på specifika behov i den beröringskänsliga miljön och ger användarna en bättre upplevelse. Du kan också hantera båda händelserna separat om du vill skicka olika svar på beröringshändelser och mushändelser.

Obs! Avsnittet om klassen Multitouch innehåller information om miljökompatibilitet.

Det skickade TransformGestureEvent-objektet har följande egenskaper:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onPan(evt:TransformGestureEvent):void {

    evt.target.localX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Relaterade API-element

Skickas när användaren utför en rotationsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med två fingrar och rotera dem över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). Att rotera två fingrar är en vanlig rotationsgest, men varje enhet och operativsystem har egna regler hur rotation ska anges. Vissa enheter kan också tolka den här kontakten som en kombination av flera mushändelser.

I synnerhet om användaren flyttar ett finger över ett InteractiveObject kan InteractiveObject-instansen skicka en mouseOver-händelse och en click-händelse (bland annat), i tillägg till gestureRotate-händelsen eller så skickas alla händelser om miljön tillåter det. Välj hur du vill hantera användarinteraktionen. Använd klassen flash.ui.Multitouch för att hantera beröringshändelser (aktivera händelsehantering för beröringsgester, händelsehantering för enkel beröringspunkt eller inaktivera beröringshändelser så att endast mushändelser skickas). Om du väljer att hantera mouseOver-händelsen körs samma händelsehanterare på en beröringsaktiverad enhet och en musaktiverad enhet. Om du väljer att hantera gestureRotate-händelsen kan du utforma en egen händelsehanterare som svarar på specifika behov i den beröringskänsliga miljön och ger användarna en bättre upplevelse. Du kan också hantera båda händelserna separat om du vill skicka olika svar på beröringshändelser och mushändelser.

Lägg märke till att egenskaperna localX och localY är inställda på den primära kontaktpunkten vid hantering av egenskaperna för händelseobjektet. Egenskaperna offsetX och offsetY anger avståndet till kontaktpunkten där rotationsgesten slutförs.

Obs! Avsnittet om klassen Multitouch innehåller information om miljökompatibilitet.

Under den här händelsen innehåller egenskapen rotation rotationsvinkeln. Rotationsvärdena är som följer:

• 0 till 180 grader för medsols riktning
• -180 till 0 grader för motsols riktning

Det skickade TransformGestureEvent-objektet har följande egenskaper:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onRotate(evt:TransformGestureEvent):void {

    evt.target.rotation -= 45;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Relaterade API-element

Skickas när användaren utför en svepningsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med tre fingrar och sedan flytta fingrarna parallellt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). Att röra flera fingrar parallellt är en vanlig svepningsgest, men alla enheter och operativsystem har egna regler för svepningar. Vissa enheter kan också tolka den här kontakten som en kombination av flera mushändelser.

Närmare bestämt, om användaren flyttar ett finger över ett InteractiveObject och sedan för samman fingrarna kan InteractiveObject-instansen skicka en rollOver-händelse och en rollOut-händelse (bland annat), utöver gestureZoom-händelsen, eller så skickas alla händelser om miljön tillåter det. Välj hur du vill hantera användarinteraktionen. Om du väljer att hantera rollOver-händelsen körs samma händelsehanterare på en beröringsaktiverad enhet och en musaktiverad enhet. Om du väljer att hantera gestureSwipe-händelsen kan du utforma en egen händelsehanterare som svarar på specifika behov i den beröringskänsliga miljön och ger användarna en bättre upplevelse. Du kan också hantera båda händelserna separat om du vill skicka olika svar på beröringshändelser och mushändelser.

Lägg märke till att egenskaperna localX och localY är inställda på den primära kontaktpunkten vid hantering av egenskaperna för händelseobjektet. Egenskaperna offsetX och offsetY anger avståndet till kontaktpunkten där svepningsgesten slutförs.

Obs! Även om vissa enheter med operativsystemet Mac OS kan tolka en fyrfingersvepning har det här gränssnittet bara stöd för trefingersvepning.

Det skickade TransformGestureEvent-objektet har följande egenskaper:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onSwipe(evt:TransformGestureEvent):void {

    if (evt.offsetX == 1 ) {
    myTextField.text = "right";
    }
    if (evt.offsetY == -1) {
    myTextField.text = "up";
    }
    myTextField.text = evt.phase;

}

Relaterade API-element

Skickas när användaren skapar en kontaktpunkt med en InteractiveObject-instans och sedan vidrör en beröringsaktiverad enhet (som att placera flera fingrar över ett visningsobjekt för att öppna en meny och sedan använda ett finger för att peka på ett menyalternativ på en mobiltelefon eller bärbar dator med pekskärm). Vissa enheter kan också tolka den här kontakten som en kombination av flera mushändelser.

I synnerhet om användaren flyttar ett finger över ett InteractiveObject och sedan trycker kan InteractiveObject-instansen skicka en mouseOver-händelse och en click-händelse (bland annat), i tillägg till gesturePressAndTap-händelsen eller så skickas alla händelser om miljön tillåter det. Välj hur du vill hantera användarinteraktionen. Använd klassen flash.ui.Multitouch för att hantera beröringshändelser (aktivera händelsehantering för beröringsgester, händelsehantering för enkel beröringspunkt eller inaktivera beröringshändelser så att endast mushändelser skickas). Om du väljer att hantera mouseOver-händelsen körs samma händelsehanterare på en beröringsaktiverad enhet och en musaktiverad enhet. Om du väljer att hantera gesturePressAndTap-händelsen kan du utforma en egen händelsehanterare som svarar på specifika behov i den beröringskänsliga miljön och ger användarna en bättre upplevelse. Du kan också hantera båda händelserna separat om du vill skicka olika svar på beröringshändelser och mushändelser.

Lägg märke till att egenskaperna localX och localY är inställda på den primära kontaktpunkten vid hantering av egenskaperna för händelseobjektet ("push"). Egenskaperna offsetX och offsetY anger avståndet till den sekundära kontaktpunkten (tryckningen).

Relaterade API-element

Skickas när användaren utför en zoomningsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med två fingrar och sedan snabbt sära på fingrarna över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). Att dra fingrarna isär är en vanlig zoomgest, men varje enhet och operativsystem har sina egna regler hur zoom anges. Vissa enheter kan också tolka den här kontakten som en kombination av flera mushändelser.

I synnerhet om användaren flyttar ett finger över ett InteractiveObject och sedan drar isär fingrarna kan InteractiveObject-instansen skicka en mouseOver-händelse och en click-händelse (bland annat), i tillägg till gestureZoom-händelsen eller så skickas alla händelser om miljön tillåter det. Välj hur du vill hantera användarinteraktionen. Använd klassen flash.ui.Multitouch för att hantera beröringshändelser (aktivera händelsehantering för beröringsgester, händelsehantering för enkel beröringspunkt eller inaktivera beröringshändelser så att endast mushändelser skickas). Om du väljer att hantera mouseOver-händelsen körs samma händelsehanterare på en beröringsaktiverad enhet och en musaktiverad enhet. Om du väljer att hantera gestureZoom-händelsen kan du utforma en egen händelsehanterare som svarar på specifika behov i den beröringskänsliga miljön och ger användarna en bättre upplevelse. Du kan också hantera båda händelserna separat om du vill skicka olika svar på beröringshändelser och mushändelser.

Lägg märke till att egenskaperna localX och localY är inställda på den primära kontaktpunkten vid hantering av egenskaperna för händelseobjektet. Egenskaperna offsetX och offsetY anger avståndet till kontaktpunkten där zoomgesten slutförs.

Obs! Avsnittet om klassen Multitouch innehåller information om miljökompatibilitet.

Det skickade TransformGestureEvent-objektet har följande egenskaper:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onZoom(evt:TransformGestureEvent):void {

    evt.target.scaleX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Relaterade API-element

Den här händelsen skickas till alla klientprogram som har stöd för indata via ett redigeringsprogram för inmatningsmetoder (IME).

Skickas när användaren trycker på en tangent. Mappning mellan tangenter och specifika tecken varierar mellan olika utrustningar och operativsystem. Denna händelsetyp genereras efter det att sådan mappning sker, men före behandling av ett redigeringsprogram för inmatningsmetoder (IME). IME-program används för att lägga in tecken som det vanliga QWERTY-tangentbordet inte lämpar sig för, exempelvis kinesiska ideogram. Denna händelse inträffar före keyUp-händelsen.

I AIR går det inte att skriva tecknet i ett textfält om händelsen avbryts.

Den här händelsen har följande egenskaper:

Skickas när användaren försöker att ändra fokuseringen med tangentbordsnavigering. Denna händelses standardbeteende är att flytta fokus och skicka motsvarande focusIn och focusOut-händelser.

Denna händelse skickas till det objekt som är i fokus för tillfället. Denna händelses relaterade objekt är den InteractiveObject-händelse som får fokus om du inte förhindrar standardbeteendet. Du kan förhindra fokusändringen genom att anropa preventDefault()-metoden i en händelseavlyssnare som är korrekt registrerad för målobjektet. Fokus förflyttas och focusIn och focusOut-händelserna skickas som standard.

Den här händelsen har följande egenskaper:

Skickas när användaren släpper upp en tangent. Mappning mellan tangenter och specifika tecken varierar mellan olika utrustningar och operativsystem. Denna händelsetyp genereras efter det att sådan mappning sker, men före behandling av ett redigeringsprogram för inmatningsmetoder (IME). IME-program används för att lägga in tecken som det vanliga QWERTY-tangentbordet inte lämpar sig för, exempelvis kinesiska ideogram. Denna händelse inträffar efter en keyDown-händelse och har följande karakteristika:

Den här händelsen har följande egenskaper:

Skickas när en användare trycker ned och släpper upp mittenknappen på sitt pekdon över samma InteractiveObject. För att en middleClick-händelse ska ske måste den alltid följa denna händelsesekvens i rätt ordningsföljd: middleMouseDown-händelsen, sedan middleMouseUp. Målobjektet måste vara detsamma för bägge dessa händelser; annars äger middleClick-händelsen inte rum. Valfritt antal andra mushändelser kan äga rum när som helst mellan middleMouseDown eller middelMouseUp-händelserna – middleClick-händelsen äger ändå rum.

Den här händelsen har följande egenskaper:

Skickas när en användare trycker på pekdonets mittenknapp över en InteractiveObject-instans.

Den här händelsen har följande egenskaper:

Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans.

Den här händelsen har följande egenskaper:

Skickas när en användare trycker på pekdonets knapp över en InteractiveObject-instans. Om målet är en SimpleButton-instans visar SimpleButton-instansen downState-visningsobjektet som standardbeteendet. Om målet utgörs av ett valbart textfält inleder textfältet valet som standardbeteendet.

Den här händelsen har följande egenskaper:

Skickas när användaren försöker att ändra fokuseringen med ett pekdon. Denna händelses standardbeteende är att flytta fokus och skicka motsvarande focusIn och focusOut-händelser.

Denna händelse skickas till det objekt som är i fokus för tillfället. Denna händelses relaterade objekt är den InteractiveObject-händelse som får fokus om du inte förhindrar standardbeteendet. Du kan förhindra fokusändringen genom att anropa preventDefault() i en händelseavlyssnare som är korrekt registrerad för målobjektet. shiftKey-egenskapen används inte. Fokus förflyttas och focusIn och focusOut-händelserna skickas som standard.

Den här händelsen har följande egenskaper:

Skickas när en användare flyttar pekdonet när det befinner sig över ett InteractiveObject. Om målet är ett textfält som användaren väljer uppdateras valet som standardbeteendet.

Den här händelsen har följande egenskaper:

Skickas när användaren flyttar bort pekdonet från en InteractiveObject-instans. Händelsemålet är det objekt som för tillfället befinner sig under pekdonet. relatedObject är det objekt pekdonet har flyttat till. Om målet är en SimpleButton-instans visar knappen upState-visningsobjektet som standardbeteendet.

mouseOut-händelsen skickas varje gång musen lämnar ett underordnat objekts område i visningsobjektbehållaren, även om musen fortfarande befinner sig över ett annat underordnat objekt till visningsobjektbehållaren. Detta är inte samma beteende som rollOut-händelsen, som är avsedd att underlätta kodningen av rolloverbeteenden för visningsobjektbehållare med underordnade. När musen lämnar ett visningsobjekts område, eller något av dess underordnades områden, för att gå till ett objekt som inte är ett av de underordnade, skickar visningsobjektet rollOut-händelsen. rollOut-händelser skickas efter varandra uppför den överordnade kedjan för objektet, med början med objektet och slut med den högsta överordnade mottagaren som vare sig är roten eller en indirekt överordnad till relatedObject.

Den här händelsen har följande egenskaper:

Skickas när användaren flyttar pekdonet över en InteractiveObject-instans. relatedObject är det objekt som för tillfället befinner sig under pekdonet. Om målet är en SimpleButton-instans visar objektet overState- eller upState-visningsobjektet, beroende på om musknappen är nedtrycket eller inte, som standardbeteendet.

mouseOver-händelsen skickas varje gång musen kommer in på ett underordnat objekts område i visningsobjektbehållaren, även om musen redan befann sig över ett annat underordnat objekt till visningsobjektbehållaren. Detta är inte samma beteende som rollOver-händelsen, som är avsedd att underlätta kodningen av rolloutbeteenden för visningsobjektbehållare med underordnade. När musen kommer in i ett visningsobjekts område eller något av dess underordnades områden från ett objekt som inte är ett av de underordnade, skickar visningsobjektet rollOver-händelsen. rollOver-händelser skickas efter varandra nedför den överordnade kedjan för objektet, med början med objektet och slut med den högsta överordnade mottagaren som vare sig är roten eller en indirekt överordnad till relatedObject och slutar med objektet.

Den här händelsen har följande egenskaper:

Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans. Om målet är en SimpleButton-instans visar objektet upState-visningsobjektet. Om målet utgörs av ett valbart textfält avslutar textfältet valet som standardbeteendet.

Den här händelsen har följande egenskaper:

Skickas när mushjulet rullas över en InteractiveObject-instans. Om målet utgörs av ett textfält rullas texten som i standardbeteendet. Endast tillgängligt i Microsoft Windows operativsystem.

Den här händelsen har följande egenskaper:

Skickas av drag initiator InteractiveObject när användaren släpper dragrörelsen.

Händelsens dropAction-egenskap indikerar åtgärden som har ställts in av drag target-objektet; ett värde på "none" (DragActions.NONE) indikerar att släppningen avbröts eller att den inte accepterades.

Händelsehanteraren nativeDragComplete är en praktisk plats att uppdatera tillståndet för det initierande visningsobjektet, till exempel genom att ta bort ett objekt från en lista (i drag-åtgärden "move") eller genom att ändra visuella egenskaper.

Den här händelsen har följande egenskaper:

Skickas av ett InteractiveObject-målobjekt när ett objekt dras till målobjektet och dragningen har accepterats med ett anrop till DragManager.acceptDragDrop().

Du kan komma åt släppta data med event object clipboard-egenskapen.

Hanteraren för denna händelse ska ställa in DragManager.dropAction-egenskapen så att den skickar feedback till initieraren om vilken dragning som utfördes. Om inget värde anges kommer DragManager att välja ett standardvärde ur listan med tillåtna åtgärder.

Den här händelsen har följande egenskaper:

Skickas av ett InteractiveObject-objekt när en dragrörelse går in i dess gränser.

Hantera antingen nativeDragEnter eller nativeDragOver-händelserna så att visningsobjektet kan vara målet för släppningen.

För att avgöra om det skickande visningsobjektet kan acceptera släppningen ska du kontrollera datalämpligheten i clipboard-egenskapen i event-objektet och tillåtna drag-åtgärder i allowedActions-egenskapen.

Den här händelsen har följande egenskaper:

Skickas av ett InteractiveObject-objekt när en dragrörelse går utanför dess gränser.

Den här händelsen har följande egenskaper:

Skickas kontinuerligt av ett InteractiveObject-objekt när en dragrörelse pågår inom dess gränser.

nativeDragOver-händelser skickas när musen flyttas. På Windows och Mac skickas de också med ett kort tidsintervall även när musen inte flyttas.

Hantera antingen nativeDragOver- eller nativeDragEnter-händelserna så att visningsobjektet kan vara målet för släppningen.

För att avgöra om det skickande visningsobjektet kan acceptera släppningen ska du kontrollera datalämpligheten i clipboard-egenskapen i event-objektet och tillåtna drag-åtgärder i allowedActions-egenskapen.

Den här händelsen har följande egenskaper:

Skickas i början av en dragning av det InteractiveObject-objekt som anges som dragningsinitierare i DragManager.doDrag()-anropet.

Den här händelsen har följande egenskaper:

Skickas under en dragning av det InteractiveObject-objekt som anges som dragningsinitierare i DragManager.doDrag()-anropet.

nativeDragUpdate-händelser skickas inte i Linux.

Den här händelsen har följande egenskaper:

Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Klistra in eller väljer Klistra in på snabbmenyn. Denna händelse skickas till det objekt som är i fokus för tillfället. Om objektet som för närvarande har fokus är ett TextField-objekt gör standardbeteendet för denna händelse att allt innehåll i urklipp klistras in i textfältet vid den aktuella insättningspunkten. Eventuell markerad text ersätts i textfältet.

Den här händelsen har följande egenskaper:

Obs! TextField-objekt skickar inte clear-, copy-, cut-, paste- eller selectAll-händelser. TextField-objekt inkluderar alltid kommandona Klipp ut, Kopiera, Klistra in, Rensa och Markera allt på snabbmenyn. Du kan inte ta bort de här kommandona från snabbmenyn för TextField-objekt. För TextField-objekt genereras inga clear-, copy-, cut-, paste- eller selectAll-händelser när de här kommandona (eller motsvarande kortkommandon) väljs. Andra klasser som utökar InteractiveObject-klassen, bland annat komponenter som byggts med Flash Text Engine (FTE), skickar dock de här händelserna som svar på användaråtgärder som kortkommandon och snabbmenyer.

Skickas när användaren sänker en aktiv penna förbi skärmens upptäcktströskel.

En vanlig händelsesekvens som inträffar när en användare sänker en penna ner mot skärmen, flyttar den över skärmen eller lyfter bort den är:

• proximityBegin
• proximityMove
• touchBegin
• touchMove
• touchEnd
• proximityMove
• proximityEnd

Obs! Avsnittet om klassen Multitouch innehåller information om miljökompatibilitet.

Det skickade TouchEvent-objektet har följande egenskaper:

Relaterade API-element

Skickas när användaren lyfter en aktiv penna över skärmens upptäcktströskel.

En proximityEnd-händelse skickas inte när pennan vidrör skärmen.

En vanlig händelsesekvens som inträffar när en användare sänker en penna ner mot skärmen, flyttar den över skärmen eller lyfter bort den är:

• proximityBegin
• proximityMove
• touchBegin
• touchMove
• touchEnd
• proximityMove
• proximityEnd

Obs! Avsnittet om klassen Multitouch innehåller information om miljökompatibilitet.

Det skickade TouchEvent-objektet har följande egenskaper:

Relaterade API-element

Skickas när användaren flyttar en aktiv penna över skärmen medan den behålls inom skärmens upptäcktströskel.

En vanlig händelsesekvens som inträffar när en användare sänker en penna ner mot skärmen, flyttar den över skärmen eller lyfter bort den är:

• proximityBegin
• proximityMove
• touchBegin
• touchMove
• touchEnd
• proximityMove
• proximityEnd

Obs! Avsnittet om klassen Multitouch innehåller information om miljökompatibilitet.

Det skickade TouchEvent-objektet har följande egenskaper:

Relaterade API-element

Skickas när användaren flyttar en aktiv penna bort från detta InteractiveObject medan den behålls inom skärmens upptäcktströskel.

Obs! Avsnittet om klassen Multitouch innehåller information om miljökompatibilitet.

Det skickade TouchEvent-objektet har följande egenskaper:

Relaterade API-element

Skickas när användaren flyttar en aktiv penna direkt över detta InteractiveObject medan den behålls inom skärmens upptäcktströskel.

Obs! Avsnittet om klassen Multitouch innehåller information om miljökompatibilitet.

Det skickade TouchEvent-objektet har följande egenskaper:

Relaterade API-element

Skickas när användaren flyttar en aktiv penna bort från detta InteractiveObject och något av dess underordnade objekt medan den behålls inom skärmens upptäcktströskel.

Händelsemålet är det objekt som tidigare befann sig under pennan eller en överordnad till det objektet. relatedObject är det objekt pennan har flyttats till. proximityRollOut-händelser skickas efter varandra uppför den överordnade kedjan för objektet, med början med objektet och slut med den högsta överordnade mottagaren, som varken är roten eller en indirekt överordnad till relatedObject.

Syftet med proximityRollOut-händelsen är att underlätta kodningen av rollover-beteenden för visningsobjektbehållare med underordnade. När pennan lämnar ett visningsobjekts område eller något av dess underordnades områden, för att gå till ett objekt som inte är ett av de underordnade, skickar visningsobjektet proximityRollOut-händelsen. Detta är ett annat beteende än det hos proximityOut-händelsen, som skickas varje gång musen lämnar ett underordnat objekts område i visningsobjektbehållaren, även om musen blir kvar över ett annat underordnat objekt till visningsobjektbehållaren.

Obs! Avsnittet om klassen Multitouch innehåller information om miljökompatibilitet.

Det skickade TouchEvent-objektet har följande egenskaper:

Relaterade API-element

Skickas när användaren flyttar en aktiv penna över detta InteractiveObject från utsidan av objektets underordnade träd i visningslistan (men stannar kvar inom skärmens upptäcktströskel).

Händelsemålet är det objekt som befann sig under pennan eller en överordnad till det objektet. Objektet relatedObject är det objekt som för tillfället befinner sig under pennan. proximityRollOver-händelser skickas efter varandra nedför den överordnade kedjan för objektet, med början med objektet och slut med den högsta överordnade mottagaren som vare sig är roten eller en indirekt överordnad till relatedObject och slutar med objektet.

Syftet med proximityRollOver-händelsen är att underlätta kodningen av rollover-beteenden för visningsobjektbehållare med underordnade. När pennan kommer över ett visningsobjekts område eller något av dess underordnades områden, från ett objekt som inte är ett av de underordnade, skickar visningsobjektet proximityRollOver-händelsen. Detta är ett annat beteende än det hos proximityOver-händelsen, som skickas varje gång musen kommer in på ett underordnat objekts område i visningsobjektbehållaren, även om musen redan befann sig över ett annat underordnat objekt till visningsobjektbehållaren.

Obs! Avsnittet om klassen Multitouch innehåller information om miljökompatibilitet.

Det skickade TouchEvent-objektet har följande egenskaper:

Relaterade API-element

Skickas när användaren släpper knappen på pekaren efter att första ha tryckt på den över en InteractiveObject-instans och sedan flyttat pekaren bort från InteractiveObject-instansen. Om målet är en SimpleButton-instans visar objektet upState-visningsobjektet. Om målet utgörs av ett valbart textfält avslutar textfältet valet som standardbeteendet.

Den här händelsen har följande egenskaper:

Skickas när en användare trycker ned och släpper upp högerknappen på sitt pekdon över samma InteractiveObject. För att en rightClick-händelse ska ske måste den alltid följa denna händelsesekvens i rätt ordningsföljd: rightMouseDown-händelsen, sedan rightMouseUp. Målobjektet måste vara detsamma för bägge dessa händelser; annars äger rightClick-händelsen inte rum. Valfritt antal andra mushändelser kan äga rum när som helst mellan rightMouseDown eller rightMouseUp-händelserna – rightClick-händelsen äger ändå rum.

Den här händelsen har följande egenskaper:

Skickas när en användare trycker på pekdonets knapp över en InteractiveObject-instans.

Den här händelsen har följande egenskaper:

Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans.

Den här händelsen har följande egenskaper:

Skickas när användaren flyttar bort pekdonet från en InteractiveObject-instans. Händelsemålet är det objekt som tidigare befann sig under pekdonet, eller en överordnad till det objektet. relatedObject är det objekt pekdonet har flyttat till. rollOut-händelser skickas efter varandra uppför den överordnade kedjan för objektet, med början med objektet och slut med den högsta överordnade mottagaren som vare sig är roten eller en indirekt överordnad till relatedObject.

Syftet med rollOut-händelsen är att underlätta kodningen av rolloverbeteenden för visningsobjektbehållare med underordnade. När musen lämnar ett visningsobjekts område eller något av dess underordnades områden, för att gå till ett objekt som inte är ett av de underordnade, skickar visningsobjektet rollOut-händelsen. Detta är ett annat beteende än det hos mouseOut-händelsen, som skickas varje gång musen lämnar ett underordnat objekts område i visningsobjektbehållaren, även om musen blir kvar över ett annat underordnat objekt till visningsobjektbehållaren.

Den här händelsen har följande egenskaper:

Skickas när användaren flyttar pekdonet över en InteractiveObject-instans. Händelsemålet är det objekt som befann sig under pekdonet, eller en överordnad till det objektet. relatedObject är det objekt som för tillfället befinner sig under pekdonet. rollOver-händelser skickas efter varandra nedför den överordnade kedjan för objektet, med början med objektet och slut med den högsta överordnade mottagaren som vare sig är roten eller en indirekt överordnad till relatedObject och slutar med objektet.

Syftet med rollOver-händelsen är att underlätta kodningen av rolloverbeteenden för visningsobjektbehållare med underordnade. När musen kommer in i ett visningsobjekts område eller något av dess underordnades områden från ett objekt som inte är ett av de underordnade, skickar visningsobjektet rollOver-händelsen. Detta är ett annat beteende än det hos mouseOver-händelsen, som skickas varje gång musen kommer in på ett underordnat objekts område i visningsobjektbehållaren, även om musen redan befann sig över ett annat underordnat objekt till visningsobjektbehållaren.

Den här händelsen har följande egenskaper: