InteractiveObject  - AS3

Die aktuelle Eingabehilfenimplementierung (AccessibilityImplementation) für diese InteractiveObject-Instanz.

Verwandte API-Elemente

Gibt das diesem Objekt zugeordnete Kontextmenü an.

Für Inhalt, der in Flash Player ausgeführt wird, handelt es sich bei dieser Eigenschaft um ein ContextMenu-Objekt. In der AIR-Laufzeitumgebung erweitert die ContextMenu-Klasse die NativeMenu-Klasse, doch Flash Player unterstützt nur die ContextMenu-Klasse, nicht aber die NativeMenu-Klasse.

Hinweis: TextField-Objekte enthalten im Kontextmenü immer ein Zwischenablagemenü. Das Zwischenablagemenü enthält die Befehle „Ausschneiden“, „Kopieren“, „Einfügen“, „Löschen“ und „Alles auswählen“. Diese Befehle können aus dem Kontextmenü von TextField-Objekten nicht entfernt werden. Bei TextField-Objekten werden beim Auswählen dieser Befehle (oder der entsprechenden Zugriffstastenkombinationen) keine clear-, copy-, cut-, paste- oder selectAll-Ereignisse ausgelöst.

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

Gibt an, ob dieses Objekt doubleClick-Ereignisse empfängt. Der Standardwert ist false. Das heißt, dass eine InteractiveObject-Instanz standardmäßig keine doubleClick-Ereignisse erhält. Ist die doubleClickEnabled-Eigenschaft auf true gesetzt, empfängt die Instanz doubleClick-Ereignisse innerhalb ihrer Grenzen. Die mouseEnabled-Eigenschaft der InteractiveObject-Instanz muss ebenfalls auf true gesetzt werden, damit das Objekt doubleClick-Ereignisse empfängt.

Durch das Festlegen dieser Eigenschaft wird kein Ereignis ausgelöst. Sie müssen die addEventListener()-Methode verwenden, um einen Ereignis-Listener für das doubleClick-Ereignis hinzuzufügen.

Verwandte API-Elemente

Gibt an, ob für dieses Objekt ein Fokusrechteck angezeigt wird. Es sind drei Werte möglich: true, false oder null. Die Werte true und false geben an, ob ein Fokusrechteck angezeigt wird oder nicht. Der Wert null gibt an, dass dieses Objekt der stageFocusRect-Eigenschaft der Bühne unterliegt.

Gibt an, ob dieses Objekt Meldungen von der Maus oder einem anderen Benutzereingabegerät empfängt. Der Standardwert ist true, d. h., dass standardmäßig jede InteractiveObject-Instanz, die sich in der Anzeigeliste befindet, Mausereignisse oder andere Benutzereingabeereignisse erhält. Wenn mouseEnabled auf false eingestellt ist, empfängt die Instanz keine Mausereignisse (oder andere Benutzereingabeereignisse wie Tastaturereignisse). Untergeordnete Elemente dieser Instanz in der Anzeigeliste sind nicht betroffen. Wenn Sie das mouseEnabled-Verhalten für alle Objekte ändern möchten, die einem Objekt in der Anzeigeliste untergeordnet sind, verwenden Sie flash.display.DisplayObjectContainer.mouseChildren.

Durch das Festlegen dieser Eigenschaft wird kein Ereignis ausgelöst. Um interaktive Funktionalität zu erzielen, müssen Sie die addEventListener()-Methode verwenden.

Verwandte API-Elemente

Gibt an, ob eine virtuelle Tastatur (Bildschirmtastatur) angezeigt wird, wenn diese InteractiveObject-Instanz den Fokus erhält.

Standardmäßig ist der Wert false und wenn die InteractiveObject-Instanz den Fokus erhält, wird die Tastatur nicht eingeblendet. Wenn die needsSoftKeyboard-Eigenschaft den Wert true hat, blendet die Laufzeitumgebung eine virtuelle Tastatur ein, wenn die InteractiveObject-Instanz für Benutzereingaben bereit ist. Eine InteractiveObject-Instanz ist für Benutzereingaben bereit, nachdem ein programmgesteuerter Aufruf erfolgt ist, um die focus-Eigenschaft des Stage-Objekts zu setzen, oder nach einer Benutzerinteraktion, zum Beispiel Tippen auf den Bildschirm. Wenn das Clientsystem eine Hardwaretastatur bereitstellt oder keine virtuelle Tastatur unterstützt, wird die virtuelle Tastatur nicht eingeblendet.

Die InteractiveObject-Instanz setzt softKeyboardActivating-, softKeyboardActivate- und softKeyboardDeactivate-Ereignisse ab, wenn die virtuelle Tastatur ein- oder ausgeblendet wird.

Hinweis: Diese Eigenschaft wird in AIR-Anwendungen unter iOS nicht unterstützt.

Verwandte API-Elemente

Steuert das Erscheinungsbild der Bildschirmtastatur.

Geräte mit Bildschirmtastatur können die Tasten der Tastatur anpassen, damit sie zu der erwarteten Eingabe passen. Wenn zum Beispiel eine numerische Eingabe erwartet wird, kann ein Gerät SoftKeyboardType.NUMBER verwenden, um nur Ziffern auf der Bildschirmtastatur anzuzeigen. Gültige Werte sind als Konstanten in der SoftKeyboardType-Klasse definiert:

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

Diese Werte dienen als Hinweise, damit ein Gerät die Tastatur anzeigen kann, die für den aktuellen Vorgang am besten geeignet ist.

Der Standardwert ist SoftKeyboardType.DEFAULT.

Verwandte API-Elemente

Definiert einen Bereich, der auf dem Bildschirm sichtbar bleiben soll, wenn eine virtuelle Tastatur angezeigt wird (nicht unter iOS verfügbar).

Wenn die needsSoftKeyboard-Eigenschaft dieser InteractiveObject-Instant den Wert true hat, passt die Laufzeitumgebung die Anzeige so an, dass das Objekt sichtbar bleibt, während der Benutzer tippt. Normalerweise verwendet die Laufzeitumgebung die Objektgrenzen, die aus der DisplayObject.getBounds()-Methode bezogen werden. Mit dieser softKeyboardInputAreaOfInterest-Eigenschaft können Sie einen anderen Bereich festlegen.

Geben Sie den Wert für softKeyboardInputAreaOfInterest in Bühnenkoordinaten ein.

Hinweis: Unter Android wird softKeyboardInputAreaOfInterest im Querformat nicht berücksichtigt.

Hinweis: softKeyboardInputAreaOfInterest wird unter IOS nicht unterstützt.

Verwandte API-Elemente

Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet. Liegt dieses Objekt in der Tabulatorreihenfolge vor, ist der Wert true, andernfalls false. Der Standardwert ist false, mit folgender Ausnahme:

