Sprite  - AS3

Legt den Schaltflächenmodus für dieses Sprite fest. Wenn true eingestellt ist, verhält sich dieses Sprite wie eine Schaltfläche. Dies bedeutet, dass die Anzeige des Handcursors ausgelöst wird, wenn der Zeiger über das Sprite bewegt wird, und ein click-Ereignis empfangen werden kann, wenn die Eingabe- oder Leertaste gedrückt wird, während das Sprite den Fokus besitzt. Sie können die Anzeige des Handcursors unterdrücken, indem Sie die useHandCursor-Eigenschaft auf false setzen. In diesem Fall wird der Pfeilcursor angezeigt.

Obwohl es besser ist, für die Erstellung von Schaltflächen die SimpleButton-Klasse zu verwenden, können Sie die buttonMode-Eigenschaft nutzen, um einem Sprite eine schaltflächenähnliche Funktionalität zu verleihen. Um ein Sprite in die Tabulatorreihenfolge einzubinden, setzen Sie die tabEnabled-Eigenschaft (wurde von der InteractiveObject-Klasse geerbt und ist standardmäßig auf false gesetzt) auf true. Zudem sollten Sie sich überlegen, ob die dem Sprite untergeordneten Objekte per Benutzereingabe aktivierbar sein sollen. Bei den meisten Schaltflächen ist für die untergeordneten Objekte keine Benutzereingabeinteraktivität aktiviert, da dies beim Ereignisablauf zu Verwirrung führen kann. Um die Benutzereingabeinteraktivität für alle untergeordneten Objekte zu aktivieren, müssen Sie die mouseChildren-Eigenschaft auf false setzen (wird von der DisplayObjectContainer-Klasse übernommen).

Wenn Sie die buttonMode-Eigenschaft mit der MovieClip-Klasse verwenden (die eine Unterklasse der Sprite-Klasse ist), kann es sein, dass Ihre Schaltfläche zusätzliche Funktionen besitzt. Wenn Sie die Bilder mit den Bezeichnungen „_up“ (auf), „_over“ (darüber) und „_down“ (gedrückt) einschließen, bietet Flash Player automatische Stausänderungen (eine Funktionalität, die in früheren ActionScript-Versionen für Movieclips bereitgestellt wurde, die als Schaltflächen verwendet werden). Diese automatischen Statusänderungen sind für Sprites nicht verfügbar, da diese keine Zeitleiste und somit auch keine Bildbezeichnungen besitzen.

Verwandte API-Elemente

import flash.display.Sprite;
import flash.events.MouseEvent;

var circle1:Sprite = new Sprite();
circle1.graphics.beginFill(0xFFCC00);
circle1.graphics.drawCircle(40, 40, 40);
circle1.buttonMode = true;
circle1.addEventListener(MouseEvent.CLICK, clicked);

var circle2:Sprite = new Sprite();
circle2.graphics.beginFill(0xFFCC00);
circle2.graphics.drawCircle(120, 40, 40);
circle2.buttonMode = false;
circle2.addEventListener(MouseEvent.CLICK, clicked);

function clicked(event:MouseEvent):void {
    trace ("Click!");
}

addChild(circle1);
addChild(circle2);

Gibt das Anzeigeobjekt an, über das der Sprite gezogen wird oder auf dem der Sprite abgelegt wurde.

Verwandte API-Elemente

import flash.display.Sprite;
import flash.events.MouseEvent;

var circle:Sprite = new Sprite();
circle.graphics.beginFill(0xFFCC00);
circle.graphics.drawCircle(0, 0, 40);

var target1:Sprite = new Sprite();
target1.graphics.beginFill(0xCCFF00);
target1.graphics.drawRect(0, 0, 100, 100);
target1.name = "target1";

var target2:Sprite = new Sprite();
target2.graphics.beginFill(0xCCFF00);
target2.graphics.drawRect(0, 200, 100, 100);
target2.name = "target2";

addChild(target1);
addChild(target2);
addChild(circle);

circle.addEventListener(MouseEvent.MOUSE_DOWN, mouseDown) 

function mouseDown(event:MouseEvent):void {
    circle.startDrag();
}
circle.addEventListener(MouseEvent.MOUSE_UP, mouseReleased);

function mouseReleased(event:MouseEvent):void {
    circle.stopDrag();
    trace(circle.dropTarget.name);
}

Legt das Graphics-Objekt fest, das zu diesem Sprite gehört und für das Vektorzeichnungsbefehle zulässig sind.

import flash.display.Sprite;

var circle:Sprite = new Sprite();
circle.graphics.beginFill(0xFFCC00);
circle.graphics.drawCircle(40, 40, 40);
addChild(circle);

