+Show TOC
×Hide TOC

DispatchableMovieClip

Kind of class:	class
Inherits from:	CoreMovieClip < MovieClip
Implements:	DispatchableInterface
Known subclasses:	EventMovieClip
Version:	04/09/07
Author:	Aaron Clinger
Classpath:	org.casaframework.movieclip.DispatchableMovieClip
File last modified:	Monday, 09 April 2007, 16:55:45

► View source

▼ Hide source

/*
    CASA Framework for ActionScript 2.0
    Copyright (C) 2007  CASA Framework
    http://casaframework.org
    
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.
    
    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details.
    
    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
*/

import org.casaframework.movieclip.CoreMovieClip;
import org.casaframework.event.DispatchableInterface;
import org.casaframework.event.EventDispatcher;
import org.casaframework.util.MovieClipUtil;

/**
    Base MovieClip that includes {@link EventDispatcher} and extends {@link CoreMovieClip}.
    
    @author Aaron Clinger
    @version 04/09/07
*/

class org.casaframework.movieclip.DispatchableMovieClip extends CoreMovieClip implements DispatchableInterface {
    private var $eventDispatcher:EventDispatcher;
    
    
    /**
        Creates an empty instance of the DispatchableMovieClip class. Use this instead of a traditional <code>new</code> constructor statement due to limitations of ActionScript 2.0.
        
        @param target: Location where the MovieClip should be attached.
        @param instanceName: A unique instance name for the MovieClip.
        @param depth: <strong>[optional]</strong> The depth level where the MovieClip is placed; defaults to next highest open depth.
        @param initObject: <strong>[optional]</strong> An object that contains properties with which to populate the newly attached MovieClip.
        @return Returns a reference to the created instance.
        @example <code>var myDispatch_mc:DispatchableMovieClip = DispatchableMovieClip.create(this, "example_mc");</code>
        @usageNote If you want to extend a non empty MovieClip you can either define the ActionScript 2.0 class in the Flash IDE library or use {@link MovieClipUtil#attachMovieRegisterClass}.
    */
    public static function create(target:MovieClip, instanceName:String, depth:Number, initObject:Object):DispatchableMovieClip {
        return DispatchableMovieClip(MovieClipUtil.createMovieRegisterClass('org.casaframework.movieclip.DispatchableMovieClip', target, instanceName, depth, initObject));
    }
    
    
    private function DispatchableMovieClip() {
        super();
        
        this.$eventDispatcher = new EventDispatcher();
        
        this.$setClassDescription('org.casaframework.movieclip.DispatchableMovieClip');
    }
    
    public function addEventObserver(scope:Object, eventName:String, eventHandler:String):Boolean {
        return this.$eventDispatcher.addEventObserver(scope, eventName, eventHandler);
    }
    
    public function removeEventObserver(scope:Object, eventName:String, eventHandler:String):Boolean {
        return this.$eventDispatcher.removeEventObserver(scope, eventName, eventHandler);
    }
    
    public function removeEventObserversForEvent(eventName:String):Boolean {
        return this.$eventDispatcher.removeEventObserversForEvent(eventName);
    }
    
    public function removeEventObserversForScope(scope:Object):Boolean {
        return this.$eventDispatcher.removeEventObserversForScope(scope);
    }
    
    public function removeAllEventObservers():Boolean {
        return this.$eventDispatcher.removeAllEventObservers();
    }
    
    /**
        {@inheritDoc}
        
        @param eventName: {@inheritDoc}
        @param param(s): {@inheritDoc}
        @return {@inheritDoc}
    */
    public function dispatchEvent(eventName:String):Boolean {
        return this.$eventDispatcher.dispatchEvent.apply(this.$eventDispatcher, arguments);
    }
    
    public function destroy():Void {
        this.$eventDispatcher.destroy();
        delete this.$eventDispatcher;
        
        super.destroy();
    }
}

Base MovieClip that includes org.casaframework.event.EventDispatcher and extends CoreMovieClip.

Summary

Instance properties

Instance properties inherited from CoreMovieClip