• Bei einem SimpleButton-Objekt lautet der Wert true.
• Bei einem TextField-Objekt mit type = "input" lautet der Wert true.
• Bei einem Sprite-Objekt oder MovieClip-Objekt mit buttonMode = true lautet der Wert true.

Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an. Die Eigenschaft tabIndex hat standardmäßig den Wert -1, d. h., für das Objekt ist kein Tabulatorindex gesetzt.

Wenn eines der gegenwärtig in der SWF-Datei angezeigten Objekte die tabIndex-Eigenschaft aufweist, wird die automatische Tabulatorreihenfolge deaktiviert und die Tabulatorreihenfolge anhand der tabIndex-Eigenschaften der Objekte in der SWF-Datei ermittelt. Bei der benutzerdefinierten Tabulatorreihenfolge werden nur Objekte berücksichtigt, die über die tabIndex-Eigenschaft verfügen.

Die tabIndex-Eigenschaft kann eine positive Ganzzahl sein. Die Objekte werden entsprechend den tabIndex-Eigenschaften in aufsteigender Reihenfolge angeordnet. Dabei liegt ein Objekt mit einem tabIndex-Wert von 1 in der Reihenfolge vor einem Objekt mit einem tabIndex-Wert von 2. Derselbe tabIndex-Wert darf nicht für mehrere Objekte verwendet werden.

Die durch die tabIndex-Eigenschaft festgelegte benutzerdefinierte Tabulatorreihenfolge ist flat. Das heißt, die hierarchischen Beziehungen zwischen Objekten in der SWF-Datei bleiben unberücksichtigt. Alle Objekte in der SWF-Datei, die die tabIndex-Eigenschaften aufweisen, werden in die Tabulatorreihenfolge eingeordnet, die wiederum durch die Reihenfolge der tabIndex-Werte bestimmt wird.

Hinweis: Um die Tabulatorreihenfolge für TLFTextField-Instanzen festzulegen, wandeln Sie das untergeordnete Anzeigeobjekt von TLFTextField in ein InteractiveObject um und legen Sie dann die tabIndex-Eigenschaft fest. Beispiel:

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

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

Durch das Aufrufen des Konstruktors new InteractiveObject() wird eine ArgumentError-Ausnahme ausgelöst. Sie können jedoch Konstruktoren für die folgenden Unterklassen von „InteractiveObject“ aufrufen:

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

Blendet eine virtuelle Tastatur ein.

Der Aufruf dieser Methode fokussiert die InteractiveObject-Instanz und blendet die virtuelle Tastatur ein, falls erforderlich. Die needsSoftKeyboard-Eigenschaft muss ebenfalls den Wert true haben. Die virtuelle Tastatur wird nicht eingeblendet, wenn eine Hardwaretastatur verfügbar ist oder wenn das Clientsystem keine virtuelle Tastatur unterstützt.

Hinweis: Diese Methode wird in AIR-Anwendungen unter iOS nicht unterstützt.

Verwandte API-Elemente

Wird ausgelöst, wenn der Benutzer aus dem Kontextmenü die Option „Löschen“ wählt. Dieses Ereignis wird für das Objekt ausgelöst, das gerade den Eingabefokus hat. Ist das Objekt, das derzeit den Eingabefokus hat, ein TextField, löscht dieses Ereignis standardmäßig aktuell ausgewählten Text aus dem Textfeld.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Hinweis: TextField-Objekte lösen folgende Ereignisse nicht aus: clear, copy, cut, paste und selectAll. TextField-Objekte enthalten die Befehle „Ausschneiden“, „Kopieren“, „Einfügen“, „Löschen“ und „Alles auswählen“ immer im Kontextmenü. Diese Befehle können aus dem Kontextmenü von TextField-Objekten nicht entfernt werden. Bei TextField-Objekten werden beim Auswählen dieser Befehle (oder der entsprechenden Zugriffstastenkombinationen) keine clear-, copy-, cut-, paste- oder selectAll-Ereignisse ausgelöst. Andere Klassen, die die InteractiveObject-Klasse erweitern, darunter Komponenten, die mit der Flash Text Engine (FTE) erstellt wurden, setzen diese Ereignisse jedoch in Reaktion auf Benutzeraktionen wie Tastaturbefehle und Kontextmenüs ab.

Wird ausgelöst, wenn ein Benutzer die Haupttaste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und wieder loslässt. Damit ein Klickereignis eintreten kann, muss es immer an die folgende Reihe von Ereignissen anschließen, und zwar in der angegebenen Reihenfolge: mouseDown-Ereignis, dann mouseUp-Ereignis. Das Zielobjekt muss für beide Ereignisse identisch sein, da das click-Ereignis sonst nicht eintritt. Zwischen den Ereignissen mouseDown und mouseUp kann jederzeit eine beliebige Anzahl von Mausereignissen vorkommen. Das click-Ereignis tritt dennoch ein.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer das Kontextmenü, das mit diesem interaktiven Objekt verknüpft ist, in einer AIR-Anwendung einblendet.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Kopieren“ aktiviert oder im Kontextmenü des Texts „Kopieren“ wählt. Dieses Ereignis wird für das Objekt ausgelöst, das gerade den Eingabefokus hat. Ist das Objekt, das derzeit den Fokus hat, ein TextField, kopiert dieses Ereignis standardmäßig aktuell ausgewählten Text aus dem Textfeld in die Zwischenablage.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Hinweis: TextField-Objekte lösen folgende Ereignisse nicht aus: clear, copy, cut, paste und selectAll. TextField-Objekte enthalten die Befehle „Ausschneiden“, „Kopieren“, „Einfügen“, „Löschen“ und „Alles auswählen“ immer im Kontextmenü. Diese Befehle können aus dem Kontextmenü von TextField-Objekten nicht entfernt werden. Bei TextField-Objekten werden beim Auswählen dieser Befehle (oder der entsprechenden Zugriffstastenkombinationen) keine clear-, copy-, cut-, paste- oder selectAll-Ereignisse ausgelöst. Andere Klassen, die die InteractiveObject-Klasse erweitern, darunter Komponenten, die mit der Flash Text Engine (FTE) erstellt wurden, setzen diese Ereignisse jedoch in Reaktion auf Benutzeraktionen wie Tastaturbefehle und Kontextmenüs ab.

Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Ausschneiden“ aktiviert oder im Kontextmenü des Texts „Ausschneiden“ wählt. Dieses Ereignis wird für das Objekt ausgelöst, das gerade den Eingabefokus hat. Ist das Objekt, das derzeit den Fokus hat, ein TextField, schneidet dieses Ereignis standardmäßig aktuell ausgewählten Text aus dem Textfeld aus und platziert ihn in die Zwischenablage.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Hinweis: TextField-Objekte lösen folgende Ereignisse nicht aus: clear, copy, cut, paste und selectAll. TextField-Objekte enthalten die Befehle „Ausschneiden“, „Kopieren“, „Einfügen“, „Löschen“ und „Alles auswählen“ immer im Kontextmenü. Diese Befehle können aus dem Kontextmenü von TextField-Objekten nicht entfernt werden. Bei TextField-Objekten werden beim Auswählen dieser Befehle (oder der entsprechenden Zugriffstastenkombinationen) keine clear-, copy-, cut-, paste- oder selectAll-Ereignisse ausgelöst. Andere Klassen, die die InteractiveObject-Klasse erweitern, darunter Komponenten, die mit der Flash Text Engine (FTE) erstellt wurden, setzen diese Ereignisse jedoch in Reaktion auf Benutzeraktionen wie Tastaturbefehle und Kontextmenüs ab.