Gibt als Kollisionsbereich für ein Sprite ein anderes Sprite an. Wenn die hitArea-Eigenschaft nicht vorhanden ist oder den Wert null oder undefined aufweist, wird das Sprite selbst als Kollisionsbereich verwendet. Der Wert der hitArea-Eigenschaft kann ein Verweis auf ein Sprite-Objekt sein.

Die hitArea-Eigenschaft kann jederzeit geändert werden. Das geänderte Sprite übernimmt sofort das neue Verhalten des Kollisionsbereichs. Das als Kollisionsbereich bestimmte Sprite braucht nicht sichtbar zu sein. Auch wenn es unsichtbar ist, wird seine grafische Form dennoch als Kollisionsbereich erkannt.

Hinweis: Sie müssen die mouseEnabled-Eigenschaft des als Kollisionsbereich vorgesehenen Sprites auf false setzen. Sonst kann es vorkommen, dass Ihre Sprite-Schaltfläche nicht funktioniert, da nicht Ihre Sprite-Schaltfläche, sondern das als Kollisionsbereich bestimmte Sprite die Benutzereingabeereignisse empfängt.

import flash.display.Sprite;
import flash.events.MouseEvent;

var circle:Sprite = new Sprite();
circle.graphics.beginFill(0xFFCC00);
circle.graphics.drawCircle(0, 0, 40);

var square:Sprite = new Sprite();
square.graphics.beginFill(0xCCFF00);
square.graphics.drawRect(200, 0, 100, 100);

circle.hitArea = square;
square.mouseEnabled = false;

circle.addEventListener(MouseEvent.CLICK, clicked);

function clicked(event:MouseEvent):void{
    trace(event.target == circle); // true
    trace(event.target == square); // false
}

addChild(circle);
addChild(square);

Steuert den Sound innerhalb dieses Sprites.

Hinweis: Diese Eigenschaft betrifft nicht HTML-Inhalt in einem HTMLControl-Objekt (in Adobe AIR).

Verwandte API-Elemente

import flash.display.Sprite;
import flash.display.Loader;
import flash.events.IOErrorEvent;
import flash.events.MouseEvent;
import flash.net.URLRequest;
import flash.text.TextField;
import flash.media.SoundTransform;

var container:Sprite = new Sprite();
addChild(container);

var ldr:Loader = new Loader;
var urlReq:URLRequest = new URLRequest("SoundPlayer.swf");
ldr.load(urlReq);

container.addChild(ldr);
ldr.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, urlNotFound);
            
var tf:TextField = new TextField();
tf.htmlText = "<a href = 'event:Mute'>Mute / Unmute</a>";
addChild(tf);

var mySoundTransform:SoundTransform = new SoundTransform();
mySoundTransform.volume = 1;

tf.addEventListener(MouseEvent.CLICK, mute);

function mute(event:MouseEvent):void {    
    if (mySoundTransform.volume == 0) {
        mySoundTransform.volume = 1;
    } else {
        mySoundTransform.volume = 0;        
    }
    container.soundTransform = mySoundTransform;
}

function urlNotFound(event:IOErrorEvent):void {
    trace("The URL was not found."); 
}

Ein boolescher Wert, der angibt, ob der Handcursor angezeigt werden soll, wenn der Zeiger über ein Sprite geführt wird, in dem die buttonMode-Eigenschaft auf true gesetzt ist. Der Standardwert für die useHandCursor-Eigenschaft lautet true. Wenn useHandCursor auf true gesetzt ist, erscheint der für Schaltflächen verwendete Handcursor, wenn Benutzer den Zeiger auf ein Schaltflächen-Sprite bewegen. Wenn useHandCursor auf false gesetzt ist, wird stattdessen der Pfeilcursor verwendet.

Die useHandCursor-Eigenschaft kann jederzeit geändert werden. Das geändert Sprite übernimmt sofort das neue Cursorverhalten.

Hinweis: Wenn das Sprite in Flex oder Flash Builder untergeordnete Sprites enthält, empfiehlt es sich möglicherweise, die mouseChildren-Eigenschaft auf false zu setzen. Wenn beispielsweise ein Handcursor über einer Flex-Steuerung <mx:Label> eingeblendet werden soll, stellen Sie die Eigenschaften useHandCursor und buttonMode auf true und die Eigenschaft mouseChildren auf false ein.

Verwandte API-Elemente

import flash.display.Sprite;
import flash.events.MouseEvent;

