InteractiveObject  - AS3

De huidige toegankelijkheidsimplementatie (AccessibilityImplementation) voor deze InteractiveObject-instantie.

Verwante API-elementen

Geeft het contextmenu op dat is gekoppeld aan dit object.

Voor inhoud die in Flash Player wordt uitgevoerd is deze eigenschap een object ContextMenu. In de AIR-runtime breidt de klasse ContextMenu de klasse NativeMenu uit, maar Flash Player ondersteunt alleen de klasse ContextMenu, niet de klasse NativeMenu.

Opmerking: TextField-objecten bevatten in het contextmenu altijd een klembordmenu. Het klembordmenu bevat de opdrachten Knippen, Kopiëren, Plakken, Wissen en Alles selecteren. U kunt deze opdrachten niet uit het contextmenu voor TextField-objecten verwijderen. Wanneer u voor TextField-objecten deze opdrachten (of hun equivalenten op het toetsenbord) selecteert, leidt dit niet tot het genereren van de gebeurtenissen clear, copy, cut, paste of selectAll.

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();
}

Geeft op of het object gebeurtenissen doubleClick ontvangt. De standaardwaarde is false. Dit betekent dat een instantie InteractiveObject standaard geen gebeurtenissen doubleClick ontvangt. Wanneer de eigenschap doubleClickEnabled is ingesteld op true, ontvangt de instantie gebeurtenissen doubleClick binnen de grenzen. Wanneer de eigenschap mouseEnabled van de instantie InteractiveObject tevens is ingesteld op true, kan het object gebeurtenissen doubleClick ontvangen.

Bij het instellen van deze eigenschap wordt geen gebeurtenis verzonden. U kunt een gebeurtenislistener toevoegen voor de gebeurtenis doubleClick met de methode addEventListener().

Verwante API-elementen

Geeft op of dit object een focusrechthoek weergeeft. Deze kan een van de volgende drie waarden hebben: true, false of null. De waarden true en false werken zoals wordt verwacht, en bepalen of de driehoek met de focus al dan niet wordt weergegeven. De waarde null geeft aan dat dit object is onderworpen aan de eigenschap stageFocusRect van het werkgebied.

Geeft aan of dit object berichten van de muis of gebruikersinvoer ontvangt. De standaardwaarde is true. Dit betekent dat iedere instantie InteractiveObject die in het weergaveoverzicht voorkomt, standaard muisgebeurtenissen of andere gebruikersinvoergebeurtenissen ontvangt. Als mouseEnabled op false is ingesteld, ontvangt de instantie geen muisgebeurtenissen (of andere gebruikersinvoergebeurtenissen zoals toetsenbordgebeurtenissen). De onderliggende items van deze instantie in het weergaveoverzicht worden niet beïnvloed. U kunt de werking van mouseEnabled voor alle onderliggende items van een object uit het weergaveoverzicht wijzigen met flash.display.DisplayObjectContainer.mouseChildren.

Bij het instellen van deze eigenschap wordt geen gebeurtenis verzonden. U moet de methode addEventListener() gebruiken om interactieve functionaliteit toe te voegen.

Verwante API-elementen

Geeft aan of een virtueel toetsenbord (een softwaretoetsenbord op het scherm) moet worden weergegeven wanneer deze InteractiveObject-instantie focus krijgt.

De standaardinstelling is false en er wordt geen toetsenbord weergegeven wanneer een InteractiveObject-instantie focus krijgt. Als de eigenschap needsSoftKeyboard is ingesteld op true, genereert de runtime een softwaretoetsenbord wanneer de InteractiveObject-instantie gebruikersinvoer kan accepteren. Een InteractiveObject-instantie is gereed om gebruikersinvoer te accepteren na een programma-aanroep om de Stage focus-eigenschap in te stellen of een gebruikersinteractie, zoals een tik. Als voor het clientsysteem een hardwaretoetsenbord beschikbaar is of als dit systeem virtuele toetenborden niet ondersteunt, wordt het softwaretoetsenbord niet weergegeven.

De InteractiveObject-instantie verzendt softKeyboardActivating-, softKeyboardActivate- en softKeyboardDeactivate-gebeurtenissen wanneer het softwaretoetsenbord wordt weergegeven en verborgen.

Opmerking: deze eigenschap wordt niet ondersteund in AIR-toepassingen op iOS.

Verwante API-elementen

Bepaalt het uiterlijk van het schermtoetsenbord.

Apparaten met schermtoetsenborden kunnen de knoppen van het toetsenbord aanpassen aan het verwachte type invoer. Als bijvoorbeeld numerieke invoer wordt verwacht, kan een apparaat SoftKeyboardType.NUMBER gebruiken om alleen nummers weer te geven op het schermtoetsenbord. Geldige waarden worden gedefinieerd als constanten in de klasse SoftKeyboardType:

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

Deze waarden fungeren als een hint, om een apparaat te helpen het beste toetsenbord voor de actieve bewerking weer te geven.

De standaardwaarde is SoftKeyboardType.DEFAULT.

Verwante API-elementen