Wird ausgelöst, wenn der Benutzer die Haupttaste des Zeigegeräts zweimal schnell hintereinander über dem gleichen InteractiveObject-Objekt drückt und das doubleClickEnabled-Kennzeichen des Objekts true lautet. Damit ein doubleClick-Ereignis eintreten kann, muss es unmittelbar an die folgende Reihe von Ereignissen anschließen: mouseDown, mouseUp, click, mouseDown, mouseUp. Alle diese Ereignisse müssen dasselbe Ziel wie das doubleClick-Ereignis aufweisen. Der zweite Klick, der jeweils durch das zweite mouseDown- und mouseUp-Ereignis repräsentiert wird, muss innerhalb einer bestimmten Zeitspanne nach dem click-Ereignis eintreten. Die zulässige Dauer dieser Zeitspanne variiert für verschiedene Betriebssysteme und kann oft vom Benutzer selbst eingestellt werden. Handelt es sich beim Ziel um ein auswählbares Textfeld, wird als Standardverhalten das Wort an der Zeigerposition ausgewählt. Ist für die Ziel-InteractiveObject-Instanz das doubleClickEnabled-Kennzeichen nicht auf true gesetzt, empfängt es einfach zwei click-Ereignisse.

Die doubleClickEnabled-Eigenschaft ist standardmäßig auf false gesetzt.

Das Doppelklick-Textauswahlverhalten eines TextField-Objekts steht nicht in Bezug zum doubleClick-Ereignis. Verwenden Sie TextField.doubleClickEnabled, um die TextField-Auswahl zu steuern.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus erhalten hat. Dies passiert, wenn Benutzer das Objekt mit einem Zeigegerät oder per Tastaturnavigation hervorheben. Der Empfänger des Fokus ist das Zielobjekt dieses Ereignisses, während die dazugehörige InteractiveObject-Instanz, die den Fokus verliert, „verwandtes Objekt“ genannt wird. Ein Verweis auf das verwandte Objekt wird in der Eigenschaft relatedObject des empfangenden Objekts gespeichert. Die shiftKey-Eigenschaft wird nicht verwendet. Dieses Ereignis folgt nach dem Auslösen des focusOut-Ereignisses des vorigen Objekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus abgegeben hat. Dies passiert, wenn Benutzer ein anderes Objekt mit einem Zeigegerät oder per Tastaturnavigation hervorheben. Das Objekt, das den Fokus verliert, ist das Zielobjekt dieses Ereignisses, während die dazugehörige InteractiveObject-Instanz, die den Fokus erhält, „verwandtes Objekt“ genannt wird. Ein Verweis auf das verwandte Objekt wird in der Eigenschaft relatedObject des Zielobjekts gespeichert. Die shiftKey-Eigenschaft wird nicht verwendet. Das Ereignis kommt vor dem Auslösen des focusIn-Ereignisses durch das verwandte Objekt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird abgesetzt, wenn der Benutzer einen Kontaktpunkt entlang der Kante der Touch-Oberfläche mit einer InteractiveObject-Instanz erstellt (z. B. durch Tippen entlang der Kante der Touch-Oberfläche auf Siri Remote für Apple TV). Bei einigen Geräten könnte dieser Kontakt auch als eine Kombination von verschiedenen Kontaktereignissen ausgelegt werden.

Insbesondere, wenn der Benutzer ein InteractiveObject mit dem Finger berührt und dann die Finger wegbewegt, kann die InteractiveObject-Instanz ein touchBegin-Ereignis und ein touchEnd-Ereignis (unter anderem) zusätzlich zum gestureDirectionalTap-Ereignis absetzen, oder sogar alle diese Ereignisse, wenn die aktuelle Umgebung dies unterstützt. Wählen Sie, wie die Benutzerinteraktion verarbeitet werden soll. Verwenden Sie die flash.ui.Multitouch-Klasse, um die Verarbeitung von Berührungsereignissen zu verwalten (Verarbeitung von Berührungsgestenereignissen oder einfachen Kontaktpunktereignissen aktivieren oder Berührungsereignisse deaktivieren, sodass nur Mausereignisse abgesetzt werden). Wenn Sie sich dafür entscheiden, das touchBegin-Ereignis zu verarbeiten, wird dieselbe Ereignisprozedur bei einem berührungsempfindlichen Gerät ausgeführt. Entscheiden Sie sich jedoch dafür, das gestureDirectionalTap-Ereignis zu verarbeiten, können Sie Ihre Ereignisprozedur so konstruieren, dass sie auf die spezifischen Anforderungen einer berührungsempfindlichen Umgebung reagiert und Benutzern eine umfassende Steuerung über Berührungen und Gesten ermöglicht. Sie können auch beide Ereignisse separat verarbeiten, um auf Gestenereignisse anders zu reagieren als auf Berührungsereignisse. Die flash.ui.Multitouch-Klasse entscheidet darüber, ob ein Berührungs- oder ein Gestenereignis ausgelöst wird.

Beachten Sie bei der Verarbeitung der Eigenschaften des Ereignisobjekts, dass die localX- und localY-Eigenschaften auf den primären Kontaktpunkt (bei Apple TV ist dies die Bildschirmmitte) gesetzt sind. Die Eigenschaften offsetX und offsetY entsprechen der Richtung der Gestenbewegung.

Hinweis: Diese API unterstützt nur das direktionale Tippen mit einem Finger.

Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer auf zwei Kontaktpunkte über derselben InteractiveObject-Instanz auf einem berührungsempfindlichen Gerät drückt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen zwei Finger auf ein Anzeigeobjekt drückt und wieder loslässt). Einige Geräte interpretieren diese Berührung möglicherweise auch als doubleClick-Ereignis.