var circle1:Sprite = new Sprite();
circle1.graphics.beginFill(0xFFCC00);
circle1.graphics.drawCircle(40, 40, 40);
circle1.buttonMode = true;
circle1.useHandCursor = true;
circle1.addEventListener(MouseEvent.CLICK, clicked);

var circle2:Sprite = new Sprite();
circle2.graphics.beginFill(0xFFCC00);
circle2.graphics.drawCircle(120, 40, 40);
circle2.buttonMode = true;
circle2.useHandCursor = false;
circle2.addEventListener(MouseEvent.CLICK, clicked);

function clicked(event:MouseEvent):void {
    trace ("Click!");
}

addChild(circle1);
addChild(circle2);

Erstellt eine neue Sprite-Instanz. Nachdem Sie die Sprite-Instanz erstellt haben, rufen Sie die Methode DisplayObjectContainer.addChild() oder DisplayObjectContainer.addChildAt() auf, um die Sprite-Instanz einem übergeordneten „DisplayObjectContainer“ hinzuzufügen.

Ermöglicht es Benutzern, das angegebene Sprite mit einer Ziehoperation zu verschieben. Das Sprite bleibt so lange ziehbar, bis die Freigabe durch einen Aufruf der Sprite.stopDrag()-Methode aufgehoben wird oder bis ein anderes Sprite als ziehbares Objekt definiert wird. Es kann jeweils nur ein Sprite ziehbar sein.

Dreidimensionale Anzeigeobjekte folgen dem Zeiger und Sprite.startDrag() bewegt das Objekt innerhalb des dreidimensionalen Raums, der durch das Anzeigeobjekt festgelegt ist. Oder, wenn es sich bei dem Anzeigeobjekt um ein zweidimensionales Objekt handelt, das einem dreidimensionalen Objekt untergeordnet ist, bewegt sich das zweidimensionale Objekt innerhalb des dreidimensionalen Raums, der durch das übergeordnete dreidimensionale Objekt festgelegt ist.

Parameter

Verwandte API-Elemente

import flash.display.Sprite;
import flash.events.MouseEvent;

var circle:Sprite = new Sprite();
circle.graphics.beginFill(0xFFCC00);
circle.graphics.drawCircle(0, 0, 40);

var target1:Sprite = new Sprite();
target1.graphics.beginFill(0xCCFF00);
target1.graphics.drawRect(0, 0, 100, 100);
target1.name = "target1";

var target2:Sprite = new Sprite();
target2.graphics.beginFill(0xCCFF00);
target2.graphics.drawRect(0, 200, 100, 100);
target2.name = "target2";

addChild(target1);
addChild(target2);
addChild(circle);

circle.addEventListener(MouseEvent.MOUSE_DOWN, mouseDown) 

function mouseDown(event:MouseEvent):void {
    circle.startDrag();
}
circle.addEventListener(MouseEvent.MOUSE_UP, mouseReleased);

function mouseReleased(event:MouseEvent):void {
    circle.stopDrag();
    trace(circle.dropTarget.name);
}

Ermöglicht dem Benutzer das Ziehen des angegebenen Sprites auf einem berührungsempfindlichen Gerät. Das Sprite bleibt so lange ziehbar, bis die Freigabe durch einen Aufruf der Sprite.stopTouchDrag()-Methode aufgehoben wird oder bis ein anderes Sprite als ziehbares Objekt definiert wird. Es kann jeweils nur ein Sprite ziehbar sein.

Dreidimensionale Anzeigeobjekte folgen dem Zeiger und Sprite.startTouchDrag() bewegt das Objekt innerhalb des dreidimensionalen Raums, der durch das Anzeigeobjekt festgelegt ist. Oder, wenn es sich bei dem Anzeigeobjekt um ein zweidimensionales Objekt handelt, das einem dreidimensionalen Objekt untergeordnet ist, bewegt sich das zweidimensionale Objekt innerhalb des dreidimensionalen Raums, der durch das übergeordnete dreidimensionale Objekt festgelegt ist.

Parameter

Verwandte API-Elemente

MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);

function onTouchBegin(e:TouchEvent) {
     e.target.startTouchDrag(e.touchPointID, false, bg.getRect(this));
     trace("touch begin");
 
 }
function onTouchEnd(e:TouchEvent) {
     e.target.stopTouchDrag(e.touchPointID);
     trace("touch end");
}

Beendet die startDrag()-Methode. Ein Sprite, das mit der startDrag()-Methode ziehbar gemacht wurde, bleibt so lange ziehbar, bis die stopDrag()-Methode hinzugefügt oder ein anderes Sprite ziehbar gemacht wird. Es kann jeweils nur ein Sprite ziehbar sein.

Verwandte API-Elemente