Definieert het gebied dat als scherm moet blijven fungeren wanneer een softwaretoetsenbord wordt weergegeven (niet beschikbaar op iOS).

Als de eigenschap needsSoftKeyboard van dit InteractiveObject is ingesteld op true, past de runtime de weergave indien nodig aan om het object zichtbaar te houden terwijl de gebruiker typt. Doorgaans gebruikt de runtime de objectgrenzen die worden verkregen van de methode DisplayObject.getBounds(). U kunt een andere eigenschap opgeven met deze softKeyboardInputAreaOfInterest-eigenschap.

Geef de softKeyboardInputAreaOfInterest op in werkgebiedcoördinaten.

Opmerking: in Android werkt softKeyboardInputAreaOfInterest niet bij een liggende afdrukstand.

Opmerking: softKeyboardInputAreaOfInterest wordt niet ondersteund op iOS.

Verwante API-elementen

Geeft op of dit object in de tabvolgorde is opgenomen. Wanneer dit object is opgenomen in de tabvolgorde, is de waarde true; anders is de waarde false. De waarde is standaard false, met uitzondering van de volgende objecten:

• De waarde van een object SimpleButton is true.
• De waarde van een object TextField met type = "input" is true.
• De waarde van een object Sprite of een object MovieClip met buttonMode = true is true.

Geeft de tabvolgorde van objecten in een SWF-bestand op. De eigenschap tabIndex is standaard -1. Dit betekent dat er geen tabindex is ingesteld voor het object.

Wanneer een momenteel weergegeven object in het SWF-bestand de eigenschap tabIndex bevat, wordt automatische tabvolgorde uitgeschakeld en wordt de tabvolgorde berekend op basis van de eigenschappen tabIndex van objecten in het SWF-bestand. De aangepaste tabvolgorde omvat alleen objecten met eigenschappen tabIndex.

De eigenschap tabIndex kan een positief geheel getal zijn. De objecten worden gerangschikt op basis van hun eigenschappen tabIndex, in oplopende volgorde. Een object met een waarde tabIndex van 1 komt voor een object met een waarde tabIndex van 2. Gebruik dezelfde waarde tabIndex niet voor meerdere objecten.

De aangepaste tabvolgorde die door de eigenschap tabIndex wordt gedefinieerd, is vlak. Dit betekent dat er geen aandacht wordt besteed aan de hiërarchische relaties van objecten in het SWF-bestand. Alle objecten in het SWF-bestand met eigenschappen tabIndex worden opgenomen in de tabvolgorde en de tabvolgorde wordt bepaald op basis van de volgorde van de waarden tabIndex.

Opmerking: als u de tabvolgorde voor instanties TLFTextField wilt instellen, gebruikt u het onderliggende weergaveobject van TLFTextField als InteractiveObject en vervolgens stelt u de eigenschap tabIndex in. Bijvoorbeeld:

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

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

Wanneer de constructor new InteractiveObject() wordt aangeroepen, wordt een uitzondering ArgumentError gegenereerd. U kunt echter constructors aanroepen voor de volgende subklassen van InteractiveObject:

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

Geeft een virtueel toetsenbord weer.

Wanneer deze methode wordt aangeroepen, krijgt de InteractiveObject-instantie focus en wordt het softwaretoetsenbord weergegeven, indien nodig. De needsSoftKeyboard moet ook true zijn. Er wordt geen toetsenbord weergegeven als er een hardwaretoetsenbord beschikbaar is of als het clientsysteem virtuele toetsenborden niet ondersteunt.

Opmerking: deze methode wordt niet ondersteund in AIR-toepassingen op iOS.

Verwante API-elementen

Wordt verzonden wanneer de gebruiker Wissen of Verwijderen kiest in het snelmenu. Deze gebeurtenis wordt verzonden naar het object dat focus heeft. Als het object met de focus een TextField is, is het standaardgedrag van deze gebeurtenis dat alle geselecteerde tekst uit het tekstveld wordt verwijderd.

Deze gebeurtenis heeft de volgende eigenschappen:

Opmerking: TextField-objecten versturen de volgende gebeurtenissen niet: clear, copy, cut, paste of selectAll. TextField-objecten hebben in het contextmenu altijd de opdrachten Cut, Copy, Paste, Clear en Select All. U kunt deze opdrachten niet uit het contextmenu voor TextField-objecten verwijderen. Wanneer u voor TextField-objecten deze opdrachten (of hun equivalenten op het toetsenbord) selecteert, leidt dit niet tot het genereren van de gebeurtenissen clear, copy, cut, paste of selectAll. Bij andere klassen die een uitbreiding vormen op de klasse InteractiveObject, inclusief componenten die zijn gemaakt met Flash Text Engine (FTE), worden deze gebeurtenissen echter verzonden als reactie op gebruikersacties zoals bijvoorbeeld sneltoetsen en contextmenu's.