Insbesondere, wenn der Benutzer mit zwei Fingern auf ein InteractiveObject tippt, kann die InteractiveObject-Instanz ein doubleClick-Ereignis oder ein gestureTwoFingerTap-Ereignis absetzen, oder beide Ereignisse, wenn die aktuelle Umgebung dies unterstützt. Wählen Sie, wie die Benutzerinteraktion verarbeitet werden soll. Verwenden Sie die flash.ui.Multitouch-Klasse, um die Verarbeitung von Berührungsereignissen zu verwalten (Verarbeitung von Berührungsgestenereignissen oder einfachen Kontaktpunktereignissen aktivieren oder Berührungsereignisse deaktivieren, sodass nur Mausereignisse abgesetzt werden). Wenn Sie sich dafür entscheiden, das doubleClick-Ereignis zu verarbeiten, wird dieselbe Ereignisprozedur bei einem berührungsempfindlichen Gerät und auf einem mausfähigen Gerät ausgeführt. Entscheiden Sie sich jedoch dafür, das gestureTwoFingerTap-Ereignis zu verarbeiten, können Sie Ihre Ereignisprozedur so konstruieren, dass sie auf die spezifischen Anforderungen einer berührungsempfindlichen Umgebung reagiert und Benutzern eine umfassende Steuerung über Berührungen und Gesten ermöglicht. Sie können auch beide Ereignisse separat verarbeiten, um auf Berührungsereignisse anders zu reagieren als auf Mausereignisse.

Hinweis: Informationen zur Umgebungskompatibilität finden Sie im Abschnitt über die Multitouch-Klasse.

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer einen Berührungspunkt über die InteractiveObject-Instanz auf einem berührungsempfindlichen Gerät bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger über ein Anzeigeobjekt von links nach rechts bewegt). Einige Geräte interpretieren diese Berührung möglicherweise auch als ein mouseOver-Ereignis und als ein touchOver-Ereignis.

Insbesondere, wenn der Benutzer einen Finger über ein InteractiveObject bewegt, kann die InteractiveObject-Instanz ein mouseOver-Ereignis oder ein touchOver-Ereignis oder ein gesturePan-Ereignis absetzen, oder sogar alle diese Ereignisse, wenn die aktuelle Umgebung dies unterstützt. Wählen Sie, wie die Benutzerinteraktion verarbeitet werden soll. Verwenden Sie die flash.ui.Multitouch-Klasse, um die Verarbeitung von Berührungsereignissen zu verwalten (Verarbeitung von Berührungsgestenereignissen oder einfachen Kontaktpunktereignissen aktivieren oder Berührungsereignisse deaktivieren, sodass nur Mausereignisse abgesetzt werden). Wenn Sie sich dafür entscheiden, das mouseOver-Ereignis zu verarbeiten, wird dieselbe Ereignisprozedur bei einem berührungsempfindlichen Gerät und auf einem mausfähigen Gerät ausgeführt. Entscheiden Sie sich jedoch dafür, das gesturePan-Ereignis zu verarbeiten, können Sie Ihre Ereignisprozedur so konstruieren, dass sie auf die spezifischen Anforderungen einer berührungsempfindlichen Umgebung reagiert und Benutzern eine umfassende Steuerung über Berührungen und Gesten ermöglicht. Sie können auch beide Ereignisse separat verarbeiten, um auf Berührungsereignisse anders zu reagieren als auf Mausereignisse.

Hinweis: Informationen zur Umgebungskompatibilität finden Sie im Abschnitt über die Multitouch-Klasse.

Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:

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

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer eine Drehgeste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit zwei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann über einem Anzeigeobjekt dreht). Die Zwei-Fingerdrehung ist eine gebräuchliche Drehgeste, jedoch kann jedes Gerät und jedes Betriebssystem eigene Anforderungen für Drehvorgänge haben. Einige Geräte interpretieren diese Art der Berührung möglicherweise auch als Kombination verschiedener Mausereignisse.

Insbesondere, wenn der Benutzer einen Finger über ein InteractiveObject bewegt, kann die InteractiveObject-Instanz ein mouseOver-Ereignis und ein click-Ereignis (unter anderem) zusätzlich zum gestureZoom-Ereignis absetzen, oder sogar alle diese Ereignisse, wenn die aktuelle Umgebung dies unterstützt. Wählen Sie, wie die Benutzerinteraktion verarbeitet werden soll. Verwenden Sie die flash.ui.Multitouch-Klasse, um die Verarbeitung von Berührungsereignissen zu verwalten (Verarbeitung von Berührungsgestenereignissen oder einfachen Kontaktpunktereignissen aktivieren oder Berührungsereignisse deaktivieren, sodass nur Mausereignisse abgesetzt werden). Wenn Sie sich dafür entscheiden, das mouseOver-Ereignis zu verarbeiten, wird dieselbe Ereignisprozedur bei einem berührungsempfindlichen Gerät und auf einem mausfähigen Gerät ausgeführt. Entscheiden Sie sich jedoch dafür, das gestureRotate-Ereignis zu verarbeiten, können Sie Ihre Ereignisprozedur so konstruieren, dass sie auf die spezifischen Anforderungen einer berührungsempfindlichen Umgebung reagiert und Benutzern eine umfassende Steuerung über Berührungen und Gesten ermöglicht. Sie können auch beide Ereignisse separat verarbeiten, um auf Berührungsereignisse anders zu reagieren als auf Mausereignisse.

Beachten Sie bei der Verarbeitung der Eigenschaften des Ereignisobjekts, dass die localX- und localY-Eigenschaften auf den primären Kontaktpunkt gesetzt sind. Die offsetX- und offsetY-Eigenschaften geben den Abstand zum Kontaktpunkt, an dem die Drehgeste abgeschlossen ist, an.

Hinweis: Informationen zur Umgebungskompatibilität finden Sie im Abschnitt über die Multitouch-Klasse.

Während dieses Ereignisses enthält die rotation-Eigenschaft den Drehwinkel. Die Drehwerte lauten wie folgt:

• 0 bis 180 Grad für die Drehung im Uhrzeigersinn
• -180 bis 0 Grad für die Drehung gegen den Uhrzeigersinn

Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:

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

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer eine Swipe-Geste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit drei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann parallel über ein Anzeigeobjekt bewegt). Das parallele Bewegen mehrerer Finger ist eine gebräuchliche Swipe-Geste, jedoch kann jedes Gerät seine eigenen Anforderungen für eine Swipe-Geste haben. Einige Geräte interpretieren diese Art der Berührung möglicherweise auch als Kombination verschiedener Mausereignisse.

Insbesondere, wenn der Benutzer einen Finger über ein InteractiveObject bewegt und dann die Finger zusammen bewegt, kann die InteractiveObject-Instanz ein rollOver-Ereignis und ein rollOut-Ereignis (unter anderem) zusätzlich zum gestureSwipe-Ereignis absetzen, oder sogar alle diese Ereignisse, wenn die aktuelle Umgebung dies unterstützt. Wählen Sie, wie die Benutzerinteraktion verarbeitet werden soll. Wenn Sie sich dafür entscheiden, das rollOver-Ereignis zu verarbeiten, wird dieselbe Ereignisprozedur bei einem berührungsempfindlichen Gerät und auf einem mausfähigen Gerät ausgeführt. Entscheiden Sie sich jedoch dafür, das gestureSwipe-Ereignis zu verarbeiten, können Sie Ihre Ereignisprozedur so konstruieren, dass sie auf die spezifischen Anforderungen einer berührungsempfindlichen Umgebung reagiert und Benutzern eine umfassende Steuerung über Berührungen und Gesten ermöglicht. Sie können auch beide Ereignisse separat verarbeiten, um auf Berührungsereignisse anders zu reagieren als auf Mausereignisse.

Beachten Sie bei der Verarbeitung der Eigenschaften des Ereignisobjekts, dass die localX- und localY-Eigenschaften auf den primären Kontaktpunkt gesetzt sind. Die offsetX- und offsetY-Eigenschaften geben den Abstand zum Kontaktpunkt, an dem die Swipe-Geste abgeschlossen ist, an.

Hinweis: Während einige Geräte mit dem Betriebssystem Mac OS eine Swipe-Geste mit vier Fingern erkennen, unterstützt diese API nur Swipe-Gesten mit drei Fingern.

Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:

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;

}

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer einen Kontaktpunkt mit einer InteractiveObject-Instanz erstellt und dann auf ein berührungsempfindliches Gerät tippt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen mehrere Finger auf einem Anzeigeobjekt platziert, um ein Menü zu öffnen, und dann mit einem Finger tippt, um einen Menüpunkt auszuwählen). Einige Geräte interpretieren diese Art der Berührung möglicherweise auch als Kombination verschiedener Mausereignisse.

Insbesondere, wenn der Benutzer einen Finger über ein InteractiveObject bewegt und dann ein sekundäres Tippen ausführt, kann die InteractiveObject-Instanz ein mouseOver-Ereignis und ein click-Ereignis (unter anderem) zusätzlich zum gesturePressAndTap-Ereignis absetzen, oder sogar alle diese Ereignisse, wenn die aktuelle Umgebung dies unterstützt. Wählen Sie, wie die Benutzerinteraktion verarbeitet werden soll. Verwenden Sie die flash.ui.Multitouch-Klasse, um die Verarbeitung von Berührungsereignissen zu verwalten (Verarbeitung von Berührungsgestenereignissen oder einfachen Kontaktpunktereignissen aktivieren oder Berührungsereignisse deaktivieren, sodass nur Mausereignisse abgesetzt werden). Wenn Sie sich dafür entscheiden, das mouseOver-Ereignis zu verarbeiten, wird dieselbe Ereignisprozedur bei einem berührungsempfindlichen Gerät und auf einem mausfähigen Gerät ausgeführt. Entscheiden Sie sich jedoch dafür, das gesturePressAndTap-Ereignis zu verarbeiten, können Sie Ihre Ereignisprozedur so konstruieren, dass sie auf die spezifischen Anforderungen einer berührungsempfindlichen Umgebung reagiert und Benutzern eine umfassende Steuerung über Berührungen und Gesten ermöglicht. Sie können auch beide Ereignisse separat verarbeiten, um auf Berührungsereignisse anders zu reagieren als auf Mausereignisse.

Beachten Sie bei der Verarbeitung der Eigenschaften des Ereignisobjekts, dass die localX- und localY-Eigenschaften auf den primären Kontaktpunkt (das Drücken) gesetzt sind. Die offsetX- und offsetY-Eigenschaften geben den Abstand zum sekundären Kontaktpunkt (das Tippen) an.

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer eine Zoom-Geste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit zwei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann schnell über einem Anzeigeobjekt spreizt). Das Spreizen von Fingern ist eine gebräuchliche Zoomgeste, jedoch kann jedes Gerät und jedes Betriebssystem eigene Anforderungen für Zoomvorgänge haben. Einige Geräte interpretieren diese Art der Berührung möglicherweise auch als Kombination verschiedener Mausereignisse.

Insbesondere, wenn der Benutzer einen Finger über ein InteractiveObject bewegt und die Finger spreizt, kann die InteractiveObject-Instanz ein mouseOver-Ereignis und ein click-Ereignis (unter anderem) zusätzlich zum gestureZoom-Ereignis absetzen, oder sogar alle diese Ereignisse, wenn die aktuelle Umgebung dies unterstützt. Wählen Sie, wie die Benutzerinteraktion verarbeitet werden soll. Verwenden Sie die flash.ui.Multitouch-Klasse, um die Verarbeitung von Berührungsereignissen zu verwalten (Verarbeitung von Berührungsgestenereignissen oder einfachen Kontaktpunktereignissen aktivieren oder Berührungsereignisse deaktivieren, sodass nur Mausereignisse abgesetzt werden). Wenn Sie sich dafür entscheiden, das mouseOver-Ereignis zu verarbeiten, wird dieselbe Ereignisprozedur bei einem berührungsempfindlichen Gerät und auf einem mausfähigen Gerät ausgeführt. Entscheiden Sie sich jedoch dafür, das gestureZoom-Ereignis zu verarbeiten, können Sie Ihre Ereignisprozedur so konstruieren, dass sie auf die spezifischen Anforderungen einer berührungsempfindlichen Umgebung reagiert und Benutzern eine umfassende Steuerung über Berührungen und Gesten ermöglicht. Sie können auch beide Ereignisse separat verarbeiten, um auf Berührungsereignisse anders zu reagieren als auf Mausereignisse.

Beachten Sie bei der Verarbeitung der Eigenschaften des Ereignisobjekts, dass die localX- und localY-Eigenschaften auf den primären Kontaktpunkt gesetzt sind. Die offsetX- und offsetY-Eigenschaften geben den Abstand zum Kontaktpunkt, an dem die Zoomgeste abgeschlossen ist, an.

Hinweis: Informationen zur Umgebungskompatibilität finden Sie im Abschnitt über die Multitouch-Klasse.

Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:

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

Verwandte API-Elemente

Dieses Ereignis wird an jede Client-Anwendung abgesetzt, die die Inline-Eingabe mit einem IME unterstützt

Wird ausgelöst, wenn der Benutzer eine Taste drückt. Zuordnungen zwischen Tasten und spezifischen Zeichen variieren zwischen verschiedenen Geräten und Betriebssystemen. Dieser Ereignistyp wird erzeugt, nachdem eine Zuordnung dieser Art stattgefunden hat, aber vor der Verarbeitung eines IME (Input Method Editor, Eingabemethodeneditor). IMEs werden zur Eingabe von Zeichen verwendet, die auf der Standard-QWERTY-Tastatur nicht belegt sind, wie etwa chinesische Ideogramme. Dieses Ereignis tritt vor dem keyUp-Ereignis ein.

Wenn Sie in AIR dieses Ereignis abbrechen, wird verhindert, dass das Zeichen in ein Textfeld eingegeben wird.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe der Tastatur zu ändern. Das Standardverhalten dieses Ereignisses besteht darin, den Fokus zu ändern und das entsprechende focusIn- und focusOut-Ereignis auszulösen.

Dieses Ereignis wird für das Objekt ausgelöst, das gerade den Eingabefokus hat. Das verwandte Objekt für dieses Ereignis ist die InteractiveObject-Instanz, die den Fokus erhält, wenn Sie das Standardverhalten nicht verhindern. Sie können den Fokuswechsel verhindern, indem Sie in einem Ereignis-Listener, der bei dem Zielobjekt ordentlich registriert ist, die preventDefault()-Methode aufrufen. Der Fokus wird gewechselt und die Ereignisse focusIn und focusOut werden standardmäßig ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer eine Taste loslässt. Zuordnungen zwischen Tasten und spezifischen Zeichen variieren zwischen verschiedenen Geräten und Betriebssystemen. Dieser Ereignistyp wird erzeugt, nachdem eine Zuordnung dieser Art stattgefunden hat, aber vor der Verarbeitung eines IME (Input Method Editor, Eingabemethodeneditor). IMEs werden zur Eingabe von Zeichen verwendet, die auf der Standard-QWERTY-Tastatur nicht belegt sind, wie etwa chinesische Ideogramme. Dieses Ereignis tritt nach einem keyDown-Ereignis auf und besitzt die folgenden Merkmale:

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt. Damit ein middleClick-Ereignis auftritt, müssen zunächst immer die beiden folgenden Ereignisse in der angegebenen Reihenfolge auftreten: middleMouseDown, dann middleMouseUp. Das Zielobjekt muss für beide Ereignisse identisch sein; andernfalls tritt kein middleClick-Ereignis auf. Zwischen den Ereignissen middleMouseDown und middleMouseUp können noch verschiedene andere Mausereignisse auftreten, wobei das middleClick-Ereignis trotzdem auftritt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt. Handelt es sich bei dem Ziel um eine SimpleButton-Instanz, zeigt die SimpleButton-Instanz als Standardverhalten das downState-Anzeigeobjekt an. Handelt es sich beim Ziel um ein auswählbares Textfeld, wird als Standardverhalten die Textauswahl begonnen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe eines Zeigegeräts zu ändern. Das Standardverhalten dieses Ereignisses besteht darin, den Fokus zu ändern und das entsprechende focusIn- und focusOut-Ereignis auszulösen.

Dieses Ereignis wird für das Objekt ausgelöst, das gerade den Eingabefokus hat. Das verwandte Objekt für dieses Ereignis ist die InteractiveObject-Instanz, die den Fokus erhält, wenn Sie das Standardverhalten nicht verhindern. Sie können den Fokuswechsel verhindern, indem Sie in einem Ereignis-Listener, der bei dem Zielobjekt ordentlich registriert ist, preventDefault() aufrufen. Die shiftKey-Eigenschaft wird nicht verwendet. Der Fokus wird gewechselt und die Ereignisse focusIn und focusOut werden standardmäßig ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer das Zeigegerät bewegt, während es sich auf einer InteractiveObject-Instanz befindet. Handelt es sich beim Ziel um ein Textfeld, in dem der Benutzer eine Auswahl vornimmt, wird als Standardverhalten die Auswahl aktualisiert.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt. Das Ereignisziel ist das Objekt, das sich davor unter dem Zeigegerät befunden hat. relatedObject ist das Objekt, zu dem sich das Zeigegerät bewegt hat. Handelt es sich bei dem Ziel um eine SimpleButton-Instanz, zeigt die Schaltfläche als Standardverhalten das upState-Anzeigeobjekt an.

Das Ereignis mouseOut wird jedes Mal ausgelöst, wenn die Maus den Bereich eines dem Anzeigeobjekt-Container untergeordneten Objekts verlässt, selbst sich wenn die Maus weiterhin über einem anderen dem Anzeigeobjekt-Container untergeordneten Objekt befindet. Dieses Verhalten unterscheidet sich vom Zweck des rollOut-Ereignisses, der darin besteht, die Programmierung von Rollover-Verhaltensweisen für Anzeigeobjekt-Container mit untergeordneten Objekten zu vereinfachen. Verlässt die Maus den Bereich eines Anzeigeobjekts oder den Bereich, in dem sich die diesem untergeordneten Objekte befinden, um auf ein Objekt zu zeigen, das diesem Objekt nicht untergeordnet ist, löst das Anzeigeobjekt das rollOut-Ereignis aus. Die rollOut-Ereignisse werden über die übergeordnete Kette des Objekts fortlaufend nach oben hin ausgelöst, beginnend mit dem Objekt selbst und endend mit dem höchsten übergeordneten Objekt, das weder das Stammobjekt noch ein übergeordnetes Element des relatedObject-Objekts ist.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt. relatedObject ist das Objekt, das sich davor unter dem Zeigegerät befunden hat. Handelt es sich beim Ziel um eine SimpleButton-Instanz, zeigt das Objekt als Standardverhalten das overState- oder das upState-Anzeigeobjekt an. Dies hängt davon ab, ob die Maustaste gerade gedrückt ist.

Das Ereignis mouseOver wird jedes Mal ausgelöst, wenn die Maus in den Bereich eines dem Anzeigeobjekt-Container untergeordneten Objekts bewegt wird, selbst wenn sich die Maus bereits über einem anderen dem Anzeigeobjekt-Container untergeordneten Objekt befindet. Dieses Verhalten unterscheidet sich vom Zweck des rollOver-Ereignisses, der darin besteht, die Programmierung von Rollout-Verhaltensweisen für Anzeigeobjekt-Container mit untergeordneten Objekten zu vereinfachen. Kommt die Maus aus einem Objekt, das diesem Anzeigeobjekt nicht untergeordnet ist, in den Bereich eines Anzeigeobjekts oder in den Bereich, in dem sich die diesem untergeordneten Objekte befinden, löst das Anzeigeobjekt das rollOver-Ereignis aus. Die rollOver-Ereignisse werden über die übergeordnete Kette des Objekts fortlaufend nach unten hin ausgelöst, beginnend mit dem höchsten übergeordneten Objekt, das weder das Stammobjekt noch ein übergeordnetes Element des relatedObject-Objekts ist.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt. Handelt es sich beim Ziel um eine SimpleButton-Instanz, zeigt das Objekt das upState-Anzeigeobjekt an. Handelt es sich beim Ziel um ein auswählbares Textfeld, wird als Standardverhalten die Textauswahl abgeschlossen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn das Mausrad über einer InteractiveObject-Instanz gedreht wird. Handelt es sich beim Ziel um ein Textfeld, wird als Standardverhalten der Text innerhalb des Textfelds nach oben oder unten verschoben. Nur unter Microsoft Windows verfügbar.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird vom InteractiveObject-Ziehinitiator ausgelöst, wenn der Benutzer die Ziehbewegung beendet.

Die dropAction-Eigenschaft des Ereignisses gibt die Aktion an, die vom Zielobjekt des Ziehvorgangs festgelegt ist. Der Wert „none“ (DragActions.NONE) bedeutet, dass der Ablegevorgang abgebrochen oder nicht akzeptiert wurde.

Die nativeDragComplete-Ereignisprozedur eignet sich, um den Status des einleitenden Anzeigeobjekts zu aktualisieren, beispielsweise durch Entfernen eines Elements aus einer Liste (für die move-Ziehaktion) oder durch Ändern der visuellen Eigenschaften.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird vom InteractiveObject-Zielobjekt ausgelöst, wenn ein gezogenes Objekt darauf abgelegt wird und das Ablegen mit einem Aufruf von „DragManager.acceptDragDrop()“ akzeptiert wurde.

Auf die abgelegten Daten kann mit der clipboard-Eigenschaft des Ereignisobjekts zugegriffen werden.

Die Prozedur für dieses Ereignis sollte die DragManager.dropAction-Eigenschaft festlegen, um dem Initiatorobjekt mitzuteilen, welche Ziehaktion ausgeführt wurde. Wenn kein Wert festgelegt wird, wählt DragManager einen Standardwert in der Liste der zulässigen Aktionen aus.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung in ihre Begrenzungen eintritt.

Entweder das nativeDragEnter-Ereignis oder das nativeDragOver-Ereignis sollte so eingestellt werden, dass das Anzeigeobjekt zum Ablageziel werden kann.

Um zu bestimmen, ob das auslösende Anzeigeobjekt den Ablegevorgang akzeptieren kann, überprüfen Sie die Eignung der Daten in der clipboard-Eigenschaft des Ereignisobjekts und die zulässigen Ziehaktionen in der allowedActions-Eigenschaft.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung ihre Begrenzungen verlässt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird von einer InteractiveObject-Instanz kontinuierlich ausgelöst, während eine Ziehbewegung innerhalb ihrer Begrenzungen verbleibt.

nativeDragOver-Ereignisse werden ausgelöst, wann immer die Maus bewegt wird. Unter Windows und Mac werden sie auch bei kurzen Timerintervallen ausgelöst, selbst, wenn sich die Maus nicht bewegt hat.

Entweder das nativeDragOver-Ereignis oder das nativeDragEnter-Ereignis sollte so eingestellt werden, dass das Anzeigeobjekt zum Ablageziel werden kann.

Um zu bestimmen, ob das auslösende Anzeigeobjekt den Ablegevorgang akzeptieren kann, überprüfen Sie die Eignung der Daten in der clipboard-Eigenschaft des Ereignisobjekts und die zulässigen Ziehaktionen in der allowedActions-Eigenschaft.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird am Anfang eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird während eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist.

Unter Linux werden keine nativeDragUpdate-Ereignisse ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Einfügen“ aktiviert oder im Kontextmenü des Texts „Einfügen“ wählt. Dieses Ereignis wird für das Objekt ausgelöst, das gerade den Eingabefokus hat. Ist das Objekt, das derzeit den Fokus hat, ein TextField, fügt dieses Ereignis standardmäßig die Inhalte der Zwischenablage an der aktuellen Einfügemarke im Textfeld ein, wobei aktuell ausgewählter Text ersetzt wird.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Hinweis: TextField-Objekte lösen folgende Ereignisse nicht aus: clear, copy, cut, paste und selectAll. TextField-Objekte enthalten die Befehle „Ausschneiden“, „Kopieren“, „Einfügen“, „Löschen“ und „Alles auswählen“ immer im Kontextmenü. Diese Befehle können aus dem Kontextmenü von TextField-Objekten nicht entfernt werden. Bei TextField-Objekten werden beim Auswählen dieser Befehle (oder der entsprechenden Zugriffstastenkombinationen) keine clear-, copy-, cut-, paste- oder selectAll-Ereignisse ausgelöst. Andere Klassen, die die InteractiveObject-Klasse erweitern, darunter Komponenten, die mit der Flash Text Engine (FTE) erstellt wurden, setzen diese Ereignisse jedoch in Reaktion auf Benutzeraktionen wie Tastaturbefehle und Kontextmenüs ab.

Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift unter den Schwellenwert für die Abstandserkennung des Bildschirms senkt.

Die typische Abfolge von Ereignissen, die auftritt, wenn ein Benutzer einen Eingabestift auf den Bildschirm aufsetzt, über den Bildschirm bewegt und vom Bildschirm nimmt, ist:

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

Hinweis: Informationen zur Umgebungskompatibilität finden Sie im Abschnitt über die Multitouch-Klasse.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift über den Schwellenwert für die Abstandserkennung des Bildschirms anhebt.

Ein proximityEnd-Ereignis wird nicht abgesetzt, wenn der Eingabestift den Bildschirm berührt.

Die typische Abfolge von Ereignissen, die auftritt, wenn ein Benutzer einen Eingabestift auf den Bildschirm aufsetzt, über den Bildschirm bewegt und vom Bildschirm nimmt, ist:

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

Hinweis: Informationen zur Umgebungskompatibilität finden Sie im Abschnitt über die Multitouch-Klasse.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift über den Bildschirm bewegt, während er innerhalb des Schwellenwerts der Abstandserkennung bleibt.

Die typische Abfolge von Ereignissen, die auftritt, wenn ein Benutzer einen Eingabestift auf den Bildschirm aufsetzt, über den Bildschirm bewegt und vom Bildschirm nimmt, ist:

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

Hinweis: Informationen zur Umgebungskompatibilität finden Sie im Abschnitt über die Multitouch-Klasse.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift von diesem InteractiveObject wegbewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt.

Hinweis: Informationen zur Umgebungskompatibilität finden Sie im Abschnitt über die Multitouch-Klasse.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift direkt über dieses InteractiveObject bewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt.

Hinweis: Informationen zur Umgebungskompatibilität finden Sie im Abschnitt über die Multitouch-Klasse.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift von diesem InteractiveObject und seinen untergeordneten Elementen wegbewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt.

Das Ereignisziel ist das Objekt, das sich zuvor unter dem Eingabestift befunden hat, oder ein Objekt, das diesem übergeordnet ist. relatedObject ist das Objekt, von dem sich der Eingabestift wegbewegt hat. Die proximityRollOut-Ereignisse werden über die übergeordnete Kette des Objekts fortlaufend nach oben hin ausgelöst, beginnend mit dem Objekt selbst und endend mit dem höchsten übergeordneten Objekt, das weder das Stammobjekt noch ein übergeordnetes Element des relatedObject-Objekts ist.

Der Zweck des proximityRollOut-Ereignisses besteht darin, die Programmierung von Rollover-Verhaltensweisen für Anzeigeobjekt-Container mit untergeordneten Objekten zu vereinfachen. Verlässt der Eingabestift den Bereich eines Anzeigeobjekts oder den Bereich, in dem sich die diesem untergeordneten Objekte befinden, um sich zu einem Objekt zu bewegen, das diesem Objekt nicht untergeordnet ist, löst das Anzeigeobjekt das proximityRollOut-Ereignis aus. Dieses Verhalten unterscheidet sich von dem des proximityOut-Ereignisses, das jeweils dann ausgelöst wird, wenn die Maus den Bereich eines dem Anzeigeobjekt-Container untergeordneten Objekts verlässt, selbst wenn die Maus über einem anderen dem Anzeigeobjekt-Container untergeordneten Objekt bleibt.

Hinweis: Informationen zur Umgebungskompatibilität finden Sie im Abschnitt über die Multitouch-Klasse.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift von außerhalb der Nachfolgerstruktur des Objekts in der Anzeigeliste über dieses InteractiveObject bewegt (und dabei innerhalb des Schwellenwerts für die Abstandserkennung auf dem Bildschirm bleibt).

Das Ereignisziel ist das Objekt unter dem Eingabestift oder ein Objekt, das diesem übergeordnet ist. relatedObject ist das Objekt, das sich davor unter dem Eingabestift befunden hat. Die proximityRollOver-Ereignisse werden über die übergeordnete Kette des Objekts fortlaufend nach unten hin ausgelöst, beginnend mit dem höchsten übergeordneten Objekt, das weder das Stammobjekt noch ein übergeordnetes Element des relatedObject-Objekts ist.

Der Zweck des proximityRollOver-Ereignisses besteht darin, die Programmierung von Rollout-Verhaltensweisen für Anzeigeobjekt-Container mit untergeordneten Objekten zu vereinfachen. Kommt der Eingabestift von einem Objekt, das diesem Anzeigeobjekt nicht untergeordnet ist, in den Bereich eines Anzeigeobjekts oder in den Bereich, in dem sich die diesem untergeordneten Objekte befinden, löst das Anzeigeobjekt das proximityRollOver-Ereignis aus. Dieses Verhalten unterscheidet sich vom proximityOver-Ereignis, das immer dann ausgelöst wird, wenn die Maus auf den Bereich eines dem Anzeigeobjekt-Container untergeordneten Objekts bewegt wird. Dies ist auch der Fall, wenn sich die Maus bereits über einem anderen dem Anzeigeobjekt-Container untergeordneten Objekt befunden hat.

Hinweis: Informationen zur Umgebungskompatibilität finden Sie im Abschnitt über die Multitouch-Klasse.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Wird abgesetzt, wenn ein Benutzer die Taste des Zeigegeräts loslässt, nachdem er die Taste über einer InteractiveObject-Instanz gedrückt und das Zeigegerät dann von der InteractiveObject-Instanz wegbewegt hat. Handelt es sich beim Ziel um eine SimpleButton-Instanz, zeigt das Objekt das upState-Anzeigeobjekt an. Handelt es sich beim Ziel um ein auswählbares Textfeld, wird als Standardverhalten die Textauswahl abgeschlossen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer die rechte Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt. Damit ein rightClick-Ereignis auftritt, müssen zunächst immer die beiden folgenden Ereignisse in der angegebenen Reihenfolge auftreten: rightMouseDown, dann rightMouseUp. Das Zielobjekt muss für beide Ereignisse identisch sein; andernfalls tritt kein rightClick-Ereignis auf. Zwischen den Ereignissen rightMouseDown und rightMouseUp können noch verschiedene andere Mausereignisse auftreten, wobei das rightClick-Ereignis trotzdem auftritt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt. Das Ereignisziel ist das Objekt, das sich davor unter dem Zeigegerät befunden hat, oder ein Objekt, das diesem übergeordnet ist. relatedObject ist das Objekt, zu dem sich das Zeigegerät bewegt hat. Die rollOut-Ereignisse werden über die übergeordnete Kette des Objekts fortlaufend nach oben hin ausgelöst, beginnend mit dem Objekt selbst und endend mit dem höchsten übergeordneten Objekt, das weder das Stammobjekt noch ein übergeordnetes Element des relatedObject-Objekts ist.

Der Zweck des rollOut-Ereignisses besteht darin, die Programmierung von Rollover-Verhaltensweisen für Anzeigeobjekt-Container mit untergeordneten Objekten zu vereinfachen. Verlässt die Maus den Bereich eines Anzeigeobjekts oder den Bereich, in dem sich die diesem untergeordneten Objekte befinden, um auf ein Objekt zu zeigen, das diesem Objekt nicht untergeordnet ist, löst das Anzeigeobjekt das rollOut-Ereignis aus. Dieses Verhalten unterscheidet sich von dem des mouseOut-Ereignisses, das jeweils dann ausgelöst wird, wenn die Maus den Bereich eines dem Anzeigeobjekt-Container untergeordneten Objekts verlässt, selbst wenn die Maus über einem anderen dem Anzeigeobjekt-Container untergeordneten Objekt bleibt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt. Das Ereignisziel ist das Objekt unter dem Zeigegerät oder ein Objekt, das diesem übergeordnet ist. relatedObject ist das Objekt, das sich davor unter dem Zeigegerät befunden hat. Die rollOver-Ereignisse werden über die übergeordnete Kette des Objekts fortlaufend nach unten hin ausgelöst, beginnend mit dem höchsten übergeordneten Objekt, das weder das Stammobjekt noch ein übergeordnetes Element des relatedObject-Objekts ist.

Der Zweck des rollOver-Ereignisses besteht darin, die Programmierung von Rollout-Verhaltensweisen für Anzeigeobjekt-Container mit untergeordneten Objekten zu vereinfachen. Kommt die Maus aus einem Objekt, das diesem Anzeigeobjekt nicht untergeordnet ist, in den Bereich eines Anzeigeobjekts oder in den Bereich, in dem sich die diesem untergeordneten Objekte befinden, löst das Anzeigeobjekt das rollOver-Ereignis aus. Dieses Verhalten unterscheidet sich vom mouseOver-Ereignis, das immer dann ausgelöst wird, wenn die Maus auf den Bereich eines dem Anzeigeobjekt-Container untergeordneten Objekts bewegt wird. Dies ist auch der Fall, wenn sich die Maus bereits über einem anderen dem Anzeigeobjekt-Container untergeordneten Objekt befunden hat.

Dieses Ereignis verfügt über die folgenden Eigenschaften: