Packagewidgetfactory.communication
Classpublic class BaseSlideRoom
InheritanceBaseSlideRoom Inheritance BaseRoom Inheritance flash.events.EventDispatcher
Implements ISlideRoom

A special type of widget room that allows widgets on a certain slide to communicate with each other.

BaseSlideRoom works by tricking the WidgetManager into thinking that it is a widget set to appear from the start to the end of the slide. The enterSlide() and exitSlide() Template Methods are the equivalent of the enterRuntime() and exitRuntime() Template Methods in the StaticWidget class. These template methods allow you to load and unload the room depending on whether the Captivate Movie is currently on the appropriate slide.

To create a slide room, indicate that you wish to use the BaseSlideRoom class (or a class that extends it) when joining the room with the WidgetRooms class.

     
         WidgetRooms.joinRoom("SlideRoom", widgetSlide, memberObject, "Barry", BaseSlideRoom);
     
     

For more information on how widget rooms work, see the BaseRoom class.

BaseSlideRoom comes with a matching BaseSlideRoomProxy class for strong typing between widget instances.

See also

BaseRoom
BaseSlideRoomProxy


Public Properties
 PropertyDefined By
 InheritedisRoom : Boolean
[read-only] A property that WidgetRooms looks for when it is trying to locate a room object.
BaseRoom
 Inheritedlocation : MovieClip
[read-only] The location where the room has been created.
BaseRoom
 Inheritedname : String
[read-only] The name given to the room when it was created.
BaseRoom
 InheritednumMembers : int
[read-only] The number of members that are registered with the room.
BaseRoom
  slideNumber : int
[read-only] The number of the slide that this room is setup on.
BaseSlideRoom
Protected Properties
 PropertyDefined By
 InheritedallMembers : Array
[read-only] A list of all the members that have joined the room.
BaseRoom
  captivateMainTimeline : MovieClip
A reference to the Captivate Main Timeline.
BaseSlideRoom
  delayEnterSlideOnFirstSlide : Boolean
Indicates whether the call to the enterSlide() method should be delayed by one frame if the room is on the first slide of the movie.
BaseSlideRoom
 InheritedonNoMembersDeleteRoom : Boolean
Indicates whether this room should delete itself if all its members deregister.
BaseRoom
Public Methods
 MethodDefined By
  
BaseSlideRoom(name:String, location:MovieClip)
Creates a new instance of the BaseSlideRoom class.
BaseSlideRoom
 Inherited
deregister(member:Object):void
Removes a member from the member list so that it can no longer be found with getMemberByName or getMembersByRole.
BaseRoom
 Inherited
getMemberByName(memberName:String, role:String):Object
Returns the member object that matches the name and role that are passed in.
BaseRoom
 Inherited
getMemberRole(member:Object):String
Takes the member object and finds what role it belongs it.
BaseRoom
 Inherited
getMembersByRole(role:String):Array
Returns a list of all members that belong to a particular role.
BaseRoom
 Inherited
register(member:Object, memberName:String, role:String):void
Registers a member with the room's member list.
BaseRoom
Protected Methods
 MethodDefined By
  
enterSlide():void
A Template Method which is called when the movie enters the slide that the room is attached to.
BaseSlideRoom
  
exitSlide():void
A Template Method which is called when the movie exits the slide that the room is attached to.
BaseSlideRoom
Events
 Event Summary Defined By
 Inherited Dispatched when a member leaves the room.BaseRoom
 Inherited Dispatched when a new member joins the room.BaseRoom
 Inherited Dispatched in the case where a member is added to the room which has the same name as another member.BaseRoom
 Inherited Dispatched when the room is about to be deleted.BaseRoom
Public Constants
 ConstantDefined By
 InheritedCOMMON_ROLE : String = commonRole
[static] The string representation the Common Role.
BaseRoom
Property Detail
captivateMainTimelineproperty
protected var captivateMainTimeline:MovieClip

A reference to the Captivate Main Timeline.

See also

delayEnterSlideOnFirstSlideproperty 
delayEnterSlideOnFirstSlide:Boolean

Indicates whether the call to the enterSlide() method should be delayed by one frame if the room is on the first slide of the movie. This allows time for all widgets to load and join the room (providing that they join the room in their enterMovie() Template Method).


Implementation
    protected function get delayEnterSlideOnFirstSlide():Boolean
    protected function set delayEnterSlideOnFirstSlide(value:Boolean):void

See also

slideNumberproperty 
slideNumber:int  [read-only]

The number of the slide that this room is setup on. (1 based)


Implementation
    public function get slideNumber():int
Constructor Detail
BaseSlideRoom()Constructor
public function BaseSlideRoom(name:String, location:MovieClip)

Creates a new instance of the BaseSlideRoom class.

Parameters
name:String — The name of the room.
 
location:MovieClip — The place where the room is set up.
Method Detail
enterSlide()method
protected function enterSlide():void

A Template Method which is called when the movie enters the slide that the room is attached to.

exitSlide()method 
protected function exitSlide():void

A Template Method which is called when the movie exits the slide that the room is attached to.