Wordt verzonden wanneer een gebruiker op de hoofdknop van het aanwijsapparaat drukt en deze boven hetzelfde InteractiveObject loslaat. Een gebeurtenis click vindt pas plaats nadat de volgende reeks gebeurtenissen in deze volgorde heeft plaatsgevonden: eerst gebeurtenis mouseDown, vervolgens mouseUp. Het doelobject moet gelijk zijn voor beide gebeurtenissen. Zoniet, dan zal de gebeurtenis click niet plaatsvinden. Een willekeurig aantal andere muisgebeurtenissen kan plaatsvinden op ieder moment tussen de gebeurtenissen mouseDown of mouseUp. De gebeurtenis click zal evengoed plaatsvinden.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een handeling van de gebruiker het snelmenu opent dat aan dit interactieve object in een AIR-toepassing is gekoppeld.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Wordt verzonden wanneer de gebruiker de platformspecifieke toetsencombinatie voor een kopieerbewerking gebruikt of Kopiëren kiest in het contextmenu. Deze gebeurtenis wordt verzonden naar het object dat focus heeft. Als het object met de focus een TextField is, is het standaardgedrag van deze gebeurtenis dat alle geselecteerde tekst in het tekstveld naar het klembord wordt gekopieerd.

Deze gebeurtenis heeft de volgende eigenschappen:

Opmerking: TextField-objecten versturen de volgende gebeurtenissen niet: clear, copy, cut, paste of selectAll. TextField-objecten hebben in het contextmenu altijd de opdrachten Cut, Copy, Paste, Clear en Select All. U kunt deze opdrachten niet uit het contextmenu voor TextField-objecten verwijderen. Wanneer u voor TextField-objecten deze opdrachten (of hun equivalenten op het toetsenbord) selecteert, leidt dit niet tot het genereren van de gebeurtenissen clear, copy, cut, paste of selectAll. Bij andere klassen die een uitbreiding vormen op de klasse InteractiveObject, inclusief componenten die zijn gemaakt met Flash Text Engine (FTE), worden deze gebeurtenissen echter verzonden als reactie op gebruikersacties zoals bijvoorbeeld sneltoetsen en contextmenu's.

Wordt verzonden wanneer de gebruiker de platformspecifieke toetsencombinatie voor een knipbewerking gebruikt of Knippen kiest in het contextmenu. Deze gebeurtenis wordt verzonden naar het object dat focus heeft. Als het object met de focus een TextField is, is het standaardgedrag van deze gebeurtenis dat alle geselecteerde tekst in het tekstveld naar het klembord wordt geknipt.

Deze gebeurtenis heeft de volgende eigenschappen:

Opmerking: TextField-objecten versturen de volgende gebeurtenissen niet: clear, copy, cut, paste of selectAll. TextField-objecten hebben in het contextmenu altijd de opdrachten Cut, Copy, Paste, Clear en Select All. U kunt deze opdrachten niet uit het contextmenu voor TextField-objecten verwijderen. Wanneer u voor TextField-objecten deze opdrachten (of hun equivalenten op het toetsenbord) selecteert, leidt dit niet tot het genereren van de gebeurtenissen clear, copy, cut, paste of selectAll. Bij andere klassen die een uitbreiding vormen op de klasse InteractiveObject, inclusief componenten die zijn gemaakt met Flash Text Engine (FTE), worden deze gebeurtenissen echter verzonden als reactie op gebruikersacties zoals bijvoorbeeld sneltoetsen en contextmenu's.

Wordt verzonden wanneer een gebruiker tweemaal snel achtereen op de hoofdknop van een aanwijsapparaat drukt en deze boven hetzelfde InteractiveObject loslaat wanneer de markering doubleClickEnabled van dat object op true is ingesteld. Een gebeurtenis doubleClick vindt pas plaats direct na de volgende reeks gebeurtenissen: mouseDown, mouseUp, click, mouseDown, mouseUp. Deze gebeurtenissen moeten allemaal hetzelfde doel hebben als de gebeurtenis doubleClick. De tweede klik, die bestaat uit de tweede gebeurtenissen mouseDown en mouseUp, moet plaatsvinden binnen een bepaalde tijdsperiode na de gebeurtenis click. De toegestane duur van deze periode varieert per besturingssysteem en kan vaak worden geconfigureerd door de gebruiker. Wanneer het doel een selecteerbaar tekstveld is, wordt standaard het woord onder de aanwijzer geselecteerd. Wanneer de markering doubleClickEnabled van het doel InteractiveObject niet is ingesteld op true, zal het twee gebeurtenissen click ontvangen.

De eigenschap doubleClickEnabled staat standaard ingesteld op false.