import flash.display.Sprite;
import flash.events.MouseEvent;

var circle:Sprite = new Sprite();
circle.graphics.beginFill(0xFFCC00);
circle.graphics.drawCircle(0, 0, 40);

var target1:Sprite = new Sprite();
target1.graphics.beginFill(0xCCFF00);
target1.graphics.drawRect(0, 0, 100, 100);
target1.name = "target1";

var target2:Sprite = new Sprite();
target2.graphics.beginFill(0xCCFF00);
target2.graphics.drawRect(0, 200, 100, 100);
target2.name = "target2";

addChild(target1);
addChild(target2);
addChild(circle);

circle.addEventListener(MouseEvent.MOUSE_DOWN, mouseDown) 

function mouseDown(event:MouseEvent):void {
    circle.startDrag();
}
circle.addEventListener(MouseEvent.MOUSE_UP, mouseReleased);

function mouseReleased(event:MouseEvent):void {
    circle.stopDrag();
    trace(circle.dropTarget.name);
}

Beendet die startTouchDrag()-Methode zur Verwendung mit berührungsempfindlichen Geräten. Ein Sprite, das mit der startTouchDrag()-Methode ziehbar gemacht wurde, bleibt so lange ziehbar, bis die stopTouchDrag()-Methode hinzugefügt oder ein anderes Sprite ziehbar gemacht wird. Es kann jeweils nur ein Sprite ziehbar sein.

Parameter

Verwandte API-Elemente

MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);

function onTouchBegin(e:TouchEvent) {
     e.target.startTouchDrag(e.touchPointID, false, bg.getRect(this));
     trace("touch begin");
 
 }
function onTouchEnd(e:TouchEvent) {
     e.target.stopTouchDrag(e.touchPointID);
     trace("touch end");
}

1. Im Beispiel wird die size-Eigenschaft (100 x 100 Pixel) und die Hintergrundfarbe (Orange) zur späteren Verwendung beim Zeichnen des Quadrats deklariert.
2. Der Konstruktor erstellt anschließend ein neues child-Sprite-Objekt und verwendet es, um zwei Ereignis-Listener und die dazugehörigen Methoden hinzuzufügen: mouseDownHandler() und mouseUpHandler().
3. Das child-Sprite-Objekt wird dann an die draw()-Methode übergeben, die das orangefarbene Quadrat zeichnet.
4. Das child-Objekt wird in die Anzeigeliste eingefügt, indem die addChild()-Methode aufgerufen wird.
5. Die Ereignis-Listener funktionieren wie folgt:
   • mouseDownHandler(): Wenn Benutzer auf das Sprite-Objekt klicken, fügt diese Methode einen mouseMove-Ereignis-Listener hinzu (die mouseMoveHandler()-Methode), der die Mausbewegungen verarbeitet. Als Nächstes wird die startDrag()-Methode aufgerufen, die das Ziehen des Sprite-Objekts ermöglicht.
   • mouseUpHandler(): Wenn die Maustaste losgelassen wird, wird der mouseMove-Ereignis-Listener entfernt, und die stopDrag()-Methode wird aufgerufen, die das orangefarbene Quadrat an seiner Position fixiert.
   • mouseMoveHandler: Solange die linke Maustaste gedrückt gehalten wird, weist diese Methode den Player an, das orangefarbene Quadrat neu zu zeichnen.

Hinweis: Jede Ereignis-Listener-Methode deklariert eine lokale sprite-Variable, der die target-Eigenschaft des Ereignisses zugewiesen wird.

package {
    import flash.display.Sprite;
    import flash.events.*;

    public class SpriteExample extends Sprite {
        private var size:uint    = 100;
        private var bgColor:uint = 0xFFCC00;

        public function SpriteExample() {
            var child:Sprite = new Sprite();
            child.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
            child.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
            draw(child);
            addChild(child);
        }

        private function mouseDownHandler(event:MouseEvent):void {
            trace("mouseDownHandler");
            var sprite:Sprite = Sprite(event.target);
            sprite.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
            sprite.startDrag();
        }

        private function mouseUpHandler(event:MouseEvent):void {
            trace("mouseUpHandler");
            var sprite:Sprite = Sprite(event.target);
            sprite.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
            sprite.stopDrag();
        }

        private function mouseMoveHandler(event:MouseEvent):void {
            trace("mouseMoveHandler");
            event.updateAfterEvent();
        }

        private function draw(sprite:Sprite):void {
            sprite.graphics.beginFill(bgColor);
            sprite.graphics.drawRect(0, 0, size, size);
            sprite.graphics.endFill();
        }
    }
}