$instanceDescription

Class methods

create

Class methods inherited from CoreMovieClip

create

Instance methods

addEventObserver
removeEventObserver
removeEventObserversForEvent
removeEventObserversForScope
removeAllEventObservers
dispatchEvent
destroy

Instance methods inherited from CoreMovieClip

$setClassDescription destroy removeMovieClip toString

Class methods

create

static function create (

target:MovieClip, instanceName:String, depth:Number, initObject:Object) : DispatchableMovieClip

Creates an empty instance of the DispatchableMovieClip class. Use this instead of a traditional new constructor statement due to limitations of ActionScript 2.0.

Parameters:

target :

Location where the MovieClip should be attached.

instanceName:

A unique instance name for the MovieClip.

depth :

[optional] The depth level where the MovieClip is placed; defaults to next highest open depth.

initObject :

[optional] An object that contains properties with which to populate the newly attached MovieClip.

Returns:

Returns a reference to the created instance.

Example:

var myDispatch_mc:DispatchableMovieClip = DispatchableMovieClip.create(this, "example_mc");

Usage note:

If you want to extend a non empty MovieClip you can either define the ActionScript 2.0 class in the Flash IDE library or use org.casaframework.util.MovieClipUtil.attachMovieRegisterClass.

Instance methods

addEventObserver

function addEventObserver (

scope:Object, eventName:String, eventHandler:String) : Boolean

Registers a function to receive notification when a event handler is invoked.

Parameters:

scope :

The target or object in which to subscribe.

eventName :

Event name to subscribe to.

eventHandler:

[optional] Name of function to recieve the event. If undefined class assumes eventHandler matches eventName.

Returns:

Returns true if the observer was established successfully; otherwise false.

Specified by:

org.casaframework.event.DispatchableInterface.addEventObserver

destroy

function destroy (

) : Void

Removes any internal variables, intervals, enter frames, internal MovieClips and event observers to allow the object to be garbage collected.

Always call destroy() before deleting last object pointer.

Overrides:

CoreMovieClip.destroy

Specified by:

org.casaframework.core.CoreInterface.destroy

dispatchEvent

function dispatchEvent (

eventName:String) : Boolean

Reports event to all subscribed objects.

Parameters:

eventName:

Event name.

param(s) :

[optional] Parameters passed to the function specified by "eventName". Multiple parameters are allowed and should be separated by commas: param1,param2, ...,paramN

Returns:

Returns true if observer(s) listening to specifed event were found; otherwise false.

Specified by:

org.casaframework.event.DispatchableInterface.dispatchEvent

removeAllEventObservers

function removeAllEventObservers (

) : Boolean

Removes all observers regardless of scope or event.

Returns:

Returns true if observers were successfully removed; otherwise false.

Specified by:

org.casaframework.event.DispatchableInterface.removeAllEventObservers

removeEventObserver

function removeEventObserver (

scope:Object, eventName:String, eventHandler:String) : Boolean

Removes specific observer for event.

Parameters:

scope :

The target or object in which subscribed.

eventName :

Event name to unsubscribe to.

eventHandler:

[optional] Name of function that recieved the event. If undefined class assumes eventHandler matched eventName.

Returns:

Returns true if the observer was successfully found and removed; otherwise false.

Specified by:

org.casaframework.event.DispatchableInterface.removeEventObserver

removeEventObserversForEvent

function removeEventObserversForEvent (

eventName:String) : Boolean

Removes all observers for a specified event.

Parameters:

eventName:

Event name to unsubscribe to.

Returns:

Returns true if observers were successfully found for specified eventName and removed; otherwise false.

Specified by:

org.casaframework.event.DispatchableInterface.removeEventObserversForEvent

removeEventObserversForScope

function removeEventObserversForScope (

scope:Object) : Boolean

Removes all observers in a specified scope.

Parameters:

scope:

The target or object in which to unsubscribe.

Returns:

Returns true if observers were successfully found in scope and removed; otherwise false.

Specified by:

org.casaframework.event.DispatchableInterface.removeEventObserversForScope