De werking van het selecteren van een object TextField via dubbelklikken is niet verwant aan de gebeurtenis doubleClick. U kunt TextField.doubleClickEnabled gebruiken om de instellingen van TextField te beheren.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Wordt verzonden nadat een weergaveobject focus krijgt. Een dergelijke situatie ontstaat wanneer een gebruiker het object markeert met een aanwijsapparaat of toetsenbordnavigatie. De ontvanger van dergelijke focus wordt het doelobject van deze gebeurtenis genoemd, terwijl de bijbehorende instantie InteractiveObject die focus heeft verloren vanwege deze verandering, het verwante object wordt genoemd. Een verwijzing naar het verwante object wordt opgeslagen in de eigenschap relatedObject van het ontvangende object. De eigenschap shiftKey wordt niet gebruikt. Deze gebeurtenis volgt op de verzending van de gebeurtenis focusOut van het vorige object.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden nadat een weergaveobject focus verliest. Dit gebeurt wanneer een gebruiker een ander object markeert met een aanwijsapparaat of toetsenbordnavigatie. Het object dat focus verliest wordt het doelobject van deze gebeurtenis genoemd, terwijl de bijbehorende instantie InteractiveObject die focus ontvangt, het verwante object wordt genoemd. Een verwijzing naar het verwante object wordt opgeslagen in de eigenschap relatedObject van het doelobject. De eigenschap shiftKey wordt niet gebruikt. Deze gebeurtenis gaat vooraf aan de verzending van de gebeurtenis focusIn door het verwante object.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer de gebruiker een aanraakpunt langs de rand van het touchoppervlak maakt met een InteractiveObject-instantie (zoals wanneer u langs de rand van het touchoppervlak op Siri Extern voor Apple TV tikt). Sommige apparaten interpreteren dit contact misschien ook als een combinatie van verschillende aanraakgebeurtenissen.

Meer specifiek, als een gebruiker met een vinger een InteractiveObject aanraakt en zijn vingers vervolgens weghaalt, kan de InteractiveObject-instantie (onder andere) een touchBegin-gebeurtenis en een touchEnd-gebeurtenis versturen, alsook de gestureDirectionalTap-gebeurtenis, of alle gebeurtenissen als dit wordt ondersteund door de huidige omgeving. Kies hoe u de gebruikersinteractie wilt bedienen. Gebruik de flash.ui.Multitouch-klasse om de bediening van de aanraakgebeurtenis te beheren (om bediening met aanraakgebeurtenissen in te schakelen, raakt u eenvoudig het aanraakpunt voor gebeurtenisbediening aan of schakelt u aanraakgebeurtenissen uit, zodat alleen muisgebeurtenissen worden verzonden). Als u ervoor kiest om de touchBegin-gebeurtenis toe te passen, dan zal dezelfde gebeurtenishandler op een apparaat met aanraakbediening worden uitgevoerd. Als u er echter voor kiest om de gestureDirectionalTap-gebeurtenis toe te passen, kunt u uw gebeurtenishandler zodanig ontwerpen, dat deze is aangepast aan de specifieke vereisten van een omgeving met aanraakbediening om gebruikers nog meer te laten profiteren van aanraakbediening. U kunt ook beide gebeurtenissen apart toepassen om bij een bewegingsgebeurtenis voor een andere reactie te zorgen dan bij een aanraakgebeurtenis. Maar de flash.ui.Multitouch-klasse bepaalt of de aanraakgebeurtenis of de bewegingsgebeurtenis geactiveerd wordt.

Wanneer u eigenschappen van het gebeurtenisobject toepast, moet u opletten of de eigenschappen localX en localY op het primaire contactpunt zijn ingesteld (voor Apple TV is dit het midden van het scherm). De eigenschappen OffsetX en offsetY komen overeen met de richting van de beweging.

Opmerking:: Deze API biedt alleen ondersteuning voor een richtingstik met één vinger.

Het TransformGestureEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Wordt verzonden wanneer de gebruiker op twee aanraakpunten drukt op dezelfde InteractiveObject-instantie op een apparaat met aanraakbediening (zoals wanneer de gebruiker met twee vingers op een weergaveobject op een gsm of tablet met aanraakscherm drukt en vervolgens weer loslaat). Dit contact kan door sommige apparaten als een doubleClick-gebeurtenis worden geïnterpreteerd.

Als een gebruiker met twee vingers op een InteractiveObject drukt, kan de InteractiveObject-instantie een doubleClick-gebeurtenis of een gestureTwoFingerTap-gebeurtenis versturen, of beide als dit door de huidige omgeving wordt ondersteund. Kies hoe u de gebruikersinteractie wilt bedienen. Gebruik de flash.ui.Multitouch-klasse om de bediening van de aanraakgebeurtenis te beheren (om bediening met aanraakgebeurtenissen in te schakelen, raakt u eenvoudig het aanraakpunt voor gebeurtenisbediening aan of schakelt u aanraakgebeurtenissen uit, zodat alleen muisgebeurtenissen worden verzonden). Als u ervoor kiest om de doubleClick-gebeurtenis te bedienen, dan zal dezelfde gebeurtenisbediening een apparaat met aanraakbediening en een apparaat met muisbediening starten. Als u er echter voor kiest om de gestureTwoFingerTap-gebeurtenis te verwerken, kunt u uw gebeurtenishandler zodanig ontwerpen, zodat deze is aangepast aan de specifieke vereisten van een omgeving met aanraakbediening om gebruikers een rijkere beleving met aanraakbediening te bieden. U kunt ook beide gebeurtenissen apart bedienen, om een andere reactie te bieden voor een aanraakgebeurtenis dan voor een muisgebeurtenis.

Opmerking: zie de Multitouch-klasse voor informatie over omgevingscompatibiliteit.

Verwante API-elementen

Wordt verzonden wanneer de gebruiker een aanraakpunt over de InteractiveObject-instantie beweegt op een apparaat met aanraakbediening (zoals wanneer de gebruiker een vinger van links naar rechts beweegt over een weergaveobject op een gsm of tablet met aanraakscherm). Sommige apparaten interpreteren dit contact als een mouseOver-gebeurtenis en als een touchOver-gebeurtenis.

Meer specifiek, als een gebruiker een vinger over een InteractiveObject beweegt, kan de InteractiveObject-instantie (onder andere) een mouseOver-gebeurtenis en een touchOver-gebeurtenis versturen, naast de gesturePan-gebeurtenis of alle gebeurtenissen als dit wordt ondersteund door de huidige omgeving. Kies hoe u de gebruikersinteractie wilt bedienen. Gebruik de flash.ui.Multitouch-klasse om de bediening van de aanraakgebeurtenis te beheren (om bediening met aanraakgebeurtenissen in te schakelen, raakt u eenvoudig het aanraakpunt voor gebeurtenisbediening aan of schakelt u aanraakgebeurtenissen uit, zodat alleen muisgebeurtenissen worden verzonden). Als u ervoor kiest om de mouseOver-gebeurtenis te bedienen, dan zal dezelfde gebeurtenisbediening een apparaat met aanraakbediening en een apparaat met muisbediening starten. Als u er echter voor kiest om de gesturePan-gebeurtenis te verwerken, kunt u uw gebeurtenishandler zodanig ontwerpen, zodat deze is aangepast aan de specifieke vereisten van een omgeving met aanraakbediening om gebruikers een rijkere beleving met aanraakbediening te bieden. U kunt ook beide gebeurtenissen apart bedienen, om een andere reactie te bieden voor een aanraakgebeurtenis dan voor een muisgebeurtenis.

Opmerking: zie de Multitouch-klasse voor informatie over omgevingscompatibiliteit.

Het TransformGestureEvent-object heeft de volgende eigenschappen:

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";
    }
}

Verwante API-elementen

Wordt verzonden wanneer de gebruiker een zoombeweging maakt op een aanraakpunt met een InteractiveObject-instantie (zoals wanneer de gebruiker een scherm aanraakt met twee vingers en deze vervolgens roteert over een weergaveobject op een gsm of tablet met een aanraakscherm). Met twee vingers draaien is een algemene rotatiebeweging, maar elk apparaat en besturingssysteem kan eigen rotatievereisten hebben. Sommige apparaten interpreteren dit contact misschien ook als een combinatie van verschillende muisgebeurtenissen.

Meer specifiek, als een gebruiker een vinger over een InteractiveObject beweegt, kan de InteractiveObject-instantie een mouseOver-gebeurtenis en een click-gebeurtenis (onder andere) versturen, naast de gestureRotate-gebeurtenis of alle gebeurtenissen als dit wordt ondersteund door de huidige omgeving. Kies hoe u de gebruikersinteractie wilt bedienen. Gebruik de flash.ui.Multitouch-klasse om de bediening van de aanraakgebeurtenis te beheren (om bediening met aanraakgebeurtenissen in te schakelen, raakt u eenvoudig het aanraakpunt voor gebeurtenisbediening aan of schakelt u aanraakgebeurtenissen uit, zodat alleen muisgebeurtenissen worden verzonden). Als u ervoor kiest om de mouseOver-gebeurtenis te bedienen, dan zal dezelfde gebeurtenisbediening een apparaat met aanraakbediening en een apparaat met muisbediening starten. Als u er echter voor kiest om de gestureRotate-gebeurtenis te verwerken, kunt u uw gebeurtenishandler zodanig ontwerpen, zodat deze is aangepast aan de specifieke vereisten van een omgeving met aanraakbediening om gebruikers een rijkere beleving met aanraakbediening te bieden. U kunt ook beide gebeurtenissen apart bedienen, om een andere reactie te bieden voor een aanraakgebeurtenis dan voor een muisgebeurtenis.

Wanneer u eigenschappen van het gebeurtenisobject bedient, moet u opletten of de eigenschappen localX en localY op het primaire aanraakpunt zijn ingesteld. De offsetX- en offsetY-eigenschappen geven de afstand aan tot het contactpunt en het punt waarbij de rotatiebeweging is voltooid.

Opmerking: zie de Multitouch-klasse voor informatie over omgevingscompatibiliteit.

Tijdens deze gebeurtenis bevat de eigenschap rotation de rotatiehoek. De rotatiewaarden zijn als volgt:

• 0 tot 180 graden rechtsom
• -180 tot 0 graden linksom

Het TransformGestureEvent-object heeft de volgende eigenschappen:

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";
    }
}

Verwante API-elementen

Wordt verzonden wanneer de gebruiker een veegbeweging maakt op een aanraakpunt met een InteractiveObject-instantie (zoals wanneer de gebruiker een scherm aanraakt met drie vingers en deze vervolgens parallel beweegt over een weergaveobject op een gsm of tablet met een aanraakscherm). Het parallel bewegen van verschillende vingers is een algemene veegbeweging, maar elk apparaat en besturingssysteem kan zijn eigen vereisten voor een veegbeweging hebben. Sommige apparaten interpreteren dit contact misschien ook als een combinatie van verschillende muisgebeurtenissen.

Meer specifiek, als een gebruiker een vinger over een InteractiveObject beweegt en zijn vingers samen beweegt, kan de InteractiveObject-instantie een rollOver-gebeurtenis en een rollOut-gebeurtenis (onder andere) versturen, naast de gestureSwipe-gebeurtenis of alle gebeurtenissen als dit wordt ondersteund door de huidige omgeving. Kies hoe u de gebruikersinteractie wilt bedienen. Als u ervoor kiest om de rollOver-gebeurtenis te bedienen, dan zal dezelfde gebeurtenisbediening een apparaat met aanraakbediening en een apparaat met muisbediening starten. Als u er echter voor kiest om de gestureSwipe-gebeurtenis te verwerken, kunt u uw gebeurtenishandler zodanig ontwerpen, zodat deze is aangepast aan de specifieke vereisten van een omgeving met aanraakbediening om gebruikers een rijkere beleving met aanraakbediening te bieden. U kunt ook beide gebeurtenissen apart bedienen, om een andere reactie te bieden voor een aanraakgebeurtenis dan voor een muisgebeurtenis.

Wanneer u eigenschappen van het gebeurtenisobject bedient, moet u opletten of de eigenschappen localX en localY op het primaire aanraakpunt zijn ingesteld. De offsetX- en offsetY-eigenschappen geven de afstand aan tot het aanraakpunt en het punt waarbij de veegbeweging is voltooid.

Opmerking: hoewel sommige apparaten met Mac OS een veegbeweging met vier vingers kunnen interpreteren, ondersteunt deze API alleen een veegbeweging met drie vingers.

Het TransformGestureEvent-object heeft de volgende eigenschappen:

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;

}

Verwante API-elementen

Wordt verzonden wanneer de gebruiker een aanraakpunt maakt met een InteractiveObject-instantie en vervolgens op een apparaat met aanraakbediening drukt (zoals wanneer de gebruiker een paar vingers op een weergaveobject plaatst om een menu te openen en er met een vinger op drukt om een menu-item op een gsm of tablet met een aanraakscherm te selecteren). Sommige apparaten interpreteren dit contact misschien ook als een combinatie van verschillende muisgebeurtenissen.

Meer specifiek, als een gebruiker een vinger over een InteractiveObject beweegt en er vervolgens voor de tweede keer op drukt, kan de InteractiveObject-instantie (onder andere) een mouseOver-gebeurtenis en een click-gebeurtenis versturen, naast de gesturePressAndTap-gebeurtenis of alle gebeurtenissen als dit wordt ondersteund door de huidige omgeving. Kies hoe u de gebruikersinteractie wilt bedienen. Gebruik de flash.ui.Multitouch-klasse om de bediening van de aanraakgebeurtenis te beheren (om bediening met aanraakgebeurtenissen in te schakelen, raakt u eenvoudig het aanraakpunt voor gebeurtenisbediening aan of schakelt u aanraakgebeurtenissen uit, zodat alleen muisgebeurtenissen worden verzonden). Als u ervoor kiest om de mouseOver-gebeurtenis te bedienen, dan zal dezelfde gebeurtenisbediening een apparaat met aanraakbediening en een apparaat met muisbediening starten. Als u er echter voor kiest om de gesturePressAndTap-gebeurtenis te verwerken, kunt u uw gebeurtenishandler zodanig ontwerpen, zodat deze is aangepast aan de specifieke vereisten van een omgeving met aanraakbediening om gebruikers een rijkere beleving met aanraakbediening te bieden. U kunt ook beide gebeurtenissen apart bedienen, om een andere reactie te bieden voor een aanraakgebeurtenis dan voor een muisgebeurtenis.

Wanneer u eigenschappen van het gebeurtenisobject bedient, moet u opletten of de eigenschappen localX en localY op het primaire contactpunt zijn ingesteld (de 'push'). De eigenschappen offsetX en offsetY geven de afstand tot het secundaire contactpunt aan (de 'tap').

Verwante API-elementen

Wordt verzonden wanneer de gebruiker een zoombeweging maakt op een aanraakpunt met een InteractiveObject-instantie (zoals wanneer de gebruiker een scherm aanraakt met twee vingers en deze vervolgens snel spreidt over een weergaveobject op een gsm of tablet met een aanraakscherm). Het uit elkaar bewegen van vingers is een algemene zoombeweging, maar elk apparaat en besturingssysteem kan zijn eigen vereisten hebben om zoomen aan te geven. Sommige apparaten interpreteren dit contact misschien ook als een combinatie van verschillende muisgebeurtenissen.

Meer specifiek, als een gebruiker een vinger over een InteractiveObject beweegt en zijn vingers uit elkaar beweegt, kan de InteractiveObject-instantie een mouseOver-gebeurtenis en een click-gebeurtenis (onder andere) versturen, naast de gestureZoom-gebeurtenis of alle gebeurtenissen als dit wordt ondersteund door de huidige omgeving. Kies hoe u de gebruikersinteractie wilt bedienen. Gebruik de flash.ui.Multitouch-klasse om de bediening van de aanraakgebeurtenis te beheren (om bediening met aanraakgebeurtenissen in te schakelen, raakt u eenvoudig het aanraakpunt voor gebeurtenisbediening aan of schakelt u aanraakgebeurtenissen uit, zodat alleen muisgebeurtenissen worden verzonden). Als u ervoor kiest om de mouseOver-gebeurtenis te bedienen, dan zal dezelfde gebeurtenisbediening een apparaat met aanraakbediening en een apparaat met muisbediening starten. Als u er echter voor kiest om de gestureZoom-gebeurtenis te verwerken, kunt u uw gebeurtenishandler zodanig ontwerpen, zodat deze is aangepast aan de specifieke vereisten van een omgeving met aanraakbediening om gebruikers een rijkere beleving met aanraakbediening te bieden. U kunt ook beide gebeurtenissen apart bedienen, om een andere reactie te bieden voor een aanraakgebeurtenis dan voor een muisgebeurtenis.

Wanneer u eigenschappen van het gebeurtenisobject bedient, moet u opletten of de eigenschappen localX en localY op het primaire aanraakpunt zijn ingesteld. De offsetX- en offsetY-eigenschappen geven de afstand aan tot het contactpunt en het punt waarbij de zoombeweging is voltooid.

Opmerking: zie de Multitouch-klasse voor informatie over omgevingscompatibiliteit.

Het TransformGestureEvent-object heeft de volgende eigenschappen:

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";
    }
}

Verwante API-elementen

Deze gebeurtenis wordt verzonden naar elke clienttoepassing die inline-invoer met een IME ondersteunt.

Wordt verzonden wanneer de gebruiker op een toets drukt. Toewijzingen tussen toetsen en specifieke tekens kunnen variëren per apparaat en besturingssysteem. Dit type gebeurtenis wordt gegenereerd nadat een dergelijke toewijzing heeft plaatsgevonden en voordat een invoermethode-editor (IME) wordt verwerkt. IME's worden gebruikt voor het invoeren van tekens, zoals Chinese ideografische tekens, die met het standaard QWERTY-toetsenbord moeilijk kunnen worden geproduceerd. Deze gebeurtenis treedt op vóór de gebeurtenis keyUp.

Als u deze gebeurtenis annuleert in AIR, wordt voorkomen dat het teken in een tekstveld wordt ingevoerd.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer de gebruiker focus probeert te wijzigen met toetsenbordnavigatie. De standaardwerking van deze gebeurtenis is dat focus wordt gewijzigd en de bijbehorende gebeurtenissen focusIn en focusOut worden verzonden.

Deze gebeurtenis wordt verzonden naar het object dat focus heeft. Het verwante object voor deze gebeurtenis is de instantie InteractiveObject die focus ontvangt wanneer u de standaardwerking niet voorkomt. U kunt de gewijzigde focus voorkomen door de methode preventDefault() aan te roepen in een gebeurtenislistener die correct is geregistreerd bij het doelobject. Focus verandert en de gebeurtenissen focusIn en focusOut worden standaard verzonden.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer de gebruiker een toets loslaat. Toewijzingen tussen toetsen en specifieke tekens kunnen variëren per apparaat en besturingssysteem. Dit type gebeurtenis wordt gegenereerd nadat een dergelijke toewijzing heeft plaatsgevonden en voordat een invoermethode-editor (IME) wordt verwerkt. IME's worden gebruikt voor het invoeren van tekens, zoals Chinese ideografische tekens, die met het standaard QWERTY-toetsenbord moeilijk kunnen worden geproduceerd. Deze gebeurtenis treedt op na een gebeurtenis keyDown en heeft de volgende kenmerken:

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een gebruiker op de middelste knop van het aanwijsapparaat drukt en deze boven hetzelfde InteractiveObject loslaat. Een gebeurtenis middleClick vindt pas plaats nadat de volgende reeks gebeurtenissen in deze volgorde heeft plaatsgevonden: de gebeurtenis middleMouseDown en vervolgens middleMouseUp. Het doelobject moet gelijk zijn voor beide gebeurtenissen. Zoniet, dan zal de gebeurtenis middleClick niet plaatsvinden. Een willekeurig aantal andere muisgebeurtenissen kan plaatsvinden op ieder moment tussen de gebeurtenissen middleMouseDown of middleMouseUp. De gebeurtenis middleClick zal evengoed plaatsvinden.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een gebruiker op de middelste aanwijsapparaatknop drukt over een instantie InteractiveObject.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een gebruiker de aanwijsapparaatknop over een instantie InteractiveObject beweegt.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een gebruiker op de aanwijsapparaatknop drukt over een instantie InteractiveObject. Wanneer het doel een instantie SimpleButton is, geeft de instantie SimpleButton standaard het weergaveobject downState weer. Wanneer het doel een selecteerbaar tekstveld is, begint de selectie standaard bij het tekstveld.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer de gebruiker focus probeert te wijzigen met een aanwijsapparaat. De standaardwerking van deze gebeurtenis is dat focus wordt gewijzigd en de bijbehorende gebeurtenissen focusIn en focusOut worden verzonden.

Deze gebeurtenis wordt verzonden naar het object dat focus heeft. Het verwante object voor deze gebeurtenis is de instantie InteractiveObject die focus ontvangt wanneer u de standaardwerking niet voorkomt. U kunt de gewijzigde focus voorkomen door preventDefault() aan te roepen in een gebeurtenislistener die correct is geregistreerd bij het doelobject. De eigenschap shiftKey wordt niet gebruikt. Focus verandert en de gebeurtenissen focusIn en focusOut worden standaard verzonden.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer de gebruiker het aanwijsapparaat verplaatst terwijl het zich boven een InteractiveObject bevindt. Wanneer het doel een tekstveld is dat door de gebruiker wordt geselecteerd, wordt de selectie standaard bijgewerkt.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer de gebruiker een aanwijsapparaat van een instantie InteractiveObject af verplaatst. Doel van gebeurtenis is het object dat zich eerder onder het aanwijsapparaat bevond. Het relatedObject is het object waarnaar het aanwijsapparaat is verplaatst. Wanneer het doel een instantie SimpleButton is, geeft de knop standaard het weergaveobject upState weer.

De gebeurtenis mouseOut wordt iedere keer verzonden wanneer de muis het gebied van een willekeurig onderliggend object van de weergaveobjectcontainer verlaat, zelfs wanneer de muis boven een ander onderliggend object van de weergaveobjectcontainer blijft staan. De gebeurtenis rollOut heeft een ander doel, namelijk de codering van rollover-gedragingen voor weergaveobjectcontainers met onderliggende items te vereenvoudigen. Wanneer de muis het gebied van een weergaveobject of het gebied van een van de onderliggende items verlaat om naar een object te gaan dat niet behoort tot een van de onderliggende items, wordt de gebeurtenis rollOut door het weergaveobject verzonden. De gebeurtenissen rollOut worden achtereenvolgens verzonden naar de bovenliggende items van het object en beginnen bij het object en eindigen bij het hoogst bovenliggende item dat noch hoofdknooppunt noch bovenliggend item is van het relatedObject.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer de gebruiker een aanwijsapparaat over een instantie InteractiveObject beweegt. Het relatedObject is het object dat zich eerder onder het aanwijsapparaat bevond. Wanneer het doel een instantie SimpleButton is, geeft het object standaard het weergaveobject overState of upState weer, afhankelijk van of de muisknop is ingedrukt of niet.

De gebeurtenis mouseOver wordt iedere keer verzonden wanneer de muis het gebied van een willekeurig onderliggend object van de weergaveobjectcontainer binnenkomt, zelfs wanneer de muis zich al boven een ander onderliggend object van de weergaveobjectcontainer bevond. De gebeurtenis rollOver heeft een ander doel, namelijk de codering van rollout-gedragingen voor weergaveobjectcontainers met onderliggende items te vereenvoudigen. Wanneer de muis het gebied van een weergaveobject of het gebied van een van de onderliggende items binnenkomt vanaf een object dat niet behoort tot een van de onderliggende items, wordt de gebeurtenis rollOver door het weergaveobject verzonden. De gebeurtenissen rollOver worden achtereenvolgens verzonden naar de bovenliggende items van het object en beginnen bij het hoogst bovenliggende item dat hoofdknooppunt noch bovenliggend item is van het relatedObject en eindigen bij het object.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een gebruiker de aanwijsapparaatknop over een instantie InteractiveObject beweegt. Wanneer het doel een instantie SimpleButton is, geeft het object het weergaveobject upState weer. Wanneer het doel een selecteerbaar tekstveld is, eindigt de selectie standaard bij het tekstveld.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een muiswiel over een instantie InteractiveObject wordt gedraaid. Wanneer het doel een tekstveld is, wordt de tekst standaard geschoven. Alleen beschikbaar op Microsoft Windows-besturingssystemen.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden door de sleepinitiator InteractiveObject wanneer de gebruiker de sleepbeweging onderbreekt.

De eigenschap dropAction van de gebeurtenis duidt op de actie die door het doelobject voor slepen is ingesteld; een waarde "none" (DragActions.NONE) duidt aan dat het neerzetten is geannuleerd of niet geaccepteerd.

De gebeurtenishandler nativeDragComplete is een nuttige plaats om de status van het initiërende weergaveobject bij te werken, bijvoorbeeld door een item uit een lijst te verwijderen (bij een sleepactie voor verplaatsen), of door de visuele eigenschappen te wijzigen.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden door het doel InteractiveObject wanneer een gesleept object erop wordt neergezet en het neerzetten is geaccepteerd met een aanroep van DragManager.acceptDragDrop().

Toegang tot de neergezette gegevens met de eigenschap clipboard van het gebeurtenisobject.

De handler voor deze gebeurtenis stelt de eigenschap DragManager.dropAction in om feedback te geven aan het initiatorobject waarvoor een sleepactie is uitgevoerd. Als er geen waarde is ingesteld, selecteert DragManager een standaardwaarde in de lijst van toegestane acties.

Deze gebeurtenis heeft de volgende eigenschappen: